AH
aharoJ/barbershop
Full-Stack Barbershop Management Platform – A modern system for barbers, shop owners, and clients to manage appointments, schedules, and services. Built with Spring Boot 3, PostgreSQL, Next.js, Tailwind CSS, and JWT Authentication.
BarberOS ✂️ - Modern Barbershop Management Platform
Enterprise-ready solution connecting barbers, clients, and shop owners through digital workflows.
Repository Overview
.
├── backend/ # Spring Boot API (Authentication, Business Logic)
├── frontend/ # Next.js 15 Web App (UI & Client Interaction)
├── docs/ # Documentation, ADRs, Security Reports (private for now)
├── public/ # Static assets (images, icons, etc.)
📖 Documentation & Reference
- 48 REST endpoints
- 22 entity relationships
- 9 enum state machines
- 31 React components
- 8 Zustand stores
- 4 authentication workflows
Key Features
| Role | Capabilities |
|---|---|
| Owners | 🏢 Multi-shop management • 📊 Analytics & Reporting • 👥 Staffing Control • 💰 Staff earning |
| Barbers | 📅 Schedule management • 🗂 Client history • 💰 Earnings tracking |
| Clients | 🔖 Booking • ⭐ Reviews & Feedback • 💳 Payment history |
🏗 Architecture
graph LR
subgraph "System Architecture"
A[Client] --> B[Next.js Frontend]
B --> C[Spring Boot API]
C --> D[(PostgreSQL Database)]
C --> F["Payment Gateway \(Stripe/PayPal\)"]
C --> G["Auth Service \(OAuth2\)"]
end
classDef primary fill:#2E86C1,stroke:#1B4F72,color:white,font-weight:bold;
classDef secondary fill:#AED6F1,stroke:#2E86C1,color:black;
class A,B,C primary;
class D,E,F,G secondary;
mindmap
root((User Roles))
Owners
Multi-Shop Management
Analytics | Insights
Staffing | Operations
Barbers
Schedule Management
Client History
Earnings | Payouts
Clients
Booking Appointments
Reviews | Feedback
Payment History