# okasha-chaudhry/islamicpizza architecture

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

- Interactive diagram: https://gitdiagram.com/okasha-chaudhry/islamicpizza
- Repository: https://github.com/okasha-chaudhry/islamicpizza

## Overview

restaurant-pos is a desktop restaurant point-of-sale app. Staff authenticate, create and manage orders, then use the app’s order services to persist sales and print receipts; administrators also manage the menu, expenses, reports, settings, users, and licensing. The renderer reaches main-process capabilities through preload IPC, with SQLite as the local store. Major UI and service areas are retained from the tree and SOURCE INDEX; some links represent documented IPC capabilities, while unsampled page internals are not inferred.

Main entry points: [`src/renderer/src/App.tsx`](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/App.tsx) (App routing), [`src/main/ipc/index.ts`](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/ipc/index.ts) (IPC handlers), [`src/preload/index.ts`](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/preload/index.ts) (Preload API), [`src/main/db/index.ts`](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/db/index.ts) (SQLite database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Desktop interface"]
  node_app["App routing<br/>[App.tsx]"]
  node_login["Login and activation<br/>[LoginScreen.tsx]"]
  node_neworder["Order entry<br/>[NewOrder.tsx]"]
  node_ordersui["Order history<br/>[Orders.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_ledger["Sales ledger<br/>[Ledger.tsx]"]
  node_productsui["Product catalog<br/>[Products.tsx]"]
  node_categoriesui["Categories<br/>[Categories.tsx]"]
  node_tablesui["Tables and waiters<br/>[Tables.tsx]"]
  node_expensesui["Expenses<br/>[Expenses.tsx]"]
  node_reportsui["Reports<br/>[Reports.tsx]"]
  node_settingsui["Settings<br/>[Settings.tsx]"]
end

subgraph group_bridge["Electron boundary"]
  node_preload["Preload API<br/>[index.ts]"]
  node_ipc["IPC handlers<br/>[index.ts]"]
end

subgraph group_operations["Sales and operations"]
  node_orders["Order service<br/>[orders.service.ts]"]
  node_products["Product service"]
  node_entities["Categories and entities"]
  node_customers["Customer service"]
  node_expenses["Expense service"]
  node_reports["Reporting service<br/>[reports.service.ts]"]
end

subgraph group_support["Administration"]
  node_users["Users and auth<br/>[users.service.ts]"]
  node_license["License service<br/>[license.service.ts]"]
  node_settings["Settings service"]
  node_backup["Backup service<br/>[backup.service.ts]"]
end

subgraph group_storage["Persistence and printing"]
  node_database[("SQLite database<br/>[index.ts]")]
  node_schema["Data schema<br/>[schema.ts]"]
  node_print["Print service<br/>[print.service.ts]"]
  node_receipt["Receipt template"]
  node_escpos["ESC/POS printing"]
end

node_staff(("Staff"))

node_staff -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_neworder
node_app -->|"routes to"| node_ordersui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_ledger
node_app -->|"routes to"| node_productsui
node_app -->|"routes to"| node_categoriesui
node_app -->|"routes to"| node_tablesui
node_app -->|"routes to"| node_expensesui
node_app -->|"routes to"| node_reportsui
node_app -->|"routes to"| node_settingsui
node_login -.->|"requests auth"| node_preload
node_neworder -.->|"submits orders"| node_preload
node_ordersui -.->|"requests orders"| node_preload
node_productsui -.->|"manages products"| node_preload
node_categoriesui -.->|"manages categories"| node_preload
node_tablesui -.->|"manages entities"| node_preload
node_expensesui -.->|"manages expenses"| node_preload
node_reportsui -.->|"requests reports"| node_preload
node_settingsui -.->|"updates settings"| node_preload
node_preload -->|"invokes channels"| node_ipc
node_ipc -->|"dispatches"| node_orders
node_ipc -->|"dispatches"| node_products
node_ipc -->|"dispatches"| node_entities
node_ipc -->|"dispatches"| node_expenses
node_ipc -->|"dispatches"| node_reports
node_ipc -->|"dispatches"| node_users
node_ipc -->|"dispatches"| node_license
node_ipc -->|"dispatches"| node_settings
node_ipc -->|"dispatches"| node_backup
node_ipc -->|"dispatches"| node_print
node_orders -->|"upserts customer"| node_customers
node_orders -->|"reads and writes"| node_database
node_products -->|"reads and writes"| node_database
node_expenses -->|"reads and writes"| node_database
node_reports -->|"queries"| node_database
node_settings -->|"reads and writes"| node_database
node_users -->|"reads and writes"| node_database
node_license -->|"reads and writes"| node_database
node_backup -->|"backs up"| node_database
node_database -->|"uses schema"| node_schema
node_print -->|"dispatches"| node_escpos
node_print -->|"builds receipt"| node_receipt
node_print -->|"loads settings"| node_settings
node_escpos -->|"loads settings"| node_settings

click node_app "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/App.tsx"
click node_login "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/LoginScreen.tsx"
click node_neworder "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/NewOrder.tsx"
click node_ordersui "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Orders.tsx"
click node_dashboard "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Dashboard.tsx"
click node_ledger "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Ledger.tsx"
click node_productsui "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Products.tsx"
click node_categoriesui "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Categories.tsx"
click node_tablesui "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Tables.tsx"
click node_expensesui "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Expenses.tsx"
click node_reportsui "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Reports.tsx"
click node_settingsui "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Settings.tsx"
click node_preload "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/preload/index.ts"
click node_ipc "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/ipc/index.ts"
click node_orders "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/orders.service.ts"
click node_products "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/products.service.ts"
click node_entities "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/named-entity.service.ts"
click node_customers "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/customers.service.ts"
click node_expenses "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/expenses.service.ts"
click node_reports "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/reports.service.ts"
click node_users "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/users.service.ts"
click node_license "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/license.service.ts"
click node_settings "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/settings.service.ts"
click node_backup "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/backup.service.ts"
click node_database "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/db/index.ts"
click node_schema "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/db/schema.ts"
click node_print "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/printing/print.service.ts"
click node_receipt "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/printing/receipt-template.ts"
click node_escpos "https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/printing/escpos-print.service.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_app,node_login,node_neworder,node_ordersui,node_dashboard,node_ledger,node_productsui,node_categoriesui,node_tablesui,node_expensesui,node_reportsui,node_settingsui toneBlue
class node_preload,node_ipc toneAmber
class node_orders,node_products,node_entities,node_customers,node_expenses,node_reports toneMint
class node_users,node_license,node_settings,node_backup toneRose
class node_database,node_schema,node_print,node_receipt,node_escpos,node_staff toneIndigo
```

## Components

### Desktop interface

- [App routing](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/App.tsx): `src/renderer/src/App.tsx`
- [Login and activation](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/LoginScreen.tsx): `src/renderer/src/pages/LoginScreen.tsx`
- [Order entry](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/NewOrder.tsx): `src/renderer/src/pages/NewOrder.tsx`
- [Order history](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Orders.tsx): `src/renderer/src/pages/Orders.tsx`
- [Dashboard](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Dashboard.tsx): `src/renderer/src/pages/Dashboard.tsx`
- [Sales ledger](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Ledger.tsx): `src/renderer/src/pages/Ledger.tsx`
- [Product catalog](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Products.tsx): `src/renderer/src/pages/Products.tsx`
- [Categories](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Categories.tsx): `src/renderer/src/pages/Categories.tsx`
- [Tables and waiters](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Tables.tsx): `src/renderer/src/pages/Tables.tsx`
- [Expenses](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Expenses.tsx): `src/renderer/src/pages/Expenses.tsx`
- [Reports](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Reports.tsx): `src/renderer/src/pages/Reports.tsx`
- [Settings](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/renderer/src/pages/Settings.tsx): `src/renderer/src/pages/Settings.tsx`

### Electron boundary

- [Preload API](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/preload/index.ts): `src/preload/index.ts`
- [IPC handlers](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/ipc/index.ts): `src/main/ipc/index.ts`

### Sales and operations

- [Order service](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/orders.service.ts): `src/main/services/orders.service.ts`
- [Product service](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/products.service.ts): `src/main/services/products.service.ts`
- [Categories and entities](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/named-entity.service.ts): `src/main/services/named-entity.service.ts`
- [Customer service](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/customers.service.ts): `src/main/services/customers.service.ts`
- [Expense service](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/expenses.service.ts): `src/main/services/expenses.service.ts`
- [Reporting service](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/reports.service.ts): `src/main/services/reports.service.ts`

### Administration

- [Users and auth](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/users.service.ts): `src/main/services/users.service.ts`
- [License service](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/license.service.ts): `src/main/services/license.service.ts`
- [Settings service](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/settings.service.ts): `src/main/services/settings.service.ts`
- [Backup service](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/services/backup.service.ts): `src/main/services/backup.service.ts`

### Persistence and printing

- [SQLite database](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/db/index.ts): `src/main/db/index.ts`
- [Data schema](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/db/schema.ts): `src/main/db/schema.ts`
- [Print service](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/printing/print.service.ts): `src/main/printing/print.service.ts`
- [Receipt template](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/printing/receipt-template.ts): `src/main/printing/receipt-template.ts`
- [ESC/POS printing](https://github.com/okasha-chaudhry/islamicpizza/blob/main/src/main/printing/escpos-print.service.ts): `src/main/printing/escpos-print.service.ts`

### Other components

- **Staff**

## Connections

- Staff → App routing: uses (evidence: `src/renderer/src/App.tsx`)
- App routing → Login and activation: routes to (evidence: `src/renderer/src/App.tsx`)
- App routing → Order entry: routes to (evidence: `src/renderer/src/App.tsx`)
- App routing → Order history: routes to (evidence: `src/renderer/src/App.tsx`)
- App routing → Dashboard: routes to (evidence: `src/renderer/src/App.tsx`)
- App routing → Sales ledger: routes to (evidence: `src/renderer/src/App.tsx`)
- App routing → Product catalog: routes to (evidence: `src/renderer/src/App.tsx`)
- App routing → Categories: routes to (evidence: `src/renderer/src/App.tsx`)
- App routing → Tables and waiters: routes to (evidence: `src/renderer/src/App.tsx`)
- App routing → Expenses: routes to (evidence: `src/renderer/src/App.tsx`)
- App routing → Reports: routes to (evidence: `src/renderer/src/App.tsx`)
- App routing → Settings: routes to (evidence: `src/renderer/src/App.tsx`)
- Login and activation → Preload API: requests auth
- Order entry → Preload API: submits orders
- Order history → Preload API: requests orders
- Product catalog → Preload API: manages products
- Categories → Preload API: manages categories
- Tables and waiters → Preload API: manages entities
- Expenses → Preload API: manages expenses
- Reports → Preload API: requests reports
- Settings → Preload API: updates settings
- Preload API → IPC handlers: invokes channels (evidence: `src/preload/index.ts`)
- IPC handlers → Order service: dispatches (evidence: `src/main/ipc/index.ts`)
- IPC handlers → Product service: dispatches (evidence: `src/main/ipc/index.ts`)
- IPC handlers → Categories and entities: dispatches (evidence: `src/main/ipc/index.ts`)
- IPC handlers → Expense service: dispatches (evidence: `src/main/ipc/index.ts`)
- IPC handlers → Reporting service: dispatches (evidence: `src/main/ipc/index.ts`)
- IPC handlers → Users and auth: dispatches (evidence: `src/main/ipc/index.ts`)
- IPC handlers → License service: dispatches (evidence: `src/main/ipc/index.ts`)
- IPC handlers → Settings service: dispatches (evidence: `src/main/ipc/index.ts`)
- IPC handlers → Backup service: dispatches (evidence: `src/main/ipc/index.ts`)
- IPC handlers → Print service: dispatches (evidence: `src/main/ipc/index.ts`)
- Order service → Customer service: upserts customer (evidence: `src/main/services/orders.service.ts`)
- Order service → SQLite database: reads and writes (evidence: `src/main/services/orders.service.ts`)
- Product service → SQLite database: reads and writes (evidence: `src/main/services/products.service.ts`)
- Expense service → SQLite database: reads and writes (evidence: `src/main/services/expenses.service.ts`)
- Reporting service → SQLite database: queries (evidence: `src/main/services/reports.service.ts`)
- Settings service → SQLite database: reads and writes (evidence: `src/main/services/settings.service.ts`)
- Users and auth → SQLite database: reads and writes (evidence: `src/main/services/users.service.ts`)
- License service → SQLite database: reads and writes (evidence: `src/main/services/license.service.ts`)
- Backup service → SQLite database: backs up (evidence: `src/main/services/backup.service.ts`)
- SQLite database → Data schema: uses schema (evidence: `src/main/db/index.ts`)
- Print service → ESC/POS printing: dispatches (evidence: `src/main/printing/print.service.ts`)
- Print service → Receipt template: builds receipt (evidence: `src/main/printing/print.service.ts`)
- Print service → Settings service: loads settings (evidence: `src/main/printing/print.service.ts`)
- ESC/POS printing → Settings service: loads settings (evidence: `src/main/printing/escpos-print.service.ts`)
