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

📌 Backend Documentation

• 48 REST endpoints
• 22 entity relationships
• 9 enum state machines

📌 Frontend Documentation

• 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