A full-stack business management platform for independent service providers and small businesses.
Designed to streamline appointment scheduling, customer management, and daily operations through a centralized admin dashboard.

Business Management System is a production-oriented web application built for small, service-based businesses.

The system enables business owners to manage appointments, services, customers, availability, and waitlists from a single platform, with a strong focus on reliability, clear separation of roles, and prevention of scheduling conflicts.

This repository represents a commercial product under active development.

• Intelligent appointment scheduling with conflict prevention
• Service catalog management (pricing, duration, descriptions)
• Customer management with contact details
• Business availability configuration and blocked times
• Waitlist mechanism for fully booked time slots
• Email notifications for confirmations and updates

• Centralized admin dashboard
• Calendar-based appointment management
• Manual appointment creation, update, and cancellation
• Service and availability management
• Basic operational reports and summaries

• Self-service appointment booking
• View, reschedule, and cancel personal appointments
• Join waitlists when no availability exists
• Receive automated email notifications

• JWT-based authentication and authorization
• Background job processing for waitlist handling and notifications
• Redis-backed Bull Queue for asynchronous tasks
• Modular backend architecture
• Type-safe communication across frontend and backend

• NestJS
• TypeScript
• Prisma ORM
• PostgreSQL
• Bull Queue
• Redis (used for background jobs)
• JWT + Passport
• Swagger (API documentation)

• Next.js
• React
• Zustand
• React Hook Form
• TanStack React Query
• Tailwind CSS
• Radix UI
• Lucide Icons
• date-fns

• Docker
• Docker Compose

business-management/ ├── backend/ │ ├── src/modules/ │ │ ├── auth │ │ ├── users │ │ ├── services │ │ ├── appointments │ │ ├── waitlist │ │ └── notifications │ └── prisma/ │ ├── frontend/ │ ├── app/ │ │ ├── admin │ │ ├── customer │ │ └── auth │ └── src/ │ └── docker-compose.yml

The system is designed to be run using Docker Compose.

docker-compose up -d

Access the application:

• Frontend: http://localhost:3000
• Backend API: http://localhost:3001

Interactive API documentation is available via Swagger:

http://localhost:3001/api/docs

Main entities:

• Users – customers and administrators
• Services – service definitions
• Appointments – scheduled bookings
• BlockedTimes – unavailable periods
• Waitlist – pending booking requests

• Modular NestJS design
• Controllers, services, DTOs, and guards
• Clear separation of business logic and transport layer

• Component-driven architecture
• Centralized API layer
• Global state management with Zustand
• Server state handled via React Query

UNLICENSED – Proprietary Software

All rights reserved.