# majimbav/projeto-clai architecture

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

- Interactive diagram: https://gitdiagram.com/majimbav/projeto-clai
- Repository: https://github.com/majimbav/projeto-clai

## Overview

CLAI is a campus student-support system. Its documented working workflow is student registration, listing, consultation, and update through the React app and REST API; the codebase also contains case-study and action-plan workflows, although the README says only student API operations are currently available. Backend services apply business rules and persist domain entities through Spring Data repositories. Case-study and action-plan links are shown as implemented code paths, not as confirmed deployed capabilities; unsampled integrations are left unverified.

Main entry points: [`apps/backend/src/main/java/com/ifpb/edu/br/clai/service/AlunoService.java`](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/service/AlunoService.java) (Student rules), [`apps/frontend/projeto-clai-frontend/src/App.jsx`](https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/App.jsx) (Route app), [`apps/backend/src/main/java/com/ifpb/edu/br/clai/service/EstudoDeCasoService.java`](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/service/EstudoDeCasoService.java) (Case rules), [`apps/frontend/projeto-clai-frontend/src/services/api.js`](https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/services/api.js) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Route app<br/>[App.jsx]"]
  node_student_ui["Student screens<br/>[Alunos.jsx]"]
  node_case_ui["Case screens<br/>[EstudoCasoForm.jsx]"]
  node_plan_ui["Action plan screens<br/>[PlanoAcaoForm.jsx]"]
  node_student_client["Student API client<br/>[AlunoService.js]"]
  node_case_client["Case API client"]
  node_plan_client["Plan API client"]
  node_api["HTTP client<br/>[api.js]"]
end

subgraph group_student["Student records"]
  node_backend["REST API"]
  node_student_service["Student rules<br/>[AlunoService.java]"]
  node_student_mapper["Student mapping<br/>[AlunoMapper.java]"]
  node_student_entity["Student record<br/>[Aluno.java]"]
end

subgraph group_support["Support planning"]
  node_case_api["Case API"]
  node_case_service["Case rules"]
  node_case_model["Case study<br/>[EstudoDeCaso.java]"]
  node_plan_service["Action plan rules"]
  node_plan_model["Action plan<br/>[PlanoAcao.java]"]
end

subgraph group_persistence["Persistence"]
  node_repositories["JPA repositories"]
  node_postgres[("PostgreSQL")]
end

node_staff(("Campus staff"))

node_staff -->|"uses"| node_app
node_app -->|"routes to"| node_student_ui
node_app -->|"routes to"| node_case_ui
node_app -->|"routes to"| node_plan_ui
node_student_ui -.->|"requests"| node_student_client
node_case_ui -.->|"requests"| node_case_client
node_plan_ui -.->|"requests"| node_plan_client
node_student_client -->|"sends requests"| node_api
node_case_client -->|"sends requests"| node_api
node_plan_client -->|"sends requests"| node_api
node_api -.->|"calls REST"| node_backend
node_backend -->|"delegates to"| node_student_service
node_case_api -->|"delegates to"| node_case_service
node_student_service -->|"maps records"| node_student_mapper
node_student_service -->|"queries and saves"| node_repositories
node_student_service -->|"updates"| node_student_entity
node_case_service -->|"creates student"| node_student_service
node_case_service -->|"maps case"| node_case_model
node_case_service -.->|"queries and saves"| node_repositories
node_plan_service -->|"maps plan"| node_plan_model
node_plan_service -->|"queries and saves"| node_repositories
node_repositories -.->|"persists via JPA"| node_postgres

click node_app "https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/App.jsx"
click node_student_ui "https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/components/pages/alunolist/Alunos.jsx"
click node_case_ui "https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/components/pages/estudodecaso/EstudoCasoForm.jsx"
click node_plan_ui "https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/components/pages/planoacao/PlanoAcaoForm.jsx"
click node_student_client "https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/services/AlunoService.js"
click node_case_client "https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/services/EstudoCasoService.js"
click node_plan_client "https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/services/PlanoAcaoService.js"
click node_api "https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/services/api.js"
click node_backend "https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/controller/AlunoController.java"
click node_student_service "https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/service/AlunoService.java"
click node_student_mapper "https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/mapper/AlunoMapper.java"
click node_student_entity "https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/model/aluno/Aluno.java"
click node_case_api "https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/controller/EstudoDeCasoController.java"
click node_case_service "https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/service/EstudoDeCasoService.java"
click node_case_model "https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/model/estudodecaso/EstudoDeCaso.java"
click node_plan_service "https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/service/PlanoAcaoService.java"
click node_plan_model "https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/model/planoacao/PlanoAcao.java"
click node_repositories "https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/repository/AlunoRepository.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_student_ui,node_case_ui,node_plan_ui,node_student_client,node_case_client,node_plan_client,node_api toneBlue
class node_backend,node_student_service,node_student_mapper,node_student_entity toneAmber
class node_case_api,node_case_service,node_case_model,node_plan_service,node_plan_model toneMint
class node_repositories,node_postgres toneRose
class node_staff toneIndigo
```

## Components

### Web application

- [Route app](https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/App.jsx): `apps/frontend/projeto-clai-frontend/src/App.jsx`
- [Student screens](https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/components/pages/alunolist/Alunos.jsx): `apps/frontend/projeto-clai-frontend/src/components/pages/alunolist/Alunos.jsx`
- [Case screens](https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/components/pages/estudodecaso/EstudoCasoForm.jsx): `apps/frontend/projeto-clai-frontend/src/components/pages/estudodecaso/EstudoCasoForm.jsx`
- [Action plan screens](https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/components/pages/planoacao/PlanoAcaoForm.jsx): `apps/frontend/projeto-clai-frontend/src/components/pages/planoacao/PlanoAcaoForm.jsx`
- [Student API client](https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/services/AlunoService.js): `apps/frontend/projeto-clai-frontend/src/services/AlunoService.js`
- [Case API client](https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/services/EstudoCasoService.js): `apps/frontend/projeto-clai-frontend/src/services/EstudoCasoService.js`
- [Plan API client](https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/services/PlanoAcaoService.js): `apps/frontend/projeto-clai-frontend/src/services/PlanoAcaoService.js`
- [HTTP client](https://github.com/majimbav/projeto-clai/blob/main/apps/frontend/projeto-clai-frontend/src/services/api.js): `apps/frontend/projeto-clai-frontend/src/services/api.js`

### Student records

- [REST API](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/controller/AlunoController.java): `apps/backend/src/main/java/com/ifpb/edu/br/clai/controller/AlunoController.java`
- [Student rules](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/service/AlunoService.java): `apps/backend/src/main/java/com/ifpb/edu/br/clai/service/AlunoService.java`
- [Student mapping](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/mapper/AlunoMapper.java): `apps/backend/src/main/java/com/ifpb/edu/br/clai/mapper/AlunoMapper.java`
- [Student record](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/model/aluno/Aluno.java): `apps/backend/src/main/java/com/ifpb/edu/br/clai/model/aluno/Aluno.java`

### Support planning

- [Case API](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/controller/EstudoDeCasoController.java): `apps/backend/src/main/java/com/ifpb/edu/br/clai/controller/EstudoDeCasoController.java`
- [Case rules](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/service/EstudoDeCasoService.java): `apps/backend/src/main/java/com/ifpb/edu/br/clai/service/EstudoDeCasoService.java`
- [Case study](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/model/estudodecaso/EstudoDeCaso.java): `apps/backend/src/main/java/com/ifpb/edu/br/clai/model/estudodecaso/EstudoDeCaso.java`
- [Action plan rules](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/service/PlanoAcaoService.java): `apps/backend/src/main/java/com/ifpb/edu/br/clai/service/PlanoAcaoService.java`
- [Action plan](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/model/planoacao/PlanoAcao.java): `apps/backend/src/main/java/com/ifpb/edu/br/clai/model/planoacao/PlanoAcao.java`

### Persistence

- [JPA repositories](https://github.com/majimbav/projeto-clai/blob/main/apps/backend/src/main/java/com/ifpb/edu/br/clai/repository/AlunoRepository.java): `apps/backend/src/main/java/com/ifpb/edu/br/clai/repository/AlunoRepository.java`
- **PostgreSQL**

### Other components

- **Campus staff**

## Connections

- Campus staff → Route app: uses (evidence: `apps/frontend/projeto-clai-frontend/src/App.jsx`)
- Route app → Student screens: routes to (evidence: `apps/frontend/projeto-clai-frontend/src/App.jsx`)
- Route app → Case screens: routes to (evidence: `apps/frontend/projeto-clai-frontend/src/App.jsx`)
- Route app → Action plan screens: routes to (evidence: `apps/frontend/projeto-clai-frontend/src/App.jsx`)
- Student screens → Student API client: requests
- Case screens → Case API client: requests
- Action plan screens → Plan API client: requests
- Student API client → HTTP client: sends requests (evidence: `apps/frontend/projeto-clai-frontend/src/services/AlunoService.js`)
- Case API client → HTTP client: sends requests (evidence: `apps/frontend/projeto-clai-frontend/src/services/EstudoCasoService.js`)
- Plan API client → HTTP client: sends requests (evidence: `apps/frontend/projeto-clai-frontend/src/services/PlanoAcaoService.js`)
- HTTP client → REST API: calls REST
- REST API → Student rules: delegates to (evidence: `apps/backend/src/main/java/com/ifpb/edu/br/clai/controller/AlunoController.java`)
- Case API → Case rules: delegates to (evidence: `apps/backend/src/main/java/com/ifpb/edu/br/clai/controller/EstudoDeCasoController.java`)
- Student rules → Student mapping: maps records (evidence: `apps/backend/src/main/java/com/ifpb/edu/br/clai/service/AlunoService.java`)
- Student rules → JPA repositories: queries and saves (evidence: `apps/backend/src/main/java/com/ifpb/edu/br/clai/service/AlunoService.java`)
- Student rules → Student record: updates (evidence: `apps/backend/src/main/java/com/ifpb/edu/br/clai/service/AlunoService.java`)
- Case rules → Student rules: creates student (evidence: `apps/backend/src/main/java/com/ifpb/edu/br/clai/service/EstudoDeCasoService.java`)
- Case rules → Case study: maps case (evidence: `apps/backend/src/main/java/com/ifpb/edu/br/clai/service/EstudoDeCasoService.java`)
- Case rules → JPA repositories: queries and saves
- Action plan rules → Action plan: maps plan (evidence: `apps/backend/src/main/java/com/ifpb/edu/br/clai/service/PlanoAcaoService.java`)
- Action plan rules → JPA repositories: queries and saves (evidence: `apps/backend/src/main/java/com/ifpb/edu/br/clai/service/PlanoAcaoService.java`)
- JPA repositories → PostgreSQL: persists via JPA
