# denzeldonsala/it342-sala-patupi architecture

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

- Interactive diagram: https://gitdiagram.com/denzeldonsala/it342-sala-patupi
- Repository: https://github.com/denzeldonsala/it342-sala-patupi

## Overview

Patupi is a barbershop booking and operations product, with a React web client, an Android app, and a Spring backend. Customers sign in, browse barbers/services, and book or review appointments; barbers manage availability and appointment status, while administrators manage bookings and shop data. The backend owns authentication, appointment and barber operations, and persistence. The excerpts show selected service and appointment logic, Android session handling, and route wiring; most web feature internals and backend controllers were not sampled, so their detailed interactions are omitted.

Main entry points: [`web/patupi/src/App.jsx`](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/App.jsx) (Web router), [`mobile/app/src/main/java/com/sala/patupi/LoginActivity.kt`](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/LoginActivity.kt) (Mobile login), [`mobile/app/src/main/java/com/sala/patupi/BarberPageActivity.kt`](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/BarberPageActivity.kt) (Barber workspace), [`backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentService.java`](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentService.java) (Appointment logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webapp["Web router<br/>[App.jsx]"]
  node_protected["Role guard<br/>[ProtectedRoute.jsx]"]
  node_webauth["Web authentication"]
  node_webprofile["Web profile<br/>[Profile.jsx]"]
  node_webbooking["Customer appointments<br/>[Dashboard.jsx]"]
  node_webadmin["Admin appointments<br/>[AdminDashboard.jsx]"]
  node_webhistory["Appointment history<br/>[AdminHistory.jsx]"]
  node_webbarbers["Barber directory<br/>[Barbers.jsx]"]
  node_webcustomers["Customer admin<br/>[AdminCustomer.jsx]"]
end

subgraph group_mobile["Android app"]
  node_mobilelogin["Mobile login<br/>[LoginActivity.kt]"]
  node_session["Session state<br/>[SessionManager.kt]"]
  node_mobilebooking["Mobile booking<br/>[BookingActivity.kt]"]
  node_mobiledashboard["Mobile dashboard"]
  node_barberworkspace["Barber workspace"]
end

subgraph group_backend["Backend services"]
  node_authapi["Authentication API"]
  node_authservice["Credential service<br/>[AuthService.java]"]
  node_appointmentapi["Appointment API"]
  node_appointmentservice["Appointment logic"]
  node_barberapi["Barber API"]
  node_barberservice["Barber operations<br/>[BarberService.java]"]
  node_email["Email delivery<br/>[EmailService.java]"]
end

subgraph group_data["Domain and persistence"]
  node_users[("User records<br/>[User.java]")]
  node_userrepo["User repository"]
  node_appointments[("Appointment records<br/>[Appointment.java]")]
  node_appointmentrepo["Appointment repository"]
  node_servicecatalog[("Service catalog<br/>[Service.java]")]
  node_servicerepo["Service repository"]
  node_barberprofile[("Barber profiles<br/>[BarberProfile.java]")]
  node_profilerepo["Profile repository"]
end

node_customer(("Customer"))
node_barber(("Barber"))
node_admin(("Administrator"))

node_customer -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_webauth
node_webapp -->|"guards routes"| node_protected
node_webapp -->|"routes to"| node_webprofile
node_webapp -->|"routes to"| node_webbooking
node_webapp -->|"routes to"| node_webadmin
node_webapp -->|"routes to"| node_webhistory
node_webapp -->|"routes to"| node_webbarbers
node_webapp -->|"routes to"| node_webcustomers
node_customer -->|"uses"| node_mobilelogin
node_barber -->|"uses"| node_barberworkspace
node_mobilelogin -->|"saves session"| node_session
node_mobilelogin -->|"posts credentials"| node_authapi
node_mobilelogin -->|"opens for barber"| node_barberworkspace
node_mobilelogin -->|"opens for customer"| node_mobiledashboard
node_mobiledashboard -->|"opens booking"| node_mobilebooking
node_barberworkspace -->|"reads session"| node_session
node_barberworkspace -->|"updates availability"| node_barberapi
node_barberworkspace -->|"updates status"| node_appointmentapi
node_authapi -->|"delegates"| node_authservice
node_authservice -->|"checks and saves"| node_userrepo
node_appointmentapi -->|"delegates"| node_appointmentservice
node_appointmentservice -->|"queries appointments"| node_appointmentrepo
node_appointmentservice -->|"looks up services"| node_servicerepo
node_appointmentservice -->|"looks up users"| node_userrepo
node_barberapi -->|"delegates"| node_barberservice
node_barberservice -->|"saves barber"| node_userrepo
node_barberservice -->|"saves profile"| node_profilerepo
node_userrepo -->|"persists"| node_users
node_appointmentrepo -.->|"persists"| node_appointments
node_servicerepo -.->|"persists"| node_servicecatalog
node_profilerepo -.->|"persists"| node_barberprofile

click node_webapp "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/App.jsx"
click node_protected "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/common/components/ProtectedRoute.jsx"
click node_webauth "https://github.com/denzeldonsala/it342-sala-patupi/tree/main/web/patupi/src/features/authentication"
click node_webprofile "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/authentication/Profile.jsx"
click node_webbooking "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/appointments/Dashboard.jsx"
click node_webadmin "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/appointments/AdminDashboard.jsx"
click node_webhistory "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/appointments/AdminHistory.jsx"
click node_webbarbers "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/services/Barbers.jsx"
click node_webcustomers "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/services/AdminCustomer.jsx"
click node_mobilelogin "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/LoginActivity.kt"
click node_session "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/SessionManager.kt"
click node_mobilebooking "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/BookingActivity.kt"
click node_mobiledashboard "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/DashboardActivity.kt"
click node_barberworkspace "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/BarberPageActivity.kt"
click node_authapi "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/AuthController.java"
click node_authservice "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/AuthService.java"
click node_appointmentapi "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentController.java"
click node_appointmentservice "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentService.java"
click node_barberapi "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberController.java"
click node_barberservice "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberService.java"
click node_email "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/Infrastructure/EmailService.java"
click node_users "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/User.java"
click node_userrepo "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/UserRepository.java"
click node_appointments "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/Appointment.java"
click node_appointmentrepo "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentRepository.java"
click node_servicecatalog "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/Service.java"
click node_servicerepo "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/ServiceRepository.java"
click node_barberprofile "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberProfile.java"
click node_profilerepo "https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberProfileRepository.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_webapp,node_protected,node_webauth,node_webprofile,node_webbooking,node_webadmin,node_webhistory,node_webbarbers,node_webcustomers toneBlue
class node_mobilelogin,node_session,node_mobilebooking,node_mobiledashboard,node_barberworkspace toneAmber
class node_authapi,node_authservice,node_appointmentapi,node_appointmentservice,node_barberapi,node_barberservice,node_email toneMint
class node_users,node_userrepo,node_appointments,node_appointmentrepo,node_servicecatalog,node_servicerepo,node_barberprofile,node_profilerepo toneRose
class node_customer,node_barber,node_admin toneIndigo
```

## Components

### Web experience

- [Web router](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/App.jsx): `web/patupi/src/App.jsx`
- [Role guard](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/common/components/ProtectedRoute.jsx): `web/patupi/src/common/components/ProtectedRoute.jsx`
- [Web authentication](https://github.com/denzeldonsala/it342-sala-patupi/tree/main/web/patupi/src/features/authentication): `web/patupi/src/features/authentication`
- [Web profile](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/authentication/Profile.jsx): `web/patupi/src/features/authentication/Profile.jsx`
- [Customer appointments](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/appointments/Dashboard.jsx): `web/patupi/src/features/appointments/Dashboard.jsx`
- [Admin appointments](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/appointments/AdminDashboard.jsx): `web/patupi/src/features/appointments/AdminDashboard.jsx`
- [Appointment history](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/appointments/AdminHistory.jsx): `web/patupi/src/features/appointments/AdminHistory.jsx`
- [Barber directory](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/services/Barbers.jsx): `web/patupi/src/features/services/Barbers.jsx`
- [Customer admin](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/web/patupi/src/features/services/AdminCustomer.jsx): `web/patupi/src/features/services/AdminCustomer.jsx`

### Android app

- [Mobile login](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/LoginActivity.kt): `mobile/app/src/main/java/com/sala/patupi/LoginActivity.kt`
- [Session state](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/SessionManager.kt): `mobile/app/src/main/java/com/sala/patupi/SessionManager.kt`
- [Mobile booking](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/BookingActivity.kt): `mobile/app/src/main/java/com/sala/patupi/BookingActivity.kt`
- [Mobile dashboard](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/DashboardActivity.kt): `mobile/app/src/main/java/com/sala/patupi/DashboardActivity.kt`
- [Barber workspace](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/mobile/app/src/main/java/com/sala/patupi/BarberPageActivity.kt): `mobile/app/src/main/java/com/sala/patupi/BarberPageActivity.kt`

### Backend services

- [Authentication API](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/AuthController.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/AuthController.java`
- [Credential service](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/AuthService.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/AuthService.java`
- [Appointment API](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentController.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentController.java`
- [Appointment logic](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentService.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentService.java`
- [Barber API](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberController.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberController.java`
- [Barber operations](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberService.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberService.java`
- [Email delivery](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/Infrastructure/EmailService.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/Infrastructure/EmailService.java`

### Domain and persistence

- [User records](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/User.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/User.java`
- [User repository](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/UserRepository.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/UserRepository.java`
- [Appointment records](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/Appointment.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/Appointment.java`
- [Appointment repository](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentRepository.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentRepository.java`
- [Service catalog](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/Service.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/Service.java`
- [Service repository](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/ServiceRepository.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/ServiceRepository.java`
- [Barber profiles](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberProfile.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberProfile.java`
- [Profile repository](https://github.com/denzeldonsala/it342-sala-patupi/blob/main/backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberProfileRepository.java): `backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberProfileRepository.java`

### Other components

- **Customer**
- **Barber**
- **Administrator**

## Connections

- Customer → Web router: uses (evidence: `web/patupi/src/App.jsx`)
- Web router → Web authentication: routes to (evidence: `web/patupi/src/App.jsx`)
- Web router → Role guard: guards routes (evidence: `web/patupi/src/App.jsx`)
- Web router → Web profile: routes to (evidence: `web/patupi/src/App.jsx`)
- Web router → Customer appointments: routes to (evidence: `web/patupi/src/App.jsx`)
- Web router → Admin appointments: routes to (evidence: `web/patupi/src/App.jsx`)
- Web router → Appointment history: routes to (evidence: `web/patupi/src/App.jsx`)
- Web router → Barber directory: routes to (evidence: `web/patupi/src/App.jsx`)
- Web router → Customer admin: routes to (evidence: `web/patupi/src/App.jsx`)
- Customer → Mobile login: uses (evidence: `mobile/app/src/main/java/com/sala/patupi/LoginActivity.kt`)
- Barber → Barber workspace: uses (evidence: `mobile/app/src/main/java/com/sala/patupi/BarberPageActivity.kt`)
- Mobile login → Session state: saves session (evidence: `mobile/app/src/main/java/com/sala/patupi/LoginActivity.kt`)
- Mobile login → Authentication API: posts credentials (evidence: `mobile/app/src/main/java/com/sala/patupi/LoginActivity.kt`)
- Mobile login → Barber workspace: opens for barber (evidence: `mobile/app/src/main/java/com/sala/patupi/LoginActivity.kt`)
- Mobile login → Mobile dashboard: opens for customer (evidence: `mobile/app/src/main/java/com/sala/patupi/LoginActivity.kt`)
- Mobile dashboard → Mobile booking: opens booking (evidence: `mobile/app/src/main/java/com/sala/patupi/DashboardActivity.kt`)
- Barber workspace → Session state: reads session (evidence: `mobile/app/src/main/java/com/sala/patupi/BarberPageActivity.kt`)
- Barber workspace → Barber API: updates availability (evidence: `mobile/app/src/main/java/com/sala/patupi/BarberPageActivity.kt`)
- Barber workspace → Appointment API: updates status (evidence: `mobile/app/src/main/java/com/sala/patupi/BarberPageActivity.kt`)
- Authentication API → Credential service: delegates (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/AuthController.java`)
- Credential service → User repository: checks and saves (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/AuthService.java`)
- Appointment API → Appointment logic: delegates (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentController.java`)
- Appointment logic → Appointment repository: queries appointments (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentService.java`)
- Appointment logic → Service repository: looks up services (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentService.java`)
- Appointment logic → User repository: looks up users (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentService.java`)
- Barber API → Barber operations: delegates (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberController.java`)
- Barber operations → User repository: saves barber (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberService.java`)
- Barber operations → Profile repository: saves profile (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberService.java`)
- User repository → User records: persists (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/authentication/UserRepository.java`)
- Appointment repository → Appointment records: persists (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/appointments/AppointmentRepository.java`)
- Service repository → Service catalog: persists (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/ServiceRepository.java`)
- Profile repository → Barber profiles: persists (evidence: `backend/patupi/src/main/java/edu/cit/sala/patupi/features/services/BarberProfileRepository.java`)
