https://github.com/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.
https://github.com/aharoj/barbershop

appointment-scheduling barbershop-saas enterprise-software fullstack jwt-authentication multi-tenant nextjs payment-integration postgresql promotion-engine rsa-encryption salon-management spring-boot tailwindcss typscript

Last synced: about 1 year ago
JSON representation

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.

• Host: GitHub
• URL: https://github.com/aharoj/barbershop
• Owner: aharoJ
• License: agpl-3.0
• Created: 2025-02-11T07:55:43.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-07T00:14:43.000Z (over 1 year ago)
• Last Synced: 2025-03-07T00:20:52.251Z (over 1 year ago)
• Topics: appointment-scheduling, barbershop-saas, enterprise-software, fullstack, jwt-authentication, multi-tenant, nextjs, payment-integration, postgresql, promotion-engine, rsa-encryption, salon-management, spring-boot, tailwindcss, typscript
• Language: Java
• Homepage: https://www.aharoj.io
• Size: 170 MB
• Stars: 16
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# BarberOS ✂️ - Modern Barbershop Management Platform

[![Spring Boot](https://img.shields.io/badge/Spring_Boot-3-6DB33F?logo=spring)](https://spring.io/) [![Next.js](https://img.shields.io/badge/Next.js-15-000000?logo=next.js)](https://nextjs.org/) [![AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue)](LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript)](https://www.typescriptlang.org/) [![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.4-06B6D4?logo=tailwindcss)](https://tailwindcss.com/) [![OAuth2](https://img.shields.io/badge/OAuth_2.0-✅-EB5424?logo=openid)](https://oauth.net/2/)

![Platform Overview](public/landing-img/fullstack-owner-dashboard.png)

**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](backend/README.md)**

- 48 REST endpoints

- 22 entity relationships

- 9 enum state machines

📌 **[Frontend Documentation](frontend/README.md)**

- 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

```mermaid

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;

```

```mermaid

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

```