# higorpalmeira/sistema-de-gerenciamento-de-consultas architecture

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

## Overview

SGC is a Java desktop application for managing appointments and their patients, doctors, specialties, and addresses. A user works through the Swing front end; its services use HTTP clients to request operations from a Spring Boot API, whose domain services validate and map data to persistence. The README identifies MySQL as the database. The excerpts support several service-to-repository and service-to-client links; some UI and API wiring is not shown, so those relationships are omitted or marked unverified.

Main entry points: [`gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/controller`](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/controller) (REST controllers), [`gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/repository`](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/repository) (Repositories), [`gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/ConsultaService.java`](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/ConsultaService.java) (Appointment service), [`gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/mappers`](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/mappers) (DTO mappers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop application"]
  node_swing["Swing screens"]
  node_frontservices["Front-end services"]
  node_httpclients["API clients"]
  node_addressclient["Address lookup client"]
end

subgraph group_api["API and domain"]
  node_controllers["REST controllers"]
  node_enderecoservice["Address service"]
  node_mappers["DTO mappers"]
  node_validation["Validation and status<br/>[Validator.java]"]
end

subgraph group_data["Persistence"]
  node_repositories["Repositories"]
  node_mysql[("MySQL database")]
end

subgraph group_people["People and scheduling"]
  node_consultaservice["Appointment service"]
  node_pacienteservice["Patient service"]
  node_medicoservice["Doctor service<br/>[MedicoService.java]"]
  node_especialidadeservice["Specialty service"]
  node_entities["Domain entities"]
end

node_user(("System user"))

node_user -.->|"uses"| node_swing
node_swing -.->|"invokes"| node_frontservices
node_frontservices -->|"calls"| node_httpclients
node_frontservices -.->|"calls"| node_addressclient
node_httpclients -.->|"HTTP requests"| node_controllers
node_controllers -->|"delegates to"| node_pacienteservice
node_controllers -.->|"delegates to"| node_consultaservice
node_controllers -.->|"delegates to"| node_medicoservice
node_controllers -.->|"delegates to"| node_especialidadeservice
node_controllers -.->|"delegates to"| node_enderecoservice
node_consultaservice -->|"queries and saves"| node_repositories
node_consultaservice -->|"maps DTOs"| node_mappers
node_consultaservice -->|"validates"| node_validation
node_pacienteservice -->|"queries and saves"| node_repositories
node_pacienteservice -->|"maps DTOs"| node_mappers
node_medicoservice -.->|"queries and saves"| node_repositories
node_especialidadeservice -->|"queries and saves"| node_repositories
node_especialidadeservice -->|"maps DTOs"| node_mappers
node_repositories -.->|"persists"| node_mysql
node_mappers -->|"maps entities"| node_entities

click node_swing "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/view"
click node_frontservices "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/service"
click node_httpclients "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/client"
click node_addressclient "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/client/external/ExtEnderecoClient.java"
click node_controllers "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/controller"
click node_consultaservice "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/ConsultaService.java"
click node_pacienteservice "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/PacienteService.java"
click node_medicoservice "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/MedicoService.java"
click node_especialidadeservice "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/EspecialidadeService.java"
click node_enderecoservice "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/EnderecoService.java"
click node_entities "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/entity"
click node_mappers "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/mappers"
click node_validation "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/util/Validator.java"
click node_repositories "https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/repository"

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_swing,node_frontservices,node_httpclients,node_addressclient,node_user toneBlue
class node_controllers,node_enderecoservice,node_mappers,node_validation toneAmber
class node_repositories,node_mysql toneMint
class node_consultaservice,node_pacienteservice,node_medicoservice,node_especialidadeservice,node_entities toneRose
```

## Components

### Desktop application

- [Swing screens](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/view): `gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/view`
- [Front-end services](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/service): `gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/service`
- [API clients](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/client): `gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/client`
- [Address lookup client](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/client/external/ExtEnderecoClient.java): `gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/client/external/ExtEnderecoClient.java`

### API and domain

- [REST controllers](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/controller): `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/controller`
- [Address service](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/EnderecoService.java): `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/EnderecoService.java`
- [DTO mappers](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/mappers): `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/mappers`
- [Validation and status](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/util/Validator.java): `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/util/Validator.java`

### Persistence

- [Repositories](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/repository): `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/repository`
- **MySQL database**

### People and scheduling

- [Appointment service](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/ConsultaService.java): `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/ConsultaService.java`
- [Patient service](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/PacienteService.java): `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/PacienteService.java`
- [Doctor service](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/MedicoService.java): `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/MedicoService.java`
- [Specialty service](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/blob/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/EspecialidadeService.java): `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/EspecialidadeService.java`
- [Domain entities](https://github.com/higorpalmeira/sistema-de-gerenciamento-de-consultas/tree/main/gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/entity): `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/entity`

### Other components

- **System user**

## Connections

- System user → Swing screens: uses (evidence: `README.md`)
- Swing screens → Front-end services: invokes (evidence: `gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/view/frmMedico.java`)
- Front-end services → API clients: calls (evidence: `gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/service/ConsultaService.java`)
- Front-end services → Address lookup client: calls (evidence: `gerenciador-consultas-front/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/service/EnderecoService.java`)
- API clients → REST controllers: HTTP requests
- REST controllers → Patient service: delegates to (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/controller/PacienteController.java`)
- REST controllers → Appointment service: delegates to (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/controller/ConsultaController.java`)
- REST controllers → Doctor service: delegates to (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/controller/MedicoController.java`)
- REST controllers → Specialty service: delegates to (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/controller/EspecialidadeController.java`)
- REST controllers → Address service: delegates to (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/controller/EnderecoController.java`)
- Appointment service → Repositories: queries and saves (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/ConsultaService.java`)
- Appointment service → DTO mappers: maps DTOs (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/ConsultaService.java`)
- Appointment service → Validation and status: validates (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/ConsultaService.java`)
- Patient service → Repositories: queries and saves (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/PacienteService.java`)
- Patient service → DTO mappers: maps DTOs (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/PacienteService.java`)
- Doctor service → Repositories: queries and saves (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/MedicoService.java`)
- Specialty service → Repositories: queries and saves (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/EspecialidadeService.java`)
- Specialty service → DTO mappers: maps DTOs (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/service/EspecialidadeService.java`)
- Repositories → MySQL database: persists (evidence: `README.md`)
- DTO mappers → Domain entities: maps entities (evidence: `gerenciador-consultas-api/src/main/java/com/higorpalmeira/github/gerenciadorconsultas/model/mappers/MedicoMapper.java`)
