# arjwan307/almahasibpro architecture

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

- Interactive diagram: https://gitdiagram.com/arjwan307/almahasibpro
- Repository: https://github.com/arjwan307/almahasibpro

## Overview

AlMahasib Pro is an incomplete, multi-tenant business-management product with three point-of-sale modes, commerce and inventory workflows, finance, workforce, and mobile-representative operations. The main user workflow is cashier sale entry, local/offline handling, and server-side API processing; the README documents sync and offline capability. The API excerpt shows route handlers invoking store operations, while runtime startup wires the API to MongoDB or memory. Several domain modules are represented by README-backed directory nodes because their implementation files were not sampled; the documented PostgreSQL direction conflicts with the sampled startup configuration, so no runtime PostgreSQL connection is asserted.

Main entry points: [`apps/api/src/app.js`](https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/app.js) (API Routes), [`server.js`](https://github.com/arjwan307/almahasibpro/blob/main/server.js) (Runtime Startup), [`public/pos-ui.js`](https://github.com/arjwan307/almahasibpro/blob/main/public/pos-ui.js) (POS Cashier), [`apps/api/src/store/mongo-store.js`](https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/store/mongo-store.js) (Mongo Store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_front["User Interfaces"]
  node_cashier["POS Cashier<br/>[pos-ui.js]"]
  node_offline["Offline Sync<br/>[offline-sync.js]"]
  node_commerceui["Commerce UI<br/>[commerce-ui.js]"]
  node_representativeui["Representative UI"]
end

subgraph group_api["API And Security"]
  node_apiapp["API Routes<br/>[app.js]"]
  node_http["HTTP Validation<br/>[http.js]"]
  node_security["Password Security<br/>[security.js]"]
  node_permissions["Role Permissions<br/>[permissions.js]"]
  node_decimal["Decimal Arithmetic<br/>[decimal.js]"]
  node_server["Runtime Startup<br/>[server.js]"]
end

subgraph group_domains["Business Workflows"]
  node_catalog["Catalog And Inventory"]
  node_purchasing["Purchasing"]
  node_sales["Sales And Returns"]
  node_pos["POS And Shifts"]
  node_accounting["Accounting And Treasury"]
  node_representatives["Field Representatives"]
  node_payroll["Employees And Payroll"]
  node_audit["Audit"]
  node_sync["Operation Sync"]
end

subgraph group_storage["Persistence"]
  node_memory[("Memory Store<br/>[memory-store.js]")]
  node_mongo[("Mongo Store<br/>[mongo-store.js]")]
  node_postgres[("PostgreSQL Store<br/>[postgres-store.js]")]
  node_schema["Database Migrations"]
end

node_operator(("Business User"))

node_operator -->|"enters sales"| node_cashier
node_cashier -->|"queues offline"| node_offline
node_cashier -->|"submits requests"| node_apiapp
node_commerceui -.->|"uses API"| node_apiapp
node_representativeui -.->|"syncs operations"| node_apiapp
node_offline -->|"syncs operations"| node_apiapp
node_apiapp -->|"validates routes"| node_http
node_apiapp -->|"verifies passwords"| node_security
node_apiapp -->|"checks roles"| node_permissions
node_apiapp -->|"validates amounts"| node_decimal
node_apiapp -.->|"handles domain requests"| node_catalog
node_apiapp -.->|"handles purchases"| node_purchasing
node_apiapp -.->|"handles sales"| node_sales
node_apiapp -.->|"handles cashier shifts"| node_pos
node_apiapp -.->|"supports finance"| node_accounting
node_apiapp -.->|"supports field sales"| node_representatives
node_apiapp -.->|"supports payroll"| node_payroll
node_apiapp -.->|"supports audit"| node_audit
node_apiapp -.->|"processes sync"| node_sync
node_server -->|"creates app"| node_apiapp
node_server -->|"selects memory"| node_memory
node_server -->|"selects MongoDB"| node_mongo
node_mongo -->|"extends behavior"| node_memory
node_apiapp -.->|"calls store"| node_memory
node_apiapp -.->|"calls store"| node_mongo
node_postgres -.->|"uses migrations"| node_schema

click node_cashier "https://github.com/arjwan307/almahasibpro/blob/main/public/pos-ui.js"
click node_offline "https://github.com/arjwan307/almahasibpro/blob/main/public/offline-sync.js"
click node_commerceui "https://github.com/arjwan307/almahasibpro/blob/main/public/commerce-ui.js"
click node_representativeui "https://github.com/arjwan307/almahasibpro/blob/main/public/representative-ui.js"
click node_apiapp "https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/app.js"
click node_http "https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/lib/http.js"
click node_security "https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/lib/security.js"
click node_permissions "https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/permissions.js"
click node_decimal "https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/lib/decimal.js"
click node_catalog "https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/catalog"
click node_purchasing "https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/purchasing"
click node_sales "https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/sales"
click node_pos "https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/pos"
click node_accounting "https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/accounting"
click node_representatives "https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/representatives"
click node_payroll "https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/payroll"
click node_audit "https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/audit"
click node_sync "https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/sync"
click node_server "https://github.com/arjwan307/almahasibpro/blob/main/server.js"
click node_memory "https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/store/memory-store.js"
click node_mongo "https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/store/mongo-store.js"
click node_postgres "https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/store/postgres-store.js"
click node_schema "https://github.com/arjwan307/almahasibpro/tree/main/database/migrations"

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_cashier,node_offline,node_commerceui,node_representativeui,node_operator toneBlue
class node_apiapp,node_http,node_security,node_permissions,node_decimal,node_server toneAmber
class node_catalog,node_purchasing,node_sales,node_pos,node_accounting,node_representatives,node_payroll,node_audit,node_sync toneMint
class node_memory,node_mongo,node_postgres,node_schema toneRose
```

## Components

### User Interfaces

- [POS Cashier](https://github.com/arjwan307/almahasibpro/blob/main/public/pos-ui.js): `public/pos-ui.js`
- [Offline Sync](https://github.com/arjwan307/almahasibpro/blob/main/public/offline-sync.js): `public/offline-sync.js`
- [Commerce UI](https://github.com/arjwan307/almahasibpro/blob/main/public/commerce-ui.js): `public/commerce-ui.js`
- [Representative UI](https://github.com/arjwan307/almahasibpro/blob/main/public/representative-ui.js): `public/representative-ui.js`

### API And Security

- [API Routes](https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/app.js): `apps/api/src/app.js`
- [HTTP Validation](https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/lib/http.js): `apps/api/src/lib/http.js`
- [Password Security](https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/lib/security.js): `apps/api/src/lib/security.js`
- [Role Permissions](https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/permissions.js): `apps/api/src/permissions.js`
- [Decimal Arithmetic](https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/lib/decimal.js): `apps/api/src/lib/decimal.js`
- [Runtime Startup](https://github.com/arjwan307/almahasibpro/blob/main/server.js): `server.js`

### Business Workflows

- [Catalog And Inventory](https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/catalog): `apps/api/src/modules/catalog`
- [Purchasing](https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/purchasing): `apps/api/src/modules/purchasing`
- [Sales And Returns](https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/sales): `apps/api/src/modules/sales`
- [POS And Shifts](https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/pos): `apps/api/src/modules/pos`
- [Accounting And Treasury](https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/accounting): `apps/api/src/modules/accounting`
- [Field Representatives](https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/representatives): `apps/api/src/modules/representatives`
- [Employees And Payroll](https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/payroll): `apps/api/src/modules/payroll`
- [Audit](https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/audit): `apps/api/src/modules/audit`
- [Operation Sync](https://github.com/arjwan307/almahasibpro/tree/main/apps/api/src/modules/sync): `apps/api/src/modules/sync`

### Persistence

- [Memory Store](https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/store/memory-store.js): `apps/api/src/store/memory-store.js`
- [Mongo Store](https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/store/mongo-store.js): `apps/api/src/store/mongo-store.js`
- [PostgreSQL Store](https://github.com/arjwan307/almahasibpro/blob/main/apps/api/src/store/postgres-store.js): `apps/api/src/store/postgres-store.js`
- [Database Migrations](https://github.com/arjwan307/almahasibpro/tree/main/database/migrations): `database/migrations`

### Other components

- **Business User**

## Connections

- Business User → POS Cashier: enters sales (evidence: `README.md`)
- POS Cashier → Offline Sync: queues offline (evidence: `README.md`)
- POS Cashier → API Routes: submits requests (evidence: `README.md`)
- Commerce UI → API Routes: uses API (evidence: `README.md`)
- Representative UI → API Routes: syncs operations (evidence: `README.md`)
- Offline Sync → API Routes: syncs operations (evidence: `README.md`)
- API Routes → HTTP Validation: validates routes (evidence: `apps/api/src/app.js`)
- API Routes → Password Security: verifies passwords (evidence: `apps/api/src/app.js`)
- API Routes → Role Permissions: checks roles (evidence: `apps/api/src/permissions.js`)
- API Routes → Decimal Arithmetic: validates amounts (evidence: `apps/api/src/app.js`)
- API Routes → Catalog And Inventory: handles domain requests (evidence: `README.md`)
- API Routes → Purchasing: handles purchases (evidence: `README.md`)
- API Routes → Sales And Returns: handles sales (evidence: `README.md`)
- API Routes → POS And Shifts: handles cashier shifts (evidence: `README.md`)
- API Routes → Accounting And Treasury: supports finance (evidence: `README.md`)
- API Routes → Field Representatives: supports field sales (evidence: `README.md`)
- API Routes → Employees And Payroll: supports payroll (evidence: `README.md`)
- API Routes → Audit: supports audit (evidence: `README.md`)
- API Routes → Operation Sync: processes sync (evidence: `README.md`)
- Runtime Startup → API Routes: creates app (evidence: `server.js`)
- Runtime Startup → Memory Store: selects memory (evidence: `server.js`)
- Runtime Startup → Mongo Store: selects MongoDB (evidence: `server.js`)
- Mongo Store → Memory Store: extends behavior (evidence: `apps/api/src/store/mongo-store.js`)
- API Routes → Memory Store: calls store
- API Routes → Mongo Store: calls store
- PostgreSQL Store → Database Migrations: uses migrations
