How mt1504-coffee/backend works
Aseo UCP Backend is a Spring API for bathroom cleaning operations: users authenticate, submit cleaning records and incident reports, and administrators can review incidents and update their status. The API also supports user management, photo uploads, and password-reset email. The diagram follows the documented controller/service boundaries and the indexed repository, security, and notification references. Some implementations and configuration wiring were not excerpted, so their relationships are omitted or marked unverified rather than assumed.
Main entry points: repository Persistence repositories · AuthServiceImpl.java Authentication service · dto API data contracts · AuthController.java Authentication API
Components 28
API workflows
- Authentication API
src/main/java/com/ucp/aseo_ucp_backend/controller/AuthController.java - Bathroom API
src/main/java/com/ucp/aseo_ucp_backend/controller/BathroomController.java - Cleaning API
src/main/java/com/ucp/aseo_ucp_backend/controller/CleaningActivityController.java - Incident API
src/main/java/com/ucp/aseo_ucp_backend/controller/IncidentController.java - User API
src/main/java/com/ucp/aseo_ucp_backend/controller/UserController.java - API data contracts
src/main/java/com/ucp/aseo_ucp_backend/dto - File API
src/main/java/com/ucp/aseo_ucp_backend/controller/FileController.java - Exception handling
src/main/java/com/ucp/aseo_ucp_backend/exception/GlobalExceptionHandler.java
Cleaning domain
- Cleaning service
src/main/java/com/ucp/aseo_ucp_backend/service/impl/CleaningActivityServiceImpl.java - Bathroom service
src/main/java/com/ucp/aseo_ucp_backend/service/impl/BathroomServiceImpl.java - Incident service
src/main/java/com/ucp/aseo_ucp_backend/service/impl/IncidentServiceImpl.java - User records
src/main/java/com/ucp/aseo_ucp_backend/entity/User.java - Bathroom records
src/main/java/com/ucp/aseo_ucp_backend/entity/Bathroom.java - Cleaning records
src/main/java/com/ucp/aseo_ucp_backend/entity/CleaningActivity.java - Incident records
src/main/java/com/ucp/aseo_ucp_backend/entity/Incident.java - Persistence repositories
src/main/java/com/ucp/aseo_ucp_backend/repository
Identity and security
- Authentication service
src/main/java/com/ucp/aseo_ucp_backend/service/impl/AuthServiceImpl.java - User service
src/main/java/com/ucp/aseo_ucp_backend/service/impl/UserServiceImpl.java - JWT security
src/main/java/com/ucp/aseo_ucp_backend/security - User lookup
src/main/java/com/ucp/aseo_ucp_backend/security/UserDetailsServiceImpl.java
Storage and notifications
- File storage service
src/main/java/com/ucp/aseo_ucp_backend/service/FileStorageService.java - Local file storage
src/main/java/com/ucp/aseo_ucp_backend/service/impl/FileStorageServiceImpl.java - Cloudinary storage
src/main/java/com/ucp/aseo_ucp_backend/service/impl/CloudinaryFileStorageServiceImpl.java - Email service
src/main/java/com/ucp/aseo_ucp_backend/service/impl/EmailServiceImpl.java
Other components
- API client
- Relational database
- Cloudinary
- Email provider
Connections 34
- API client → Authentication API: calls
src/main/java/com/ucp/aseo_ucp_backend/controller/AuthController.java - API client → Bathroom API: calls
src/main/java/com/ucp/aseo_ucp_backend/controller/BathroomController.java - API client → Cleaning API: calls
src/main/java/com/ucp/aseo_ucp_backend/controller/CleaningActivityController.java - API client → Incident API: calls
src/main/java/com/ucp/aseo_ucp_backend/controller/IncidentController.java - API client → User API: calls
src/main/java/com/ucp/aseo_ucp_backend/controller/UserController.java - Authentication API → Authentication service: delegates to
src/main/java/com/ucp/aseo_ucp_backend/controller/AuthController.java - Bathroom API → Bathroom service: delegates to
src/main/java/com/ucp/aseo_ucp_backend/controller/BathroomController.java - Cleaning API → Cleaning service: delegates to
src/main/java/com/ucp/aseo_ucp_backend/controller/CleaningActivityController.java - Incident API → Incident service: delegates to
src/main/java/com/ucp/aseo_ucp_backend/controller/IncidentController.java - User API → User service: delegates to
src/main/java/com/ucp/aseo_ucp_backend/controller/UserController.java - Authentication API → API data contracts: accepts and returns
src/main/java/com/ucp/aseo_ucp_backend/controller/AuthController.java - Cleaning API → API data contracts: uses
src/main/java/com/ucp/aseo_ucp_backend/controller/CleaningActivityController.java - Incident API → API data contracts: uses
src/main/java/com/ucp/aseo_ucp_backend/controller/IncidentController.java - User API → API data contracts: returns
src/main/java/com/ucp/aseo_ucp_backend/controller/UserController.java - Cleaning service → Persistence repositories: persists via
- Incident service → Persistence repositories: persists via
- Bathroom service → Persistence repositories: persists via
- User service → Persistence repositories: persists via
- Persistence repositories → Relational database: reads and writes
- Cleaning records → User records: references
src/main/java/com/ucp/aseo_ucp_backend/entity/CleaningActivity.java - Cleaning records → Bathroom records: references
src/main/java/com/ucp/aseo_ucp_backend/entity/CleaningActivity.java - Incident records → User records: references
src/main/java/com/ucp/aseo_ucp_backend/entity/Incident.java - Incident records → Bathroom records: references
src/main/java/com/ucp/aseo_ucp_backend/entity/Incident.java - File API → File storage service: delegates to
src/main/java/com/ucp/aseo_ucp_backend/controller/FileController.java - File storage service → Local file storage: implemented by
src/main/java/com/ucp/aseo_ucp_backend/service/impl/FileStorageServiceImpl.java - File storage service → Cloudinary storage: implemented by
src/main/java/com/ucp/aseo_ucp_backend/service/impl/CloudinaryFileStorageServiceImpl.java - Cloudinary storage → Cloudinary: uploads to
src/main/java/com/ucp/aseo_ucp_backend/service/impl/CloudinaryFileStorageServiceImpl.java - Authentication service → Persistence repositories: uses
src/main/java/com/ucp/aseo_ucp_backend/service/impl/AuthServiceImpl.java - Authentication service → JWT security: creates tokens
src/main/java/com/ucp/aseo_ucp_backend/service/impl/AuthServiceImpl.java - JWT security → User lookup: loads users
- User lookup → Persistence repositories: looks up users
src/main/java/com/ucp/aseo_ucp_backend/security/UserDetailsServiceImpl.java - Authentication service → Email service: requests reset email
src/main/java/com/ucp/aseo_ucp_backend/service/impl/AuthServiceImpl.java - Email service → Email provider: sends messages
- Exception handling → API client: returns errors