# caua-21/gerenciador-de-testes architecture

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

- Interactive diagram: https://gitdiagram.com/caua-21/gerenciador-de-testes
- Repository: https://github.com/caua-21/gerenciador-de-testes

## Overview

PKL is a Windows console application for managing developers, software tests, and test cases. Users register or log in, then use menus to manage developer and test data; domain types validate entered values, service controllers apply business rules, and singleton containers keep records in memory. The graph separates these domain stages and the service/storage layers. Relationships come from the README and shown excerpts; domain implementation details were not sampled, and the documented stubs are unused.

Main entry points: [`controladorasapresentacao.cpp`](https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasapresentacao.cpp) (Menu navigation), [`controladorasservico.cpp`](https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasservico.cpp) (Test and case rules), [`conteiners.cpp`](https://github.com/caua-21/gerenciador-de-testes/blob/main/conteiners.cpp) (Developer records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Console interaction"]
  node_startup["Menu navigation"]
  node_auth_ui["Login screen"]
  node_developer_ui["Developer screens"]
  node_test_ui["Test screens"]
end

subgraph group_domain["Domain model"]
  node_domain_types["Validated types<br/>[dominios.cpp]"]
  node_entities["Developer and tests<br/>[entidades.h]"]
end

subgraph group_service["Service layer"]
  node_contracts["Service interfaces<br/>[interfaces.h]"]
  node_auth_service["Authentication"]
  node_developer_service["Developer rules"]
  node_test_service["Test and case rules"]
end

subgraph group_storage["Memory storage"]
  node_developer_store[("Developer records<br/>[conteiners.cpp]")]
  node_test_store[("Test records<br/>[conteiners.cpp]")]
  node_case_store[("Case records<br/>[conteiners.cpp]")]
end

node_user(("User"))

node_user -->|"uses menus"| node_startup
node_startup -->|"dispatches to"| node_auth_ui
node_startup -->|"dispatches to"| node_developer_ui
node_startup -->|"dispatches to"| node_test_ui
node_startup -->|"wires service"| node_auth_service
node_startup -->|"wires service"| node_developer_service
node_startup -->|"wires service"| node_test_service
node_auth_ui -->|"authenticates via"| node_auth_service
node_developer_ui -->|"manages developers"| node_developer_service
node_test_ui -->|"manages tests"| node_test_service
node_auth_service -->|"reads credentials"| node_developer_store
node_developer_service -->|"manages records"| node_developer_store
node_developer_service -->|"removes developer tests"| node_test_store
node_test_service -->|"manages tests"| node_test_store
node_test_service -->|"manages cases"| node_case_store
node_test_service -->|"removes test cases"| node_case_store

click node_startup "https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasapresentacao.cpp"
click node_auth_ui "https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasapresentacao.cpp"
click node_developer_ui "https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasapresentacao.cpp"
click node_test_ui "https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasapresentacao.cpp"
click node_contracts "https://github.com/caua-21/gerenciador-de-testes/blob/main/interfaces.h"
click node_domain_types "https://github.com/caua-21/gerenciador-de-testes/blob/main/dominios.cpp"
click node_entities "https://github.com/caua-21/gerenciador-de-testes/blob/main/entidades.h"
click node_auth_service "https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasservico.cpp"
click node_developer_service "https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasservico.cpp"
click node_test_service "https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasservico.cpp"
click node_developer_store "https://github.com/caua-21/gerenciador-de-testes/blob/main/conteiners.cpp"
click node_test_store "https://github.com/caua-21/gerenciador-de-testes/blob/main/conteiners.cpp"
click node_case_store "https://github.com/caua-21/gerenciador-de-testes/blob/main/conteiners.cpp"

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_startup,node_auth_ui,node_developer_ui,node_test_ui,node_user toneBlue
class node_domain_types,node_entities toneAmber
class node_contracts,node_auth_service,node_developer_service,node_test_service toneMint
class node_developer_store,node_test_store,node_case_store toneRose
```

## Components

### Console interaction

- [Menu navigation](https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasapresentacao.cpp): `controladorasapresentacao.cpp`
- [Login screen](https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasapresentacao.cpp): `controladorasapresentacao.cpp`
- [Developer screens](https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasapresentacao.cpp): `controladorasapresentacao.cpp`
- [Test screens](https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasapresentacao.cpp): `controladorasapresentacao.cpp`

### Domain model

- [Validated types](https://github.com/caua-21/gerenciador-de-testes/blob/main/dominios.cpp): `dominios.cpp`
- [Developer and tests](https://github.com/caua-21/gerenciador-de-testes/blob/main/entidades.h): `entidades.h`

### Service layer

- [Service interfaces](https://github.com/caua-21/gerenciador-de-testes/blob/main/interfaces.h): `interfaces.h`
- [Authentication](https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasservico.cpp): `controladorasservico.cpp`
- [Developer rules](https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasservico.cpp): `controladorasservico.cpp`
- [Test and case rules](https://github.com/caua-21/gerenciador-de-testes/blob/main/controladorasservico.cpp): `controladorasservico.cpp`

### Memory storage

- [Developer records](https://github.com/caua-21/gerenciador-de-testes/blob/main/conteiners.cpp): `conteiners.cpp`
- [Test records](https://github.com/caua-21/gerenciador-de-testes/blob/main/conteiners.cpp): `conteiners.cpp`
- [Case records](https://github.com/caua-21/gerenciador-de-testes/blob/main/conteiners.cpp): `conteiners.cpp`

### Other components

- **User**

## Connections

- User → Menu navigation: uses menus (evidence: `README.md`)
- Menu navigation → Login screen: dispatches to (evidence: `controladorasapresentacao.cpp`)
- Menu navigation → Developer screens: dispatches to (evidence: `controladorasapresentacao.cpp`)
- Menu navigation → Test screens: dispatches to (evidence: `controladorasapresentacao.cpp`)
- Menu navigation → Authentication: wires service
- Menu navigation → Developer rules: wires service
- Menu navigation → Test and case rules: wires service
- Login screen → Authentication: authenticates via (evidence: `README.md`)
- Developer screens → Developer rules: manages developers (evidence: `README.md`)
- Test screens → Test and case rules: manages tests (evidence: `README.md`)
- Authentication → Developer records: reads credentials (evidence: `controladorasservico.cpp`)
- Developer rules → Developer records: manages records (evidence: `controladorasservico.cpp`)
- Developer rules → Test records: removes developer tests (evidence: `controladorasservico.cpp`)
- Test and case rules → Test records: manages tests (evidence: `controladorasservico.cpp`)
- Test and case rules → Case records: manages cases (evidence: `controladorasservico.cpp`)
- Test and case rules → Case records: removes test cases (evidence: `controladorasservico.cpp`)
