📘 TECHNICAL ONBOARDING DOCUMENTATION
Smart Spa Management System – ERP + IoT Integration
Ngoc Anh Spa / ThincTech Platform
1. 🎯 System Objectives
Helps spa manage all operations comprehensively:
- 📅 Appointment booking & staff scheduling
- 💳 Point of sale (POS) payment processing
- 📦 Inventory management – products – stock control
- 👩⚕️ Staff management & shift scheduling
- 📈 Revenue and performance reporting
- 📲 IoT sensor integration for room automation
- 🧠 All operations through Web ERP platform
2. 🧑💻 System Architecture
2.1. ERP Software (Web)
Access: https://erp.thinctech.org/dashboard
Account & Permissions:
| Role | Access Rights |
|---|---|
| Admin | Full administrative access |
| Manager | Staff, reports, scheduling |
| Front Desk | Booking, sales |
| Therapist | Personal schedule view, check-in |
2.2. Hardware Devices / IoT
Connected devices: receipt printers, room sensors, NFC, smart plugs, RGB lights…
Integration with: Firebase (via MQTT or API)
3. ⚙️ Equipment Preparation
| Area | Required Equipment |
|---|---|
| Front Desk | PC/Mac + Receipt printer + Barcode scanner + Cash drawer |
| Treatment Rooms | Presence sensors, smart RGB lights, smart power outlets |
| Staff | Tablet/iPad for Therapist/Front desk |
| Warehouse | QR code printer + Product barcode scanner (cosmetics, shampoo, etc.) |
| Network | Strong router + WiFi mesh/Repeater + Zigbee hub if needed |
4. 🧠 Software Setup
4.1. Account Creation and Permissions
Admin creates staff accounts at /staff
Assign roles: admin, manager, front-desk, therapist
4.2. Category Setup
Services, rooms, products: create in /settings or /inventory modules
Assign staff by specialty (e.g., hot stone → Linh)
5. 🔌 IoT Device Integration
5.1. WiFi-enabled Devices
Configure spa WiFi connection (recommend separate WiFi for IoT)
Ensure static IP if remote control is desired
5.2. Data Transmission to System
Use intermediary devices (Raspberry Pi or ESP32)
Send sensor data via MQTT or REST API to Firestore
5.3. Sample Workflow
Customer books appointment → Assign Room 1 + Therapist A
→ Therapist check-in with NFC card
→ System turns on red light + starts massage machine
→ Session ends → Sensor detects no movement → room status changes to "available"6. 🔒 Security & Permissions
- Data stored on Firebase (Google Cloud)
- Each user has unique authentication token
- Roles distributed via role-based UI rendering in system
7. 💡 New Spa Setup Checklist
| Item | Status |
|---|---|
| ☑️ Register custom domain or subdomain | |
| ☑️ Configure front desk equipment | |
| ☑️ Install ERP software (cloud/web) | |
| ☑️ Add staff & assign permissions | |
| ☑️ Connect room sensors | |
| ☑️ Connect receipt printer + barcode scanner | |
| ☑️ Test booking + check-in process | |
| ☑️ Train staff on system usage | |
| ☑️ Print and post user guides at front desk |
8. 📩 Technical Support Contact
- Email: thinctech.org@gmail.com
- Technical Hotline: 0964 595 374
- Detailed Technical Documentation: docs.soc.thinctech.org/VN/spa-onboarding
9. 🚀 Advanced Features
9.1. API Integration
- Use REST API to integrate with third-party systems
- Sync with CRM platforms
- Automate payment processes
9.2. Custom Reporting
- Use advanced filters to create specific reports
- Export reports in multiple formats (CSV, Excel)
9.3. Process Automation
- Automate repetitive tasks such as:
- Send inventory notification emails
- Schedule weekly reports
9.4. Advanced Security
- Activity Logging: Track user activities
- Two-Factor Authentication: Add extra security layer for important accounts
10. 📊 Workflow Process
10.1. Step-by-step Process
-
User Authentication:
- Login via Firebase Authentication
- Role-based access determines available features
-
Dashboard Access:
- View KPIs and manage important business modules
-
Module Interaction:
- User Module: Add or manage users
- Inventory Module: Track stock and manage products
- Reporting Module: Create insights for decision making
10.2. Workflow Diagram
ThincAdmin ERP is your companion solution to help your spa operate efficiently and stay organized. Use this documentation to maximize the software’s potential. For additional support, please refer to the FAQ tab or contact our support team.