# kurniadi2271/toko-kelontong architecture

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

- Interactive diagram: https://gitdiagram.com/kurniadi2271/toko-kelontong
- Repository: https://github.com/kurniadi2271/toko-kelontong

## Overview

Asri is a supermarket point-of-sale and management system: cashiers sign in, look up products, complete sales, and review their own transactions; administrators manage inventory, users, settings, dashboards, and reports. The static frontend communicates with an Express API backed by PostgreSQL. The checkout service is a key internal layer: it validates and prices items, updates stock, records transaction details, and commits the sale atomically. Some frontend-to-API feature wiring and unsampled settings implementations are not shown, so those links are omitted or marked unverified.

Main entry points: [`asri-frontend/js/main.js`](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/main.js) (Frontend shell), [`asri-backend/src/routes`](https://github.com/kurniadi2271/toko-kelontong/tree/main/asri-backend/src/routes) (API routes), [`asri-backend/src/config/db.js`](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/config/db.js) (PostgreSQL), [`asri-backend/src/services/transactionService.js`](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/transactionService.js) (Checkout & history)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Storefront"]
  node_webapp["Frontend shell<br/>[main.js]"]
  node_login["Sign-in<br/>[auth.js]"]
  node_pos["Point of sale<br/>[kasir.js]"]
  node_catalog["Product catalog<br/>[masterBarang.js]"]
  node_stockui["Stock management<br/>[stokBarang.js]"]
  node_dashboardui["Dashboard<br/>[dashboard.js]"]
  node_reportsui["Sales reports<br/>[laporan.js]"]
  node_accountsui["Account management<br/>[akun.js]"]
  node_settingsui["Settings UI<br/>[settings.js]"]
end

subgraph group_api["API access"]
  node_api_client["API client<br/>[api.js]"]
  node_express["Express app<br/>[app.js]"]
  node_routes["API routes"]
end

subgraph group_operations["Store operations"]
  node_auth["Authentication<br/>[authService.js]"]
  node_products["Products &amp; categories<br/>[productService.js]"]
  node_stock["Stock movements"]
  node_checkout["Checkout &amp; history"]
  node_analytics["Dashboard &amp; reports"]
  node_users["User administration<br/>[userService.js]"]
  node_settings["Settings service<br/>[settingsService.js]"]
end

subgraph group_data["Persistence"]
  node_database[("PostgreSQL<br/>[db.js]")]
end

node_staff(("Cashier / admin"))

node_staff -->|"uses"| node_webapp
node_webapp -.->|"renders"| node_login
node_webapp -.->|"renders"| node_pos
node_webapp -.->|"renders"| node_catalog
node_webapp -.->|"renders"| node_stockui
node_webapp -.->|"renders"| node_dashboardui
node_webapp -.->|"renders"| node_reportsui
node_webapp -.->|"renders"| node_accountsui
node_webapp -.->|"renders"| node_settingsui
node_api_client -->|"HTTP requests"| node_express
node_express -->|"mounts"| node_routes
node_routes -->|"dispatches"| node_auth
node_routes -->|"dispatches"| node_products
node_routes -->|"dispatches"| node_checkout
node_routes -->|"dispatches"| node_analytics
node_routes -->|"dispatches"| node_users
node_routes -->|"dispatches"| node_settings
node_products -->|"records movements"| node_stock
node_checkout -->|"records sale"| node_stock
node_analytics -->|"lists cashier sales"| node_checkout
node_auth -->|"queries users"| node_database
node_products -->|"queries products"| node_database
node_stock -->|"records movements"| node_database
node_checkout -->|"commits sales"| node_database
node_analytics -->|"queries metrics"| node_database
node_users -->|"queries users"| node_database
node_settings -.->|"queries settings"| node_database

click node_webapp "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/main.js"
click node_login "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/auth.js"
click node_pos "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/kasir.js"
click node_catalog "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/masterBarang.js"
click node_stockui "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/stokBarang.js"
click node_dashboardui "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/dashboard.js"
click node_reportsui "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/laporan.js"
click node_accountsui "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/akun.js"
click node_settingsui "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/settings.js"
click node_api_client "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/api.js"
click node_express "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/app.js"
click node_routes "https://github.com/kurniadi2271/toko-kelontong/tree/main/asri-backend/src/routes"
click node_auth "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/authService.js"
click node_products "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/productService.js"
click node_stock "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/stockMovementService.js"
click node_checkout "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/transactionService.js"
click node_analytics "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/dashboardService.js"
click node_users "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/userService.js"
click node_settings "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/settingsService.js"
click node_database "https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/config/db.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_webapp,node_login,node_pos,node_catalog,node_stockui,node_dashboardui,node_reportsui,node_accountsui,node_settingsui toneBlue
class node_api_client,node_express,node_routes toneAmber
class node_auth,node_products,node_stock,node_checkout,node_analytics,node_users,node_settings toneMint
class node_database toneRose
class node_staff toneIndigo
```

## Components

### Storefront

- [Frontend shell](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/main.js): `asri-frontend/js/main.js`
- [Sign-in](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/auth.js): `asri-frontend/js/pages/auth.js`
- [Point of sale](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/kasir.js): `asri-frontend/js/pages/kasir.js`
- [Product catalog](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/masterBarang.js): `asri-frontend/js/pages/masterBarang.js`
- [Stock management](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/stokBarang.js): `asri-frontend/js/pages/stokBarang.js`
- [Dashboard](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/dashboard.js): `asri-frontend/js/pages/dashboard.js`
- [Sales reports](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/laporan.js): `asri-frontend/js/pages/laporan.js`
- [Account management](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/akun.js): `asri-frontend/js/pages/akun.js`
- [Settings UI](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/pages/settings.js): `asri-frontend/js/pages/settings.js`

### API access

- [API client](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-frontend/js/api.js): `asri-frontend/js/api.js`
- [Express app](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/app.js): `asri-backend/src/app.js`
- [API routes](https://github.com/kurniadi2271/toko-kelontong/tree/main/asri-backend/src/routes): `asri-backend/src/routes`

### Store operations

- [Authentication](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/authService.js): `asri-backend/src/services/authService.js`
- [Products & categories](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/productService.js): `asri-backend/src/services/productService.js`
- [Stock movements](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/stockMovementService.js): `asri-backend/src/services/stockMovementService.js`
- [Checkout & history](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/transactionService.js): `asri-backend/src/services/transactionService.js`
- [Dashboard & reports](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/dashboardService.js): `asri-backend/src/services/dashboardService.js`
- [User administration](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/userService.js): `asri-backend/src/services/userService.js`
- [Settings service](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/services/settingsService.js): `asri-backend/src/services/settingsService.js`

### Persistence

- [PostgreSQL](https://github.com/kurniadi2271/toko-kelontong/blob/main/asri-backend/src/config/db.js): `asri-backend/src/config/db.js`

### Other components

- **Cashier / admin**

## Connections

- Cashier / admin → Frontend shell: uses (evidence: `README.md`)
- Frontend shell → Sign-in: renders
- Frontend shell → Point of sale: renders
- Frontend shell → Product catalog: renders
- Frontend shell → Stock management: renders
- Frontend shell → Dashboard: renders
- Frontend shell → Sales reports: renders
- Frontend shell → Account management: renders
- Frontend shell → Settings UI: renders
- API client → Express app: HTTP requests (evidence: `README.md`)
- Express app → API routes: mounts (evidence: `asri-backend/src/app.js`)
- API routes → Authentication: dispatches (evidence: `asri-backend/src/routes/auth.routes.js`)
- API routes → Products & categories: dispatches (evidence: `asri-backend/src/routes/product.routes.js`)
- API routes → Checkout & history: dispatches (evidence: `asri-backend/src/routes/transaction.routes.js`)
- API routes → Dashboard & reports: dispatches (evidence: `asri-backend/src/routes/dashboard.routes.js`)
- API routes → User administration: dispatches (evidence: `asri-backend/src/routes/user.routes.js`)
- API routes → Settings service: dispatches (evidence: `asri-backend/src/routes/settings.routes.js`)
- Products & categories → Stock movements: records movements (evidence: `asri-backend/src/services/productService.js`)
- Checkout & history → Stock movements: records sale (evidence: `asri-backend/src/services/transactionService.js`)
- Dashboard & reports → Checkout & history: lists cashier sales (evidence: `asri-backend/src/controllers/dashboardController.js`)
- Authentication → PostgreSQL: queries users (evidence: `asri-backend/src/services/authService.js`)
- Products & categories → PostgreSQL: queries products (evidence: `asri-backend/src/services/productService.js`)
- Stock movements → PostgreSQL: records movements (evidence: `asri-backend/src/services/stockMovementService.js`)
- Checkout & history → PostgreSQL: commits sales (evidence: `asri-backend/src/services/transactionService.js`)
- Dashboard & reports → PostgreSQL: queries metrics (evidence: `asri-backend/src/services/dashboardService.js`)
- User administration → PostgreSQL: queries users (evidence: `asri-backend/src/services/userService.js`)
- Settings service → PostgreSQL: queries settings
