Comprehensive System Capabilities & Feature Architecture

The complete, exhaustive breakdown of the GTSS Offline-First Hotel, Retail, & POS Captive Portal System.

This document represents the absolute entirety of the platform's capabilities—spanning the core infrastructure, networking, integrations, administrative control, localized POS, and the dual-vertical client experience (Restaurant & Retail).

---

🌐 1. CORE INFRASTRUCTURE & NETWORKING

The invisible engine powering the offline-first experience.

• Captive Portal & DNS Hijacking: Forces any device connecting to the WiFi hotspot to instantly land on the application UI without requiring internet access or manual URL entry.
• Zero-Login Identity Tracking: Assigns a unique tracking token via MAC-address or local device storage. Guests never type a username, yet the system remembers their cart, table, and past sessions individually.
• WebSockets (Socket.IO) Real-Time Engine: 100% live synchronization. When a kitchen swipes "Ready", the waiter's tablet instantly updates, and the guest's phone live-tracks the food.
• Deployable on Linux/Windows Hosts: Runs highly automated script wrappers (
  setup-offline.sh
  ,
  setup-hotspot.ps1
  ) to handle iptables, DNS routing, and DHCP directly from the host machine or dedicated edge router.
• Offline-First Tolerance: Node.js and SQLite/PostgreSQL operate entirely locally. System never goes down if the ISP goes down.

---

👑 2. ADMIN & ENTERPRISE MANAGEMENT HUB

The omnipotent view for Hotel Owners and General Managers.

📊 Deep Analytics & Reporting (

AnalyticsDashboard

)

• Revenue Tracking: Visual charts of sales over days/weeks segregated by Retail vs Restaurant.
• Traffic & Operations Analysis: Peak ordering hours heatmaps, average kitchen turnaround times (Prep to Ready).
• Item Performance: Best sellers, worst sellers, and category-wise breakdowns.
• Automated PDF/CSV Exports: Export entire transaction logs, daily PDF revenue summaries, and staff performance metrics.

👥 Staff Auditing & Tracking (

AuditLogsPage

,

WaiterMonitoring

)

• Comprehensive Audit Trail: Every significant action (Logins, Order Status Changes, Issue Replies, Settings Modifications) is logged in an uneditable ledger with timestamps and IP addresses securely.
• Waiter Load-Balancing & Tracking: Real-time view of which waiters have the most active orders, their historical delivery times, and individual revenue generated.
• Inter-Staff Messaging: Internal chat module enabling the Admin to send direct broadcasts or text messages to specific staff units/roles.

🛎️ Live Operations & Floor Control (

AdminDashboard

,

TableOccupancy

)

• Global Command Center: One screen to oversee all active Restaurant orders, Retail orders, and unresolved guest complaints.
• Live Table Occupancy Mapping: Visual grid layout displaying live table statuses: Idle, Ordering (Browsing), Waiting for Food, Eating, or Filing a Complaint.
• Mass Notifications Broadcast System: Admin can push visual alerts to all connected devices on the network (e.g., "WiFi Maintenance", "Happy Hour Deals: 50% Off Drinks Now!").
• Customer Relationship Management (CRM): Identify repeat customers based on device retention, view their entire holistic order history and historical complaints.

⚙️ Inventory & Settings Configurations

• Dynamic Hotel Settings: Adjust global currency, operating hours, payment methods, timezone, and activate/deactivate the Retail/Hotel modules entirely.
• Advanced Menu Control:
  • Add/Delete items, set categories, upload images.
  • Modifiers: Define prep time, allergen flags (Spicy, Nuts), stock counts.
  • Upselling Engine: Link specific items together as "Pairings" (e.g., Buying Chips triggers a popup to buy Chicken).
  • Add-On Modules: Attach paid or free customizations to specific meals (e.g., "Extra Cheese +$1").

---

👨‍🍳 3. HOTEL RESTAURANT OPERATIONS (Staff Side)

Tools optimized for high-pressure kitchen and waiter environments.

Smart Kitchen Display System (KDS)

• Focused UI: Massive screen UI displaying only pending and active orders. Stripped of all non-essential data.
• Visual Timers: Color-coded countdowns indicating how long a ticket has been waiting.
• Swipe-to-Complete: Cooks swipe or tap a large button to move an item from "Preparing" to "Ready," instantly pinging the assigned Waiter.

Waiter POS Dashboard (

WaiterDashboard

)

• Auto-Assignment Algorithm: Orders are logically routed to the specific waiter currently bearing the lowest active workload to prevent table bottlenecks.
• Actionable Feed: Waiters see their specific assigned orders, their statuses, and specific table requests.
• Bill Management: Mark orders as "Paid," partially paid, or print physical receipts for the table.

Service Issue Center

• Waiters/Admins receive immediate visual/audio pings when a table requests a specific service ("Need Ketchup," "Delayed Food," "Need the Bill," "Spilled Water").

---

📱 4. THE GUEST EXPERIENCE (RESTAURANT)

A pristine, low-friction ordering environment mimicking modern native apps.

• Categorized Rich Menu: Lazy-loaded, high-fidelity image displays for menu items.
• Smart Search & Filters: Dietary filters (Vegan, Non-Spicy) and instant search bars.
• Customizable Carts: Add notes ("No onions, extra salt") and select dynamic addons before adding to the cart.
• Live Pizza-Tracker: Guests watch their order move from Pending -> Accepted -> Preparing -> Ready -> Delivered natively on their screen.
• Bill Status & Instant Payment Views: Guests can request their consolidated bill directly from their phone.

---

🛍️ 5. THE RETAIL & SERVICE VERTICAL

A complete secondary ecosystem for Gift Shops, Spas, and Minibars.

• Dedicated Retail UI (
  RetailHome
  ,
  RetailCatalog
  ): Guests seamlessly switch from the "Restaurant" to the "Boutique/Shop" within the same captive portal.
• Service Timeslots & Booking: Beyond physical goods, guests can book "Spa Massages" or "Excursions" that utilize an inventory of available calendar time slots.
• Variant Pricing: Retail items support variations (e.g., "T-Shirt: Red, Large - $20").
• Minibar Tracking: Connects room stock to the guest's digital bill.
• Bulk Admin Action: Retail Dashboard handles bulk actions (Checkbox select 10 orders -> Mark as Fulfilled) designed for high-volume POS situations.

---

💸 6. FINTECH & PAYMENTS

Frictionless local checkout designed for the African & Global markets.

• Safaricom Daraja M-Pesa API: Core integration for STK Pushes directly via Safaricom.
• Direct-to-Device M-Pesa Integration: Guests hit "Pay via M-Pesa" on their phone; the backend triggers an API call that makes a prompt pop up on the guest's mobile phone instantly.
• Payment State Ledger: Tracks exact
  amount_paid
  , partial payments, and
  failed_reasons
  locally to prevent revenue leakage.
• Manual Override: Waiters can bypass digital APIs to log Cash or Physical POS Card transactions directly into the order ledger.

---

🏢 7. MICROSOFT BUSINESS CENTRAL (BC) ERP INTEGRATION

Enterprise-grade accounting synchronization built for "Offline-First".

• OData / OAuth2 Secure Handshake: Validated Entra ID (Azure) Client Credential flows to communicate securely with BC.
• The Sync Queue Engine: Because the POS may be completely offline, all finalized orders are moved to a resilient
  SyncQueue
  table.
• Background Cron Worker: A silent processor constantly probes for internet access. Once detected, it systematically pushes the backlog to the cloud without stalling the local server.
• Idempotency & Conflict Resolution: Uses
  orderNumber
  UUIDs to ensure Business Central never double-counts a sale during a flaky network reconnect.
• Mappings:
  • Orders →BC
    salesInvoices
  • Payments → BC
    cashReceiptJournals
  • Inventory → BC
    itemLedgerEntries
• Integration Logs: Admins can audit every single BC payload that was sent/received directly from the local UI, determining exactly when the accounting ledger was last updated.