# ascyazilim/lina-clinic architecture

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

- Interactive diagram: https://gitdiagram.com/ascyazilim/lina-clinic
- Repository: https://github.com/ascyazilim/lina-clinic

## Overview

Lina Clinic is a beauty-clinic information site and appointment-management system. The main user journey is browsing services, choosing a date and available slot, submitting a privacy-consented appointment request, and having clinic staff manage its status in the admin panel. The backend is a modular monolith covering appointments, treatments, staff, working hours, authentication, and shared security. The graph reflects documented API and product flows; some controller and frontend implementation links are based on README documentation because those sources were not excerpted.

Main entry points: [`frontend/lina-clinic-web/src/pages/ServicesPage.tsx`](https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/pages/ServicesPage.tsx) (Service Views), [`backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/PublicAppointmentService.java`](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/PublicAppointmentService.java) (Slot and Booking Logic), [`backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/AdminAppointmentService.java`](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/AdminAppointmentService.java) (Admin Status Logic), [`backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/service/AuthService.java`](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/service/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Public Website"]
  node_router["Page Router<br/>[AppRouter.tsx]"]
  node_publicpages["Public Pages"]
  node_appointmentpage["Appointment Form"]
  node_httpclient["API Client<br/>[client.ts]"]
end

subgraph group_catalog["Service Catalog"]
  node_serviceviews["Service Views<br/>[ServicesPage.tsx]"]
  node_servicecatalog["Service Catalog Data<br/>[serviceCatalog.ts]"]
  node_servicemedia["Service Media<br/>[ServiceMedia.tsx]"]
  node_publictreatmentapi["Public Treatment API"]
  node_treatmentservice["Treatment Service"]
end

subgraph group_booking["Appointment Booking"]
  node_appointmentformapi["Public Appointment API"]
  node_bookinglogic["Slot and Booking Logic"]
  node_appointments[("Appointment Records<br/>[Appointment.java]")]
  node_appointmentrepo["Appointment Repository"]
end

subgraph group_admin["Admin and Auth"]
  node_adminpage["Admin Appointment Page"]
  node_adminapi["Admin Appointment API"]
  node_adminlogic["Admin Status Logic"]
  node_authapi["Login API"]
  node_authlogic["Authentication<br/>[AuthService.java]"]
  node_jwt["JWT Service<br/>[JwtService.java]"]
  node_userdetails["User Lookup"]
  node_users[("User Records")]
end

subgraph group_domain["Clinic Domain"]
  node_scheduledata["Staff and Hours"]
end

node_visitor(("Clinic Visitor"))
node_adminuser(("Clinic Admin"))

node_visitor -->|"browses"| node_router
node_router -->|"routes to"| node_publicpages
node_publicpages -.->|"shows services"| node_serviceviews
node_serviceviews -->|"reads catalog"| node_servicecatalog
node_serviceviews -->|"renders media"| node_servicemedia
node_visitor -->|"explores treatments"| node_serviceviews
node_serviceviews -.->|"requests treatments"| node_publictreatmentapi
node_publictreatmentapi -.->|"delegates to"| node_treatmentservice
node_visitor -->|"requests appointment"| node_appointmentpage
node_appointmentpage -.->|"submits request"| node_httpclient
node_httpclient -.->|"calls API"| node_appointmentformapi
node_appointmentformapi -.->|"delegates to"| node_bookinglogic
node_bookinglogic -->|"checks availability"| node_scheduledata
node_bookinglogic -->|"checks conflicts"| node_appointmentrepo
node_bookinglogic -->|"saves appointment"| node_appointments
node_appointmentrepo -.->|"persists"| node_appointments
node_adminuser -->|"manages bookings"| node_adminpage
node_adminpage -.->|"requests actions"| node_adminapi
node_adminapi -.->|"delegates to"| node_adminlogic
node_adminlogic -->|"reads appointments"| node_appointmentrepo
node_adminlogic -->|"updates status"| node_appointments
node_adminuser -->|"logs in"| node_authapi
node_authapi -.->|"delegates to"| node_authlogic
node_authlogic -->|"generates token"| node_jwt
node_authlogic -.->|"authenticates via"| node_userdetails
node_userdetails -->|"loads user"| node_users

click node_router "https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/router/AppRouter.tsx"
click node_publicpages "https://github.com/ascyazilim/lina-clinic/tree/main/frontend/lina-clinic-web/src/pages"
click node_appointmentpage "https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/pages/AppointmentPage.tsx"
click node_httpclient "https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/api/client.ts"
click node_serviceviews "https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/pages/ServicesPage.tsx"
click node_servicecatalog "https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/components/services/serviceCatalog.ts"
click node_servicemedia "https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/components/services/ServiceMedia.tsx"
click node_publictreatmentapi "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/treatment/controller/PublicTreatmentController.java"
click node_treatmentservice "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/treatment/service/PublicTreatmentService.java"
click node_appointmentformapi "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/controller/PublicAppointmentController.java"
click node_bookinglogic "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/PublicAppointmentService.java"
click node_appointments "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/entity/Appointment.java"
click node_appointmentrepo "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/repository/AppointmentRepository.java"
click node_scheduledata "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/workinghour/repository/WorkingHourRepository.java"
click node_adminpage "https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/pages/AdminAppointmentsPage.tsx"
click node_adminapi "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/controller/AdminAppointmentController.java"
click node_adminlogic "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/AdminAppointmentService.java"
click node_authapi "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/controller/AuthController.java"
click node_authlogic "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/service/AuthService.java"
click node_jwt "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/common/security/JwtService.java"
click node_userdetails "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/common/security/CustomUserDetailsService.java"
click node_users "https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/repository/UserRepository.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_router,node_publicpages,node_appointmentpage,node_httpclient toneBlue
class node_serviceviews,node_servicecatalog,node_servicemedia,node_publictreatmentapi,node_treatmentservice toneAmber
class node_appointmentformapi,node_bookinglogic,node_appointments,node_appointmentrepo toneMint
class node_adminpage,node_adminapi,node_adminlogic,node_authapi,node_authlogic,node_jwt,node_userdetails,node_users toneRose
class node_scheduledata,node_visitor,node_adminuser toneIndigo
```

## Components

### Public Website

- [Page Router](https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/router/AppRouter.tsx): `frontend/lina-clinic-web/src/router/AppRouter.tsx`
- [Public Pages](https://github.com/ascyazilim/lina-clinic/tree/main/frontend/lina-clinic-web/src/pages): `frontend/lina-clinic-web/src/pages`
- [Appointment Form](https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/pages/AppointmentPage.tsx): `frontend/lina-clinic-web/src/pages/AppointmentPage.tsx`
- [API Client](https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/api/client.ts): `frontend/lina-clinic-web/src/api/client.ts`

### Service Catalog

- [Service Views](https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/pages/ServicesPage.tsx): `frontend/lina-clinic-web/src/pages/ServicesPage.tsx`
- [Service Catalog Data](https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/components/services/serviceCatalog.ts): `frontend/lina-clinic-web/src/components/services/serviceCatalog.ts`
- [Service Media](https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/components/services/ServiceMedia.tsx): `frontend/lina-clinic-web/src/components/services/ServiceMedia.tsx`
- [Public Treatment API](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/treatment/controller/PublicTreatmentController.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/treatment/controller/PublicTreatmentController.java`
- [Treatment Service](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/treatment/service/PublicTreatmentService.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/treatment/service/PublicTreatmentService.java`

### Appointment Booking

- [Public Appointment API](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/controller/PublicAppointmentController.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/controller/PublicAppointmentController.java`
- [Slot and Booking Logic](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/PublicAppointmentService.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/PublicAppointmentService.java`
- [Appointment Records](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/entity/Appointment.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/entity/Appointment.java`
- [Appointment Repository](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/repository/AppointmentRepository.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/repository/AppointmentRepository.java`

### Admin and Auth

- [Admin Appointment Page](https://github.com/ascyazilim/lina-clinic/blob/main/frontend/lina-clinic-web/src/pages/AdminAppointmentsPage.tsx): `frontend/lina-clinic-web/src/pages/AdminAppointmentsPage.tsx`
- [Admin Appointment API](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/controller/AdminAppointmentController.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/controller/AdminAppointmentController.java`
- [Admin Status Logic](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/AdminAppointmentService.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/AdminAppointmentService.java`
- [Login API](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/controller/AuthController.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/controller/AuthController.java`
- [Authentication](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/service/AuthService.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/service/AuthService.java`
- [JWT Service](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/common/security/JwtService.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/common/security/JwtService.java`
- [User Lookup](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/common/security/CustomUserDetailsService.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/common/security/CustomUserDetailsService.java`
- [User Records](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/repository/UserRepository.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/repository/UserRepository.java`

### Clinic Domain

- [Staff and Hours](https://github.com/ascyazilim/lina-clinic/blob/main/backend/lina-clinic-api/src/main/java/com/lina/clinic/workinghour/repository/WorkingHourRepository.java): `backend/lina-clinic-api/src/main/java/com/lina/clinic/workinghour/repository/WorkingHourRepository.java`

### Other components

- **Clinic Visitor**
- **Clinic Admin**

## Connections

- Clinic Visitor → Page Router: browses (evidence: `README.md`)
- Page Router → Public Pages: routes to (evidence: `frontend/lina-clinic-web/src/router/AppRouter.tsx`)
- Public Pages → Service Views: shows services
- Service Views → Service Catalog Data: reads catalog (evidence: `frontend/lina-clinic-web/src/pages/ServicesPage.tsx`)
- Service Views → Service Media: renders media
- Clinic Visitor → Service Views: explores treatments (evidence: `README.md`)
- Service Views → Public Treatment API: requests treatments (evidence: `README.md`)
- Public Treatment API → Treatment Service: delegates to (evidence: `README.md`)
- Clinic Visitor → Appointment Form: requests appointment (evidence: `README.md`)
- Appointment Form → API Client: submits request (evidence: `README.md`)
- API Client → Public Appointment API: calls API (evidence: `README.md`)
- Public Appointment API → Slot and Booking Logic: delegates to (evidence: `README.md`)
- Slot and Booking Logic → Staff and Hours: checks availability (evidence: `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/PublicAppointmentService.java`)
- Slot and Booking Logic → Appointment Repository: checks conflicts (evidence: `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/PublicAppointmentService.java`)
- Slot and Booking Logic → Appointment Records: saves appointment (evidence: `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/PublicAppointmentService.java`)
- Appointment Repository → Appointment Records: persists (evidence: `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/repository/AppointmentRepository.java`)
- Clinic Admin → Admin Appointment Page: manages bookings (evidence: `README.md`)
- Admin Appointment Page → Admin Appointment API: requests actions (evidence: `README.md`)
- Admin Appointment API → Admin Status Logic: delegates to (evidence: `README.md`)
- Admin Status Logic → Appointment Repository: reads appointments (evidence: `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/AdminAppointmentService.java`)
- Admin Status Logic → Appointment Records: updates status (evidence: `backend/lina-clinic-api/src/main/java/com/lina/clinic/appointment/service/AdminAppointmentService.java`)
- Clinic Admin → Login API: logs in (evidence: `README.md`)
- Login API → Authentication: delegates to (evidence: `README.md`)
- Authentication → JWT Service: generates token (evidence: `backend/lina-clinic-api/src/main/java/com/lina/clinic/auth/service/AuthService.java`)
- Authentication → User Lookup: authenticates via
- User Lookup → User Records: loads user (evidence: `backend/lina-clinic-api/src/main/java/com/lina/clinic/common/security/CustomUserDetailsService.java`)
