# almeidaisabela/trabalho-seguranca-computacional architecture

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

- Interactive diagram: https://gitdiagram.com/almeidaisabela/trabalho-seguranca-computacional
- Repository: https://github.com/almeidaisabela/trabalho-seguranca-computacional

## Overview

Este é um sistema de votação eletrônica com cédulas cifradas por ElGamal, chave conjunta das autoridades, quadro público encadeado por hash e auditoria independente. O fluxo principal vai da configuração e do cadastro à votação, verificação do recibo, encerramento, apuração conjunta e auditoria dos dados publicados. A CLI unifica as operações; o auditor também pode ser executado separadamente. As conexões refletem trechos lidos, referências do índice de fontes e capacidades documentadas no README; módulos não amostrados não são detalhados além do que essas evidências sustentam.

Main entry points: [`autoridades/apuracao.py`](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/autoridades/apuracao.py) (Apuração conjunta), [`servidor/servidor.py`](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/servidor/servidor.py) (Servidor de votação), [`autoridades/autoridade.py`](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/autoridades/autoridade.py) (Autoridade eleitoral), [`eleitor/cliente.py`](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/eleitor/cliente.py) (Cliente do eleitor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entrada e persistência"]
  node_cli["CLI eleitoral<br/>[main.py]"]
  node_storage["Arquivos JSON<br/>[arquivos.py]"]
  node_public_data[("Dados públicos")]
  node_private_data[("Dados privados")]
end

subgraph group_election["Operação eleitoral"]
  node_voter["Cliente do eleitor<br/>[cliente.py]"]
  node_server["Servidor de votação<br/>[servidor.py]"]
  node_board[("Quadro encadeado<br/>[quadro.py]")]
end

subgraph group_tally["Apuração e auditoria"]
  node_authority["Autoridade eleitoral<br/>[autoridade.py]"]
  node_tally["Apuração conjunta<br/>[apuracao.py]"]
  node_auditor["Auditor independente<br/>[auditor.py]"]
end

subgraph group_crypto["Criptografia"]
  node_params["Parâmetros do grupo<br/>[params.py]"]
  node_elgamal["ElGamal homomórfico<br/>[elgamal.py]"]
  node_proofs["Provas criptográficas<br/>[provas.py]"]
  node_signatures["Assinaturas RSA<br/>[assinatura.py]"]
  node_serial["Serialização e hash<br/>[serial.py]"]
end

node_operator(("Operador"))

node_operator -->|"opera via"| node_cli
node_cli -->|"comanda etapas"| node_server
node_cli -->|"comanda votação"| node_voter
node_cli -->|"comanda autoridades"| node_authority
node_cli -->|"inicia apuração"| node_tally
node_cli -->|"inicia auditoria"| node_auditor
node_voter -->|"registra e envia"| node_server
node_voter -->|"confere recibo"| node_board
node_voter -->|"lê e grava"| node_storage
node_server -->|"publica registros"| node_board
node_server -->|"persiste estado"| node_storage
node_authority -->|"lê quadro"| node_board
node_authority -->|"lê e grava"| node_storage
node_tally -->|"solicita parciais"| node_authority
node_tally -->|"lê cédulas"| node_board
node_tally -->|"lê e publica"| node_storage
node_auditor -->|"lê dados públicos"| node_public_data
node_voter -->|"cifra cédula"| node_elgamal
node_voter -->|"assina e verifica"| node_signatures
node_voter -->|"canoniza dados"| node_serial
node_server -->|"verifica e assina"| node_signatures
node_server -->|"verifica provas"| node_proofs
node_server -->|"valida grupo"| node_params
node_server -->|"canoniza dados"| node_serial
node_board -->|"lê e grava quadro"| node_storage
node_board -->|"verifica encerramento"| node_signatures
node_board -->|"calcula hashes"| node_serial
node_authority -->|"usa grupo"| node_params
node_authority -->|"agrega cifras"| node_elgamal
node_authority -->|"prova decifração"| node_proofs
node_authority -->|"converte inteiros"| node_serial
node_tally -->|"combina cifras"| node_elgamal
node_tally -->|"verifica parciais"| node_proofs
node_tally -->|"usa grupo"| node_params
node_tally -->|"converte inteiros"| node_serial
node_auditor -->|"verifica assinaturas"| node_signatures
node_auditor -->|"verifica provas"| node_proofs
node_auditor -->|"confere parâmetros"| node_params
node_auditor -->|"recalcula hashes"| node_serial
node_elgamal -->|"usa parâmetros"| node_params
node_proofs -->|"usa parâmetros"| node_params
node_proofs -->|"canoniza desafios"| node_serial

click node_cli "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/main.py"
click node_storage "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/armazenamento/arquivos.py"
click node_public_data "https://github.com/almeidaisabela/trabalho-seguranca-computacional/tree/main/dados_publicos"
click node_private_data "https://github.com/almeidaisabela/trabalho-seguranca-computacional/tree/main/dados_privados"
click node_voter "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/eleitor/cliente.py"
click node_server "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/servidor/servidor.py"
click node_board "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/servidor/quadro.py"
click node_authority "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/autoridades/autoridade.py"
click node_tally "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/autoridades/apuracao.py"
click node_auditor "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/auditor/auditor.py"
click node_params "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/crypto/params.py"
click node_elgamal "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/crypto/elgamal.py"
click node_proofs "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/crypto/provas.py"
click node_signatures "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/crypto/assinatura.py"
click node_serial "https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/crypto/serial.py"

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_cli,node_storage,node_public_data,node_private_data toneBlue
class node_voter,node_server,node_board toneAmber
class node_authority,node_tally,node_auditor toneMint
class node_params,node_elgamal,node_proofs,node_signatures,node_serial toneRose
class node_operator toneIndigo
```

## Components

### Entrada e persistência

- [CLI eleitoral](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/main.py): `main.py`
- [Arquivos JSON](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/armazenamento/arquivos.py): `armazenamento/arquivos.py`
- [Dados públicos](https://github.com/almeidaisabela/trabalho-seguranca-computacional/tree/main/dados_publicos): `dados_publicos`
- [Dados privados](https://github.com/almeidaisabela/trabalho-seguranca-computacional/tree/main/dados_privados): `dados_privados`

### Operação eleitoral

- [Cliente do eleitor](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/eleitor/cliente.py): `eleitor/cliente.py`
- [Servidor de votação](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/servidor/servidor.py): `servidor/servidor.py`
- [Quadro encadeado](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/servidor/quadro.py): `servidor/quadro.py`

### Apuração e auditoria

- [Autoridade eleitoral](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/autoridades/autoridade.py): `autoridades/autoridade.py`
- [Apuração conjunta](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/autoridades/apuracao.py): `autoridades/apuracao.py`
- [Auditor independente](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/auditor/auditor.py): `auditor/auditor.py`

### Criptografia

- [Parâmetros do grupo](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/crypto/params.py): `crypto/params.py`
- [ElGamal homomórfico](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/crypto/elgamal.py): `crypto/elgamal.py`
- [Provas criptográficas](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/crypto/provas.py): `crypto/provas.py`
- [Assinaturas RSA](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/crypto/assinatura.py): `crypto/assinatura.py`
- [Serialização e hash](https://github.com/almeidaisabela/trabalho-seguranca-computacional/blob/main/crypto/serial.py): `crypto/serial.py`

### Other components

- **Operador**

## Connections

- Operador → CLI eleitoral: opera via (evidence: `README.md`)
- CLI eleitoral → Servidor de votação: comanda etapas (evidence: `main.py`)
- CLI eleitoral → Cliente do eleitor: comanda votação (evidence: `main.py`)
- CLI eleitoral → Autoridade eleitoral: comanda autoridades (evidence: `main.py`)
- CLI eleitoral → Apuração conjunta: inicia apuração (evidence: `main.py`)
- CLI eleitoral → Auditor independente: inicia auditoria (evidence: `main.py`)
- Cliente do eleitor → Servidor de votação: registra e envia (evidence: `eleitor/cliente.py`)
- Cliente do eleitor → Quadro encadeado: confere recibo (evidence: `eleitor/cliente.py`)
- Cliente do eleitor → Arquivos JSON: lê e grava (evidence: `eleitor/cliente.py`)
- Servidor de votação → Quadro encadeado: publica registros (evidence: `servidor/servidor.py`)
- Servidor de votação → Arquivos JSON: persiste estado (evidence: `servidor/servidor.py`)
- Autoridade eleitoral → Quadro encadeado: lê quadro (evidence: `autoridades/autoridade.py`)
- Autoridade eleitoral → Arquivos JSON: lê e grava (evidence: `autoridades/autoridade.py`)
- Apuração conjunta → Autoridade eleitoral: solicita parciais (evidence: `autoridades/apuracao.py`)
- Apuração conjunta → Quadro encadeado: lê cédulas (evidence: `autoridades/apuracao.py`)
- Apuração conjunta → Arquivos JSON: lê e publica (evidence: `autoridades/apuracao.py`)
- Auditor independente → Dados públicos: lê dados públicos (evidence: `README.md`)
- Cliente do eleitor → ElGamal homomórfico: cifra cédula (evidence: `eleitor/cliente.py`)
- Cliente do eleitor → Assinaturas RSA: assina e verifica (evidence: `eleitor/cliente.py`)
- Cliente do eleitor → Serialização e hash: canoniza dados (evidence: `eleitor/cliente.py`)
- Servidor de votação → Assinaturas RSA: verifica e assina (evidence: `servidor/servidor.py`)
- Servidor de votação → Provas criptográficas: verifica provas (evidence: `servidor/servidor.py`)
- Servidor de votação → Parâmetros do grupo: valida grupo (evidence: `servidor/servidor.py`)
- Servidor de votação → Serialização e hash: canoniza dados (evidence: `servidor/servidor.py`)
- Quadro encadeado → Arquivos JSON: lê e grava quadro (evidence: `servidor/quadro.py`)
- Quadro encadeado → Assinaturas RSA: verifica encerramento (evidence: `servidor/quadro.py`)
- Quadro encadeado → Serialização e hash: calcula hashes (evidence: `servidor/quadro.py`)
- Autoridade eleitoral → Parâmetros do grupo: usa grupo (evidence: `autoridades/autoridade.py`)
- Autoridade eleitoral → ElGamal homomórfico: agrega cifras (evidence: `autoridades/autoridade.py`)
- Autoridade eleitoral → Provas criptográficas: prova decifração (evidence: `autoridades/autoridade.py`)
- Autoridade eleitoral → Serialização e hash: converte inteiros (evidence: `autoridades/autoridade.py`)
- Apuração conjunta → ElGamal homomórfico: combina cifras (evidence: `autoridades/apuracao.py`)
- Apuração conjunta → Provas criptográficas: verifica parciais (evidence: `autoridades/apuracao.py`)
- Apuração conjunta → Parâmetros do grupo: usa grupo (evidence: `autoridades/apuracao.py`)
- Apuração conjunta → Serialização e hash: converte inteiros (evidence: `autoridades/apuracao.py`)
- Auditor independente → Assinaturas RSA: verifica assinaturas (evidence: `auditor/auditor.py`)
- Auditor independente → Provas criptográficas: verifica provas (evidence: `auditor/auditor.py`)
- Auditor independente → Parâmetros do grupo: confere parâmetros (evidence: `auditor/auditor.py`)
- Auditor independente → Serialização e hash: recalcula hashes (evidence: `auditor/auditor.py`)
- ElGamal homomórfico → Parâmetros do grupo: usa parâmetros (evidence: `crypto/elgamal.py`)
- Provas criptográficas → Parâmetros do grupo: usa parâmetros (evidence: `crypto/provas.py`)
- Provas criptográficas → Serialização e hash: canoniza desafios (evidence: `crypto/provas.py`)
