How jm-ortega/piedrazul-agendamiento-citas works
Piedra Azul is a role-based clinic appointment platform. Patients or clinic staff initiate scheduling through the Angular SPA; the Spring API provides appointment availability and booking, while doctors and administrators use related agenda, management, and reporting capabilities. The backend is a modular monolith with PostgreSQL persistence and locally validated Keycloak-issued JWTs. The README documents the main product capabilities and system boundaries; sampled source also shows role-aware frontend navigation and patient, doctor, and notification service responsibilities, but does not expose enough wiring to assert most internal calls.
Main entry points: backend REST API · app Role-based SPA · AppointmentController.java Appointment API · application Scheduling rules
Components 18
Web experience
- Role-based SPA
frontend/src/app - Role routes
frontend/src/app/app.routes.ts - Booking UI state
frontend/src/app/features/appointment/services
Appointment lifecycle
- REST API
backend/src/main/java/co/edu/unicauca/piedrazul/backend - Appointment API
backend/src/main/java/co/edu/unicauca/piedrazul/backend/appointment/infrastructure/api/AppointmentController.java - Scheduling rules
backend/src/main/java/co/edu/unicauca/piedrazul/backend/appointment/application - Appointment data
backend/src/main/java/co/edu/unicauca/piedrazul/backend/appointment/infrastructure/persistence
Clinic operations
- Patient management
backend/src/main/java/co/edu/unicauca/piedrazul/backend/patients/application/PatientService.java - Doctor and schedules
backend/src/main/java/co/edu/unicauca/piedrazul/backend/doctors/application/DoctorService.java - User administration
backend/src/main/java/co/edu/unicauca/piedrazul/backend/user/application/UserService.java - Reports and statistics
backend/src/main/java/co/edu/unicauca/piedrazul/backend/report/application - Audit queries
backend/src/main/java/co/edu/unicauca/piedrazul/backend/audit/application
Identity and messaging
- Account verification
backend/src/main/java/co/edu/unicauca/piedrazul/backend/verification - Notifications
backend/src/main/java/co/edu/unicauca/piedrazul/backend/notifications/application/NotificationDispatcherService.java - Keycloak identity
infra/keycloak - PostgreSQL
Other components
- Patient
- Clinic staff
Connections 18
- Patient → Role-based SPA: uses
README.md - Clinic staff → Role-based SPA: uses
README.md - Role-based SPA → Keycloak identity: signs in via OIDC
README.md - Role-based SPA → REST API: sends bearer requests
README.md - Role-based SPA → Role routes: loads role routes
frontend/src/app/app.routes.ts - Role-based SPA → Booking UI state: supports booking
frontend/src/app/features/appointment/services/bookingState.service.ts - REST API → Appointment API: exposes appointments
README.md - REST API → PostgreSQL: persists business data
README.md - REST API → Keycloak identity: validates JWT keys
README.md - Appointment API → Scheduling rules: handles scheduling
- Scheduling rules → Appointment data: stores appointments
backend/src/main/java/co/edu/unicauca/piedrazul/backend/appointment/application/AppointmentSchedulingService.java - REST API → Patient management: supports patient workflows
README.md - REST API → Doctor and schedules: supports doctor workflows
README.md - REST API → User administration: supports administration
README.md - REST API → Reports and statistics: provides reports
README.md - REST API → Audit queries: provides audit events
README.md - REST API → Account verification: verifies account links
README.md - REST API → Notifications: sends reminders
README.md