- qdrant/main.py: search/file now accepts hnsw_ef, exact, indexed_only form fields
(was silently ignoring them, using server defaults only)
- qdrant/main.py: add GET /inspect endpoint — full diagnostic summary for all
collections: HNSW, optimizer, quantization, segment count, payload index coverage,
raw RAM estimate (vectors * dim * 4B * 1.5)
- gateway/main.py: vectors/search/file now forwards hnsw_ef, exact, indexed_only
- gateway/main.py: add GET /vectors/inspect proxy
Inspection findings:
- _ensure_collection() created collections with bare VectorParams (no HNSW/optimizer config)
- _do_search() had no SearchParams — used Qdrant defaults (ef often ~100, no indexed_only)
- No payload index management at all — filtered searches scanned unindexed fields every time
- collection_info() returned minimal data — impossible to inspect production state
- No way to create/ensure payload indexes via the API
Changes — qdrant/main.py:
- Add SEARCH_HNSW_EF env var (default 128, above Qdrant default for better recall)
- _ensure_collection(): configure HnswConfigDiff(m=16, ef_construct=200, on_disk=False)
and OptimizersConfigDiff(indexing_threshold=20000, default_segment_number=4) on creation
- _do_search(): use SearchParams(hnsw_ef, exact, indexed_only) on every query
- SearchUrlRequest + SearchVectorRequest: expose hnsw_ef, exact, indexed_only per request
- collection_info(): expand to full HNSW/optimizer/quantization/segment/payload_schema detail
- GET /collections/{name}/indexes — list all payload indexes
- POST /collections/{name}/indexes — create a single payload index
- POST /collections/{name}/ensure-indexes — idempotent bulk index creation (skip existing)
- POST /collections/{name}/configure — apply HNSW/optimizer changes to existing collections
Changes — gateway/main.py:
- Expose the 4 new qdrant-svc endpoints under /vectors/collections/{name}/...
Changes — docker-compose.yml:
- Add SEARCH_HNSW_EF=128 to qdrant-svc environment
Critical usage note for existing collections:
After deploying, call POST /vectors/collections/images/ensure-indexes with the
payload fields actually used in filter_metadata (is_public, category_id, etc.)
to add missing indexes. This is the highest-impact single action for filtered search.
- New card-renderer FastAPI service (Python 3.11 + Pillow)
- GET /health, GET /templates
- POST /render (URL input)
- POST /render/file (multipart upload)
- POST /render/meta (dry-run layout metadata)
- nova-artwork-v1 template: cover crop, gradient overlay, text, logo
- SSRF-safe async image fetch with redirect validation
- Smart center cover crop isolated for future YOLO focal-point support
- Graceful font/logo fallback when assets are absent
- docker-compose.yml: add card-renderer service + healthcheck;
extend gateway with CARD_RENDERER_URL and depends_on
- gateway/main.py: proxy endpoints under /cards/*
- GET /cards/templates
- POST /cards/render
- POST /cards/render/file
- POST /cards/render/meta
All protected by existing APIKeyMiddleware
