# pablohsgc/sistema-de-doacoes-java architecture

> Architecture diagram of the GitHub repository pablohsgc/sistema-de-doacoes-java, 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/pablohsgc/sistema-de-doacoes-java
- Repository: https://github.com/pablohsgc/sistema-de-doacoes-java

## Overview

This is a Java desktop donation-management application. Users register or log in, submit donations, browse approved items, and express interest; administrators add item categories and approve or reject submitted donations. The Swing interface delegates operations to Sistema, which coordinates controllers, catalogs, search, and local JSON persistence. The README documents the major workflows, while sampled code confirms some calls; several UI actions and integrations are not fully shown, so their links are omitted rather than inferred.

Main entry points: [`src/Controle/Sistema.java`](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Sistema.java) (System facade), [`src/Controle/Controle_Administrador.java`](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Controle_Administrador.java) (Admin review), [`src/Visao/JanelaSistema.java`](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/JanelaSistema.java) (Main window), [`src/Visao/JanelaCadastroDePessoa.java`](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/JanelaCadastroDePessoa.java) (Registration window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_main_window["Main window<br/>[JanelaSistema.java]"]
  node_registration_window["Registration window"]
  node_image_window["Image window<br/>[JanelaImagem.java]"]
  node_photo_panel["Photo panel<br/>[PainelDeFotos.java]"]
  node_interest_panel["Interested panel"]
end

subgraph group_control["Application control"]
  node_system["System facade<br/>[Sistema.java]"]
  node_login["Login<br/>[Login.java]"]
  node_registration["User registration<br/>[Cadastro.java]"]
  node_people_control["Person creation"]
  node_donation_control["Donation management"]
  node_admin_control["Admin review"]
  node_interest_control["Interest handling"]
  node_image_control["Image handling"]
end

subgraph group_domain["Donation domain"]
  node_search["Donation search<br/>[Pesquisa.java]"]
  node_donation_catalog[("Donation catalog")]
  node_user_catalog[("User catalog")]
  node_donation["Donation record<br/>[Doacao.java]"]
  node_item["Item details<br/>[Item.java]"]
  node_interest["Interest record<br/>[Interesse.java]"]
  node_user_model["User identity<br/>[Usuario.java]"]
  node_category["Item categories<br/>[Tipo_Item.java]"]
  node_evaluation["Evaluation notice<br/>[Avaliacao.java]"]
  node_email["Email service<br/>[Sistema_Email.java]"]
end

subgraph group_storage["Local persistence"]
  node_file_io["JSON file access"]
  node_user_json["User data<br/>[Usuarios.json]"]
  node_donation_json["Donation data<br/>[Doacoes.json]"]
end

node_user(("User"))
node_admin(("Administrator"))

node_user -->|"uses"| node_main_window
node_admin -->|"uses"| node_main_window
node_main_window -->|"delegates"| node_system
node_main_window -->|"opens"| node_registration_window
node_main_window -->|"opens"| node_image_window
node_registration_window -->|"creates person"| node_people_control
node_registration_window -->|"registers user"| node_system
node_image_window -->|"delegates"| node_image_control
node_photo_panel -->|"delegates"| node_image_control
node_main_window -->|"shows"| node_interest_panel
node_system -->|"initializes"| node_login
node_system -->|"delegates"| node_registration
node_system -->|"delegates"| node_donation_control
node_system -->|"delegates"| node_admin_control
node_system -->|"delegates"| node_interest_control
node_system -->|"queries"| node_search
node_system -->|"loads and saves"| node_file_io
node_file_io -->|"reads and writes"| node_user_json
node_file_io -->|"reads and writes"| node_donation_json
node_registration -->|"adds user"| node_user_catalog
node_admin_control -->|"adds category"| node_donation_catalog
node_admin_control -->|"finds donation"| node_search
node_admin_control -->|"looks up donor"| node_user_catalog
node_admin_control -->|"creates notice"| node_evaluation
node_admin_control -->|"sends notice"| node_email
node_search -->|"searches"| node_donation_catalog
node_donation_catalog -->|"stores"| node_category
node_category -->|"associates"| node_donation
node_donation -->|"contains"| node_item
node_donation -->|"tracks"| node_interest
node_user_catalog -->|"stores"| node_user_model
node_interest_panel -->|"displays"| node_interest
node_admin -->|"reviews donations"| node_admin_control
node_user -->|"submits donation"| node_donation_control
node_user -->|"expresses interest"| node_interest_control

click node_main_window "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/JanelaSistema.java"
click node_registration_window "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/JanelaCadastroDePessoa.java"
click node_image_window "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/JanelaImagem.java"
click node_photo_panel "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/PainelDeFotos.java"
click node_interest_panel "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/PainelInteressados.java"
click node_system "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Sistema.java"
click node_login "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Login.java"
click node_registration "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Cadastro.java"
click node_people_control "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Controle_Pessoa.java"
click node_donation_control "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Controle_Doacao.java"
click node_admin_control "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Controle_Administrador.java"
click node_interest_control "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Controle_Interesse.java"
click node_image_control "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Controle_De_Imagens.java"
click node_search "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Pesquisa.java"
click node_donation_catalog "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Catalogo_Itens.java"
click node_user_catalog "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Catalogo_Usuarios.java"
click node_donation "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Doacao.java"
click node_item "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Item.java"
click node_interest "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Interesse.java"
click node_user_model "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Usuario.java"
click node_category "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Tipo_Item.java"
click node_evaluation "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Avaliacao.java"
click node_email "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Sistema_Email.java"
click node_file_io "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Manipula_Arquivo.java"
click node_user_json "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/Usuarios.json"
click node_donation_json "https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/Doacoes.json"

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_main_window,node_registration_window,node_image_window,node_photo_panel,node_interest_panel,node_user toneBlue
class node_system,node_login,node_registration,node_people_control,node_donation_control,node_admin_control,node_interest_control,node_image_control toneAmber
class node_search,node_donation_catalog,node_user_catalog,node_donation,node_item,node_interest,node_user_model,node_category,node_evaluation,node_email toneMint
class node_file_io,node_user_json,node_donation_json toneRose
class node_admin toneIndigo
```

## Components

### Desktop interface

- [Main window](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/JanelaSistema.java): `src/Visao/JanelaSistema.java`
- [Registration window](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/JanelaCadastroDePessoa.java): `src/Visao/JanelaCadastroDePessoa.java`
- [Image window](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/JanelaImagem.java): `src/Visao/JanelaImagem.java`
- [Photo panel](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/PainelDeFotos.java): `src/Visao/PainelDeFotos.java`
- [Interested panel](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Visao/PainelInteressados.java): `src/Visao/PainelInteressados.java`

### Application control

- [System facade](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Sistema.java): `src/Controle/Sistema.java`
- [Login](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Login.java): `src/Controle/Login.java`
- [User registration](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Cadastro.java): `src/Controle/Cadastro.java`
- [Person creation](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Controle_Pessoa.java): `src/Controle/Controle_Pessoa.java`
- [Donation management](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Controle_Doacao.java): `src/Controle/Controle_Doacao.java`
- [Admin review](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Controle_Administrador.java): `src/Controle/Controle_Administrador.java`
- [Interest handling](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Controle_Interesse.java): `src/Controle/Controle_Interesse.java`
- [Image handling](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Controle/Controle_De_Imagens.java): `src/Controle/Controle_De_Imagens.java`

### Donation domain

- [Donation search](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Pesquisa.java): `src/Modelo/Pesquisa.java`
- [Donation catalog](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Catalogo_Itens.java): `src/Modelo/Catalogo_Itens.java`
- [User catalog](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Catalogo_Usuarios.java): `src/Modelo/Catalogo_Usuarios.java`
- [Donation record](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Doacao.java): `src/Modelo/Doacao.java`
- [Item details](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Item.java): `src/Modelo/Item.java`
- [Interest record](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Interesse.java): `src/Modelo/Interesse.java`
- [User identity](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Usuario.java): `src/Modelo/Usuario.java`
- [Item categories](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Tipo_Item.java): `src/Modelo/Tipo_Item.java`
- [Evaluation notice](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Avaliacao.java): `src/Modelo/Avaliacao.java`
- [Email service](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Sistema_Email.java): `src/Modelo/Sistema_Email.java`

### Local persistence

- [JSON file access](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/src/Modelo/Manipula_Arquivo.java): `src/Modelo/Manipula_Arquivo.java`
- [User data](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/Usuarios.json): `Usuarios.json`
- [Donation data](https://github.com/pablohsgc/sistema-de-doacoes-java/blob/main/Doacoes.json): `Doacoes.json`

### Other components

- **User**
- **Administrator**

## Connections

- User → Main window: uses (evidence: `README.md`)
- Administrator → Main window: uses (evidence: `README.md`)
- Main window → System facade: delegates (evidence: `src/Visao/JanelaSistema.java`)
- Main window → Registration window: opens (evidence: `src/Visao/JanelaSistema.java`)
- Main window → Image window: opens (evidence: `src/Visao/JanelaSistema.java`)
- Registration window → Person creation: creates person (evidence: `src/Visao/JanelaCadastroDePessoa.java`)
- Registration window → System facade: registers user (evidence: `src/Visao/JanelaCadastroDePessoa.java`)
- Image window → Image handling: delegates (evidence: `src/Visao/JanelaImagem.java`)
- Photo panel → Image handling: delegates (evidence: `src/Visao/PainelDeFotos.java`)
- Main window → Interested panel: shows (evidence: `src/Visao/JanelaSistema.java`)
- System facade → Login: initializes (evidence: `src/Controle/Sistema.java`)
- System facade → User registration: delegates (evidence: `src/Controle/Sistema.java`)
- System facade → Donation management: delegates (evidence: `src/Controle/Sistema.java`)
- System facade → Admin review: delegates (evidence: `src/Controle/Sistema.java`)
- System facade → Interest handling: delegates (evidence: `src/Controle/Sistema.java`)
- System facade → Donation search: queries (evidence: `src/Controle/Sistema.java`)
- System facade → JSON file access: loads and saves (evidence: `src/Controle/Sistema.java`)
- JSON file access → User data: reads and writes (evidence: `README.md`)
- JSON file access → Donation data: reads and writes (evidence: `README.md`)
- User registration → User catalog: adds user (evidence: `src/Controle/Cadastro.java`)
- Admin review → Donation catalog: adds category (evidence: `src/Controle/Controle_Administrador.java`)
- Admin review → Donation search: finds donation (evidence: `src/Controle/Controle_Administrador.java`)
- Admin review → User catalog: looks up donor (evidence: `src/Controle/Controle_Administrador.java`)
- Admin review → Evaluation notice: creates notice (evidence: `src/Controle/Controle_Administrador.java`)
- Admin review → Email service: sends notice (evidence: `src/Controle/Controle_Administrador.java`)
- Donation search → Donation catalog: searches (evidence: `src/Modelo/Pesquisa.java`)
- Donation catalog → Item categories: stores (evidence: `src/Modelo/Catalogo_Itens.java`)
- Item categories → Donation record: associates (evidence: `src/Modelo/Tipo_Item.java`)
- Donation record → Item details: contains (evidence: `src/Modelo/Doacao.java`)
- Donation record → Interest record: tracks (evidence: `src/Modelo/Doacao.java`)
- User catalog → User identity: stores (evidence: `src/Modelo/Catalogo_Usuarios.java`)
- Interested panel → Interest record: displays (evidence: `src/Visao/JanelaSistema.java`)
- Administrator → Admin review: reviews donations (evidence: `README.md`)
- User → Donation management: submits donation (evidence: `README.md`)
- User → Interest handling: expresses interest (evidence: `README.md`)
