# gurkan22/site-de-gerenciamento-de-alunos-e-turmas architecture

> Architecture diagram of the GitHub repository gurkan22/site-de-gerenciamento-de-alunos-e-turmas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas
- Repository: https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas

## Overview

This repository combines a React/TypeScript web client with a Spring Boot REST API for managing students, classes, disciplines, professors, and enrollments. The main workflow is navigating to a client page, querying or mutating through hooks and HTTP, then handling the request in an API controller, service, repository, and relational database. The README documents CRUD, enrollment, filtering, and pagination capabilities; several client pages and backend subsystems are represented from the tree and documentation because their source was not sampled. Links are limited to documented or indexed relationships.

Main entry points: [`Uff-Des-Web-React-projeto13/src/routes/router.tsx`](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Uff-Des-Web-React-projeto13/src/routes/router.tsx) (Page router), [`Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/repository`](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/repository) (JPA repositories), [`Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/service/InscricaoService.java`](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/service/InscricaoService.java) (Enrollment service), [`Uff-Des-Web-React-projeto13/src/pages/TurmasComAlunosSearchPage.tsx`](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Uff-Des-Web-React-projeto13/src/pages/TurmasComAlunosSearchPage.tsx) (Class search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web client"]
  node_app["React entry<br/>[main.tsx]"]
  node_routes["Page router<br/>[router.tsx]"]
  node_student_pages["Student pages"]
  node_class_pages["Class pages"]
  node_enrollment_page["Enrollment page<br/>[InscricaoPage.tsx]"]
  node_search_page["Class search"]
  node_client_hooks["Data hooks"]
  node_tables_forms["Forms and tables"]
end

subgraph group_api["REST API"]
  node_student_api["Student endpoints"]
  node_class_api["Class endpoints"]
  node_enrollment_api["Enrollment endpoints"]
  node_other_api["Catalog endpoints"]
end

subgraph group_domain["Domain and persistence"]
  node_student_service["Student service<br/>[AlunoService.java]"]
  node_class_service["Class service<br/>[TurmaService.java]"]
  node_enrollment_service["Enrollment service"]
  node_other_services["Catalog services"]
  node_repositories["JPA repositories"]
  node_entities["Domain entities"]
end

subgraph group_platform["Cross-cutting"]
  node_errors["Error handling"]
  node_cors["CORS config<br/>[CorsConfig.java]"]
end

node_user(("Browser user"))
node_api_actor(("REST client"))
node_mysql[("MySQL database")]

node_user -->|"uses"| node_app
node_app -->|"mounts"| node_routes
node_routes -->|"routes to"| node_student_pages
node_routes -->|"routes to"| node_class_pages
node_routes -->|"routes to"| node_enrollment_page
node_routes -->|"routes to"| node_search_page
node_search_page -->|"queries with"| node_client_hooks
node_search_page -->|"renders"| node_tables_forms
node_client_hooks -->|"fetches"| node_api_actor
node_api_actor -.->|"requests"| node_class_api
node_student_api -->|"delegates"| node_student_service
node_class_api -->|"delegates"| node_class_service
node_student_api -->|"uses"| node_enrollment_service
node_student_service -->|"persists via"| node_repositories
node_class_service -->|"persists via"| node_repositories
node_class_service -->|"reads enrollments"| node_enrollment_service
node_enrollment_service -->|"persists via"| node_repositories
node_other_api -.->|"delegates"| node_other_services
node_enrollment_api -.->|"delegates"| node_enrollment_service
node_other_services -.->|"persists via"| node_repositories
node_repositories -.->|"reads and writes"| node_mysql
node_entities -->|"maps entities"| node_mysql
node_errors -.->|"handles errors from"| node_student_service
node_cors -.->|"permits requests"| node_api_actor

click node_app "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Uff-Des-Web-React-projeto13/src/main.tsx"
click node_routes "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Uff-Des-Web-React-projeto13/src/routes/router.tsx"
click node_student_pages "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Uff-Des-Web-React-projeto13/src/pages"
click node_class_pages "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Uff-Des-Web-React-projeto13/src/pages"
click node_enrollment_page "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Uff-Des-Web-React-projeto13/src/pages/InscricaoPage.tsx"
click node_search_page "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Uff-Des-Web-React-projeto13/src/pages/TurmasComAlunosSearchPage.tsx"
click node_client_hooks "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Uff-Des-Web-React-projeto13/src/hooks"
click node_tables_forms "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Uff-Des-Web-React-projeto13/src/components"
click node_student_api "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/controller/AlunoController.java"
click node_class_api "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/controller/TurmaController.java"
click node_enrollment_api "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/controller/InscricaoController.java"
click node_other_api "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/controller"
click node_student_service "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/service/AlunoService.java"
click node_class_service "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/service/TurmaService.java"
click node_enrollment_service "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/service/InscricaoService.java"
click node_other_services "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/service"
click node_repositories "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/repository"
click node_entities "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/model"
click node_errors "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/exception/GlobalExceptionHandler.java"
click node_cors "https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/config/CorsConfig.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_app,node_routes,node_student_pages,node_class_pages,node_enrollment_page,node_search_page,node_client_hooks,node_tables_forms,node_user,node_api_actor toneBlue
class node_student_api,node_class_api,node_enrollment_api,node_other_api,node_mysql toneAmber
class node_student_service,node_class_service,node_enrollment_service,node_other_services,node_repositories,node_entities toneMint
class node_errors,node_cors toneRose
```

## Components

### Web client

- [React entry](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Uff-Des-Web-React-projeto13/src/main.tsx): `Uff-Des-Web-React-projeto13/src/main.tsx`
- [Page router](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Uff-Des-Web-React-projeto13/src/routes/router.tsx): `Uff-Des-Web-React-projeto13/src/routes/router.tsx`
- [Student pages](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Uff-Des-Web-React-projeto13/src/pages): `Uff-Des-Web-React-projeto13/src/pages`
- [Class pages](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Uff-Des-Web-React-projeto13/src/pages): `Uff-Des-Web-React-projeto13/src/pages`
- [Enrollment page](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Uff-Des-Web-React-projeto13/src/pages/InscricaoPage.tsx): `Uff-Des-Web-React-projeto13/src/pages/InscricaoPage.tsx`
- [Class search](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Uff-Des-Web-React-projeto13/src/pages/TurmasComAlunosSearchPage.tsx): `Uff-Des-Web-React-projeto13/src/pages/TurmasComAlunosSearchPage.tsx`
- [Data hooks](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Uff-Des-Web-React-projeto13/src/hooks): `Uff-Des-Web-React-projeto13/src/hooks`
- [Forms and tables](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Uff-Des-Web-React-projeto13/src/components): `Uff-Des-Web-React-projeto13/src/components`

### REST API

- [Student endpoints](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/controller/AlunoController.java): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/controller/AlunoController.java`
- [Class endpoints](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/controller/TurmaController.java): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/controller/TurmaController.java`
- [Enrollment endpoints](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/controller/InscricaoController.java): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/controller/InscricaoController.java`
- [Catalog endpoints](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/controller): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/controller`

### Domain and persistence

- [Student service](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/service/AlunoService.java): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/service/AlunoService.java`
- [Class service](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/service/TurmaService.java): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/service/TurmaService.java`
- [Enrollment service](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/service/InscricaoService.java): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/service/InscricaoService.java`
- [Catalog services](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/service): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/service`
- [JPA repositories](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/repository): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/repository`
- [Domain entities](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/tree/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/model): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/model`

### Cross-cutting

- [Error handling](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/exception/GlobalExceptionHandler.java): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/exception/GlobalExceptionHandler.java`
- [CORS config](https://github.com/gurkan22/site-de-gerenciamento-de-alunos-e-turmas/blob/main/Trabalho-2%20-%20ApiRestful%20-%20Pedro%20Almeida%20e%20Joao%20Cecim/src/main/java/com/carlosribeiro/apirestful/config/CorsConfig.java): `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/config/CorsConfig.java`

### Other components

- **Browser user**
- **REST client**
- **MySQL database**

## Connections

- Browser user → React entry: uses
- React entry → Page router: mounts (evidence: `Uff-Des-Web-React-projeto13/src/main.tsx`)
- Page router → Student pages: routes to (evidence: `Uff-Des-Web-React-projeto13/src/routes/router.tsx`)
- Page router → Class pages: routes to (evidence: `Uff-Des-Web-React-projeto13/src/routes/router.tsx`)
- Page router → Enrollment page: routes to (evidence: `Uff-Des-Web-React-projeto13/src/routes/router.tsx`)
- Page router → Class search: routes to (evidence: `Uff-Des-Web-React-projeto13/src/routes/router.tsx`)
- Class search → Data hooks: queries with (evidence: `Uff-Des-Web-React-projeto13/src/pages/TurmasComAlunosSearchPage.tsx`)
- Class search → Forms and tables: renders (evidence: `Uff-Des-Web-React-projeto13/src/pages/TurmasComAlunosSearchPage.tsx`)
- Data hooks → REST client: fetches (evidence: `Uff-Des-Web-React-projeto13/src/hooks/useRecuperarAlunosDaTurmaComPaginacao.tsx`)
- REST client → Class endpoints: requests
- Student endpoints → Student service: delegates (evidence: `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/controller/AlunoController.java`)
- Class endpoints → Class service: delegates (evidence: `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/controller/TurmaController.java`)
- Student endpoints → Enrollment service: uses (evidence: `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/controller/AlunoController.java`)
- Student service → JPA repositories: persists via (evidence: `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/service/AlunoService.java`)
- Class service → JPA repositories: persists via (evidence: `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/service/TurmaService.java`)
- Class service → Enrollment service: reads enrollments (evidence: `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/service/TurmaService.java`)
- Enrollment service → JPA repositories: persists via (evidence: `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/service/InscricaoService.java`)
- Catalog endpoints → Catalog services: delegates (evidence: `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/controller/TurmaController.java`)
- Enrollment endpoints → Enrollment service: delegates
- Catalog services → JPA repositories: persists via (evidence: `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/service/TurmaService.java`)
- JPA repositories → MySQL database: reads and writes
- Domain entities → MySQL database: maps entities (evidence: `Trabalho-2 - ApiRestful - Pedro Almeida e Joao Cecim/src/main/java/com/carlosribeiro/apirestful/model/Inscricao.java`)
- Error handling → Student service: handles errors from
- CORS config → REST client: permits requests
