How jose-antonio98/mastersys works
MasterSys is a Spring REST API for gym operations. The main workflow manages a student, creates and maintains their enrollment, attaches active modality plans, and generates and tracks enrollment invoices; separate endpoints provide operational and financial reports. The README describes the common HTTP controller-to-service-to-repository layering, while sampled services confirm key business rules and persistence calls. Scheduler and reporting capabilities are documented, but their implementation details were not sampled, so those connections are shown only where the README supports them.
Main entry points: FaturaMatriculaService.java Invoice Lifecycle · GlobalExceptionHandler.java Error Responses · MatriculaModalidadeService.java Enrollment Plan Links · MatriculaRepository.java Enrollment Repository
Components 26
Student Management
- Students API
src/main/java/dev/jose/mastersys/aluno/controller/AlunoController.java - Student Records
src/main/java/dev/jose/mastersys/aluno/service/AlunoService.java - Student Repository
src/main/java/dev/jose/mastersys/aluno/repository/AlunoRepository.java
Plans and Modalities
- Modalities API
src/main/java/dev/jose/mastersys/modalidade/controller/ModalidadeController.java - Modality Catalog
src/main/java/dev/jose/mastersys/modalidade/service/ModalidadeService.java - Modality Repository
src/main/java/dev/jose/mastersys/modalidade/repository/ModalidadeRepository.java - Plans API
src/main/java/dev/jose/mastersys/plano/controller/PlanoController.java - Plan Catalog
src/main/java/dev/jose/mastersys/plano/service/PlanoService.java - Plan Repository
src/main/java/dev/jose/mastersys/plano/repository/PlanosRepository.java
Enrollment Lifecycle
- Enrollment API
src/main/java/dev/jose/mastersys/matricula/controller/MatriculaController.java - Enrollment Lifecycle
src/main/java/dev/jose/mastersys/matricula/service/MatriculaService.java - Enrollment Repository
src/main/java/dev/jose/mastersys/matricula/repository/MatriculaRepository.java - Modality Links API
src/main/java/dev/jose/mastersys/matricula/controller/MatriculaModalidadeController.java - Enrollment Plan Links
src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java - Link Repository
src/main/java/dev/jose/mastersys/matricula/repository/MatriculaModalidadeRepository.java
Invoices
- Invoices API
src/main/java/dev/jose/mastersys/fatura/controller/FaturaMatriculaController.java - Invoice Lifecycle
src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java - Invoice Repository
src/main/java/dev/jose/mastersys/fatura/repository/FaturaMatriculaRepository.java - Invoice Schedulers
src/main/java/dev/jose/mastersys/fatura/scheduler/FaturaGeracaoScheduler.java - Overdue Scheduler
src/main/java/dev/jose/mastersys/fatura/scheduler/FaturaStatusScheduler.java
Reporting and Errors
- Reports API
src/main/java/dev/jose/mastersys/relatorio/controller/RelatorioController.java - Report Queries
src/main/java/dev/jose/mastersys/relatorio/service/RelatorioService.java - Report Repository
src/main/java/dev/jose/mastersys/relatorio/repository/RelatorioRepository.java - Error Responses
src/main/java/dev/jose/mastersys/exception/GlobalExceptionHandler.java
Other components
- API Client
- PostgreSQL
Connections 41
- API Client → Students API: sends requests
README.md - API Client → Modalities API: sends requests
README.md - API Client → Plans API: sends requests
README.md - API Client → Enrollment API: sends requests
README.md - API Client → Modality Links API: sends requests
README.md - API Client → Invoices API: sends requests
README.md - API Client → Reports API: sends requests
README.md - Students API → Student Records: delegates to
README.md - Student Records → Student Repository: queries and saves
src/main/java/dev/jose/mastersys/aluno/service/AlunoService.java - Modalities API → Modality Catalog: delegates to
README.md - Modality Catalog → Modality Repository: queries and saves
src/main/java/dev/jose/mastersys/modalidade/service/ModalidadeService.java - Plans API → Plan Catalog: delegates to
README.md - Plan Catalog → Plan Repository: queries and saves
src/main/java/dev/jose/mastersys/plano/service/PlanoService.java - Plan Catalog → Modality Repository: looks up modality
src/main/java/dev/jose/mastersys/plano/service/PlanoService.java - Enrollment API → Enrollment Lifecycle: delegates to
README.md - Enrollment Lifecycle → Enrollment Repository: queries and saves
src/main/java/dev/jose/mastersys/matricula/service/MatriculaService.java - Enrollment Lifecycle → Student Repository: looks up student
src/main/java/dev/jose/mastersys/matricula/service/MatriculaService.java - Modality Links API → Enrollment Plan Links: delegates to
README.md - Enrollment Plan Links → Enrollment Repository: looks up enrollment
src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java - Enrollment Plan Links → Plan Repository: looks up plan
src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java - Enrollment Plan Links → Link Repository: queries and saves
src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java - Invoices API → Invoice Lifecycle: delegates to
README.md - Invoice Lifecycle → Invoice Repository: queries and saves
src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java - Invoice Lifecycle → Enrollment Repository: loads active enrollments
src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java - Invoice Lifecycle → Link Repository: loads active links
src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java - Invoice Schedulers → Invoice Lifecycle: triggers generation
README.md - Overdue Scheduler → Invoice Lifecycle: updates overdue status
README.md - Reports API → Report Queries: delegates to
README.md - Report Queries → Report Repository: runs report queries
src/main/java/dev/jose/mastersys/relatorio/service/RelatorioService.java - Student Repository → PostgreSQL: persists records
README.md - Modality Repository → PostgreSQL: persists records
README.md - Plan Repository → PostgreSQL: persists records
README.md - Enrollment Repository → PostgreSQL: persists records
README.md - Link Repository → PostgreSQL: persists records
README.md - Invoice Repository → PostgreSQL: persists records
README.md - Report Repository → PostgreSQL: queries data
README.md - Students API → Error Responses: uses error handling
README.md - Modalities API → Error Responses: uses error handling
README.md - Plans API → Error Responses: uses error handling
README.md - Enrollment API → Error Responses: uses error handling
README.md - Invoices API → Error Responses: uses error handling
README.md