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.
- Sanctum Powered: Secure, token-based API authentication.
- Granular Resources: Full CRUD control over Branches, Employees, Customers, and Suppliers.
- Smart Cart System: Integrated booking and voucher purchase through a unified cart logic.
- 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
# 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.