# jose-antonio98/mastersys architecture

> Architecture diagram of the GitHub repository jose-antonio98/mastersys, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jose-antonio98/mastersys
- Repository: https://github.com/jose-antonio98/mastersys

## Overview

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: [`src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java`](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java) (Invoice Lifecycle), [`src/main/java/dev/jose/mastersys/exception/GlobalExceptionHandler.java`](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/exception/GlobalExceptionHandler.java) (Error Responses), [`src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java`](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java) (Enrollment Plan Links), [`src/main/java/dev/jose/mastersys/matricula/repository/MatriculaRepository.java`](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/repository/MatriculaRepository.java) (Enrollment Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_people["Student Management"]
  node_students_api["Students API"]
  node_students["Student Records<br/>[AlunoService.java]"]
  node_student_store["Student Repository"]
end

subgraph group_catalog["Plans and Modalities"]
  node_modalities_api["Modalities API"]
  node_modalities["Modality Catalog"]
  node_modality_store["Modality Repository"]
  node_plans_api["Plans API"]
  node_plans["Plan Catalog<br/>[PlanoService.java]"]
  node_plan_store["Plan Repository"]
end

subgraph group_enrollment["Enrollment Lifecycle"]
  node_enrollment_api["Enrollment API"]
  node_enrollments["Enrollment Lifecycle"]
  node_enrollment_store["Enrollment Repository"]
  node_links_api["Modality Links API"]
  node_enrollment_links["Enrollment Plan Links"]
  node_link_store["Link Repository"]
end

subgraph group_billing["Invoices"]
  node_invoices_api["Invoices API"]
  node_invoices["Invoice Lifecycle"]
  node_invoice_store["Invoice Repository"]
  node_invoice_jobs["Invoice Schedulers"]
  node_status_job["Overdue Scheduler"]
end

subgraph group_insight["Reporting and Errors"]
  node_reports_api["Reports API"]
  node_reports["Report Queries"]
  node_report_store["Report Repository"]
  node_error_handler["Error Responses"]
end

node_client(("API Client"))
node_postgres[("PostgreSQL")]

node_client -->|"sends requests"| node_students_api
node_client -->|"sends requests"| node_modalities_api
node_client -->|"sends requests"| node_plans_api
node_client -->|"sends requests"| node_enrollment_api
node_client -->|"sends requests"| node_links_api
node_client -->|"sends requests"| node_invoices_api
node_client -->|"sends requests"| node_reports_api
node_students_api -->|"delegates to"| node_students
node_students -->|"queries and saves"| node_student_store
node_modalities_api -->|"delegates to"| node_modalities
node_modalities -->|"queries and saves"| node_modality_store
node_plans_api -->|"delegates to"| node_plans
node_plans -->|"queries and saves"| node_plan_store
node_plans -->|"looks up modality"| node_modality_store
node_enrollment_api -->|"delegates to"| node_enrollments
node_enrollments -->|"queries and saves"| node_enrollment_store
node_enrollments -->|"looks up student"| node_student_store
node_links_api -->|"delegates to"| node_enrollment_links
node_enrollment_links -->|"looks up enrollment"| node_enrollment_store
node_enrollment_links -->|"looks up plan"| node_plan_store
node_enrollment_links -->|"queries and saves"| node_link_store
node_invoices_api -->|"delegates to"| node_invoices
node_invoices -->|"queries and saves"| node_invoice_store
node_invoices -->|"loads active enrollments"| node_enrollment_store
node_invoices -->|"loads active links"| node_link_store
node_invoice_jobs -->|"triggers generation"| node_invoices
node_status_job -->|"updates overdue status"| node_invoices
node_reports_api -->|"delegates to"| node_reports
node_reports -->|"runs report queries"| node_report_store
node_student_store -->|"persists records"| node_postgres
node_modality_store -->|"persists records"| node_postgres
node_plan_store -->|"persists records"| node_postgres
node_enrollment_store -->|"persists records"| node_postgres
node_link_store -->|"persists records"| node_postgres
node_invoice_store -->|"persists records"| node_postgres
node_report_store -->|"queries data"| node_postgres
node_students_api -.->|"uses error handling"| node_error_handler
node_modalities_api -.->|"uses error handling"| node_error_handler
node_plans_api -.->|"uses error handling"| node_error_handler
node_enrollment_api -.->|"uses error handling"| node_error_handler
node_invoices_api -.->|"uses error handling"| node_error_handler

click node_students_api "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/aluno/controller/AlunoController.java"
click node_students "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/aluno/service/AlunoService.java"
click node_student_store "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/aluno/repository/AlunoRepository.java"
click node_modalities_api "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/modalidade/controller/ModalidadeController.java"
click node_modalities "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/modalidade/service/ModalidadeService.java"
click node_modality_store "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/modalidade/repository/ModalidadeRepository.java"
click node_plans_api "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/plano/controller/PlanoController.java"
click node_plans "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/plano/service/PlanoService.java"
click node_plan_store "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/plano/repository/PlanosRepository.java"
click node_enrollment_api "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/controller/MatriculaController.java"
click node_enrollments "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/service/MatriculaService.java"
click node_enrollment_store "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/repository/MatriculaRepository.java"
click node_links_api "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/controller/MatriculaModalidadeController.java"
click node_enrollment_links "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java"
click node_link_store "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/repository/MatriculaModalidadeRepository.java"
click node_invoices_api "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/fatura/controller/FaturaMatriculaController.java"
click node_invoices "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java"
click node_invoice_store "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/fatura/repository/FaturaMatriculaRepository.java"
click node_invoice_jobs "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/fatura/scheduler/FaturaGeracaoScheduler.java"
click node_status_job "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/fatura/scheduler/FaturaStatusScheduler.java"
click node_reports_api "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/relatorio/controller/RelatorioController.java"
click node_reports "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/relatorio/service/RelatorioService.java"
click node_report_store "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/relatorio/repository/RelatorioRepository.java"
click node_error_handler "https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/exception/GlobalExceptionHandler.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_students_api,node_students,node_student_store,node_client toneBlue
class node_modalities_api,node_modalities,node_modality_store,node_plans_api,node_plans,node_plan_store,node_postgres toneAmber
class node_enrollment_api,node_enrollments,node_enrollment_store,node_links_api,node_enrollment_links,node_link_store toneMint
class node_invoices_api,node_invoices,node_invoice_store,node_invoice_jobs,node_status_job toneRose
class node_reports_api,node_reports,node_report_store,node_error_handler toneIndigo
```

## Components

### Student Management

- [Students API](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/aluno/controller/AlunoController.java): `src/main/java/dev/jose/mastersys/aluno/controller/AlunoController.java`
- [Student Records](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/aluno/service/AlunoService.java): `src/main/java/dev/jose/mastersys/aluno/service/AlunoService.java`
- [Student Repository](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/aluno/repository/AlunoRepository.java): `src/main/java/dev/jose/mastersys/aluno/repository/AlunoRepository.java`

### Plans and Modalities

- [Modalities API](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/modalidade/controller/ModalidadeController.java): `src/main/java/dev/jose/mastersys/modalidade/controller/ModalidadeController.java`
- [Modality Catalog](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/modalidade/service/ModalidadeService.java): `src/main/java/dev/jose/mastersys/modalidade/service/ModalidadeService.java`
- [Modality Repository](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/modalidade/repository/ModalidadeRepository.java): `src/main/java/dev/jose/mastersys/modalidade/repository/ModalidadeRepository.java`
- [Plans API](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/plano/controller/PlanoController.java): `src/main/java/dev/jose/mastersys/plano/controller/PlanoController.java`
- [Plan Catalog](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/plano/service/PlanoService.java): `src/main/java/dev/jose/mastersys/plano/service/PlanoService.java`
- [Plan Repository](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/plano/repository/PlanosRepository.java): `src/main/java/dev/jose/mastersys/plano/repository/PlanosRepository.java`

### Enrollment Lifecycle

- [Enrollment API](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/controller/MatriculaController.java): `src/main/java/dev/jose/mastersys/matricula/controller/MatriculaController.java`
- [Enrollment Lifecycle](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/service/MatriculaService.java): `src/main/java/dev/jose/mastersys/matricula/service/MatriculaService.java`
- [Enrollment Repository](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/repository/MatriculaRepository.java): `src/main/java/dev/jose/mastersys/matricula/repository/MatriculaRepository.java`
- [Modality Links API](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/controller/MatriculaModalidadeController.java): `src/main/java/dev/jose/mastersys/matricula/controller/MatriculaModalidadeController.java`
- [Enrollment Plan Links](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java): `src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java`
- [Link Repository](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/matricula/repository/MatriculaModalidadeRepository.java): `src/main/java/dev/jose/mastersys/matricula/repository/MatriculaModalidadeRepository.java`

### Invoices

- [Invoices API](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/fatura/controller/FaturaMatriculaController.java): `src/main/java/dev/jose/mastersys/fatura/controller/FaturaMatriculaController.java`
- [Invoice Lifecycle](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java): `src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java`
- [Invoice Repository](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/fatura/repository/FaturaMatriculaRepository.java): `src/main/java/dev/jose/mastersys/fatura/repository/FaturaMatriculaRepository.java`
- [Invoice Schedulers](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/fatura/scheduler/FaturaGeracaoScheduler.java): `src/main/java/dev/jose/mastersys/fatura/scheduler/FaturaGeracaoScheduler.java`
- [Overdue Scheduler](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/fatura/scheduler/FaturaStatusScheduler.java): `src/main/java/dev/jose/mastersys/fatura/scheduler/FaturaStatusScheduler.java`

### Reporting and Errors

- [Reports API](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/relatorio/controller/RelatorioController.java): `src/main/java/dev/jose/mastersys/relatorio/controller/RelatorioController.java`
- [Report Queries](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/relatorio/service/RelatorioService.java): `src/main/java/dev/jose/mastersys/relatorio/service/RelatorioService.java`
- [Report Repository](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/relatorio/repository/RelatorioRepository.java): `src/main/java/dev/jose/mastersys/relatorio/repository/RelatorioRepository.java`
- [Error Responses](https://github.com/jose-antonio98/mastersys/blob/master/src/main/java/dev/jose/mastersys/exception/GlobalExceptionHandler.java): `src/main/java/dev/jose/mastersys/exception/GlobalExceptionHandler.java`

### Other components

- **API Client**
- **PostgreSQL**

## Connections

- API Client → Students API: sends requests (evidence: `README.md`)
- API Client → Modalities API: sends requests (evidence: `README.md`)
- API Client → Plans API: sends requests (evidence: `README.md`)
- API Client → Enrollment API: sends requests (evidence: `README.md`)
- API Client → Modality Links API: sends requests (evidence: `README.md`)
- API Client → Invoices API: sends requests (evidence: `README.md`)
- API Client → Reports API: sends requests (evidence: `README.md`)
- Students API → Student Records: delegates to (evidence: `README.md`)
- Student Records → Student Repository: queries and saves (evidence: `src/main/java/dev/jose/mastersys/aluno/service/AlunoService.java`)
- Modalities API → Modality Catalog: delegates to (evidence: `README.md`)
- Modality Catalog → Modality Repository: queries and saves (evidence: `src/main/java/dev/jose/mastersys/modalidade/service/ModalidadeService.java`)
- Plans API → Plan Catalog: delegates to (evidence: `README.md`)
- Plan Catalog → Plan Repository: queries and saves (evidence: `src/main/java/dev/jose/mastersys/plano/service/PlanoService.java`)
- Plan Catalog → Modality Repository: looks up modality (evidence: `src/main/java/dev/jose/mastersys/plano/service/PlanoService.java`)
- Enrollment API → Enrollment Lifecycle: delegates to (evidence: `README.md`)
- Enrollment Lifecycle → Enrollment Repository: queries and saves (evidence: `src/main/java/dev/jose/mastersys/matricula/service/MatriculaService.java`)
- Enrollment Lifecycle → Student Repository: looks up student (evidence: `src/main/java/dev/jose/mastersys/matricula/service/MatriculaService.java`)
- Modality Links API → Enrollment Plan Links: delegates to (evidence: `README.md`)
- Enrollment Plan Links → Enrollment Repository: looks up enrollment (evidence: `src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java`)
- Enrollment Plan Links → Plan Repository: looks up plan (evidence: `src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java`)
- Enrollment Plan Links → Link Repository: queries and saves (evidence: `src/main/java/dev/jose/mastersys/matricula/service/MatriculaModalidadeService.java`)
- Invoices API → Invoice Lifecycle: delegates to (evidence: `README.md`)
- Invoice Lifecycle → Invoice Repository: queries and saves (evidence: `src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java`)
- Invoice Lifecycle → Enrollment Repository: loads active enrollments (evidence: `src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java`)
- Invoice Lifecycle → Link Repository: loads active links (evidence: `src/main/java/dev/jose/mastersys/fatura/service/FaturaMatriculaService.java`)
- Invoice Schedulers → Invoice Lifecycle: triggers generation (evidence: `README.md`)
- Overdue Scheduler → Invoice Lifecycle: updates overdue status (evidence: `README.md`)
- Reports API → Report Queries: delegates to (evidence: `README.md`)
- Report Queries → Report Repository: runs report queries (evidence: `src/main/java/dev/jose/mastersys/relatorio/service/RelatorioService.java`)
- Student Repository → PostgreSQL: persists records (evidence: `README.md`)
- Modality Repository → PostgreSQL: persists records (evidence: `README.md`)
- Plan Repository → PostgreSQL: persists records (evidence: `README.md`)
- Enrollment Repository → PostgreSQL: persists records (evidence: `README.md`)
- Link Repository → PostgreSQL: persists records (evidence: `README.md`)
- Invoice Repository → PostgreSQL: persists records (evidence: `README.md`)
- Report Repository → PostgreSQL: queries data (evidence: `README.md`)
- Students API → Error Responses: uses error handling (evidence: `README.md`)
- Modalities API → Error Responses: uses error handling (evidence: `README.md`)
- Plans API → Error Responses: uses error handling (evidence: `README.md`)
- Enrollment API → Error Responses: uses error handling (evidence: `README.md`)
- Invoices API → Error Responses: uses error handling (evidence: `README.md`)
