# mariooliveiramps/forsoft-civa architecture

> Architecture diagram of the GitHub repository mariooliveiramps/forsoft-civa, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mariooliveiramps/forsoft-civa
- Repository: https://github.com/mariooliveiramps/forsoft-civa

## Overview

Forsoft CIVA is described as a digital international vaccination card. Its Java application includes authentication, country and actor administration, vaccine and vaccination records, and persistence; the README does not detail the end-to-end screens or routing. The graph shows evidenced DAO dependencies and database access, while grouping unsampled controller areas by domain rather than inferring their calls. The web tree is largely third-party plugins, so it is not mapped as product functionality.

Main entry points: [`app-civa/src/java/dao/ConnectionFactory.java`](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/ConnectionFactory.java) (JDBC connection), [`app-civa/src/java/dao/PortadorCivaDao.java`](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/PortadorCivaDao.java) (Card holder records), [`app-civa/src/java/controller/auth.java`](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/controller/auth.java) (Authentication), [`app-civa/src/java/dao/PaisDao.java`](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/PaisDao.java) (Country records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and roles"]
  node_auth["Authentication<br/>[auth.java]"]
  node_login_dao["Login lookup<br/>[LoginDao.java]"]
  node_role_controllers["Role administration"]
end

subgraph group_registry["People and geography"]
  node_country_controller["Country administration<br/>[pais.java]"]
  node_people_dao["Person records<br/>[PessoaDao.java]"]
  node_person["Person profile<br/>[Pessoa.java]"]
  node_address_dao["Address records<br/>[EnderecoDao.java]"]
  node_address["Address data<br/>[Endereco.java]"]
  node_documents_dao["Identity documents<br/>[DocsDao.java]"]
  node_documents["Document data<br/>[Docs.java]"]
  node_country_dao["Country records<br/>[PaisDao.java]"]
  node_country["Country data<br/>[Pais.java]"]
end

subgraph group_vaccination["Vaccination records"]
  node_holder_dao["Card holder records"]
  node_unit_dao["Vaccination units<br/>[UnidadeDao.java]"]
  node_vaccination_dao["Vaccination history<br/>[VacinacaoDao.java]"]
  node_vaccine_controller["Vaccine administration<br/>[vacina.java]"]
end

subgraph group_persistence["Persistence"]
  node_db_connection["JDBC connection"]
  node_mysql[("MySQL database")]
end

node_user(("Card user"))

node_user -.->|"signs in"| node_auth
node_auth -->|"checks credentials"| node_login_dao
node_auth -->|"uses profile"| node_person
node_country_controller -->|"manages countries"| node_country_dao
node_people_dao -->|"maps records"| node_person
node_address_dao -->|"maps records"| node_address
node_documents_dao -->|"maps records"| node_documents
node_country_dao -->|"maps records"| node_country
node_holder_dao -->|"loads history"| node_vaccination_dao
node_holder_dao -->|"loads units"| node_unit_dao
node_vaccination_dao -->|"queries units"| node_unit_dao
node_login_dao -->|"opens connection"| node_db_connection
node_people_dao -->|"opens connection"| node_db_connection
node_address_dao -->|"opens connection"| node_db_connection
node_documents_dao -->|"opens connection"| node_db_connection
node_country_dao -->|"opens connection"| node_db_connection
node_holder_dao -->|"opens connection"| node_db_connection
node_unit_dao -->|"opens connection"| node_db_connection
node_vaccination_dao -->|"opens connection"| node_db_connection
node_db_connection -->|"connects to"| node_mysql

click node_auth "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/controller/auth.java"
click node_login_dao "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/LoginDao.java"
click node_role_controllers "https://github.com/mariooliveiramps/forsoft-civa/tree/master/app-civa/src/java/controller"
click node_country_controller "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/controller/pais.java"
click node_people_dao "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/PessoaDao.java"
click node_person "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/model/Pessoa.java"
click node_address_dao "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/EnderecoDao.java"
click node_address "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/model/Endereco.java"
click node_documents_dao "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/DocsDao.java"
click node_documents "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/model/Docs.java"
click node_country_dao "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/PaisDao.java"
click node_country "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/model/Pais.java"
click node_holder_dao "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/PortadorCivaDao.java"
click node_unit_dao "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/UnidadeDao.java"
click node_vaccination_dao "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/VacinacaoDao.java"
click node_vaccine_controller "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/controller/vacina.java"
click node_db_connection "https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/ConnectionFactory.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_auth,node_login_dao,node_role_controllers,node_user toneBlue
class node_country_controller,node_people_dao,node_person,node_address_dao,node_address,node_documents_dao,node_documents,node_country_dao,node_country toneAmber
class node_holder_dao,node_unit_dao,node_vaccination_dao,node_vaccine_controller toneMint
class node_db_connection,node_mysql toneRose
```

## Components

### Access and roles

- [Authentication](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/controller/auth.java): `app-civa/src/java/controller/auth.java`
- [Login lookup](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/LoginDao.java): `app-civa/src/java/dao/LoginDao.java`
- [Role administration](https://github.com/mariooliveiramps/forsoft-civa/tree/master/app-civa/src/java/controller): `app-civa/src/java/controller`

### People and geography

- [Country administration](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/controller/pais.java): `app-civa/src/java/controller/pais.java`
- [Person records](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/PessoaDao.java): `app-civa/src/java/dao/PessoaDao.java`
- [Person profile](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/model/Pessoa.java): `app-civa/src/java/model/Pessoa.java`
- [Address records](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/EnderecoDao.java): `app-civa/src/java/dao/EnderecoDao.java`
- [Address data](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/model/Endereco.java): `app-civa/src/java/model/Endereco.java`
- [Identity documents](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/DocsDao.java): `app-civa/src/java/dao/DocsDao.java`
- [Document data](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/model/Docs.java): `app-civa/src/java/model/Docs.java`
- [Country records](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/PaisDao.java): `app-civa/src/java/dao/PaisDao.java`
- [Country data](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/model/Pais.java): `app-civa/src/java/model/Pais.java`

### Vaccination records

- [Card holder records](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/PortadorCivaDao.java): `app-civa/src/java/dao/PortadorCivaDao.java`
- [Vaccination units](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/UnidadeDao.java): `app-civa/src/java/dao/UnidadeDao.java`
- [Vaccination history](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/VacinacaoDao.java): `app-civa/src/java/dao/VacinacaoDao.java`
- [Vaccine administration](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/controller/vacina.java): `app-civa/src/java/controller/vacina.java`

### Persistence

- [JDBC connection](https://github.com/mariooliveiramps/forsoft-civa/blob/master/app-civa/src/java/dao/ConnectionFactory.java): `app-civa/src/java/dao/ConnectionFactory.java`
- **MySQL database**

### Other components

- **Card user**

## Connections

- Card user → Authentication: signs in
- Authentication → Login lookup: checks credentials (evidence: `app-civa/src/java/controller/auth.java`)
- Authentication → Person profile: uses profile (evidence: `app-civa/src/java/controller/auth.java`)
- Country administration → Country records: manages countries (evidence: `app-civa/src/java/controller/pais.java`)
- Person records → Person profile: maps records (evidence: `app-civa/src/java/dao/PessoaDao.java`)
- Address records → Address data: maps records (evidence: `app-civa/src/java/dao/EnderecoDao.java`)
- Identity documents → Document data: maps records (evidence: `app-civa/src/java/dao/DocsDao.java`)
- Country records → Country data: maps records (evidence: `app-civa/src/java/dao/PaisDao.java`)
- Card holder records → Vaccination history: loads history (evidence: `app-civa/src/java/dao/PortadorCivaDao.java`)
- Card holder records → Vaccination units: loads units (evidence: `app-civa/src/java/dao/PortadorCivaDao.java`)
- Vaccination history → Vaccination units: queries units (evidence: `app-civa/src/java/dao/VacinacaoDao.java`)
- Login lookup → JDBC connection: opens connection (evidence: `app-civa/src/java/dao/LoginDao.java`)
- Person records → JDBC connection: opens connection (evidence: `app-civa/src/java/dao/PessoaDao.java`)
- Address records → JDBC connection: opens connection (evidence: `app-civa/src/java/dao/EnderecoDao.java`)
- Identity documents → JDBC connection: opens connection (evidence: `app-civa/src/java/dao/DocsDao.java`)
- Country records → JDBC connection: opens connection (evidence: `app-civa/src/java/dao/PaisDao.java`)
- Card holder records → JDBC connection: opens connection (evidence: `app-civa/src/java/dao/PortadorCivaDao.java`)
- Vaccination units → JDBC connection: opens connection (evidence: `app-civa/src/java/dao/UnidadeDao.java`)
- Vaccination history → JDBC connection: opens connection (evidence: `app-civa/src/java/dao/VacinacaoDao.java`)
- JDBC connection → MySQL database: connects to (evidence: `app-civa/src/java/dao/ConnectionFactory.java`)
