# salmannfirdausss/point_of_sales_raos_dimsum architecture

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

- Interactive diagram: https://gitdiagram.com/salmannfirdausss/point_of_sales_raos_dimsum
- Repository: https://github.com/salmannfirdausss/point_of_sales_raos_dimsum

## Overview

POS Raos Dimsum supports cashier sales and administration of products, outlets, staff, attendance, reporting, and operating costs. The principal documented-in-code workflow is cashier checkout: an authenticated cashier submits items, the sales controller validates attendance and products, then saves sales and sauce details transactionally. The tree establishes the client screens and server route domains, but README content is absent and most client/API wiring was not sampled; those links are therefore left out. Model-backed arrows shown are supported by sampled controller code.

Main entry points: [`server/routers`](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/tree/main/server/routers) (Management Routes), [`server/models/index.js`](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/models/index.js) (Relational Database), [`server/routers/auth-router.js`](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/routers/auth-router.js) (Authentication Routes), [`server/controllers/penjualan-controller.js`](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/penjualan-controller.js) (Checkout And History)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["POS Client"]
  node_cashier["Cashier Workspace"]
  node_admin["Admin Workspace"]
  node_login["Login Screen<br/>[page.tsx]"]
  node_attendance_ui["Attendance Screen<br/>[page.tsx]"]
end

subgraph group_api["API Routing"]
  node_auth_routes["Authentication Routes<br/>[auth-router.js]"]
  node_sales_routes["Sales Routes"]
  node_product_routes["Product Routes<br/>[produk-router.js]"]
  node_attendance_routes["Attendance Routes<br/>[absen-router.js]"]
  node_management_routes["Management Routes"]
end

subgraph group_operations["Sales Operations"]
  node_auth_controller["Authentication<br/>[auth-controller.js]"]
  node_sales_controller["Checkout And History"]
  node_product_controller["Product Catalog"]
  node_attendance_controller["Attendance Records"]
end

subgraph group_management["Business Management"]
  node_analysis_controller["Sales Analysis"]
  node_staff_controller["Staff Management"]
  node_dashboard_controller["Dashboard Metrics"]
  node_outlet_controller["Outlet Management"]
  node_cost_controller["Operating Costs"]
end

subgraph group_storage["Domain Storage"]
  node_database[("Relational Database<br/>[index.js]")]
end

node_employee(("Cashier"))
node_manager(("Administrator"))

node_employee -->|"uses"| node_cashier
node_manager -->|"manages"| node_admin
node_manager -->|"checks"| node_attendance_ui
node_login -.-> node_auth_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_sales_routes -->|"dispatches"| node_sales_controller
node_product_routes -->|"dispatches"| node_product_controller
node_attendance_routes -->|"dispatches"| node_attendance_controller
node_management_routes -.-> node_analysis_controller
node_management_routes -.-> node_staff_controller
node_management_routes -.-> node_dashboard_controller
node_management_routes -.-> node_outlet_controller
node_management_routes -.-> node_cost_controller
node_sales_controller -->|"reads and writes"| node_database
node_product_controller -->|"reads and writes"| node_database
node_attendance_controller -->|"reads and writes"| node_database
node_analysis_controller -->|"reads"| node_database
node_staff_controller -->|"reads and writes"| node_database

click node_cashier "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/tree/main/client/app/(dashboard)/kasir"
click node_admin "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/tree/main/client/app/(dashboard)/admin"
click node_login "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/client/app/(auth)/login/page.tsx"
click node_attendance_ui "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/client/app/absen/page.tsx"
click node_auth_routes "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/routers/auth-router.js"
click node_sales_routes "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/routers/penjualan-router.js"
click node_product_routes "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/routers/produk-router.js"
click node_attendance_routes "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/routers/absen-router.js"
click node_management_routes "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/tree/main/server/routers"
click node_auth_controller "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/auth-controller.js"
click node_sales_controller "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/penjualan-controller.js"
click node_product_controller "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/produk-controller.js"
click node_attendance_controller "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/absen-controller.js"
click node_analysis_controller "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/analisa-controller.js"
click node_staff_controller "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/karyawan-controller.js"
click node_dashboard_controller "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/dashboard-controller.js"
click node_outlet_controller "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/outlet-controller.js"
click node_cost_controller "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/biaya-operasional-controller.js"
click node_database "https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/models/index.js"

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_admin,node_login,node_attendance_ui toneBlue
class node_auth_routes,node_sales_routes,node_product_routes,node_attendance_routes,node_management_routes toneAmber
class node_auth_controller,node_sales_controller,node_product_controller,node_attendance_controller toneMint
class node_analysis_controller,node_staff_controller,node_dashboard_controller,node_outlet_controller,node_cost_controller toneRose
class node_database,node_employee,node_manager toneIndigo
```

## Components

### POS Client

- [Cashier Workspace](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/tree/main/client/app/(dashboard)/kasir): `client/app/(dashboard)/kasir`
- [Admin Workspace](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/tree/main/client/app/(dashboard)/admin): `client/app/(dashboard)/admin`
- [Login Screen](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/client/app/(auth)/login/page.tsx): `client/app/(auth)/login/page.tsx`
- [Attendance Screen](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/client/app/absen/page.tsx): `client/app/absen/page.tsx`

### API Routing

- [Authentication Routes](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/routers/auth-router.js): `server/routers/auth-router.js`
- [Sales Routes](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/routers/penjualan-router.js): `server/routers/penjualan-router.js`
- [Product Routes](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/routers/produk-router.js): `server/routers/produk-router.js`
- [Attendance Routes](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/routers/absen-router.js): `server/routers/absen-router.js`
- [Management Routes](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/tree/main/server/routers): `server/routers`

### Sales Operations

- [Authentication](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/auth-controller.js): `server/controllers/auth-controller.js`
- [Checkout And History](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/penjualan-controller.js): `server/controllers/penjualan-controller.js`
- [Product Catalog](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/produk-controller.js): `server/controllers/produk-controller.js`
- [Attendance Records](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/absen-controller.js): `server/controllers/absen-controller.js`

### Business Management

- [Sales Analysis](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/analisa-controller.js): `server/controllers/analisa-controller.js`
- [Staff Management](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/karyawan-controller.js): `server/controllers/karyawan-controller.js`
- [Dashboard Metrics](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/dashboard-controller.js): `server/controllers/dashboard-controller.js`
- [Outlet Management](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/outlet-controller.js): `server/controllers/outlet-controller.js`
- [Operating Costs](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/controllers/biaya-operasional-controller.js): `server/controllers/biaya-operasional-controller.js`

### Domain Storage

- [Relational Database](https://github.com/salmannfirdausss/point_of_sales_raos_dimsum/blob/main/server/models/index.js): `server/models/index.js`

### Other components

- **Cashier**
- **Administrator**

## Connections

- Cashier → Cashier Workspace: uses
- Administrator → Admin Workspace: manages
- Administrator → Attendance Screen: checks
- Login Screen → Authentication Routes
- Authentication Routes → Authentication: dispatches
- Sales Routes → Checkout And History: dispatches
- Product Routes → Product Catalog: dispatches
- Attendance Routes → Attendance Records: dispatches
- Management Routes → Sales Analysis
- Management Routes → Staff Management
- Management Routes → Dashboard Metrics
- Management Routes → Outlet Management
- Management Routes → Operating Costs
- Checkout And History → Relational Database: reads and writes
- Product Catalog → Relational Database: reads and writes
- Attendance Records → Relational Database: reads and writes
- Sales Analysis → Relational Database: reads
- Staff Management → Relational Database: reads and writes