# villasc4/tudentaria architecture

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

- Interactive diagram: https://gitdiagram.com/villasc4/tudentaria
- Repository: https://github.com/villasc4/tudentaria

## Overview

TuDentaria is a dental-clinic management system with an Angular client and a Spring Boot backend that also retains its original Thymeleaf pages. The main user flow is browsing clinic information, registering or signing in, submitting a dental appointment request, and managing appointments; administrators maintain appointments, doctors, treatments, and accounts. The backend separates HTTP controllers, business services, and persistence. The README documents security, role-based administration, and responsive public pages; many Angular-to-backend and backend controller routes are not shown in the sampled source, so those links are marked unverified.

Main entry points: [`frontend/src/app/app.routes.ts`](https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/app.routes.ts) (Page routing), [`src/main/java/com/utp/tudentaria/controller`](https://github.com/villasc4/tudentaria/tree/main/src/main/java/com/utp/tudentaria/controller) (REST controllers), [`frontend/src/app/core/api.service.ts`](https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/core/api.service.ts) (HTTP API client), [`src/main/java/com/utp/tudentaria/service/UsuarioService.java`](https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/UsuarioService.java) (Account management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_angular["Angular application<br/>[main.ts]"]
  node_routes["Page routing<br/>[app.routes.ts]"]
  node_api_client["HTTP API client<br/>[api.service.ts]"]
  node_auth_client["Session and roles<br/>[auth.service.ts]"]
end

subgraph group_user["Patient and public workflows"]
  node_public_pages["Clinic information"]
  node_registration["Account registration<br/>[registro.ts]"]
  node_login["Sign in<br/>[login.ts]"]
  node_booking["Appointment request<br/>[cita-form.ts]"]
  node_appointments["My appointments<br/>[mis-citas.ts]"]
  node_profile["Patient profile<br/>[perfil.ts]"]
end

subgraph group_admin["Clinic administration"]
  node_admin_ui["Admin workspace"]
end

subgraph group_backend["Spring backend"]
  node_rest_api["REST controllers"]
  node_legacy_public["Thymeleaf public flow"]
  node_auth_backend["Authentication services"]
  node_user_service["Account management"]
  node_appointment_service["Appointment management<br/>[CitaService.java]"]
  node_doctor_service["Doctor management<br/>[DoctorService.java]"]
  node_treatment_service["Treatment management"]
  node_upload_service["Image uploads"]
end

subgraph group_data["Domain and persistence"]
  node_domain["Clinic domain entities<br/>[Cita.java]"]
  node_user_entity["User and patient entities<br/>[Usuario.java]"]
  node_doctor_entity["Doctor entity<br/>[Doctor.java]"]
  node_repositories["JPA repositories"]
  node_database[("Relational database")]
end

node_visitor(("Visitor or patient"))
node_admin_actor(("Clinic administrator"))

node_visitor -->|"uses"| node_angular
node_admin_actor -->|"uses"| node_angular
node_angular -->|"starts"| node_routes
node_routes -->|"routes to"| node_public_pages
node_routes -->|"routes to"| node_registration
node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_booking
node_routes -->|"routes to"| node_appointments
node_routes -->|"routes to"| node_profile
node_routes -->|"guards routes"| node_admin_ui
node_registration -.->|"submits via"| node_api_client
node_booking -->|"submits via"| node_api_client
node_appointments -.->|"loads via"| node_api_client
node_profile -.->|"loads via"| node_api_client
node_admin_ui -.->|"manages via"| node_api_client
node_login -.->|"authenticates via"| node_auth_client
node_api_client -.->|"calls REST"| node_rest_api
node_auth_client -.->|"requests login"| node_rest_api
node_visitor -.->|"submits requests"| node_legacy_public
node_legacy_public -->|"requests appointment"| node_appointment_service
node_legacy_public -->|"registers account"| node_user_service
node_rest_api -.->|"delegates"| node_appointment_service
node_rest_api -.->|"delegates"| node_user_service
node_rest_api -.->|"delegates"| node_doctor_service
node_rest_api -.->|"delegates"| node_treatment_service
node_rest_api -.->|"uploads images"| node_upload_service
node_user_service -->|"reads and writes"| node_repositories
node_user_service -->|"updates"| node_user_entity
node_user_service -.->|"persists accounts"| node_database
node_appointment_service -.->|"persists appointments"| node_repositories
node_doctor_service -.->|"persists doctors"| node_repositories
node_treatment_service -.->|"persists treatments"| node_repositories
node_repositories -.->|"queries"| node_database
node_upload_service -.->|"stores image files"| node_visitor

click node_angular "https://github.com/villasc4/tudentaria/blob/main/frontend/src/main.ts"
click node_routes "https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/app.routes.ts"
click node_api_client "https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/core/api.service.ts"
click node_auth_client "https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/core/auth.service.ts"
click node_public_pages "https://github.com/villasc4/tudentaria/tree/main/frontend/src/app/features/public"
click node_registration "https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/features/auth/registro.ts"
click node_login "https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/features/auth/login.ts"
click node_booking "https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/features/citas/cita-form.ts"
click node_appointments "https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/features/citas/mis-citas.ts"
click node_profile "https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/features/perfil/perfil.ts"
click node_admin_ui "https://github.com/villasc4/tudentaria/tree/main/frontend/src/app/features/admin"
click node_rest_api "https://github.com/villasc4/tudentaria/tree/main/src/main/java/com/utp/tudentaria/controller"
click node_legacy_public "https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/controller/PublicController.java"
click node_auth_backend "https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/CustomUserDetailsService.java"
click node_user_service "https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/UsuarioService.java"
click node_appointment_service "https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/CitaService.java"
click node_doctor_service "https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/DoctorService.java"
click node_treatment_service "https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/TratamientoService.java"
click node_upload_service "https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/UploadFileService.java"
click node_domain "https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/model/Cita.java"
click node_user_entity "https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/model/Usuario.java"
click node_doctor_entity "https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/model/Doctor.java"
click node_repositories "https://github.com/villasc4/tudentaria/tree/main/src/main/java/com/utp/tudentaria/repository"

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_angular,node_routes,node_api_client,node_auth_client toneBlue
class node_public_pages,node_registration,node_login,node_booking,node_appointments,node_profile toneAmber
class node_admin_ui toneMint
class node_rest_api,node_legacy_public,node_auth_backend,node_user_service,node_appointment_service,node_doctor_service,node_treatment_service,node_upload_service toneRose
class node_domain,node_user_entity,node_doctor_entity,node_repositories,node_database,node_visitor,node_admin_actor toneIndigo
```

## Components

### Angular client

- [Angular application](https://github.com/villasc4/tudentaria/blob/main/frontend/src/main.ts): `frontend/src/main.ts`
- [Page routing](https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [HTTP API client](https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/core/api.service.ts): `frontend/src/app/core/api.service.ts`
- [Session and roles](https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/core/auth.service.ts): `frontend/src/app/core/auth.service.ts`

### Patient and public workflows

- [Clinic information](https://github.com/villasc4/tudentaria/tree/main/frontend/src/app/features/public): `frontend/src/app/features/public`
- [Account registration](https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/features/auth/registro.ts): `frontend/src/app/features/auth/registro.ts`
- [Sign in](https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/features/auth/login.ts): `frontend/src/app/features/auth/login.ts`
- [Appointment request](https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/features/citas/cita-form.ts): `frontend/src/app/features/citas/cita-form.ts`
- [My appointments](https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/features/citas/mis-citas.ts): `frontend/src/app/features/citas/mis-citas.ts`
- [Patient profile](https://github.com/villasc4/tudentaria/blob/main/frontend/src/app/features/perfil/perfil.ts): `frontend/src/app/features/perfil/perfil.ts`

### Clinic administration

- [Admin workspace](https://github.com/villasc4/tudentaria/tree/main/frontend/src/app/features/admin): `frontend/src/app/features/admin`

### Spring backend

- [REST controllers](https://github.com/villasc4/tudentaria/tree/main/src/main/java/com/utp/tudentaria/controller): `src/main/java/com/utp/tudentaria/controller`
- [Thymeleaf public flow](https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/controller/PublicController.java): `src/main/java/com/utp/tudentaria/controller/PublicController.java`
- [Authentication services](https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/CustomUserDetailsService.java): `src/main/java/com/utp/tudentaria/service/CustomUserDetailsService.java`
- [Account management](https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/UsuarioService.java): `src/main/java/com/utp/tudentaria/service/UsuarioService.java`
- [Appointment management](https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/CitaService.java): `src/main/java/com/utp/tudentaria/service/CitaService.java`
- [Doctor management](https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/DoctorService.java): `src/main/java/com/utp/tudentaria/service/DoctorService.java`
- [Treatment management](https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/TratamientoService.java): `src/main/java/com/utp/tudentaria/service/TratamientoService.java`
- [Image uploads](https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/service/UploadFileService.java): `src/main/java/com/utp/tudentaria/service/UploadFileService.java`

### Domain and persistence

- [Clinic domain entities](https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/model/Cita.java): `src/main/java/com/utp/tudentaria/model/Cita.java`
- [User and patient entities](https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/model/Usuario.java): `src/main/java/com/utp/tudentaria/model/Usuario.java`
- [Doctor entity](https://github.com/villasc4/tudentaria/blob/main/src/main/java/com/utp/tudentaria/model/Doctor.java): `src/main/java/com/utp/tudentaria/model/Doctor.java`
- [JPA repositories](https://github.com/villasc4/tudentaria/tree/main/src/main/java/com/utp/tudentaria/repository): `src/main/java/com/utp/tudentaria/repository`
- **Relational database**

### Other components

- **Visitor or patient**
- **Clinic administrator**

## Connections

- Visitor or patient → Angular application: uses
- Clinic administrator → Angular application: uses
- Angular application → Page routing: starts (evidence: `frontend/src/main.ts`)
- Page routing → Clinic information: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Page routing → Account registration: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Page routing → Sign in: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Page routing → Appointment request: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Page routing → My appointments: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Page routing → Patient profile: routes to (evidence: `frontend/src/app/app.routes.ts`)
- Page routing → Admin workspace: guards routes (evidence: `frontend/src/app/app.routes.ts`)
- Account registration → HTTP API client: submits via
- Appointment request → HTTP API client: submits via (evidence: `frontend/src/app/features/citas/cita-form.ts`)
- My appointments → HTTP API client: loads via
- Patient profile → HTTP API client: loads via (evidence: `frontend/src/app/features/perfil/perfil.ts`)
- Admin workspace → HTTP API client: manages via (evidence: `frontend/src/app/features/admin/doctores.ts`)
- Sign in → Session and roles: authenticates via
- HTTP API client → REST controllers: calls REST
- Session and roles → REST controllers: requests login
- Visitor or patient → Thymeleaf public flow: submits requests
- Thymeleaf public flow → Appointment management: requests appointment (evidence: `src/main/java/com/utp/tudentaria/controller/PublicController.java`)
- Thymeleaf public flow → Account management: registers account (evidence: `src/main/java/com/utp/tudentaria/controller/PublicController.java`)
- REST controllers → Appointment management: delegates (evidence: `src/main/java/com/utp/tudentaria/controller/PublicController.java`)
- REST controllers → Account management: delegates (evidence: `src/main/java/com/utp/tudentaria/controller/PublicController.java`)
- REST controllers → Doctor management: delegates (evidence: `src/main/java/com/utp/tudentaria/controller/PublicController.java`)
- REST controllers → Treatment management: delegates (evidence: `src/main/java/com/utp/tudentaria/controller/PublicController.java`)
- REST controllers → Image uploads: uploads images (evidence: `src/main/java/com/utp/tudentaria/controller/AdminDoctorController.java`)
- Account management → JPA repositories: reads and writes (evidence: `src/main/java/com/utp/tudentaria/service/UsuarioService.java`)
- Account management → User and patient entities: updates (evidence: `src/main/java/com/utp/tudentaria/service/UsuarioService.java`)
- Account management → Relational database: persists accounts
- Appointment management → JPA repositories: persists appointments
- Doctor management → JPA repositories: persists doctors
- Treatment management → JPA repositories: persists treatments
- JPA repositories → Relational database: queries
- Image uploads → Visitor or patient: stores image files
