# 1nsharma/dukaanmitra.in architecture

> Architecture diagram of the GitHub repository 1nsharma/dukaanmitra.in, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1nsharma/dukaanmitra.in
- Repository: https://github.com/1nsharma/dukaanmitra.in

## Overview

DukaanMitra-OS is a multi-app operating system for Indian retailers, combining merchant dashboards, customer commerce, event-driven business operations, AI services, and WhatsApp/ONDC channels. A typical workflow starts with a merchant managing a shop or a customer placing an order; events and specialist services support inventory, bookkeeping, and commerce integrations. The README documents the product capabilities, while sampled source confirms selected route, event, inventory, and WhatsApp relationships; unsampled subsystem links are omitted or marked unverified.

Main entry points: [`apps/ai-services/app.py`](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/app.py) (AI service API), [`apps/core-engine/src/api/routes/app.routes.ts`](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/api/routes/app.routes.ts) (Store API), [`apps/mitra-os-web/components/StoreDashboard.tsx`](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/mitra-os-web/components/StoreDashboard.tsx) (Store dashboard), [`apps/dukaan-in-next/src/app/[locale]/page.tsx`](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/dukaan-in-next/src/app/%5Blocale%5D/page.tsx) (Customer storefront)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_merchant["Merchant Experience"]
  node_merchant["Merchant portal<br/>[App.tsx]"]
  node_merchant_dash["Store dashboard<br/>[StoreDashboard.tsx]"]
  node_merchant_seo["Discovery content"]
end

subgraph group_commerce["Commerce Operations"]
  node_customer_store["Customer storefront<br/>[page.tsx]"]
  node_store_api["Store API<br/>[app.routes.ts]"]
  node_event_router["Event routing<br/>[event-router.ts]"]
  node_event_store[("Event persistence<br/>[event-store.ts]")]
  node_inventory["Inventory engine"]
  node_templates["Business templates"]
  node_ledger["Merchant ledger<br/>[ledger-service.ts]"]
  node_action_engine["Action safety<br/>[action-engine.ts]"]
end

subgraph group_intelligence["AI Intelligence"]
  node_ai_api["AI service API<br/>[app.py]"]
  node_core_brain["Core brain<br/>[core_brain.py]"]
  node_platform["Retail platform"]
  node_superintelligence["Superintelligence"]
  node_delivery["Mowglai delivery"]
end

subgraph group_channels["Commerce Channels"]
  node_ondc_ai["ONDC network<br/>[ondc_network.py]"]
  node_whatsapp_routes["WhatsApp routes<br/>[whatsapp.routes.ts]"]
  node_whatsapp_bridge["OpenWA bridge<br/>[openwa.bridge.ts]"]
  node_whatsapp_gateway["WhatsApp gateway<br/>[gateway.ts]"]
  node_ondc_service["ONDC service<br/>[ondc.service.ts]"]
end

subgraph group_agents["Agent Systems"]
  node_agent_mesh["Enterprise agent mesh<br/>[orchestrator.py]"]
  node_enterprise_agents["Specialist agents<br/>[index.ts]"]
end

node_merchant_actor(("Merchant"))
node_customer_actor(("Customer"))

node_merchant_actor -->|"uses"| node_merchant
node_merchant -->|"renders"| node_merchant_dash
node_merchant_actor -->|"starts onboarding"| node_store_api
node_store_api -->|"lists templates"| node_templates
node_store_api -->|"routes events"| node_event_router
node_event_router -->|"updates status"| node_event_store
node_inventory -->|"seeds from"| node_templates
node_customer_actor -->|"shops"| node_customer_store
node_customer_store -.->|"connects to"| node_store_api
node_action_engine -->|"records entries"| node_ledger
node_merchant_actor -->|"uses AI services"| node_ai_api
node_ai_api -->|"exposes"| node_core_brain
node_ai_api -->|"exposes"| node_platform
node_ai_api -->|"exposes"| node_superintelligence
node_ai_api -->|"exposes"| node_delivery
node_ai_api -->|"exposes"| node_ondc_ai
node_whatsapp_gateway -.->|"sends webhooks"| node_whatsapp_routes
node_whatsapp_routes -->|"handles webhook"| node_whatsapp_bridge
node_ondc_service -->|"routes sales"| node_event_router
node_merchant_actor -.->|"delegates tasks"| node_agent_mesh
node_agent_mesh -.->|"coordinates agents"| node_enterprise_agents
node_customer_store -.->|"supports ONDC commerce"| node_ondc_service
node_merchant_dash -.->|"pairs WhatsApp"| node_whatsapp_routes
node_merchant_dash -.->|"manages stock"| node_inventory

click node_merchant "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/mitra-os-web/App.tsx"
click node_merchant_dash "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/mitra-os-web/components/StoreDashboard.tsx"
click node_merchant_seo "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/mitra-os-web/components/ProgrammaticSeoPage.tsx"
click node_customer_store "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/dukaan-in-next/src/app/%5Blocale%5D/page.tsx"
click node_store_api "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/api/routes/app.routes.ts"
click node_event_router "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/core/events/event-router.ts"
click node_event_store "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/core/events/event-store.ts"
click node_inventory "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/core/services/inventory.service.ts"
click node_templates "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/core/templates/business-templates.ts"
click node_ledger "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/dukaan-in-next/src/lib/modules/ledger/services/ledger-service.ts"
click node_action_engine "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/dukaan-in-next/src/lib/services/action-engine.ts"
click node_ai_api "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/app.py"
click node_core_brain "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/core_brain.py"
click node_platform "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/dukaanmitra_platform.py"
click node_superintelligence "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/superintelligence.py"
click node_delivery "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/mowglai_delivery_agent.py"
click node_ondc_ai "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/ondc_network.py"
click node_whatsapp_routes "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/api/routes/whatsapp.routes.ts"
click node_whatsapp_bridge "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/channels/whatsapp/openwa.bridge.ts"
click node_whatsapp_gateway "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/whatsapp-gateway/src/gateway.ts"
click node_ondc_service "https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/core/integration/ondc.service.ts"
click node_agent_mesh "https://github.com/1nsharma/dukaanmitra.in/blob/main/packages/agent-mesh/orchestrator.py"
click node_enterprise_agents "https://github.com/1nsharma/dukaanmitra.in/blob/main/packages/enterprise-agents/index.ts"

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_merchant,node_merchant_dash,node_merchant_seo toneBlue
class node_customer_store,node_store_api,node_event_router,node_event_store,node_inventory,node_templates,node_ledger,node_action_engine toneAmber
class node_ai_api,node_core_brain,node_platform,node_superintelligence,node_delivery toneMint
class node_ondc_ai,node_whatsapp_routes,node_whatsapp_bridge,node_whatsapp_gateway,node_ondc_service toneRose
class node_agent_mesh,node_enterprise_agents,node_merchant_actor,node_customer_actor toneIndigo
```

## Components

### Merchant Experience

- [Merchant portal](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/mitra-os-web/App.tsx): `apps/mitra-os-web/App.tsx`
- [Store dashboard](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/mitra-os-web/components/StoreDashboard.tsx): `apps/mitra-os-web/components/StoreDashboard.tsx`
- [Discovery content](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/mitra-os-web/components/ProgrammaticSeoPage.tsx): `apps/mitra-os-web/components/ProgrammaticSeoPage.tsx`

### Commerce Operations

- [Customer storefront](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/dukaan-in-next/src/app/%5Blocale%5D/page.tsx): `apps/dukaan-in-next/src/app/[locale]/page.tsx`
- [Store API](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/api/routes/app.routes.ts): `apps/core-engine/src/api/routes/app.routes.ts`
- [Event routing](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/core/events/event-router.ts): `apps/core-engine/src/core/events/event-router.ts`
- [Event persistence](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/core/events/event-store.ts): `apps/core-engine/src/core/events/event-store.ts`
- [Inventory engine](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/core/services/inventory.service.ts): `apps/core-engine/src/core/services/inventory.service.ts`
- [Business templates](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/core/templates/business-templates.ts): `apps/core-engine/src/core/templates/business-templates.ts`
- [Merchant ledger](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/dukaan-in-next/src/lib/modules/ledger/services/ledger-service.ts): `apps/dukaan-in-next/src/lib/modules/ledger/services/ledger-service.ts`
- [Action safety](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/dukaan-in-next/src/lib/services/action-engine.ts): `apps/dukaan-in-next/src/lib/services/action-engine.ts`

### AI Intelligence

- [AI service API](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/app.py): `apps/ai-services/app.py`
- [Core brain](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/core_brain.py): `apps/ai-services/core_brain.py`
- [Retail platform](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/dukaanmitra_platform.py): `apps/ai-services/dukaanmitra_platform.py`
- [Superintelligence](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/superintelligence.py): `apps/ai-services/superintelligence.py`
- [Mowglai delivery](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/mowglai_delivery_agent.py): `apps/ai-services/mowglai_delivery_agent.py`

### Commerce Channels

- [ONDC network](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/ai-services/ondc_network.py): `apps/ai-services/ondc_network.py`
- [WhatsApp routes](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/api/routes/whatsapp.routes.ts): `apps/core-engine/src/api/routes/whatsapp.routes.ts`
- [OpenWA bridge](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/channels/whatsapp/openwa.bridge.ts): `apps/core-engine/src/channels/whatsapp/openwa.bridge.ts`
- [WhatsApp gateway](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/whatsapp-gateway/src/gateway.ts): `apps/whatsapp-gateway/src/gateway.ts`
- [ONDC service](https://github.com/1nsharma/dukaanmitra.in/blob/main/apps/core-engine/src/core/integration/ondc.service.ts): `apps/core-engine/src/core/integration/ondc.service.ts`

### Agent Systems

- [Enterprise agent mesh](https://github.com/1nsharma/dukaanmitra.in/blob/main/packages/agent-mesh/orchestrator.py): `packages/agent-mesh/orchestrator.py`
- [Specialist agents](https://github.com/1nsharma/dukaanmitra.in/blob/main/packages/enterprise-agents/index.ts): `packages/enterprise-agents/index.ts`

### Other components

- **Merchant**
- **Customer**

## Connections

- Merchant → Merchant portal: uses (evidence: `README.md`)
- Merchant portal → Store dashboard: renders (evidence: `apps/mitra-os-web/App.tsx`)
- Merchant → Store API: starts onboarding (evidence: `apps/core-engine/src/api/routes/app.routes.ts`)
- Store API → Business templates: lists templates (evidence: `apps/core-engine/src/api/routes/app.routes.ts`)
- Store API → Event routing: routes events (evidence: `apps/core-engine/src/api/routes/app.routes.ts`)
- Event routing → Event persistence: updates status (evidence: `apps/core-engine/src/core/events/event-router.ts`)
- Inventory engine → Business templates: seeds from (evidence: `apps/core-engine/src/core/services/inventory.service.ts`)
- Customer → Customer storefront: shops (evidence: `README.md`)
- Customer storefront → Store API: connects to
- Action safety → Merchant ledger: records entries (evidence: `apps/dukaan-in-next/src/lib/services/action-engine.ts`)
- Merchant → AI service API: uses AI services (evidence: `README.md`)
- AI service API → Core brain: exposes (evidence: `apps/ai-services/app.py`)
- AI service API → Retail platform: exposes (evidence: `apps/ai-services/app.py`)
- AI service API → Superintelligence: exposes (evidence: `apps/ai-services/app.py`)
- AI service API → Mowglai delivery: exposes (evidence: `apps/ai-services/app.py`)
- AI service API → ONDC network: exposes (evidence: `apps/ai-services/app.py`)
- WhatsApp gateway → WhatsApp routes: sends webhooks (evidence: `README.md`)
- WhatsApp routes → OpenWA bridge: handles webhook (evidence: `apps/core-engine/src/api/routes/whatsapp.routes.ts`)
- ONDC service → Event routing: routes sales (evidence: `apps/core-engine/src/core/integration/ondc.service.ts`)
- Merchant → Enterprise agent mesh: delegates tasks
- Enterprise agent mesh → Specialist agents: coordinates agents
- Customer storefront → ONDC service: supports ONDC commerce (evidence: `README.md`)
- Store dashboard → WhatsApp routes: pairs WhatsApp (evidence: `README.md`)
- Store dashboard → Inventory engine: manages stock (evidence: `README.md`)