# gabyssantos/projeto-reclama-mairinque architecture

> Architecture diagram of the GitHub repository gabyssantos/projeto-reclama-mairinque, 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/gabyssantos/projeto-reclama-mairinque
- Repository: https://github.com/gabyssantos/projeto-reclama-mairinque

## Overview

Projeto Reclama Mairinque is a Spring MVC web application for residents to register and track local occurrences/complaints, and for administrators to review them. Residents authenticate, manage their profiles, submit complaints with location and optional photos, and view their own records or the approved public feed; administrators manage users and change complaint status. Controllers coordinate persistence through Spring Data repositories, while session checks gate access. The excerpts establish these controller-to-repository and upload-service calls; template rendering is indicated by controller return values. The README provides no further capability detail.

Main entry points: [`src/main/java/com/pbe/projetofinal/controller/PessoaController.java`](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/PessoaController.java) (Profile and account), [`src/main/java/com/pbe/projetofinal/controller/AdminController.java`](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/AdminController.java) (Admin operations), [`src/main/java/com/pbe/projetofinal/repository/OcorrenciaRepository.java`](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/repository/OcorrenciaRepository.java) (Occurrence repository), [`src/main/java/com/pbe/projetofinal/controller/OcorrenciaController.java`](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/OcorrenciaController.java) (Occurrence workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and identity"]
  node_login["Login controller"]
  node_interceptor["Session interceptor"]
  node_webconfig["Web configuration<br/>[WebConfig.java]"]
end

subgraph group_resident["Resident services"]
  node_home["Home and feed"]
  node_person_controller["Profile and account"]
  node_occurrence_controller["Occurrence workflow"]
  node_person_views["Resident pages"]
  node_occurrence_views["Occurrence pages"]
end

subgraph group_admin["Administration"]
  node_admin_controller["Admin operations"]
  node_admin_views["Admin pages"]
  node_upload_service["Profile image storage"]
end

subgraph group_domain["Domain and persistence"]
  node_person_repo["Person repository"]
  node_occurrence_repo["Occurrence repository"]
  node_person_model["Person record<br/>[Pessoa.java]"]
  node_occurrence_model["Occurrence record<br/>[Ocorrencia.java]"]
  node_profile_enum["Account roles<br/>[Perfil.java]"]
  node_status_enum["Occurrence statuses"]
end

node_resident_actor(("Resident"))
node_admin_actor(("Administrator"))
node_database[("Relational database")]

node_resident_actor -->|"authenticates"| node_login
node_login -->|"looks up account"| node_person_repo
node_login -->|"checks account"| node_person_model
node_webconfig -->|"registers"| node_interceptor
node_interceptor -->|"redirects unauthenticated"| node_resident_actor
node_resident_actor -->|"manages profile"| node_person_controller
node_person_controller -->|"reads and saves"| node_person_repo
node_person_controller -->|"counts records"| node_occurrence_repo
node_person_controller -->|"stores profile photo"| node_upload_service
node_person_controller -->|"returns views"| node_person_views
node_resident_actor -->|"submits complaints"| node_occurrence_controller
node_occurrence_controller -->|"reads and saves"| node_occurrence_repo
node_occurrence_controller -->|"returns views"| node_occurrence_views
node_occurrence_controller -->|"updates records"| node_occurrence_model
node_home -->|"loads approved feed"| node_occurrence_repo
node_admin_actor -->|"manages service"| node_admin_controller
node_admin_controller -->|"reads and saves"| node_person_repo
node_admin_controller -->|"reviews and updates"| node_occurrence_repo
node_admin_controller -->|"stores profile photo"| node_upload_service
node_admin_controller -->|"returns views"| node_admin_views
node_person_repo -.->|"persists accounts"| node_database
node_occurrence_repo -.->|"persists complaints"| node_database
node_person_model -->|"assigns role"| node_profile_enum
node_occurrence_model -->|"references requester"| node_person_model
node_occurrence_model -->|"tracks status"| node_status_enum

click node_login "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/LoginController.java"
click node_interceptor "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/config/LoginInterceptor.java"
click node_webconfig "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/config/WebConfig.java"
click node_home "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/HomeController.java"
click node_person_controller "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/PessoaController.java"
click node_occurrence_controller "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/OcorrenciaController.java"
click node_person_views "https://github.com/gabyssantos/projeto-reclama-mairinque/tree/main/src/main/resources/templates/pessoa"
click node_occurrence_views "https://github.com/gabyssantos/projeto-reclama-mairinque/tree/main/src/main/resources/templates/ocorrencia"
click node_admin_controller "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/AdminController.java"
click node_admin_views "https://github.com/gabyssantos/projeto-reclama-mairinque/tree/main/src/main/resources/templates/admin"
click node_upload_service "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/service/ArquivoService.java"
click node_person_repo "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/repository/PessoaRepository.java"
click node_occurrence_repo "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/repository/OcorrenciaRepository.java"
click node_person_model "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/model/Pessoa.java"
click node_occurrence_model "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/model/Ocorrencia.java"
click node_profile_enum "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/model/Perfil.java"
click node_status_enum "https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/model/StatusOcorrencia.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_login,node_interceptor,node_webconfig toneBlue
class node_home,node_person_controller,node_occurrence_controller,node_person_views,node_occurrence_views,node_database toneAmber
class node_admin_controller,node_admin_views,node_upload_service toneMint
class node_person_repo,node_occurrence_repo,node_person_model,node_occurrence_model,node_profile_enum,node_status_enum toneRose
class node_resident_actor,node_admin_actor toneIndigo
```

## Components

### Access and identity

- [Login controller](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/LoginController.java): `src/main/java/com/pbe/projetofinal/controller/LoginController.java`
- [Session interceptor](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/config/LoginInterceptor.java): `src/main/java/com/pbe/projetofinal/config/LoginInterceptor.java`
- [Web configuration](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/config/WebConfig.java): `src/main/java/com/pbe/projetofinal/config/WebConfig.java`

### Resident services

- [Home and feed](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/HomeController.java): `src/main/java/com/pbe/projetofinal/controller/HomeController.java`
- [Profile and account](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/PessoaController.java): `src/main/java/com/pbe/projetofinal/controller/PessoaController.java`
- [Occurrence workflow](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/OcorrenciaController.java): `src/main/java/com/pbe/projetofinal/controller/OcorrenciaController.java`
- [Resident pages](https://github.com/gabyssantos/projeto-reclama-mairinque/tree/main/src/main/resources/templates/pessoa): `src/main/resources/templates/pessoa`
- [Occurrence pages](https://github.com/gabyssantos/projeto-reclama-mairinque/tree/main/src/main/resources/templates/ocorrencia): `src/main/resources/templates/ocorrencia`

### Administration

- [Admin operations](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/controller/AdminController.java): `src/main/java/com/pbe/projetofinal/controller/AdminController.java`
- [Admin pages](https://github.com/gabyssantos/projeto-reclama-mairinque/tree/main/src/main/resources/templates/admin): `src/main/resources/templates/admin`
- [Profile image storage](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/service/ArquivoService.java): `src/main/java/com/pbe/projetofinal/service/ArquivoService.java`

### Domain and persistence

- [Person repository](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/repository/PessoaRepository.java): `src/main/java/com/pbe/projetofinal/repository/PessoaRepository.java`
- [Occurrence repository](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/repository/OcorrenciaRepository.java): `src/main/java/com/pbe/projetofinal/repository/OcorrenciaRepository.java`
- [Person record](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/model/Pessoa.java): `src/main/java/com/pbe/projetofinal/model/Pessoa.java`
- [Occurrence record](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/model/Ocorrencia.java): `src/main/java/com/pbe/projetofinal/model/Ocorrencia.java`
- [Account roles](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/model/Perfil.java): `src/main/java/com/pbe/projetofinal/model/Perfil.java`
- [Occurrence statuses](https://github.com/gabyssantos/projeto-reclama-mairinque/blob/main/src/main/java/com/pbe/projetofinal/model/StatusOcorrencia.java): `src/main/java/com/pbe/projetofinal/model/StatusOcorrencia.java`

### Other components

- **Resident**
- **Administrator**
- **Relational database**

## Connections

- Resident → Login controller: authenticates (evidence: `src/main/java/com/pbe/projetofinal/controller/LoginController.java`)
- Login controller → Person repository: looks up account (evidence: `src/main/java/com/pbe/projetofinal/controller/LoginController.java`)
- Login controller → Person record: checks account (evidence: `src/main/java/com/pbe/projetofinal/controller/LoginController.java`)
- Web configuration → Session interceptor: registers (evidence: `src/main/java/com/pbe/projetofinal/config/WebConfig.java`)
- Session interceptor → Resident: redirects unauthenticated (evidence: `src/main/java/com/pbe/projetofinal/config/LoginInterceptor.java`)
- Resident → Profile and account: manages profile (evidence: `src/main/java/com/pbe/projetofinal/controller/PessoaController.java`)
- Profile and account → Person repository: reads and saves (evidence: `src/main/java/com/pbe/projetofinal/controller/PessoaController.java`)
- Profile and account → Occurrence repository: counts records (evidence: `src/main/java/com/pbe/projetofinal/controller/PessoaController.java`)
- Profile and account → Profile image storage: stores profile photo (evidence: `src/main/java/com/pbe/projetofinal/controller/PessoaController.java`)
- Profile and account → Resident pages: returns views (evidence: `src/main/java/com/pbe/projetofinal/controller/PessoaController.java`)
- Resident → Occurrence workflow: submits complaints (evidence: `src/main/java/com/pbe/projetofinal/controller/OcorrenciaController.java`)
- Occurrence workflow → Occurrence repository: reads and saves (evidence: `src/main/java/com/pbe/projetofinal/controller/OcorrenciaController.java`)
- Occurrence workflow → Occurrence pages: returns views (evidence: `src/main/java/com/pbe/projetofinal/controller/OcorrenciaController.java`)
- Occurrence workflow → Occurrence record: updates records (evidence: `src/main/java/com/pbe/projetofinal/controller/OcorrenciaController.java`)
- Home and feed → Occurrence repository: loads approved feed (evidence: `src/main/java/com/pbe/projetofinal/controller/HomeController.java`)
- Administrator → Admin operations: manages service (evidence: `src/main/java/com/pbe/projetofinal/controller/AdminController.java`)
- Admin operations → Person repository: reads and saves (evidence: `src/main/java/com/pbe/projetofinal/controller/AdminController.java`)
- Admin operations → Occurrence repository: reviews and updates (evidence: `src/main/java/com/pbe/projetofinal/controller/AdminController.java`)
- Admin operations → Profile image storage: stores profile photo (evidence: `src/main/java/com/pbe/projetofinal/controller/AdminController.java`)
- Admin operations → Admin pages: returns views (evidence: `src/main/java/com/pbe/projetofinal/controller/AdminController.java`)
- Person repository → Relational database: persists accounts
- Occurrence repository → Relational database: persists complaints
- Person record → Account roles: assigns role (evidence: `src/main/java/com/pbe/projetofinal/model/Pessoa.java`)
- Occurrence record → Person record: references requester (evidence: `src/main/java/com/pbe/projetofinal/model/Ocorrencia.java`)
- Occurrence record → Occurrence statuses: tracks status (evidence: `src/main/java/com/pbe/projetofinal/model/Ocorrencia.java`)
