{"id":25254105,"url":"https://github.com/aharoj/barbershop","last_synced_at":"2025-04-05T22:41:35.069Z","repository":{"id":276937130,"uuid":"930784996","full_name":"aharoJ/barbershop","owner":"aharoJ","description":"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.","archived":false,"fork":false,"pushed_at":"2025-03-07T00:14:43.000Z","size":178112,"stargazers_count":16,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-07T00:20:52.251Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://www.aharoj.io","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aharoJ.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-11T07:55:43.000Z","updated_at":"2025-03-07T00:14:46.000Z","dependencies_parsed_at":"2025-02-11T09:31:59.748Z","dependency_job_id":"ab3cbc63-2332-44d9-a826-d6674c00d5b3","html_url":"https://github.com/aharoJ/barbershop","commit_stats":null,"previous_names":["aharoj/barbershop"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aharoJ%2Fbarbershop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aharoJ%2Fbarbershop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aharoJ%2Fbarbershop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aharoJ%2Fbarbershop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aharoJ","download_url":"https://codeload.github.com/aharoJ/barbershop/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247411208,"owners_count":20934650,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2025-02-12T05:08:52.426Z","updated_at":"2025-04-05T22:41:35.058Z","avatar_url":"https://github.com/aharoJ.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BarberOS ✂️ - Modern Barbershop Management Platform\n\n[![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/)\n\n![Platform Overview](public/landing-img/fullstack-owner-dashboard.png)\n\n**Enterprise-ready solution** connecting barbers, clients, and shop owners through digital workflows.\n\n---\n\n## **Repository Overview**\n\n```\n.\n├── backend/       # Spring Boot API (Authentication, Business Logic)\n├── frontend/      # Next.js 15 Web App (UI \u0026 Client Interaction)\n├── docs/          # Documentation, ADRs, Security Reports (private for now)\n├── public/        # Static assets (images, icons, etc.)\n```\n\n### 📖 **Documentation \u0026 Reference**\n\n📌 **[Backend Documentation](backend/README.md)**\n\n- 48 REST endpoints\n- 22 entity relationships\n- 9 enum state machines\n\n📌 **[Frontend Documentation](frontend/README.md)**\n\n- 31 React components\n- 8 Zustand stores\n- 4 authentication workflows\n\n---\n\n### **Key Features**\n\n| Role        | Capabilities                                                                                 |\n| ----------- | -------------------------------------------------------------------------------------------- |\n| **Owners**  | 🏢 Multi-shop management • 📊 Analytics \u0026 Reporting • 👥 Staffing Control • 💰 Staff earning |\n| **Barbers** | 📅 Schedule management • 🗂 Client history • 💰 Earnings tracking                             |\n| **Clients** | 🔖 Booking • ⭐ Reviews \u0026 Feedback • 💳 Payment history                                      |\n\n#### 🏗 Architecture\n\n```mermaid\ngraph LR\n  subgraph \"System Architecture\"\n    A[Client] --\u003e B[Next.js Frontend]\n    B --\u003e C[Spring Boot API]\n    C --\u003e D[(PostgreSQL Database)]\n    C --\u003e F[\"Payment Gateway \\(Stripe/PayPal\\)\"]\n    C --\u003e G[\"Auth Service \\(OAuth2\\)\"]\n  end\n\n  classDef primary fill:#2E86C1,stroke:#1B4F72,color:white,font-weight:bold;\n  classDef secondary fill:#AED6F1,stroke:#2E86C1,color:black;\n  \n  class A,B,C primary;\n  class D,E,F,G secondary;\n\n```\n\n```mermaid\nmindmap\n  root((User Roles))\n    Owners\n      Multi-Shop Management\n      Analytics | Insights\n      Staffing | Operations\n    Barbers\n      Schedule Management\n      Client History\n      Earnings | Payouts\n    Clients\n      Booking Appointments\n      Reviews | Feedback\n      Payment History\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faharoj%2Fbarbershop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faharoj%2Fbarbershop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faharoj%2Fbarbershop/lists"}