How adiletg/barber_notes works
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: AuthService.java Authentication · WorkShiftService.java Shift Rules · AppointmentController.java Appointment API · AppointmentBookingService.java Booking Rules
Components 22
Appointments
- Appointment API
src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentController.java - Booking Rules
src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentBookingService.java - Appointment Data
src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentEntity.java
Shop Operations
- Shift API
src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftController.java - Shift Rules
src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java - Work Shifts
src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftEntity.java - Barber Management
src/main/java/kg/barbernotes/barbernotes/barber/BarberService.java - Branch Management
src/main/java/kg/barbernotes/barbernotes/branch/BranchService.java
Identity and Access
- Staff Accounts
src/main/java/kg/barbernotes/barbernotes/staff_account/StaffAccountService.java - Authentication
src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java - JWT Tokens
src/main/java/kg/barbernotes/barbernotes/common/security/jwt/JwtService.java - Refresh Tokens
src/main/java/kg/barbernotes/barbernotes/common/security/jwt/RefreshTokenService.java - OTP Verification
src/main/java/kg/barbernotes/barbernotes/common/security/otp/OtpService.java - Customer Records
src/main/java/kg/barbernotes/barbernotes/customer/CustomerService.java
Service Catalog
- Services
src/main/java/kg/barbernotes/barbernotes/service/ServiceService.java - Service Categories
src/main/java/kg/barbernotes/barbernotes/service_category/ServiceCategoryService.java - Barber Services
src/main/java/kg/barbernotes/barbernotes/barber_service/BarberServiceService.java - Appointment Services
src/main/java/kg/barbernotes/barbernotes/appointment_service/AppointmentServiceService.java
Integrations
- Telegram Bot
src/main/java/kg/barbernotes/barbernotes/telegram/TelegramDispatcher.java
Other components
- Customer
- Staff
- Telegram User
Connections 15
- Customer → Appointment API: requests bookings
- Staff → Appointment API: manages bookings
- Appointment API → Booking Rules: delegates to
src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentController.java - Booking Rules → Appointment Data: reads and saves
src/main/java/kg/barbernotes/barbernotes/appointment/AppointmentBookingService.java - Shift Rules → Booking Rules: checks appointments
src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java - Shift Rules → Barber Management: loads barber
src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java - Shift Rules → Branch Management: loads branch
src/main/java/kg/barbernotes/barbernotes/work_shift/WorkShiftService.java - Barber Management → Branch Management: checks branch
src/main/java/kg/barbernotes/barbernotes/barber/BarberService.java - Services → Service Categories: checks category
src/main/java/kg/barbernotes/barbernotes/service/ServiceService.java - Authentication → JWT Tokens: uses tokens
src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java - Authentication → Refresh Tokens: manages refresh
src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java - Authentication → OTP Verification: uses OTP
src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java - Authentication → Customer Records: looks up customer
src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java - Authentication → Staff Accounts: checks staff
src/main/java/kg/barbernotes/barbernotes/common/security/auth/AuthService.java - Telegram User → Telegram Bot: sends updates