How cibertec-courses/matricula-api works
matricula-api is a role-protected REST API for academic enrollment. Users authenticate, then students or administrators can quote and register courses in an open period, pay or cancel enrollments, and later view records; instructors record grades. The README also documents catalog and people administration, account/session security, and payment/history capabilities. Edges are limited to relationships visible in excerpts or README statements; unsampled controller and service wiring is represented conservatively, with the README supporting the broader domain branches.
Main entry points: MatriculaService.java Enrollment service · AlumnoService.java Student records · CursoService.java Course catalog · MatriculaRepository.java Enrollment store
Components 23
Identity and access
- Auth endpoints
src/main/java/pe/edu/cibertec/matricula_api/controller/AuthController.java - Authentication service
src/main/java/pe/edu/cibertec/matricula_api/service/AuthService.java - JWT security
src/main/java/pe/edu/cibertec/matricula_api/security/SecurityConfig.java - User accounts
src/main/java/pe/edu/cibertec/matricula_api/service/UsuarioService.java
Academic catalog
- Catalog endpoints
src/main/java/pe/edu/cibertec/matricula_api/controller/CursoController.java - Course catalog
src/main/java/pe/edu/cibertec/matricula_api/service/CursoService.java - Career management
src/main/java/pe/edu/cibertec/matricula_api/service/CarreraService.java - Period endpoints
src/main/java/pe/edu/cibertec/matricula_api/controller/PeriodoController.java - Academic periods
src/main/java/pe/edu/cibertec/matricula_api/service/PeriodoService.java
Enrollment lifecycle
- Enrollment endpoints
src/main/java/pe/edu/cibertec/matricula_api/controller/MatriculaController.java - Enrollment service
src/main/java/pe/edu/cibertec/matricula_api/service/MatriculaService.java - Enrollment pricing
src/main/java/pe/edu/cibertec/matricula_api/service/CalculadoraMatricula.java - Payment endpoints
src/main/java/pe/edu/cibertec/matricula_api/controller/PagoController.java - Payment records
src/main/java/pe/edu/cibertec/matricula_api/service/PagoService.java
Student and staff records
- Student endpoints
src/main/java/pe/edu/cibertec/matricula_api/controller/AlumnoController.java - Student records
src/main/java/pe/edu/cibertec/matricula_api/service/AlumnoService.java - Staff endpoints
src/main/java/pe/edu/cibertec/matricula_api/controller/DocenteController.java - Instructor records
src/main/java/pe/edu/cibertec/matricula_api/service/DocenteService.java
Persistence layer
- Enrollment store
src/main/java/pe/edu/cibertec/matricula_api/repository/MatriculaRepository.java - Course store
src/main/java/pe/edu/cibertec/matricula_api/repository/CursoRepository.java - API error mapping
src/main/java/pe/edu/cibertec/matricula_api/exception/GlobalExceptionHandler.java - Academic domain
src/main/java/pe/edu/cibertec/matricula_api/model/Matricula.java
Other components
- API caller
Connections 28
- API caller → Auth endpoints: requests login
README.md - Auth endpoints → Authentication service: delegates auth
src/main/java/pe/edu/cibertec/matricula_api/service/AuthService.java - API caller → Enrollment endpoints: requests enrollment
README.md - Enrollment endpoints → Enrollment service: delegates enrollment
src/main/java/pe/edu/cibertec/matricula_api/controller/MatriculaController.java - Enrollment service → Enrollment pricing: calculates quote
src/main/java/pe/edu/cibertec/matricula_api/service/MatriculaService.java - Enrollment service → Student records: loads student
src/main/java/pe/edu/cibertec/matricula_api/service/MatriculaService.java - Enrollment service → Course catalog: checks course
src/main/java/pe/edu/cibertec/matricula_api/service/MatriculaService.java - Enrollment service → Academic periods: checks open period
src/main/java/pe/edu/cibertec/matricula_api/service/MatriculaService.java - Enrollment service → Enrollment store: saves enrollments
src/main/java/pe/edu/cibertec/matricula_api/service/MatriculaService.java - Enrollment service → Payment records: creates payment
src/main/java/pe/edu/cibertec/matricula_api/service/MatriculaService.java - API caller → Catalog endpoints: browses catalog
README.md - Catalog endpoints → Course catalog: delegates course operations
src/main/java/pe/edu/cibertec/matricula_api/controller/CursoController.java - Course catalog → Course store: queries courses
src/main/java/pe/edu/cibertec/matricula_api/service/CursoService.java - Course catalog → Enrollment store: checks enrollment use
src/main/java/pe/edu/cibertec/matricula_api/service/CursoService.java - API caller → Period endpoints: manages periods
README.md - Period endpoints → Academic periods: delegates period operations
src/main/java/pe/edu/cibertec/matricula_api/controller/PeriodoController.java - Academic periods → Enrollment store: annuls pending enrollments
src/main/java/pe/edu/cibertec/matricula_api/service/PeriodoService.java - API caller → Student endpoints: requests student records
README.md - Student endpoints → Student records: delegates student operations
src/main/java/pe/edu/cibertec/matricula_api/controller/AlumnoController.java - Student records → Career management: resolves career
src/main/java/pe/edu/cibertec/matricula_api/service/AlumnoService.java - Student records → User accounts: creates account
src/main/java/pe/edu/cibertec/matricula_api/service/AlumnoService.java - Student records → Enrollment store: checks enrollments
src/main/java/pe/edu/cibertec/matricula_api/service/AlumnoService.java - API caller → Staff endpoints: manages instructors
README.md - Staff endpoints → Instructor records: delegates staff operations
README.md - API caller → Payment endpoints: requests payment records
README.md - Payment endpoints → Payment records: delegates payment queries
README.md - JWT security → Authentication service: validates sessions
README.md - Enrollment endpoints → API error mapping: returns API errors
README.md