The Enterprise Engine for Modern Wellness. A robust, high-performance backend architecture designed to power premium spa and wellness centers. From hardware integration to double-entry accounting, SpaSystem API delivers the reliability your business demands.
SpaSystem API is more than just a POS backend; it's a comprehensive Business Operating System. It bridges the gap between physical operations (hardware attendance, room management) and digital excellence (real-time notifications, unified finance).
- Double-Entry Accounting: Bulletproof journal records for every transaction.
- Unified Finance: Holistic tracking of Incomes, Expenses, and multi-wallet transfers.
- Automated Balancing: Real-time updates to account balances and branch-specific financial health.
- Laravel Reverb: Blazing fast, sub-second real-time notifications and state updates.
- Hardware Integration: Native support for ZKTeco Biometric SDK for seamless staff attendance synchronization.
- WebPush Notifications: Directly engage staff and management via browser-level push alerts.
- Advanced Session Logic: Precise tracking of treatments, therapist assignments, and bed occupancy.
- Capacity Intelligent: Real-time lookups for available rooms and therapists.
- Dynamic Catalog: Managed categories, treatments, and promotional banners.
- Hybrid Driver Architecture: Seamlessly switch between OpenAI, Ollama, and LocalAI.
- Automated Copywriting: High-performance description generation for treatments, branches, and banners.
- Local Image Synthesis: Support for Stable Diffusion via LocalAI for key-less, private image generation.
- Flexible Configuration: Dedicated drivers for text and images to optimize cost and privacy.
- Framework: Laravel 12 (The latest in PHP innovation)
- Engine: PHP 8.2+
- Database: Optimized for SQLite/MySQL/PostgreSQL
- Real-time: Laravel Reverb + Echo
- Hardware: ZKTeco SDK Integration
- Notification: Laravel WebPush
- AI Engines: OpenAI (GPT-4o/DALL-E 3) & Local (Ollama/Gemma 2/LocalAI)
# Clone and enter the nexus
git clone <repository-url>
cd SpaSystem-API
# Interactive setup (Dependencies, Keys, Migrations, Assets)
composer setup- Prepare Environment:
cp .env.example .env - Install Core:
composer install - Ignition:
php artisan key:generate - Data Sync:
php artisan migrate - Real-time Engine: Ensure Reverb keys are configured in
.env
Start the entire ecosystem with a single command:
composer devLaunch server, queue listeners, log streams, and asset watchers concurrently.
Ensure enterprise-grade reliability with our automated suite:
composer test| Resource | Logic Handler | Capability |
|---|---|---|
| Sessions | SessionController |
Multi-stage booking flow (start / finish) |
| Accounting | JournalController |
High-integrity ledger records |
| Attendance | AttendanceController |
Biometric sync & hardware polling |
| Sales/Cart | CartController |
Unified booking & voucher logic |
Developed with ❤️ for the Wellness Industry. Licensed under MIT.