How iampradeep-hr/multilingual-hybrid-ecom-search works
Mila is a multilingual commerce storefront with an Angular shopper/admin UI and a Spring Boot API. Shoppers browse and search the catalog; admins can preview or generate multilingual tags and submit or delete products. In the documented Compose setup, submissions flow through Kafka to MongoDB and then Typesense indexing; search tries lexical matches before vector search using Ollama embeddings. README capabilities such as PIN-code store lookup, browser-local cart, seeded catalog, and admin session are retained. Several links are documented rather than visible in sampled source, so those edges cite the README; unsampled details are not inferred.
Main entry points: commerce-api.service.ts Commerce API client · AdminProductController.java Admin endpoints · ProductSearchService.java Product search · MongoProductCatalogStore.java Mongo catalog and vectors
Components 21
Web experience
- Storefront and admin
frontend/src/app/features/commerce/commerce.component.ts - Commerce API client
frontend/src/app/core/services/commerce-api.service.ts - Commerce models
frontend/src/app/core/models/commerce.models.ts
Commerce API
- Storefront endpoints
backend/src/main/java/com/mila/quickcommerce/api/StorefrontController.java - Admin endpoints
backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java - PIN-code stores
backend/src/main/java/com/mila/quickcommerce/api/StoreLocation.java
Catalog and ingest
- Catalog and tag rules
backend/src/main/java/com/mila/quickcommerce/catalog/ProductCatalogService.java - Product records
backend/src/main/java/com/mila/quickcommerce/catalog/Product.java - Product submission
backend/src/main/java/com/mila/quickcommerce/ingestion/KafkaProductSubmissionService.java - Kafka broker
- Ingest worker
backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIngestWorker.java - Index event publisher
backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIndexEventPublisher.java - Index worker
backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIndexWorker.java - Mongo catalog and vectors
backend/src/main/java/com/mila/quickcommerce/catalog/persistence/MongoProductCatalogStore.java
Search and AI
- Product search
backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java - Vector embeddings
backend/src/main/java/com/mila/quickcommerce/search/VectorEmbeddingService.java - Typesense index
- Ollama models
- AI tag generation
backend/src/main/java/com/mila/quickcommerce/tags/GemmaTagService.java
Other components
- Shopper
- Admin
Connections 26
- Shopper → Storefront and admin: uses storefront
README.md - Admin → Storefront and admin: uses admin
README.md - Storefront and admin → Commerce API client: calls
frontend/src/app/features/commerce/commerce.component.ts - Commerce API client → Commerce models: uses types
frontend/src/app/core/services/commerce-api.service.ts - Commerce API client → Storefront endpoints: requests
README.md - Commerce API client → Admin endpoints: requests
README.md - Storefront endpoints → Catalog and tag rules: delegates to
backend/src/main/java/com/mila/quickcommerce/api/StorefrontController.java - Storefront endpoints → PIN-code stores: resolves PIN
README.md - Admin endpoints → Catalog and tag rules: reads catalog
backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java - Admin endpoints → Product submission: submits products
backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java - Admin endpoints → AI tag generation: generates tags
backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java - Catalog and tag rules → Mongo catalog and vectors: persists catalog
backend/src/main/java/com/mila/quickcommerce/catalog/persistence/MongoProductCatalogStore.java - Product submission → Kafka broker: publishes ingest
README.md - Kafka broker → Ingest worker: dispatches event
backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIngestWorker.java - Ingest worker → Catalog and tag rules: saves product
backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIngestWorker.java - Ingest worker → Index event publisher: publishes saved product
backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIngestWorker.java - Index event publisher → Kafka broker: publishes index event
README.md - Kafka broker → Index worker: dispatches event
README.md - Index worker → Product search: indexes product
backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIndexWorker.java - Product search → Mongo catalog and vectors: reads catalog
backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java - Product search → Vector embeddings: embeds query
backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java - Vector embeddings → Ollama models: requests vectors
backend/src/main/java/com/mila/quickcommerce/search/VectorEmbeddingService.java - Product search → Typesense index: searches and indexes
backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java - AI tag generation → Ollama models: requests tags
backend/src/main/java/com/mila/quickcommerce/tags/GemmaTagService.java - Mongo catalog and vectors → Typesense index: indexes vectors
- Mongo catalog and vectors → Product records: stores records
backend/src/main/java/com/mila/quickcommerce/catalog/persistence/MongoProductCatalogStore.java