Beteseb Salon SaaS API

📌 What is Beteseb?

Beteseb is a multi-tenant salon management platform that allows organizations to manage multiple branches (workspaces), employees, services, and appointments in real-time.

It supports platform admins, salon owners, and staff with permission-based access and real-time dashboards using REST APIs and Socket.IO.

🧩 Core Modules

• 💇‍♀️ Appointments & Service Steps
• 🏢 Branches / Workspaces
• 👨‍💼 Employees & Roles
• 💳 Services & Pricing
• 📊 Dashboard & Reports
• 🔔 Notifications & Announcements

🔗 REST API

• GET /api/v1/time – Server & DB health
• /api/v1/auth – Authentication & Profile
• /api/v1/appointments – Create & manage appointments
• /api/v1/services – Manage salon services
• /api/v1/employees – Employee & role management
• /api/v1/dashboard – Analytics & reports

📡 Real-Time Events

Beteseb uses Socket.IO to push live updates without polling.

• 📺 Branch display updates
• 🎟 Appointment status changes
• 👨‍💼 Employee availability & assignments
• 📢 Live notifications & announcements

🧠 Socket Rooms

• public:display – Branch lobby screens
• appointment:{id} – Appointment-specific updates
• workspace:{id} – Branch workspace updates
• platform:global – Platform-wide admin updates

🔐 Security & Stability

• JWT authentication
• Permission-based access control
• Rate limiting & Helmet
• Graceful shutdown handling
• Database & multi-tenant health checks