# jirayu-ct-dev/saijai-phareab architecture

> Architecture diagram of the GitHub repository jirayu-ct-dev/saijai-phareab, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jirayu-ct-dev/saijai-phareab
- Repository: https://github.com/jirayu-ct-dev/saijai-phareab

## Overview

Saijai Phareab is a Thai-first laundry-shop management app. Its central workflow is staff entry of a storefront or package order, followed by payment/document handling and operational reporting; customers also have account, membership, and order-history features. The README documents these product flows and optional LINE and thermal-print capabilities. Edges are limited to documented relationships or calls visible in excerpts; unsampled API wiring is not asserted.

Main entry points: [`print-bridge/server.mjs`](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/print-bridge/server.mjs) (Print Gateway), [`app/components/admin/pos`](https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/app/components/admin/pos) (POS ordering), [`server/api/admin/service-orders`](https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/server/api/admin/service-orders) (Service orders), [`print-bridge/transport/tcp.js`](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/print-bridge/transport/tcp.js) (TCP transport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shop["Shop operations"]
  node_pos["POS ordering"]
  node_service_orders["Service orders"]
  node_credit_rules["Package credits"]
  node_catalog["Storefront catalog<br/>[mockPricing.ts]"]
  node_packages["Packages and sales"]
  node_payments["Payments"]
  node_documents["Receipts and quotes<br/>[paymentDocument.ts]"]
  node_reporting["Sales reporting"]
  node_staff_ui["Admin workspace"]
end

subgraph group_customer["Customer services"]
  node_customer_ui["Member portal"]
  node_customer_api["Member services"]
  node_domain_types["Business records"]
end

subgraph group_platform["Identity and integrations"]
  node_auth["Authentication<br/>[&#91;...all&#93;.ts]"]
  node_line["LINE integration<br/>[webhook.post.ts]"]
  node_notifications["Notifications<br/>[notify.ts]"]
end

subgraph group_printing["Thermal printing"]
  node_printer_ui["Printer controls"]
  node_gateway["Print Gateway<br/>[server.mjs]"]
  node_tcp_transport["TCP transport<br/>[tcp.js]"]
  node_fingerprint["Byte fingerprint"]
  node_mutex["Printer mutex<br/>[mutex.mjs]"]
end

node_staff(("Staff"))
node_customer_actor(("Customer"))
node_browser(("Shop browser"))
node_printer(("LAN printer"))

node_staff -->|"enters orders"| node_pos
node_pos -->|"records orders"| node_service_orders
node_service_orders -.->|"uses credits"| node_credit_rules
node_pos -->|"prices items"| node_catalog
node_staff -->|"sells packages"| node_packages
node_staff_ui -->|"views reports"| node_reporting
node_customer_actor -->|"uses portal"| node_customer_ui
node_customer_ui -.->|"requests account data"| node_customer_api
node_customer_actor -->|"pays orders"| node_payments
node_payments -->|"issues documents"| node_documents
node_customer_actor -->|"signs in"| node_auth
node_customer_actor -.->|"uses LINE"| node_line
node_service_orders -.->|"notifies on orders"| node_notifications
node_browser -->|"starts printing"| node_printer_ui
node_printer_ui -->|"sends print jobs"| node_gateway
node_gateway -->|"creates transport"| node_tcp_transport
node_gateway -->|"fingerprints payload"| node_fingerprint
node_tcp_transport -->|"fingerprints bytes"| node_fingerprint
node_gateway -->|"uses mutex"| node_mutex
node_tcp_transport -->|"writes bytes"| node_printer

click node_pos "https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/app/components/admin/pos"
click node_service_orders "https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/server/api/admin/service-orders"
click node_credit_rules "https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/server/utils/serviceOrderCredits.ts"
click node_catalog "https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/shared/data/mockPricing.ts"
click node_packages "https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/server/api/admin/packages"
click node_payments "https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/server/api/admin/payments"
click node_documents "https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/server/utils/paymentDocument.ts"
click node_reporting "https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/server/api/admin/dashboard"
click node_staff_ui "https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/app/pages/admin"
click node_customer_ui "https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/app/pages/me"
click node_customer_api "https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/server/api/me"
click node_domain_types "https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/shared/types"
click node_auth "https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/server/api/auth/%5B...all%5D.ts"
click node_line "https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/server/api/line/webhook.post.ts"
click node_notifications "https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/server/utils/notify.ts"
click node_printer_ui "https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/app/composables/useThermalPrinter.ts"
click node_gateway "https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/print-bridge/server.mjs"
click node_tcp_transport "https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/print-bridge/transport/tcp.js"
click node_fingerprint "https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/print-bridge/byteFingerprint.mjs"
click node_mutex "https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/print-bridge/mutex.mjs"

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_pos,node_service_orders,node_credit_rules,node_catalog,node_packages,node_payments,node_documents,node_reporting,node_staff_ui,node_browser toneBlue
class node_customer_ui,node_customer_api,node_domain_types toneAmber
class node_auth,node_line,node_notifications toneMint
class node_printer_ui,node_gateway,node_tcp_transport,node_fingerprint,node_mutex toneRose
class node_staff,node_customer_actor,node_printer toneIndigo
```

## Components

### Shop operations

- [POS ordering](https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/app/components/admin/pos): `app/components/admin/pos`
- [Service orders](https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/server/api/admin/service-orders): `server/api/admin/service-orders`
- [Package credits](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/server/utils/serviceOrderCredits.ts): `server/utils/serviceOrderCredits.ts`
- [Storefront catalog](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/shared/data/mockPricing.ts): `shared/data/mockPricing.ts`
- [Packages and sales](https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/server/api/admin/packages): `server/api/admin/packages`
- [Payments](https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/server/api/admin/payments): `server/api/admin/payments`
- [Receipts and quotes](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/server/utils/paymentDocument.ts): `server/utils/paymentDocument.ts`
- [Sales reporting](https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/server/api/admin/dashboard): `server/api/admin/dashboard`
- [Admin workspace](https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/app/pages/admin): `app/pages/admin`

### Customer services

- [Member portal](https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/app/pages/me): `app/pages/me`
- [Member services](https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/server/api/me): `server/api/me`
- [Business records](https://github.com/jirayu-ct-dev/saijai-phareab/tree/main/shared/types): `shared/types`

### Identity and integrations

- [Authentication](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/server/api/auth/%5B...all%5D.ts): `server/api/auth/[...all].ts`
- [LINE integration](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/server/api/line/webhook.post.ts): `server/api/line/webhook.post.ts`
- [Notifications](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/server/utils/notify.ts): `server/utils/notify.ts`

### Thermal printing

- [Printer controls](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/app/composables/useThermalPrinter.ts): `app/composables/useThermalPrinter.ts`
- [Print Gateway](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/print-bridge/server.mjs): `print-bridge/server.mjs`
- [TCP transport](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/print-bridge/transport/tcp.js): `print-bridge/transport/tcp.js`
- [Byte fingerprint](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/print-bridge/byteFingerprint.mjs): `print-bridge/byteFingerprint.mjs`
- [Printer mutex](https://github.com/jirayu-ct-dev/saijai-phareab/blob/main/print-bridge/mutex.mjs): `print-bridge/mutex.mjs`

### Other components

- **Staff**
- **Customer**
- **Shop browser**
- **LAN printer**

## Connections

- Staff → POS ordering: enters orders (evidence: `README.md`)
- POS ordering → Service orders: records orders (evidence: `README.md`)
- Service orders → Package credits: uses credits
- POS ordering → Storefront catalog: prices items (evidence: `README.md`)
- Staff → Packages and sales: sells packages (evidence: `README.md`)
- Admin workspace → Sales reporting: views reports (evidence: `README.md`)
- Customer → Member portal: uses portal (evidence: `README.md`)
- Member portal → Member services: requests account data
- Customer → Payments: pays orders (evidence: `README.md`)
- Payments → Receipts and quotes: issues documents (evidence: `README.md`)
- Customer → Authentication: signs in (evidence: `README.md`)
- Customer → LINE integration: uses LINE (evidence: `README.md`)
- Service orders → Notifications: notifies on orders
- Shop browser → Printer controls: starts printing (evidence: `README.md`)
- Printer controls → Print Gateway: sends print jobs (evidence: `README.md`)
- Print Gateway → TCP transport: creates transport (evidence: `print-bridge/server.mjs`)
- Print Gateway → Byte fingerprint: fingerprints payload (evidence: `print-bridge/server.mjs`)
- TCP transport → Byte fingerprint: fingerprints bytes (evidence: `print-bridge/transport/tcp.js`)
- Print Gateway → Printer mutex: uses mutex (evidence: `print-bridge/server.mjs`)
- TCP transport → LAN printer: writes bytes (evidence: `print-bridge/transport/tcp.js`)
