Observatório Educacional da Paraíba

Pipeline e dashboard para análise da demanda por ensino superior na Paraíba a partir de dados do SiSU e da presença territorial do IFPB.

O Observatório Educacional da Paraíba é um projeto em Python voltado à análise da procura por cursos superiores em municípios paraibanos com presença do Instituto Federal da Paraíba (IFPB). A proposta amplia um estudo inicial sobre Picuí para um recorte estadual, permitindo observar padrões de demanda, residência dos candidatos, cursos, turnos e possíveis relações com a oferta local de ensino superior.

O projeto combina dados educacionais, bases de referência, processamento automatizado e visualização em dashboard para apoiar pesquisa aplicada, planejamento institucional e estudos sobre interiorização da educação superior.

---

Resumo executivo

Este repositório organiza uma base analítica para estudar a demanda por ensino superior na Paraíba a partir das inscrições registradas no SiSU.

Entrega principal: pipeline de tratamento + base processada + dashboard Streamlit
Stack: Python, pandas, Streamlit, dados educacionais, CSV e bases de referência
Recorte inicial: municípios paraibanos com presença do IFPB
Fase atual: ensino superior via SiSU
Uso: pesquisa educacional, planejamento institucional, análise territorial e apoio à produção acadêmica

---

Problema

A expansão e a interiorização da educação superior exigem dados capazes de mostrar não apenas onde há oferta institucional, mas também de onde vêm os estudantes interessados, quais cursos concentram maior procura e como essa demanda se distribui territorialmente.

No caso do IFPB, a presença de unidades em diferentes municípios da Paraíba cria uma pergunta relevante:

A demanda observada no SiSU dialoga com a localização das unidades, com a oferta superior disponível e com os fluxos territoriais de estudantes?

O projeto busca organizar dados para investigar essa questão com maior clareza.

---

Objetivo

Construir uma base analítica e um painel de visualização para apoiar estudos sobre a demanda por ensino superior na Paraíba, considerando:

• inscrições registradas no SiSU;
• município de residência dos candidatos;
• cursos superiores;
• turnos;
• municípios com presença do IFPB;
• oferta superior local mapeada em bases de referência;
• comparação entre demanda observada e oferta institucional.

---

Escopo inicial

Item	Definição
Território	Municípios paraibanos com presença do IFPB
Fase atual	Ensino superior via SiSU
Unidade analítica	Inscrições agregadas por ano, município de residência, curso e turno
Caso original preservado	Picuí permanece como estudo específico dentro da base estadual
Expansão futura	Possível incorporação de bases específicas de cursos técnicos

---

O que o projeto entrega

• Pipeline para geração de estudos municipais e estaduais
• Base processada com recorte Paraíba/IFPB
• Estudo estadual paraiba_ifpb_superiores
• Estudo específico preservado para Picuí
• Suporte à seleção manual de municípios por código
• Base de referência com municípios do IFPB na Paraíba
• Base de comparação da oferta superior do IFPB
• Registro de status da oferta superior presencial mapeada
• Dashboard em Streamlit para exploração dos resultados
• Estrutura organizada para documentação metodológica e produção acadêmica

---

Estrutura do repositório

.
├── data/
│   ├── raw/
│   ├── processed/
│   └── reference/
├── docs/
│   ├── metodologia/
│   └── paper/
│       └── figuras/
├── src/
├── dashboard/
│   └── app.py
├── ranking_paraiba.py
├── requirements.txt
└── README.md

---

Bases de referência

O projeto utiliza arquivos de referência para delimitar o recorte territorial e comparar demanda e oferta.

Municípios IFPB/PB

data/reference/municipios_ifpb_pb.csv

Base usada pelo estudo padrão paraiba_ifpb_superiores para identificar os municípios paraibanos com presença do IFPB.

Oferta superior IFPB/PB

data/reference/oferta_superior_ifpb_pb.csv

Base de comparação entre a demanda observada no SiSU e a oferta superior local do IFPB.

Status da oferta superior presencial

data/reference/status_oferta_superior_ifpb_pb.csv

Arquivo complementar que registra onde houve ou não oferta superior presencial mapeada na consulta realizada em 25 de março de 2026.

---

Fluxo de funcionamento

Dados do SiSU
      ↓
Recorte territorial da Paraíba
      ↓
Filtro por municípios com presença do IFPB
      ↓
Agregação por ano, município, curso e turno
      ↓
Comparação com oferta superior local
      ↓
Geração de bases processadas
      ↓
Visualização no dashboard Streamlit
      ↓
Apoio à análise institucional e pesquisa acadêmica

---

Como executar localmente

1. Criar ambiente virtual

python -m venv .venv

2. Ativar o ambiente virtual

No Windows:

.venv\Scripts\activate

No Linux/macOS:

source .venv/bin/activate

3. Instalar dependências

pip install -r requirements.txt

4. Executar o estudo padrão

python ranking_paraiba.py --billing-project SEU_PROJETO_REAL

O comando padrão gera o estudo:

paraiba_ifpb_superiores

usando o cadastro de municípios em:

data/reference/municipios_ifpb_pb.csv

---

Uso com variável de ambiente

Também é possível definir o projeto de billing por variável de ambiente.

No PowerShell:

$env:BD_BILLING_PROJECT="seu-projeto-real"
python ranking_paraiba.py

---

Executar estudos específicos

Estudo estadual padrão

python ranking_paraiba.py --billing-project SEU_PROJETO_REAL

Estudo específico de Picuí

python ranking_paraiba.py --billing-project SEU_PROJETO_REAL --study-name picui --study-label "Picuí (PB)" --municipio 2511400

Estudo com municípios selecionados manualmente

python ranking_paraiba.py --billing-project SEU_PROJETO_REAL --municipios 2511400,2504009

---

Abrir o dashboard

Após gerar os dados processados, execute:

streamlit run dashboard/app.py

O dashboard permite explorar os resultados produzidos pelo pipeline e apoiar análises sobre demanda, território e oferta educacional.

---

Interpretação dos dados

As contagens representam inscrições registradas no SiSU.

Elas não equivalem, por si só, a:

• matrícula efetiva;
• permanência estudantil;
• conclusão de curso;
• evasão;
• ocupação final de vagas;
• demanda total por educação superior.

Portanto, os resultados devem ser interpretados como sinais de procura e interesse declarados no processo seletivo, não como medida direta de trajetória acadêmica posterior.

---

Possíveis perguntas de pesquisa

O projeto pode apoiar investigações como:

• Quais cursos superiores concentram maior procura nos municípios com presença do IFPB?
• De quais municípios vêm os candidatos interessados em determinados cursos?
• A demanda registrada no SiSU se concentra no entorno dos campi ou apresenta fluxos mais amplos?
• Há cursos com alta procura sem correspondência direta com a oferta local?
• Como a interiorização da oferta superior se relaciona com os padrões de residência dos candidatos?
• O caso de Picuí apresenta comportamento semelhante ou distinto do padrão estadual?

---

O que este projeto demonstra

Este repositório evidencia competências em:

• análise de dados educacionais;
• organização de bases públicas;
• recorte territorial e institucional;
• processamento automatizado com Python;
• uso de dados do SiSU;
• criação de dashboards com Streamlit;
• construção de indicadores para pesquisa aplicada;
• documentação metodológica;
• integração entre tecnologia, educação e planejamento institucional.

---

Roadmap

Concluído ou em funcionamento

• Estrutura inicial do projeto
• Recorte estadual da Paraíba
• Preservação do estudo original de Picuí
• Base de referência dos municípios IFPB/PB
• Base de oferta superior IFPB/PB
• Script principal ranking_paraiba.py
• Execução por projeto de billing
• Dashboard Streamlit

Próximas etapas

• Melhorar documentação metodológica
• Adicionar exemplos visuais do dashboard
• Criar figuras para artigo ou relatório técnico
• Consolidar indicadores comparativos entre municípios
• Incorporar análise por ano, curso e turno de forma mais explorável
• Avaliar expansão futura para cursos técnicos
• Criar seção de resultados preliminares
• Adicionar testes básicos de consistência dos dados

---

Limitações

O projeto trabalha com dados de inscrição no SiSU e com bases de referência específicas.

Algumas limitações importantes:

• inscrição não equivale a matrícula;
• demanda registrada não mede permanência ou conclusão;
• códigos de município precisam estar corretamente padronizados;
• a oferta local pode mudar ao longo do tempo;
• bases públicas podem exigir atualização periódica;
• os resultados dependem do recorte e dos filtros aplicados.

Essas limitações devem ser consideradas em qualquer uso acadêmico, técnico ou institucional dos dados.

---

Licença

Consulte o arquivo LICENSE deste repositório.

---

Autor

Bráulio Roberto Rangel da Silva

Pesquisador e desenvolvedor com atuação em dados públicos, automação, observatórios digitais, educação, comunicação e pesquisa aplicada.

GitHub: @brauliorrs