Sentra F&B — Architecture & Tech Stack Delta¶

System Architecture¶

SentraF&B menerapkan arsitektur Hybrid Local-Edge-Cloud Network. Terminal kasir dan layar KDS di dapur terhubung satu sama lain dalam satu jaringan lokal (LAN) di dalam outlet sehingga tetap dapat beroperasi dan berkoordinasi secara mulus meskipun koneksi internet eksternal terputus total.

3.1 C4 Container Diagram¶

graph TB
    subgraph "Outlet Restoran (LAN Edge)"
        A["POS Terminal App (React + Tauri)"]
        B["KDS Screens (Tauri Client)"]
        C["Local Edge Server (Mini PC / SQLite Broker)"]

        A <-->|1. WebSocket Local Event Sync| C
        B <-->|2. Ticket Status Push/Pull| C
    end

    subgraph "Cloud Enterprise Services"
        D["API Cloud Gateway (Nginx / Cloudflare)"]
        E["Sync & Inventory Broker (Go)"]
        F["Backoffice Web Suite (Next.js)"]
        G[("Aurora PostgreSQL (Master DB)")]
        H[("Redis (Shared Memory Store)")]
    end

    C -->|3. HTTPS Batch Sync & Queue| D
    F -->|4. CRUD & Management Dashboard| D
    D <--> E
    E <--> G
    E <--> H

3.2 Protokol Sinkronisasi Dapur-Kasir (Kitchen Sync Engine)¶

Zero-Drop Ticket Delivery: Ketika pelayan menginput order via tablet/POS, tiket dikirim ke local server outlet via protokol WebSocket dengan konfirmasi tanda terima (Acknowledgement Message / ACK).
Failover to Kitchen Printer: Jika stasiun KDS digital mengalami gangguan listrik/layar mati, sistem local gateway mendeteksi kegagalan ping dan otomatis mengalihkan cetakan tiket pesanan fisik ke printer dapur thermal cadangan (Automatic Fallback Printer Routing).

Tech Stack — F&B Delta¶

Baseline: _shared/tech-stack-baseline.md

Overrides¶

POS & KDS Client App → React + Tauri (Rust) (bukan Electron): Tauri dipilih karena penggunaan RAM sangat kecil (< 30 MB vs > 500 MB Electron), kritis untuk Mini PC dapur dengan resource terbatas dan layar KDS yang harus berjalan 24/7 tanpa lag.

Tambahan Sistem-Spesifik¶

KDS Display App: Aplikasi Tauri terpisah khusus untuk layar dapur/bar (kds-display/), bukan bagian dari POS terminal kasir — routing tiket per-stasiun secara independen.
Kitchen Ticket Printer (Thermal Fallback): Driver printer thermal dapur terintegrasi langsung di local edge server; diaktifkan otomatis saat stasiun KDS offline (heartbeat detection < 15 detik).
Local Edge Server (Mini PC SQLite Broker): Setiap outlet memiliki satu Mini PC sebagai WebSocket broker LAN lokal dan SQLite sync buffer — kasir dan dapur berkoordinasi 100% tanpa internet.
Online Aggregator Webhooks: Integrasi GoFood, GrabFood, ShopeeFood webhook — order marketplace masuk langsung ke KDS terpusat tanpa input manual kasir.