How villasc4/tudentaria works
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: app.routes.ts Page routing · controller REST controllers · api.service.ts HTTP API client · UsuarioService.java Account management
Components 26
Angular client
- Angular application
frontend/src/main.ts - Page routing
frontend/src/app/app.routes.ts - HTTP API client
frontend/src/app/core/api.service.ts - Session and roles
frontend/src/app/core/auth.service.ts
Patient and public workflows
- Clinic information
frontend/src/app/features/public - Account registration
frontend/src/app/features/auth/registro.ts - Sign in
frontend/src/app/features/auth/login.ts - Appointment request
frontend/src/app/features/citas/cita-form.ts - My appointments
frontend/src/app/features/citas/mis-citas.ts - Patient profile
frontend/src/app/features/perfil/perfil.ts
Clinic administration
- Admin workspace
frontend/src/app/features/admin
Spring backend
- REST controllers
src/main/java/com/utp/tudentaria/controller - Thymeleaf public flow
src/main/java/com/utp/tudentaria/controller/PublicController.java - Authentication services
src/main/java/com/utp/tudentaria/service/CustomUserDetailsService.java - Account management
src/main/java/com/utp/tudentaria/service/UsuarioService.java - Appointment management
src/main/java/com/utp/tudentaria/service/CitaService.java - Doctor management
src/main/java/com/utp/tudentaria/service/DoctorService.java - Treatment management
src/main/java/com/utp/tudentaria/service/TratamientoService.java - Image uploads
src/main/java/com/utp/tudentaria/service/UploadFileService.java
Domain and persistence
- Clinic domain entities
src/main/java/com/utp/tudentaria/model/Cita.java - User and patient entities
src/main/java/com/utp/tudentaria/model/Usuario.java - Doctor entity
src/main/java/com/utp/tudentaria/model/Doctor.java - JPA repositories
src/main/java/com/utp/tudentaria/repository - Relational database
Other components
- Visitor or patient
- Clinic administrator
Connections 34
- Visitor or patient → Angular application: uses
- Clinic administrator → Angular application: uses
- Angular application → Page routing: starts
frontend/src/main.ts - Page routing → Clinic information: routes to
frontend/src/app/app.routes.ts - Page routing → Account registration: routes to
frontend/src/app/app.routes.ts - Page routing → Sign in: routes to
frontend/src/app/app.routes.ts - Page routing → Appointment request: routes to
frontend/src/app/app.routes.ts - Page routing → My appointments: routes to
frontend/src/app/app.routes.ts - Page routing → Patient profile: routes to
frontend/src/app/app.routes.ts - Page routing → Admin workspace: guards routes
frontend/src/app/app.routes.ts - Account registration → HTTP API client: submits via
- Appointment request → HTTP API client: submits via
frontend/src/app/features/citas/cita-form.ts - My appointments → HTTP API client: loads via
- Patient profile → HTTP API client: loads via
frontend/src/app/features/perfil/perfil.ts - Admin workspace → HTTP API client: manages via
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
src/main/java/com/utp/tudentaria/controller/PublicController.java - Thymeleaf public flow → Account management: registers account
src/main/java/com/utp/tudentaria/controller/PublicController.java - REST controllers → Appointment management: delegates
src/main/java/com/utp/tudentaria/controller/PublicController.java - REST controllers → Account management: delegates
src/main/java/com/utp/tudentaria/controller/PublicController.java - REST controllers → Doctor management: delegates
src/main/java/com/utp/tudentaria/controller/PublicController.java - REST controllers → Treatment management: delegates
src/main/java/com/utp/tudentaria/controller/PublicController.java - REST controllers → Image uploads: uploads images
src/main/java/com/utp/tudentaria/controller/AdminDoctorController.java - Account management → JPA repositories: reads and writes
src/main/java/com/utp/tudentaria/service/UsuarioService.java - Account management → User and patient entities: updates
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