# kreativekraft01-jpg/mepos-online architecture

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

- Interactive diagram: https://gitdiagram.com/kreativekraft01-jpg/mepos-online
- Repository: https://github.com/kreativekraft01-jpg/mepos-online

## Overview

MEPoS Online is a web point-of-sale register backed by Express and PostgreSQL, alongside a legacy register interface with broader trading and AI features. The online workflow is staff login, catalog/customer search or entry, then exact-cash checkout and persisted sale/stock updates. The legacy interface adds tills, refunds, vouchers, banking, and an in-browser assistant. Relationships for the online workflow and legacy capabilities are documented in the README; sampled source and the SOURCE INDEX support the internal links shown. Some unsampled feature wiring is therefore omitted.

Main entry points: [`src/app/App.tsx`](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/app/App.tsx) (Legacy register app), [`server/src/server.ts`](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/server/src/server.ts) (API server), [`src/online.tsx`](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/online.tsx) (Online interface), [`src/utils/pipeline.ts`](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/pipeline.ts) (Answer pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_online["Online Register"]
  node_online_ui["Online interface<br/>[online.tsx]"]
  node_login["Staff login<br/>[Login.tsx]"]
  node_catalog["Products and customers<br/>[Products.tsx]"]
  node_checkout["Cash checkout<br/>[online.ts]"]
end

subgraph group_backend["Server and Data"]
  node_search["Paged search<br/>[search.ts]"]
  node_server["API server<br/>[server.ts]"]
  node_bootstrap["Startup setup<br/>[bootstrap.ts]"]
  node_state["Fallback state<br/>[state.ts]"]
end

subgraph group_legacy["Legacy Register"]
  node_legacy_app["Legacy register app<br/>[App.tsx]"]
  node_store[("POS state<br/>[useStore.ts]")]
  node_sync["Server synchronization<br/>[serverSync.ts]"]
  node_customers["Customer management"]
  node_orders["Cart and order history<br/>[CartPage.tsx]"]
  node_refunds["Refunds and vouchers<br/>[RefundOrder.tsx]"]
  node_tills["Tills and banking<br/>[Tills.tsx]"]
  node_settings["Store settings<br/>[Settings.tsx]"]
end

subgraph group_assistant["SmartMate Assistant"]
  node_assistant_ui["Assistant interface<br/>[AiAssistant.tsx]"]
  node_pipeline["Answer pipeline<br/>[pipeline.ts]"]
  node_ai["Catalog answers<br/>[ai.ts]"]
  node_rag["Knowledge retrieval<br/>[rag.ts]"]
  node_skills["Store skills<br/>[skills.ts]"]
  node_browser_model["Browser language model<br/>[browserLlm.ts]"]
end

node_staff(("Store staff"))
node_postgres[("PostgreSQL")]

node_staff -->|"signs in"| node_login
node_staff -->|"uses register"| node_online_ui
node_online_ui -->|"creates records"| node_catalog
node_online_ui -->|"requests pages"| node_search
node_online_ui -->|"submits cash sale"| node_checkout
node_server -->|"runs setup"| node_bootstrap
node_server -->|"routes search"| node_search
node_server -->|"routes register API"| node_checkout
node_checkout -->|"records sale"| node_postgres
node_search -->|"queries catalog"| node_postgres
node_server -->|"uses fallback state"| node_state
node_staff -->|"uses legacy interface"| node_legacy_app
node_legacy_app -->|"reads and updates"| node_store
node_legacy_app -->|"shows profiles"| node_customers
node_legacy_app -->|"shows cart pages"| node_orders
node_legacy_app -->|"routes refunds"| node_refunds
node_legacy_app -.->|"supports till work"| node_tills
node_legacy_app -.->|"configures store"| node_settings
node_legacy_app -->|"initializes sync"| node_sync
node_assistant_ui -->|"uses answers"| node_pipeline
node_pipeline -->|"retrieves catalog answers"| node_ai
node_pipeline -->|"retrieves knowledge"| node_rag
node_pipeline -->|"matches skills"| node_skills
node_assistant_ui -.->|"uses local model"| node_browser_model
node_settings -->|"configures model"| node_browser_model

click node_online_ui "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/online.tsx"
click node_login "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/pages/Login.tsx"
click node_catalog "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/pages/Products.tsx"
click node_search "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/server/src/search.ts"
click node_checkout "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/server/src/online.ts"
click node_server "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/server/src/server.ts"
click node_bootstrap "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/server/src/bootstrap.ts"
click node_state "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/server/src/state.ts"
click node_legacy_app "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/app/App.tsx"
click node_store "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/store/useStore.ts"
click node_sync "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/serverSync.ts"
click node_customers "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/app/components/CustomerProfile.tsx"
click node_orders "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/app/components/CartPage.tsx"
click node_refunds "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/app/components/RefundOrder.tsx"
click node_tills "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/pages/Tills.tsx"
click node_settings "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/pages/Settings.tsx"
click node_assistant_ui "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/components/AiAssistant.tsx"
click node_pipeline "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/pipeline.ts"
click node_ai "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/ai.ts"
click node_rag "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/rag.ts"
click node_skills "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/skills.ts"
click node_browser_model "https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/browserLlm.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_online_ui,node_login,node_catalog,node_checkout toneBlue
class node_search,node_server,node_bootstrap,node_state,node_postgres toneAmber
class node_legacy_app,node_store,node_sync,node_customers,node_orders,node_refunds,node_tills,node_settings toneMint
class node_assistant_ui,node_pipeline,node_ai,node_rag,node_skills,node_browser_model toneRose
class node_staff toneIndigo
```

## Components

### Online Register

- [Online interface](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/online.tsx): `src/online.tsx`
- [Staff login](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/pages/Login.tsx): `src/pages/Login.tsx`
- [Products and customers](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/pages/Products.tsx): `src/pages/Products.tsx`
- [Cash checkout](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/server/src/online.ts): `server/src/online.ts`

### Server and Data

- [Paged search](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/server/src/search.ts): `server/src/search.ts`
- [API server](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/server/src/server.ts): `server/src/server.ts`
- [Startup setup](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/server/src/bootstrap.ts): `server/src/bootstrap.ts`
- [Fallback state](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/server/src/state.ts): `server/src/state.ts`

### Legacy Register

- [Legacy register app](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/app/App.tsx): `src/app/App.tsx`
- [POS state](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/store/useStore.ts): `src/store/useStore.ts`
- [Server synchronization](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/serverSync.ts): `src/utils/serverSync.ts`
- [Customer management](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/app/components/CustomerProfile.tsx): `src/app/components/CustomerProfile.tsx`
- [Cart and order history](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/app/components/CartPage.tsx): `src/app/components/CartPage.tsx`
- [Refunds and vouchers](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/app/components/RefundOrder.tsx): `src/app/components/RefundOrder.tsx`
- [Tills and banking](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/pages/Tills.tsx): `src/pages/Tills.tsx`
- [Store settings](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/pages/Settings.tsx): `src/pages/Settings.tsx`

### SmartMate Assistant

- [Assistant interface](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/components/AiAssistant.tsx): `src/components/AiAssistant.tsx`
- [Answer pipeline](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/pipeline.ts): `src/utils/pipeline.ts`
- [Catalog answers](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/ai.ts): `src/utils/ai.ts`
- [Knowledge retrieval](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/rag.ts): `src/utils/rag.ts`
- [Store skills](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/skills.ts): `src/utils/skills.ts`
- [Browser language model](https://github.com/kreativekraft01-jpg/mepos-online/blob/main/src/utils/browserLlm.ts): `src/utils/browserLlm.ts`

### Other components

- **Store staff**
- **PostgreSQL**

## Connections

- Store staff → Staff login: signs in (evidence: `README.md`)
- Store staff → Online interface: uses register (evidence: `README.md`)
- Online interface → Products and customers: creates records (evidence: `README.md`)
- Online interface → Paged search: requests pages (evidence: `README.md`)
- Online interface → Cash checkout: submits cash sale (evidence: `README.md`)
- API server → Startup setup: runs setup (evidence: `server/src/server.ts`)
- API server → Paged search: routes search (evidence: `server/src/server.ts`)
- API server → Cash checkout: routes register API (evidence: `server/src/server.ts`)
- Cash checkout → PostgreSQL: records sale (evidence: `README.md`)
- Paged search → PostgreSQL: queries catalog (evidence: `README.md`)
- API server → Fallback state: uses fallback state (evidence: `server/src/server.ts`)
- Store staff → Legacy register app: uses legacy interface (evidence: `README.md`)
- Legacy register app → POS state: reads and updates (evidence: `src/app/App.tsx`)
- Legacy register app → Customer management: shows profiles (evidence: `src/app/App.tsx`)
- Legacy register app → Cart and order history: shows cart pages (evidence: `src/app/App.tsx`)
- Legacy register app → Refunds and vouchers: routes refunds (evidence: `src/app/App.tsx`)
- Legacy register app → Tills and banking: supports till work (evidence: `README.md`)
- Legacy register app → Store settings: configures store (evidence: `README.md`)
- Legacy register app → Server synchronization: initializes sync (evidence: `src/App.tsx`)
- Assistant interface → Answer pipeline: uses answers (evidence: `src/components/AiAssistant.tsx`)
- Answer pipeline → Catalog answers: retrieves catalog answers (evidence: `src/utils/pipeline.ts`)
- Answer pipeline → Knowledge retrieval: retrieves knowledge (evidence: `src/utils/pipeline.ts`)
- Answer pipeline → Store skills: matches skills (evidence: `src/utils/pipeline.ts`)
- Assistant interface → Browser language model: uses local model (evidence: `src/components/AiAssistant.tsx`)
- Store settings → Browser language model: configures model (evidence: `src/pages/Settings.tsx`)
