# iampradeep-hr/multilingual-hybrid-ecom-search architecture

> Architecture diagram of the GitHub repository iampradeep-hr/multilingual-hybrid-ecom-search, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iampradeep-hr/multilingual-hybrid-ecom-search
- Repository: https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search

## Overview

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: [`frontend/src/app/core/services/commerce-api.service.ts`](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/frontend/src/app/core/services/commerce-api.service.ts) (Commerce API client), [`backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java`](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java) (Admin endpoints), [`backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java`](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java) (Product search), [`backend/src/main/java/com/mila/quickcommerce/catalog/persistence/MongoProductCatalogStore.java`](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/catalog/persistence/MongoProductCatalogStore.java) (Mongo catalog and vectors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web experience"]
  node_frontend["Storefront and admin"]
  node_api_client["Commerce API client"]
  node_models["Commerce models<br/>[commerce.models.ts]"]
end

subgraph group_api["Commerce API"]
  node_storefront_api["Storefront endpoints"]
  node_admin_api["Admin endpoints"]
  node_location["PIN-code stores<br/>[StoreLocation.java]"]
end

subgraph group_catalog["Catalog and ingest"]
  node_catalog_service["Catalog and tag rules"]
  node_product["Product records<br/>[Product.java]"]
  node_submission["Product submission"]
  node_kafka["Kafka broker"]
  node_ingest_worker["Ingest worker"]
  node_index_events["Index event publisher"]
  node_index_worker["Index worker"]
  node_mongo_store[("Mongo catalog and vectors")]
end

subgraph group_search["Search and AI"]
  node_search_service["Product search"]
  node_embedding["Vector embeddings"]
  node_typesense[("Typesense index")]
  node_ollama["Ollama models"]
  node_gemma["AI tag generation"]
end

node_shopper(("Shopper"))
node_admin(("Admin"))

node_shopper -->|"uses storefront"| node_frontend
node_admin -->|"uses admin"| node_frontend
node_frontend -->|"calls"| node_api_client
node_api_client -->|"uses types"| node_models
node_api_client -->|"requests"| node_storefront_api
node_api_client -->|"requests"| node_admin_api
node_storefront_api -->|"delegates to"| node_catalog_service
node_storefront_api -->|"resolves PIN"| node_location
node_admin_api -->|"reads catalog"| node_catalog_service
node_admin_api -->|"submits products"| node_submission
node_admin_api -->|"generates tags"| node_gemma
node_catalog_service -->|"persists catalog"| node_mongo_store
node_submission -->|"publishes ingest"| node_kafka
node_kafka -->|"dispatches event"| node_ingest_worker
node_ingest_worker -->|"saves product"| node_catalog_service
node_ingest_worker -->|"publishes saved product"| node_index_events
node_index_events -->|"publishes index event"| node_kafka
node_kafka -->|"dispatches event"| node_index_worker
node_index_worker -->|"indexes product"| node_search_service
node_search_service -->|"reads catalog"| node_mongo_store
node_search_service -->|"embeds query"| node_embedding
node_embedding -->|"requests vectors"| node_ollama
node_search_service -->|"searches and indexes"| node_typesense
node_gemma -->|"requests tags"| node_ollama
node_mongo_store -.->|"indexes vectors"| node_typesense
node_mongo_store -->|"stores records"| node_product

click node_frontend "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/frontend/src/app/features/commerce/commerce.component.ts"
click node_api_client "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/frontend/src/app/core/services/commerce-api.service.ts"
click node_models "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/frontend/src/app/core/models/commerce.models.ts"
click node_storefront_api "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/api/StorefrontController.java"
click node_admin_api "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java"
click node_catalog_service "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/catalog/ProductCatalogService.java"
click node_product "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/catalog/Product.java"
click node_submission "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/ingestion/KafkaProductSubmissionService.java"
click node_ingest_worker "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIngestWorker.java"
click node_index_events "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIndexEventPublisher.java"
click node_index_worker "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIndexWorker.java"
click node_mongo_store "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/catalog/persistence/MongoProductCatalogStore.java"
click node_search_service "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java"
click node_embedding "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/search/VectorEmbeddingService.java"
click node_gemma "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/tags/GemmaTagService.java"
click node_location "https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/api/StoreLocation.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_api_client,node_models toneBlue
class node_storefront_api,node_admin_api,node_location toneAmber
class node_catalog_service,node_product,node_submission,node_kafka,node_ingest_worker,node_index_events,node_index_worker,node_mongo_store toneMint
class node_search_service,node_embedding,node_typesense,node_ollama,node_gemma toneRose
class node_shopper,node_admin toneIndigo
```

## Components

### Web experience

- [Storefront and admin](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/frontend/src/app/features/commerce/commerce.component.ts): `frontend/src/app/features/commerce/commerce.component.ts`
- [Commerce API client](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/frontend/src/app/core/services/commerce-api.service.ts): `frontend/src/app/core/services/commerce-api.service.ts`
- [Commerce models](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/frontend/src/app/core/models/commerce.models.ts): `frontend/src/app/core/models/commerce.models.ts`

### Commerce API

- [Storefront endpoints](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/api/StorefrontController.java): `backend/src/main/java/com/mila/quickcommerce/api/StorefrontController.java`
- [Admin endpoints](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java): `backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java`
- [PIN-code stores](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/api/StoreLocation.java): `backend/src/main/java/com/mila/quickcommerce/api/StoreLocation.java`

### Catalog and ingest

- [Catalog and tag rules](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/catalog/ProductCatalogService.java): `backend/src/main/java/com/mila/quickcommerce/catalog/ProductCatalogService.java`
- [Product records](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/catalog/Product.java): `backend/src/main/java/com/mila/quickcommerce/catalog/Product.java`
- [Product submission](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/ingestion/KafkaProductSubmissionService.java): `backend/src/main/java/com/mila/quickcommerce/ingestion/KafkaProductSubmissionService.java`
- **Kafka broker**
- [Ingest worker](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIngestWorker.java): `backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIngestWorker.java`
- [Index event publisher](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIndexEventPublisher.java): `backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIndexEventPublisher.java`
- [Index worker](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIndexWorker.java): `backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIndexWorker.java`
- [Mongo catalog and vectors](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/catalog/persistence/MongoProductCatalogStore.java): `backend/src/main/java/com/mila/quickcommerce/catalog/persistence/MongoProductCatalogStore.java`

### Search and AI

- [Product search](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java): `backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java`
- [Vector embeddings](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/search/VectorEmbeddingService.java): `backend/src/main/java/com/mila/quickcommerce/search/VectorEmbeddingService.java`
- **Typesense index**
- **Ollama models**
- [AI tag generation](https://github.com/iampradeep-hr/multilingual-hybrid-ecom-search/blob/main/backend/src/main/java/com/mila/quickcommerce/tags/GemmaTagService.java): `backend/src/main/java/com/mila/quickcommerce/tags/GemmaTagService.java`

### Other components

- **Shopper**
- **Admin**

## Connections

- Shopper → Storefront and admin: uses storefront (evidence: `README.md`)
- Admin → Storefront and admin: uses admin (evidence: `README.md`)
- Storefront and admin → Commerce API client: calls (evidence: `frontend/src/app/features/commerce/commerce.component.ts`)
- Commerce API client → Commerce models: uses types (evidence: `frontend/src/app/core/services/commerce-api.service.ts`)
- Commerce API client → Storefront endpoints: requests (evidence: `README.md`)
- Commerce API client → Admin endpoints: requests (evidence: `README.md`)
- Storefront endpoints → Catalog and tag rules: delegates to (evidence: `backend/src/main/java/com/mila/quickcommerce/api/StorefrontController.java`)
- Storefront endpoints → PIN-code stores: resolves PIN (evidence: `README.md`)
- Admin endpoints → Catalog and tag rules: reads catalog (evidence: `backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java`)
- Admin endpoints → Product submission: submits products (evidence: `backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java`)
- Admin endpoints → AI tag generation: generates tags (evidence: `backend/src/main/java/com/mila/quickcommerce/api/AdminProductController.java`)
- Catalog and tag rules → Mongo catalog and vectors: persists catalog (evidence: `backend/src/main/java/com/mila/quickcommerce/catalog/persistence/MongoProductCatalogStore.java`)
- Product submission → Kafka broker: publishes ingest (evidence: `README.md`)
- Kafka broker → Ingest worker: dispatches event (evidence: `backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIngestWorker.java`)
- Ingest worker → Catalog and tag rules: saves product (evidence: `backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIngestWorker.java`)
- Ingest worker → Index event publisher: publishes saved product (evidence: `backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIngestWorker.java`)
- Index event publisher → Kafka broker: publishes index event (evidence: `README.md`)
- Kafka broker → Index worker: dispatches event (evidence: `README.md`)
- Index worker → Product search: indexes product (evidence: `backend/src/main/java/com/mila/quickcommerce/ingestion/ProductIndexWorker.java`)
- Product search → Mongo catalog and vectors: reads catalog (evidence: `backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java`)
- Product search → Vector embeddings: embeds query (evidence: `backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java`)
- Vector embeddings → Ollama models: requests vectors (evidence: `backend/src/main/java/com/mila/quickcommerce/search/VectorEmbeddingService.java`)
- Product search → Typesense index: searches and indexes (evidence: `backend/src/main/java/com/mila/quickcommerce/search/ProductSearchService.java`)
- AI tag generation → Ollama models: requests tags (evidence: `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 (evidence: `backend/src/main/java/com/mila/quickcommerce/catalog/persistence/MongoProductCatalogStore.java`)
