# yohanimmanuel/lakupak-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/yohanimmanuel/lakupak-dashboard
- Repository: https://github.com/yohanimmanuel/lakupak-dashboard

## Overview

Lakupak is an AI-enabled B2B commerce and operations platform for FMCG distributors and their retail buyers. Its documented commercial flow unifies product and customer information, identifies opportunities, matches buyers, executes sales and commerce activity, and learns through analytics. The dashboard, marketplace, logistics, sales, offers, and automation capabilities are represented as distinct product areas. Several runtime links are evidenced by source-index references or excerpts; dashed links mark documented product flow whose implementation wiring was not shown in the supplied excerpts.

Main entry points: [`src/app/(dashboard)/(menulist)/home/page.tsx`](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/app/(dashboard)/(menulist)/home/page.tsx) (Operations Dashboard), [`src/services/mobileOrders/mobileOrdersService.ts`](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/services/mobileOrders/mobileOrdersService.ts) (Mobile Ordering), [`src/app/api/graphql/route.ts`](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/app/api/graphql/route.ts) (GraphQL API), [`src/lib/db.ts`](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/lib/db.ts) (Application Database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_commerce["Commerce &amp; Catalog"]
  node_catalog["Product Catalog"]
  node_catalog_helpers["Catalog Helpers"]
  node_marketplace["B2B Marketplace<br/>[route.ts]"]
  node_mobile_orders["Mobile Ordering"]
  node_offers["Offers &amp; Pricing"]
  node_orders["Order Management"]
end

subgraph group_operations["Distributor Operations"]
  node_dashboard["Operations Dashboard<br/>[page.tsx]"]
  node_clients["Client Management<br/>[BuyerTable.tsx]"]
  node_sales["Sales Workflows<br/>[SalesJobsBoard.tsx]"]
  node_logistics["Fleet Logistics<br/>[FleetDetails.tsx]"]
end

subgraph group_intelligence["Commercial Intelligence"]
  node_matching["Buyer Matching<br/>[service.ts]"]
  node_assortment["Assortment Insights<br/>[engine.ts]"]
  node_analytics["Sales Analytics"]
  node_automations["Workflow Automation<br/>[engine.ts]"]
end

subgraph group_platform["Platform Services"]
  node_graphql["GraphQL API<br/>[route.ts]"]
  node_registration["Account Registration<br/>[route.ts]"]
  node_database[("Application Database<br/>[db.ts]")]
  node_realtime["Realtime Broadcasts"]
  node_websocket["WebSocket Server<br/>[websocket.ts]"]
end

node_distributors(("Distributors"))
node_buyers(("Retail Buyers"))

node_distributors -->|"registers"| node_registration
node_registration -->|"creates account"| node_database
node_distributors -.->|"manages operations"| node_dashboard
node_buyers -.->|"shops privately"| node_marketplace
node_dashboard -.->|"manages products"| node_catalog
node_dashboard -.->|"manages relationships"| node_clients
node_dashboard -.->|"coordinates sales"| node_sales
node_dashboard -.->|"coordinates delivery"| node_logistics
node_catalog -->|"uses helpers"| node_catalog_helpers
node_catalog -->|"loads and saves"| node_graphql
node_marketplace -->|"reads data"| node_database
node_buyers -.->|"places orders"| node_mobile_orders
node_mobile_orders -->|"plans client match"| node_matching
node_mobile_orders -->|"validates offers"| node_offers
node_mobile_orders -.->|"persists commerce data"| node_database
node_offers -.->|"supports transactions"| node_orders
node_dashboard -.->|"surfaces opportunities"| node_assortment
node_dashboard -.->|"reviews performance"| node_analytics
node_sales -.->|"executes workflows"| node_automations
node_automations -->|"broadcasts updates"| node_realtime
node_realtime -->|"dispatches broadcasts"| node_websocket
node_graphql -->|"sets security context"| node_database
node_graphql -->|"registers module"| node_matching
node_graphql -->|"registers module"| node_automations

click node_dashboard "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/app/(dashboard)/(menulist)/home/page.tsx"
click node_clients "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/clientmanagement/BuyerTable.tsx"
click node_sales "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/sales/SalesJobsBoard.tsx"
click node_logistics "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/logisticsmanagement/FleetDetails.tsx"
click node_catalog "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/productscatalogs/useProductCatalogController.ts"
click node_catalog_helpers "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/productscatalogs/productCatalogHelpers.ts"
click node_marketplace "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/app/api/marketplace/data/route.ts"
click node_mobile_orders "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/services/mobileOrders/mobileOrdersService.ts"
click node_offers "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/offersincentivesdisc/OfferEditorForm.tsx"
click node_orders "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/services/orders/ordersRouteService.ts"
click node_matching "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/lib/clientMatching/service.ts"
click node_assortment "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/lib/assortmentOpportunities/engine.ts"
click node_analytics "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/analyticsperformance/CustomerSalesAnalytics.tsx"
click node_automations "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/lib/automations/engine.ts"
click node_graphql "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/app/api/graphql/route.ts"
click node_registration "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/app/api/auth/register/route.ts"
click node_database "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/lib/db.ts"
click node_realtime "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/utils/websocketBroadcast.ts"
click node_websocket "https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/server/websocket.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_catalog,node_catalog_helpers,node_marketplace,node_mobile_orders,node_offers,node_orders toneBlue
class node_dashboard,node_clients,node_sales,node_logistics toneAmber
class node_matching,node_assortment,node_analytics,node_automations toneMint
class node_graphql,node_registration,node_database,node_realtime,node_websocket toneRose
class node_distributors,node_buyers toneIndigo
```

## Components

### Commerce & Catalog

- [Product Catalog](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/productscatalogs/useProductCatalogController.ts): `src/components/productscatalogs/useProductCatalogController.ts`
- [Catalog Helpers](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/productscatalogs/productCatalogHelpers.ts): `src/components/productscatalogs/productCatalogHelpers.ts`
- [B2B Marketplace](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/app/api/marketplace/data/route.ts): `src/app/api/marketplace/data/route.ts`
- [Mobile Ordering](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/services/mobileOrders/mobileOrdersService.ts): `src/services/mobileOrders/mobileOrdersService.ts`
- [Offers & Pricing](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/offersincentivesdisc/OfferEditorForm.tsx): `src/components/offersincentivesdisc/OfferEditorForm.tsx`
- [Order Management](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/services/orders/ordersRouteService.ts): `src/services/orders/ordersRouteService.ts`

### Distributor Operations

- [Operations Dashboard](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/app/(dashboard)/(menulist)/home/page.tsx): `src/app/(dashboard)/(menulist)/home/page.tsx`
- [Client Management](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/clientmanagement/BuyerTable.tsx): `src/components/clientmanagement/BuyerTable.tsx`
- [Sales Workflows](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/sales/SalesJobsBoard.tsx): `src/components/sales/SalesJobsBoard.tsx`
- [Fleet Logistics](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/logisticsmanagement/FleetDetails.tsx): `src/components/logisticsmanagement/FleetDetails.tsx`

### Commercial Intelligence

- [Buyer Matching](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/lib/clientMatching/service.ts): `src/lib/clientMatching/service.ts`
- [Assortment Insights](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/lib/assortmentOpportunities/engine.ts): `src/lib/assortmentOpportunities/engine.ts`
- [Sales Analytics](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/components/analyticsperformance/CustomerSalesAnalytics.tsx): `src/components/analyticsperformance/CustomerSalesAnalytics.tsx`
- [Workflow Automation](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/lib/automations/engine.ts): `src/lib/automations/engine.ts`

### Platform Services

- [GraphQL API](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/app/api/graphql/route.ts): `src/app/api/graphql/route.ts`
- [Account Registration](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/app/api/auth/register/route.ts): `src/app/api/auth/register/route.ts`
- [Application Database](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Realtime Broadcasts](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/utils/websocketBroadcast.ts): `src/utils/websocketBroadcast.ts`
- [WebSocket Server](https://github.com/yohanimmanuel/lakupak-dashboard/blob/main/src/server/websocket.ts): `src/server/websocket.ts`

### Other components

- **Distributors**
- **Retail Buyers**

## Connections

- Distributors → Account Registration: registers (evidence: `src/app/api/auth/register/route.ts`)
- Account Registration → Application Database: creates account (evidence: `src/app/api/auth/register/route.ts`)
- Distributors → Operations Dashboard: manages operations
- Retail Buyers → B2B Marketplace: shops privately
- Operations Dashboard → Product Catalog: manages products
- Operations Dashboard → Client Management: manages relationships
- Operations Dashboard → Sales Workflows: coordinates sales
- Operations Dashboard → Fleet Logistics: coordinates delivery
- Product Catalog → Catalog Helpers: uses helpers (evidence: `src/components/productscatalogs/useProductCatalogController.ts`)
- Product Catalog → GraphQL API: loads and saves (evidence: `src/components/productscatalogs/useProductCatalogController.ts`)
- B2B Marketplace → Application Database: reads data (evidence: `src/app/api/marketplace/data/route.ts`)
- Retail Buyers → Mobile Ordering: places orders
- Mobile Ordering → Buyer Matching: plans client match (evidence: `src/services/mobileOrders/mobileOrdersService.ts`)
- Mobile Ordering → Offers & Pricing: validates offers (evidence: `src/services/mobileOrders/mobileOrdersService.ts`)
- Mobile Ordering → Application Database: persists commerce data (evidence: `src/services/mobileOrders/mobileOrdersService.ts`)
- Offers & Pricing → Order Management: supports transactions
- Operations Dashboard → Assortment Insights: surfaces opportunities
- Operations Dashboard → Sales Analytics: reviews performance
- Sales Workflows → Workflow Automation: executes workflows
- Workflow Automation → Realtime Broadcasts: broadcasts updates (evidence: `src/lib/automations/engine.ts`)
- Realtime Broadcasts → WebSocket Server: dispatches broadcasts (evidence: `src/utils/websocketBroadcast.ts`)
- GraphQL API → Application Database: sets security context (evidence: `src/app/api/graphql/route.ts`)
- GraphQL API → Buyer Matching: registers module (evidence: `src/app/api/graphql/route.ts`)
- GraphQL API → Workflow Automation: registers module (evidence: `src/app/api/graphql/route.ts`)
