# murilo-sousa44/ic-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/murilo-sousa44/ic-2026
- Repository: https://github.com/murilo-sousa44/ic-2026

## Overview

Este repositório implementa um painel Streamlit para explorar dados da Educação Infantil em Viçosa-MG: a pessoa usuária consulta métricas, aplica filtros e visualiza tendências, instituições e convênios, ou busca uma escola e sua trajetória. O módulo principal carrega tabelas SQLite e concentra as consultas, transformações e exibições; uma página separada explica os filtros e campos. A documentação atribui os dados ao Censo Escolar do INEP/MEC. Como os trechos do módulo principal são parciais, o mapa e algumas visualizações estão representados como capacidades, sem detalhar etapas internas não mostradas.

Main entry points: [`codigofonte.py`](https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py) (Painel Streamlit), [`pages/como_usar.py`](https://github.com/murilo-sousa44/ic-2026/blob/main/pages/como_usar.py) (Guia do painel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dados["Dados e consultas"]
  node_db[("Banco SQLite")]
  node_tabelas["Dados carregados<br/>[codigofonte.py]"]
end

subgraph group_analise["Análise do painel"]
  node_app["Painel Streamlit<br/>[codigofonte.py]"]
  node_filtros["Filtros do painel<br/>[codigofonte.py]"]
  node_resumo["Métricas anuais<br/>[codigofonte.py]"]
  node_tendencias["Tendências e contagens<br/>[codigofonte.py]"]
  node_convenios["Análise de convênios<br/>[codigofonte.py]"]
end

subgraph group_exploracao["Exploração institucional"]
  node_busca["Busca de instituição<br/>[codigofonte.py]"]
  node_trajetoria["Trajetória de matrículas<br/>[codigofonte.py]"]
  node_mapa["Mapa institucional<br/>[codigofonte.py]"]
end

subgraph group_ajuda["Ajuda ao usuário"]
  node_guia["Guia do painel<br/>[como_usar.py]"]
end

node_usuario(("Pessoa usuária"))

node_usuario -->|"consulta painel"| node_app
node_app -->|"consulta SQL"| node_db
node_db -->|"retorna dados"| node_tabelas
node_app -->|"aplica filtros"| node_filtros
node_app -->|"exibe métricas"| node_resumo
node_app -->|"gera gráficos"| node_tendencias
node_app -->|"exibe convênios"| node_convenios
node_app -->|"busca instituição"| node_busca
node_app -->|"exibe trajetória"| node_trajetoria
node_app -->|"renderiza mapa"| node_mapa
node_usuario -->|"consulta instruções"| node_guia

click node_app "https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py"
click node_tabelas "https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py"
click node_filtros "https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py"
click node_resumo "https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py"
click node_tendencias "https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py"
click node_convenios "https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py"
click node_busca "https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py"
click node_trajetoria "https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py"
click node_mapa "https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py"
click node_guia "https://github.com/murilo-sousa44/ic-2026/blob/main/pages/como_usar.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_db,node_tabelas toneBlue
class node_app,node_filtros,node_resumo,node_tendencias,node_convenios toneAmber
class node_busca,node_trajetoria,node_mapa toneMint
class node_guia toneRose
class node_usuario toneIndigo
```

## Components

### Dados e consultas

- **Banco SQLite**
- [Dados carregados](https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py): `codigofonte.py`

### Análise do painel

- [Painel Streamlit](https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py): `codigofonte.py`
- [Filtros do painel](https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py): `codigofonte.py`
- [Métricas anuais](https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py): `codigofonte.py`
- [Tendências e contagens](https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py): `codigofonte.py`
- [Análise de convênios](https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py): `codigofonte.py`

### Exploração institucional

- [Busca de instituição](https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py): `codigofonte.py`
- [Trajetória de matrículas](https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py): `codigofonte.py`
- [Mapa institucional](https://github.com/murilo-sousa44/ic-2026/blob/main/codigofonte.py): `codigofonte.py`

### Ajuda ao usuário

- [Guia do painel](https://github.com/murilo-sousa44/ic-2026/blob/main/pages/como_usar.py): `pages/como_usar.py`

### Other components

- **Pessoa usuária**

## Connections

- Pessoa usuária → Painel Streamlit: consulta painel
- Painel Streamlit → Banco SQLite: consulta SQL (evidence: `codigofonte.py`)
- Banco SQLite → Dados carregados: retorna dados (evidence: `codigofonte.py`)
- Painel Streamlit → Filtros do painel: aplica filtros (evidence: `codigofonte.py`)
- Painel Streamlit → Métricas anuais: exibe métricas (evidence: `codigofonte.py`)
- Painel Streamlit → Tendências e contagens: gera gráficos (evidence: `codigofonte.py`)
- Painel Streamlit → Análise de convênios: exibe convênios (evidence: `codigofonte.py`)
- Painel Streamlit → Busca de instituição: busca instituição (evidence: `codigofonte.py`)
- Painel Streamlit → Trajetória de matrículas: exibe trajetória (evidence: `codigofonte.py`)
- Painel Streamlit → Mapa institucional: renderiza mapa (evidence: `codigofonte.py`)
- Pessoa usuária → Guia do painel: consulta instruções (evidence: `pages/como_usar.py`)