# adiletg/barber_notes architecture

> Architecture diagram of the GitHub repository adiletg/barber_notes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adiletg/barber_notes
- Repository: https://github.com/adiletg/barber_notes

## Overview

BarberNotes is a barber-shop management backend. Its main workflow is managing appointment bookings and their status while enforcing user access and work-schedule constraints. The tree also shows authentication, shop/staff setup, service catalogs, and Telegram integration. The README provides no product detail, and most controllers and integrations were not sampled; uncertain connections are therefore omitted or marked unverified rather than inferred as confirmed calls.

Main entry points: [`src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java`](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java) (Authentication), [`src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java`](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java) (Shift Rules), [`src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentController.java`](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentController.java) (Appointment API), [`src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentBookingService.java`](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentBookingService.java) (Booking Rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_booking["Appointments"]
  node_appointment_api["Appointment API"]
  node_booking_service["Booking Rules"]
  node_appointment_data[("Appointment Data")]
end

subgraph group_operations["Shop Operations"]
  node_shift_api["Shift API"]
  node_shift_service["Shift Rules"]
  node_shift_data[("Work Shifts")]
  node_barber_service["Barber Management<br/>[BarberService.java]"]
  node_branch_service["Branch Management<br/>[BranchService.java]"]
end

subgraph group_identity["Identity and Access"]
  node_staff_accounts["Staff Accounts"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_jwt_service["JWT Tokens<br/>[JwtService.java]"]
  node_refresh_tokens[("Refresh Tokens")]
  node_otp_service["OTP Verification<br/>[OtpService.java]"]
  node_customer_service["Customer Records"]
end

subgraph group_catalog["Service Catalog"]
  node_service_catalog["Services"]
  node_categories["Service Categories"]
  node_barber_services["Barber Services"]
  node_appointment_services["Appointment Services"]
end

subgraph group_integrations["Integrations"]
  node_telegram["Telegram Bot"]
end

node_customer(("Customer"))
node_staff(("Staff"))
node_telegram_user(("Telegram User"))

node_customer -.->|"requests bookings"| node_appointment_api
node_staff -.->|"manages bookings"| node_appointment_api
node_appointment_api -.->|"delegates to"| node_booking_service
node_booking_service -->|"reads and saves"| node_appointment_data
node_shift_service -->|"checks appointments"| node_booking_service
node_shift_service -->|"loads barber"| node_barber_service
node_shift_service -->|"loads branch"| node_branch_service
node_barber_service -->|"checks branch"| node_branch_service
node_service_catalog -->|"checks category"| node_categories
node_auth_service -->|"uses tokens"| node_jwt_service
node_auth_service -->|"manages refresh"| node_refresh_tokens
node_auth_service -->|"uses OTP"| node_otp_service
node_auth_service -->|"looks up customer"| node_customer_service
node_auth_service -->|"checks staff"| node_staff_accounts
node_telegram_user -.->|"sends updates"| node_telegram

click node_appointment_api "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentController.java"
click node_booking_service "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentBookingService.java"
click node_appointment_data "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentEntity.java"
click node_shift_api "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftController.java"
click node_shift_service "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java"
click node_shift_data "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftEntity.java"
click node_barber_service "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/barber/BarberService.java"
click node_branch_service "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/branch/BranchService.java"
click node_staff_accounts "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/staff_account/StaffAccountService.java"
click node_auth_service "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java"
click node_jwt_service "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/common/security/jwt/JwtService.java"
click node_refresh_tokens "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/common/security/jwt/RefreshTokenService.java"
click node_otp_service "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/common/security/otp/OtpService.java"
click node_customer_service "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/customer/CustomerService.java"
click node_service_catalog "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/service/ServiceService.java"
click node_categories "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/service_category/ServiceCategoryService.java"
click node_barber_services "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/barber_service/BarberServiceService.java"
click node_appointment_services "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/appointment_service/AppointmentServiceService.java"
click node_telegram "https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/telegram/TelegramDispatcher.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_appointment_api,node_booking_service,node_appointment_data,node_telegram_user toneBlue
class node_shift_api,node_shift_service,node_shift_data,node_barber_service,node_branch_service toneAmber
class node_staff_accounts,node_auth_service,node_jwt_service,node_refresh_tokens,node_otp_service,node_customer_service toneMint
class node_service_catalog,node_categories,node_barber_services,node_appointment_services toneRose
class node_telegram,node_customer,node_staff toneIndigo
```

## Components

### Appointments

- [Appointment API](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentController.java): `src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentController.java`
- [Booking Rules](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentBookingService.java): `src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentBookingService.java`
- [Appointment Data](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentEntity.java): `src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentEntity.java`

### Shop Operations

- [Shift API](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftController.java): `src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftController.java`
- [Shift Rules](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java): `src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java`
- [Work Shifts](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftEntity.java): `src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftEntity.java`
- [Barber Management](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/barber/BarberService.java): `src/main/java/kg/barbernotes/barbernotes/barber/BarberService.java`
- [Branch Management](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/branch/BranchService.java): `src/main/java/kg/barbernotes/barbernotes/branch/BranchService.java`

### Identity and Access

- [Staff Accounts](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/staff_account/StaffAccountService.java): `src/main/java/kg/barbernotes/barbernotes/staff_account/StaffAccountService.java`
- [Authentication](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java): `src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java`
- [JWT Tokens](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/common/security/jwt/JwtService.java): `src/main/java/kg/barbernotes/barbernotes/common/security/jwt/JwtService.java`
- [Refresh Tokens](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/common/security/jwt/RefreshTokenService.java): `src/main/java/kg/barbernotes/barbernotes/common/security/jwt/RefreshTokenService.java`
- [OTP Verification](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/common/security/otp/OtpService.java): `src/main/java/kg/barbernotes/barbernotes/common/security/otp/OtpService.java`
- [Customer Records](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/customer/CustomerService.java): `src/main/java/kg/barbernotes/barbernotes/customer/CustomerService.java`

### Service Catalog

- [Services](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/service/ServiceService.java): `src/main/java/kg/barbernotes/barbernotes/service/ServiceService.java`
- [Service Categories](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/service_category/ServiceCategoryService.java): `src/main/java/kg/barbernotes/barbernotes/service_category/ServiceCategoryService.java`
- [Barber Services](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/barber_service/BarberServiceService.java): `src/main/java/kg/barbernotes/barbernotes/barber_service/BarberServiceService.java`
- [Appointment Services](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/appointment_service/AppointmentServiceService.java): `src/main/java/kg/barbernotes/barbernotes/appointment_service/AppointmentServiceService.java`

### Integrations

- [Telegram Bot](https://github.com/adiletg/barber_notes/blob/main/src/main/java/kg/barbernotes/barbernotes/telegram/TelegramDispatcher.java): `src/main/java/kg/barbernotes/barbernotes/telegram/TelegramDispatcher.java`

### Other components

- **Customer**
- **Staff**
- **Telegram User**

## Connections

- Customer → Appointment API: requests bookings
- Staff → Appointment API: manages bookings
- Appointment API → Booking Rules: delegates to (evidence: `src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentController.java`)
- Booking Rules → Appointment Data: reads and saves (evidence: `src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentBookingService.java`)
- Shift Rules → Booking Rules: checks appointments (evidence: `src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java`)
- Shift Rules → Barber Management: loads barber (evidence: `src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java`)
- Shift Rules → Branch Management: loads branch (evidence: `src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java`)
- Barber Management → Branch Management: checks branch (evidence: `src/main/java/kg/barbernotes/barbernotes/barber/BarberService.java`)
- Services → Service Categories: checks category (evidence: `src/main/java/kg/barbernotes/barbernotes/service/ServiceService.java`)
- Authentication → JWT Tokens: uses tokens (evidence: `src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java`)
- Authentication → Refresh Tokens: manages refresh (evidence: `src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java`)
- Authentication → OTP Verification: uses OTP (evidence: `src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java`)
- Authentication → Customer Records: looks up customer (evidence: `src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java`)
- Authentication → Staff Accounts: checks staff (evidence: `src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java`)
- Telegram User → Telegram Bot: sends updates
