Velvigo - Premium Multi-Tenant Appointment & Branch Management PWA
An enterprise-grade, multi-tenant appointment management PWA architected with true database-per-tenant isolation on MongoDB Atlas. Engineered for multi-branch business operations, featuring server-side scheduling collision protection and automated staff commission logistics.
Project Gallery
Project Overview
Velvigo was architected to solve the architectural vulnerabilities commonly found in standard multi-tenant scheduling systems-specifically data leaks and high-concurrency booking conflicts. By completely bypassing shared-database filtering and building a true database-per-tenant isolation engine, the application ensures absolute tenant data safety. The backend relies on a custom dynamic router pool that connects incoming API tokens to separate MongoDB Atlas shards on the fly. To ensure operational stability for multi-branch organizations, schedule conflicts are caught entirely server-side before db writes, while a custom financial processor continuously evaluates variable service commissions to automate payroll. The client application is structured as a fast, highly accessible PWA that minimizes server roundtrips by using local Zustand blocks for UI states, leaving long-term network data caching to TanStack Query. It is a highly specialized, production-hardened B2B software asset designed to operate seamlessly under high corporate workloads.
Key Features
- Engineered with Next.js (App Router) and NestJS inside two fully decoupled repositories for maximum hosting flexibility and modular scalability.
- True data segregation implemented via a custom NestJS database router pool that dynamically maps tenant requests to isolated MongoDB Atlas databases.
- Robust server-side calendar collision mapping designed to rigorously analyze time slots and eliminate double-booking errors.
- Automated internal financial layer processing complex service data to calculate dynamic employee commission splits and payroll logs.
- Advanced Role-Based Access Control (RBAC) separating administrative controls, branch managerial views, and stylist schedules.
- Dual-window in-memory rate limiting powered by NestJS ThrottlerModule, enforcing strict short-window and long-window protection boundaries.
- Fluid server-state caching ecosystem built with TanStack Query and Axios, maintaining instant UI synchronization during multi-user updates.
- Clean form orchestrations and runtime type validation schemas written via React Hook Form and Zod to eliminate client-side errors.
- Seamless internationalization and localized business management across global regions using Next-Intl and precision date mutations with date-fns.
- Pristine user interface constructed using Tailwind CSS v4 and Shadcn UI, supporting responsive PWA viewports and deep theme customization.