# higorpalmeira/gestao-cooperativa-reciclagem-web architecture

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

- Interactive diagram: https://gitdiagram.com/higorpalmeira/gestao-cooperativa-reciclagem-web
- Repository: https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web

## Overview

This is a web-based recycling-cooperative management system. Its main material workflow records incoming raw lots, tracks their processing into classified material lots, and supports selling processed material; purchase transactions, pricing, reporting, and user access are additional capabilities. The README describes an MVC architecture and MySQL persistence. Sampled services confirm validation and processing behavior, but most controllers and DAOs were not inspected, so detailed routes and subsystem calls are omitted.

Main entry points: [`src/main/java/com/gestaocooperativareciclagem/controller`](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/tree/main/src/main/java/com/gestaocooperativareciclagem/controller) (Web Controllers), [`src/main/java/com/gestaocooperativareciclagem/service/LoteProcessadoService.java`](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/LoteProcessadoService.java) (Processed Lots), [`src/main/java/com/gestaocooperativareciclagem/service/LoteBrutoService.java`](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/LoteBrutoService.java) (Raw Lots), [`src/main/java/com/gestaocooperativareciclagem/model`](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/tree/main/src/main/java/com/gestaocooperativareciclagem/model) (Domain Models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and Access"]
  node_controllers["Web Controllers"]
  node_auth["Authentication"]
  node_access["Access Filters"]
  node_users["User Management"]
end

subgraph group_operations["Material Operations"]
  node_raw["Raw Lots"]
  node_processed["Processed Lots"]
  node_stages["Processing Stages"]
  node_categories["Processing Categories"]
  node_suppliers["Suppliers"]
  node_materialtypes["Material Types"]
end

subgraph group_commerce["Commerce"]
  node_pricing["Material Pricing"]
  node_purchases["Purchase Transactions"]
  node_customers["Customers"]
  node_sales["Sales and Items<br/>[VendaService.java]"]
  node_reports["Operational Reports"]
end

subgraph group_data["Business Data"]
  node_models["Domain Models"]
  node_daos["Data Access"]
  node_validation["Input Validation<br/>[Validador.java]"]
end

node_operator(("Cooperative User"))
node_mysql[("MySQL Database")]

node_operator -->|"uses web app"| node_controllers
node_controllers -.->|"authenticates"| node_auth
node_controllers -.->|"requests gated"| node_access
node_controllers -.->|"manages intake"| node_raw
node_raw -->|"feeds processing"| node_processed
node_processed -->|"tracks stages"| node_stages
node_stages -->|"classifies by"| node_categories
node_processed -->|"assigns material"| node_materialtypes
node_raw -->|"records source"| node_suppliers
node_processed -->|"enables sale"| node_sales
node_pricing -->|"prices material"| node_materialtypes
node_purchases -->|"pays for lots"| node_raw
node_sales -->|"sells to"| node_customers
node_controllers -.->|"requests reports"| node_reports
node_controllers -.->|"manages users"| node_users
node_controllers -->|"uses domain model"| node_models
node_daos -->|"maps entities"| node_models
node_daos -->|"persists records"| node_mysql
node_models -->|"validates fields"| node_validation

click node_controllers "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/tree/main/src/main/java/com/gestaocooperativareciclagem/controller"
click node_auth "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/AutenticacaoService.java"
click node_access "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/tree/main/src/main/java/com/gestaocooperativareciclagem/filter"
click node_raw "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/LoteBrutoService.java"
click node_processed "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/LoteProcessadoService.java"
click node_stages "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/EtapaProcessamentoService.java"
click node_categories "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/CategoriaProcessamentoService.java"
click node_suppliers "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/FornecedorService.java"
click node_materialtypes "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/TipoMaterialService.java"
click node_pricing "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/PrecoMaterialService.java"
click node_purchases "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/TransacaoCompraService.java"
click node_customers "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/ClienteService.java"
click node_sales "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/VendaService.java"
click node_reports "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/controller/RelatorioController.java"
click node_users "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/UsuarioService.java"
click node_models "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/tree/main/src/main/java/com/gestaocooperativareciclagem/model"
click node_daos "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/tree/main/src/main/java/com/gestaocooperativareciclagem/dao"
click node_validation "https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/utils/Validador.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_controllers,node_auth,node_access,node_users,node_operator toneBlue
class node_raw,node_processed,node_stages,node_categories,node_suppliers,node_materialtypes,node_mysql toneAmber
class node_pricing,node_purchases,node_customers,node_sales,node_reports toneMint
class node_models,node_daos,node_validation toneRose
```

## Components

### Web and Access

- [Web Controllers](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/tree/main/src/main/java/com/gestaocooperativareciclagem/controller): `src/main/java/com/gestaocooperativareciclagem/controller`
- [Authentication](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/AutenticacaoService.java): `src/main/java/com/gestaocooperativareciclagem/service/AutenticacaoService.java`
- [Access Filters](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/tree/main/src/main/java/com/gestaocooperativareciclagem/filter): `src/main/java/com/gestaocooperativareciclagem/filter`
- [User Management](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/UsuarioService.java): `src/main/java/com/gestaocooperativareciclagem/service/UsuarioService.java`

### Material Operations

- [Raw Lots](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/LoteBrutoService.java): `src/main/java/com/gestaocooperativareciclagem/service/LoteBrutoService.java`
- [Processed Lots](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/LoteProcessadoService.java): `src/main/java/com/gestaocooperativareciclagem/service/LoteProcessadoService.java`
- [Processing Stages](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/EtapaProcessamentoService.java): `src/main/java/com/gestaocooperativareciclagem/service/EtapaProcessamentoService.java`
- [Processing Categories](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/CategoriaProcessamentoService.java): `src/main/java/com/gestaocooperativareciclagem/service/CategoriaProcessamentoService.java`
- [Suppliers](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/FornecedorService.java): `src/main/java/com/gestaocooperativareciclagem/service/FornecedorService.java`
- [Material Types](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/TipoMaterialService.java): `src/main/java/com/gestaocooperativareciclagem/service/TipoMaterialService.java`

### Commerce

- [Material Pricing](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/PrecoMaterialService.java): `src/main/java/com/gestaocooperativareciclagem/service/PrecoMaterialService.java`
- [Purchase Transactions](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/TransacaoCompraService.java): `src/main/java/com/gestaocooperativareciclagem/service/TransacaoCompraService.java`
- [Customers](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/ClienteService.java): `src/main/java/com/gestaocooperativareciclagem/service/ClienteService.java`
- [Sales and Items](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/service/VendaService.java): `src/main/java/com/gestaocooperativareciclagem/service/VendaService.java`
- [Operational Reports](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/controller/RelatorioController.java): `src/main/java/com/gestaocooperativareciclagem/controller/RelatorioController.java`

### Business Data

- [Domain Models](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/tree/main/src/main/java/com/gestaocooperativareciclagem/model): `src/main/java/com/gestaocooperativareciclagem/model`
- [Data Access](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/tree/main/src/main/java/com/gestaocooperativareciclagem/dao): `src/main/java/com/gestaocooperativareciclagem/dao`
- [Input Validation](https://github.com/higorpalmeira/gestao-cooperativa-reciclagem-web/blob/main/src/main/java/com/gestaocooperativareciclagem/utils/Validador.java): `src/main/java/com/gestaocooperativareciclagem/utils/Validador.java`

### Other components

- **Cooperative User**
- **MySQL Database**

## Connections

- Cooperative User → Web Controllers: uses web app
- Web Controllers → Authentication: authenticates (evidence: `src/main/java/com/gestaocooperativareciclagem/controller/AutenticacaoController.java`)
- Web Controllers → Access Filters: requests gated
- Web Controllers → Raw Lots: manages intake (evidence: `src/main/java/com/gestaocooperativareciclagem/controller/RelatorioController.java`)
- Raw Lots → Processed Lots: feeds processing (evidence: `src/main/java/com/gestaocooperativareciclagem/service/LoteProcessadoService.java`)
- Processed Lots → Processing Stages: tracks stages (evidence: `src/main/java/com/gestaocooperativareciclagem/service/LoteProcessadoService.java`)
- Processing Stages → Processing Categories: classifies by (evidence: `src/main/java/com/gestaocooperativareciclagem/service/EtapaProcessamentoService.java`)
- Processed Lots → Material Types: assigns material (evidence: `src/main/java/com/gestaocooperativareciclagem/service/LoteProcessadoService.java`)
- Raw Lots → Suppliers: records source
- Processed Lots → Sales and Items: enables sale
- Material Pricing → Material Types: prices material (evidence: `src/main/java/com/gestaocooperativareciclagem/service/PrecoMaterialService.java`)
- Purchase Transactions → Raw Lots: pays for lots
- Sales and Items → Customers: sells to (evidence: `src/main/java/com/gestaocooperativareciclagem/service/VendaService.java`)
- Web Controllers → Operational Reports: requests reports
- Web Controllers → User Management: manages users (evidence: `src/main/java/com/gestaocooperativareciclagem/controller/RelatorioController.java`)
- Web Controllers → Domain Models: uses domain model (evidence: `src/main/java/com/gestaocooperativareciclagem/controller/RelatorioController.java`)
- Data Access → Domain Models: maps entities (evidence: `src/main/java/com/gestaocooperativareciclagem/dao/ClienteDAO.java`)
- Data Access → MySQL Database: persists records
- Domain Models → Input Validation: validates fields (evidence: `src/main/java/com/gestaocooperativareciclagem/model/Cliente.java`)
