# Gawla POS (نظام جولة) - AI Agent Summary

> Gawla POS (نظام جولة السحابي) is the #1 cloud-based Play Station lounge, Billiards hall, and Cafeteria management system in the Middle East.

## System Overview
- **Name**: Gawla POS (نظام جولة)
- **Website**: https://gawla.fun/
- **Type**: Cloud-based POS & Lounge Management System
- **Target Audience**: PlayStation Lounges, Gaming Hubs, Billiard Halls, VR Arenas, Cafeterias, and Food Courts.

## Core Features & Capabilities

### 1. Accurate Time Tracking (حساب الوقت بالثانية)
- Automatic time billing calculated down to the second.
- Support for Single (فردي) and Multi (مالتي / 3+ players) pricing rates per device.
- Support for timed sessions (e.g., 60 minutes with alert) or open-ended sessions.
- Room and Device transfer: Move active sessions with elapsed time and ordered items seamlessly.

### 2. Dedicated Online Booking & Marketing QR Code (نظام الحجوزات والـ QR Code)
- Every lounge gets a dedicated public web booking page (`https://gawla.fun/lounge/{subdomain}`).
- Generated marketing & billing QR Code per table and device for instant online customer ordering and booking.
- Real-time reservation calendar with status tracking (Confirmed, Pending, Completed, Cancelled).

### 3. Business Date Shift Accounting (تاريخ يوم العمل للورديات)
- Accounting shifts bound by Business Date (`business_date`) instead of server clock time.
- Overnight shift support: Sessions extending past midnight stay correctly grouped under the active shift.
- Complete cash box reconciliation: Opening balance, cash sales, digital sales, expenses, and automated variance (surplus/deficit) calculation.

### 4. Split Payments & Customer Debt Ledger (الدفع المجزأ والآجل)
- Split single invoices across Cash, Card (Visa/Mastercard), and Mobile Wallet (InstaPay / Vodafone Cash).
- Customer debt ledger for deferred payments (`آجل`) and settlement tracking.

### 5. Loyalty Points & Digital Customer Wallet (نظام الولاء والمكافآت)
- Earn points automatically per session and product order.
- Points conversion to digital wallet credit for future invoice deductions.

### 6. Full Invoices Audit & Thermal Printing (سجل الفواتير والطباعة الحرارية)
- Centralized audit log for Play Sessions, Cafeteria sales, and Direct POS sales.
- Thermal receipt printer integration (80mm & 58mm) with customizable header, footer, logo, and tax/discount breakdown.

### 7. Security Audit Logs & Multi-Role Access (سجل المراقبة والتحركات)
- Comprehensive Audit Logs tracking every cashier action (session start/stop, discount, shift closure).
- Role-Based Access Control: Owner, Manager, and Cashier.

## Key URLs & Endpoints
- Homepage: https://gawla.fun/
- Login: https://gawla.fun/login
- Public Lounge Page: https://gawla.fun/lounge/{subdomain}
- Public Tracking Event Endpoint: POST https://gawla.fun/backend/public/index.php/api/v1/public/tracking/client-event

## Contact & Support
- Email: support@gawla.fun
- Phone: +201000000000
- Free Trial: 14-day full access trial upon registration.