# rodrigoaiosa/simulador-enem architecture

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

- Interactive diagram: https://gitdiagram.com/rodrigoaiosa/simulador-enem
- Repository: https://github.com/rodrigoaiosa/simulador-enem

## Overview

O Simulador ENEM é uma aplicação Streamlit para estudantes: o fluxo principal vai do acesso e cadastro à escolha e resolução de questões, com feedback imediato e análise final. O README também documenta questões embaralhadas, scores por área, radar de competências, sugestões de estudo, revisão, histórico de sessão e exportação Excel. A lógica principal está concentrada em app.py; banco.py fornece cadastro e telemetria via Supabase. Alguns recursos são documentados, mas seus trechos de implementação não foram fornecidos.

Main entry points: [`app.py`](https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py) (Interface Streamlit), [`banco.py`](https://github.com/rodrigoaiosa/simulador-enem/blob/main/banco.py) (Cadastro de alunos), [`perguntas.json`](https://github.com/rodrigoaiosa/simulador-enem/blob/main/perguntas.json) (Questões ENEM)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Experiência do simulado"]
  node_streamlit["Interface Streamlit<br/>[app.py]"]
  node_access["Acesso e cadastro<br/>[app.py]"]
  node_quiz["Simulado e respostas<br/>[app.py]"]
  node_feedback["Feedback imediato<br/>[app.py]"]
end

subgraph group_analysis["Resultados e revisão"]
  node_scoring["Scores por área<br/>[app.py]"]
  node_competencies["Radar e sugestões<br/>[app.py]"]
  node_review["Revisão final<br/>[app.py]"]
  node_history["Histórico da sessão<br/>[app.py]"]
  node_report["Relatório Excel<br/>[app.py]"]
end

subgraph group_data["Questões e dados"]
  node_questionbank["Questões ENEM<br/>[perguntas.json]"]
  node_registration["Cadastro de alunos<br/>[banco.py]"]
  node_telemetry["Telemetria de acesso<br/>[banco.py]"]
end

subgraph group_services["Serviços externos"]
  node_supabase[("Supabase")]
end

node_student(("Estudante"))

node_student -->|"usa"| node_streamlit
node_streamlit -->|"exibe acesso"| node_access
node_access -->|"consulta cadastro"| node_registration
node_access -->|"cria cadastro"| node_registration
node_streamlit -->|"inicia simulado"| node_quiz
node_quiz -->|"usa questões"| node_questionbank
node_quiz -->|"mostra resposta"| node_feedback
node_streamlit -->|"registra eventos"| node_telemetry
node_streamlit -->|"registra resultados"| node_history
node_streamlit -->|"calcula scores"| node_scoring
node_streamlit -->|"apresenta análise"| node_competencies
node_streamlit -->|"mostra revisão"| node_review
node_streamlit -->|"gera relatório"| node_report
node_registration -->|"consulta e grava"| node_supabase
node_telemetry -->|"grava eventos"| node_supabase

click node_streamlit "https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py"
click node_access "https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py"
click node_quiz "https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py"
click node_feedback "https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py"
click node_scoring "https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py"
click node_competencies "https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py"
click node_review "https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py"
click node_history "https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py"
click node_report "https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py"
click node_questionbank "https://github.com/rodrigoaiosa/simulador-enem/blob/main/perguntas.json"
click node_registration "https://github.com/rodrigoaiosa/simulador-enem/blob/main/banco.py"
click node_telemetry "https://github.com/rodrigoaiosa/simulador-enem/blob/main/banco.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_streamlit,node_access,node_quiz,node_feedback toneBlue
class node_scoring,node_competencies,node_review,node_history,node_report toneAmber
class node_questionbank,node_registration,node_telemetry toneMint
class node_supabase toneRose
class node_student toneIndigo
```

## Components

### Experiência do simulado

- [Interface Streamlit](https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py): `app.py`
- [Acesso e cadastro](https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py): `app.py`
- [Simulado e respostas](https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py): `app.py`
- [Feedback imediato](https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py): `app.py`

### Resultados e revisão

- [Scores por área](https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py): `app.py`
- [Radar e sugestões](https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py): `app.py`
- [Revisão final](https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py): `app.py`
- [Histórico da sessão](https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py): `app.py`
- [Relatório Excel](https://github.com/rodrigoaiosa/simulador-enem/blob/main/app.py): `app.py`

### Questões e dados

- [Questões ENEM](https://github.com/rodrigoaiosa/simulador-enem/blob/main/perguntas.json): `perguntas.json`
- [Cadastro de alunos](https://github.com/rodrigoaiosa/simulador-enem/blob/main/banco.py): `banco.py`
- [Telemetria de acesso](https://github.com/rodrigoaiosa/simulador-enem/blob/main/banco.py): `banco.py`

### Serviços externos

- **Supabase**

### Other components

- **Estudante**

## Connections

- Estudante → Interface Streamlit: usa (evidence: `README.md`)
- Interface Streamlit → Acesso e cadastro: exibe acesso (evidence: `README.md`)
- Acesso e cadastro → Cadastro de alunos: consulta cadastro (evidence: `app.py`)
- Acesso e cadastro → Cadastro de alunos: cria cadastro (evidence: `app.py`)
- Interface Streamlit → Simulado e respostas: inicia simulado (evidence: `README.md`)
- Simulado e respostas → Questões ENEM: usa questões (evidence: `README.md`)
- Simulado e respostas → Feedback imediato: mostra resposta (evidence: `README.md`)
- Interface Streamlit → Telemetria de acesso: registra eventos (evidence: `app.py`)
- Interface Streamlit → Histórico da sessão: registra resultados (evidence: `README.md`)
- Interface Streamlit → Scores por área: calcula scores (evidence: `app.py`)
- Interface Streamlit → Radar e sugestões: apresenta análise (evidence: `README.md`)
- Interface Streamlit → Revisão final: mostra revisão (evidence: `app.py`)
- Interface Streamlit → Relatório Excel: gera relatório (evidence: `app.py`)
- Cadastro de alunos → Supabase: consulta e grava (evidence: `banco.py`)
- Telemetria de acesso → Supabase: grava eventos (evidence: `banco.py`)
