SEDUC - Sistema de Gestão de Contratos e Projeções

Sistema inteligente para análise e gestão de contratos da Secretaria de Educação do Estado de São Paulo, com funcionalidades de projeção e análise preditiva.

Sobre o Projeto

Este projeto desenvolve um sistema integrado para a SEDUC-SP que transforma dados operacionais de contratos em insights acionáveis através de dashboards interativos.

Objetivos Principais

• Gestão Inteligente de Contratos: Monitoramento automatizado de contratos ativos com alertas de vencimento
• Análise Preditiva: Projeções baseadas em dados históricos para planejamento estratégico
• Dashboard Interativo: Interface web para análise em tempo real dos dados contratuais

Contexto Operacional

A SEDUC-SP gerencia:

• 3 milhões de alunos em todo o estado
• 5.400+ escolas espalhadas em 645 municípios
• 91 diretorias de ensino regionais
• Contratos ativos com valores significativos e prazos variados

Funcionalidades Principais

Dashboard Interativo

• KPIs em Tempo Real: Valor total de contratos, quantidade ativa, vencimentos próximos
• Análise por Unidade Gestora: Distribuição de contratos e valores por UG
• Projeções Temporais: Análise de tendências e previsões baseadas em dados históricos
• Visualizações Avançadas: Gráficos interativos com Plotly/Dash

Sistema de Projeções

• Forecasting Temporal: Análise de tendências usando modelos estatísticos
• Identificação de Padrões: Detecção de sazonalidade e anomalias
• Alertas Inteligentes: Sistema de notificações baseado em análise preditiva

Arquivos de Dados

Importante: O sistema requer o arquivo "Base CED" (CSV) para funcionamento. Este arquivo deve conter:

• Informações de contratos ativos
• Datas de vigência e vencimento
• Valores contratuais
• Unidades gestoras e credores
• Assuntos planejados

Tecnologias Utilizadas

• Python 3.13: Linguagem principal
• Dash/Plotly: Framework para dashboards interativos
• Pandas/NumPy: Manipulação e análise de dados
• StatsModels: Análise de séries temporais e projeções
• Kaleido: Exportação de gráficos estáticos

Acesso Online

Dashboard disponível 24/7:

https://seduc-contratos-804677531336.southamerica-east1.run.app

✅ Características:

• Instância sempre ativa (nunca "dorme")
• HTTPS automático e seguro
• Imagem imutável com dados embutidos
• Versões pinadas para máxima estabilidade
• Acessível de qualquer lugar, a qualquer momento

Instalação e Execução Local

Pré-requisitos

• Python 3.8+
• Arquivo "Base CED" no formato CSV

Instalação

# Clone o repositório
git clone [URL_DO_REPOSITORIO]

# Navegue para o diretório
cd Publicar_Git

# Crie ambiente virtual (recomendado)
python -m venv venv
source venv/bin/activate  # Linux/Mac
# ou
venv\Scripts\activate     # Windows

# Instale as dependências
pip install -r requirements.txt

Execução Local

Dashboard Interativo

python dashboard.py

Acesse: http://localhost:8050

Estrutura do Projeto

Publicar_Git/
├── dashboard.py              # Dashboard interativo principal
├── requirements.txt          # Dependências Python
├── Dockerfile               # Imagem containerizada
├── deploy.sh                # Script de deploy automatizado
├── assets/                  # Recursos estáticos
└── src/                     # Código fonte organizado
    ├── dashboards/          # Módulos de dashboard
    └── models/              # Modelos de dados e ML

Deploy

Deploy Ativo no Google Cloud Run

O sistema está deployed e funcionando no Google Cloud Run com as seguintes características:

• URL Pública: https://seduc-contratos-804677531336.southamerica-east1.run.app
• Região: southamerica-east1 (São Paulo)
• Configuração: Instância sempre ativa (min-instances=1)
• Segurança: HTTPS automático, acesso público controlado
• Estabilidade: Imagem Docker imutável com dados embutidos

Configuração de Deploy

O projeto inclui:

• Dockerfile: Imagem containerizada
• requirements.txt: Dependências pinadas
• deploy.sh: Script de deploy automatizado
• DEPLOY_CLOUD.md: Documentação completa de deploy

Contribuição

Este projeto foi desenvolvido para a Secretaria de Educação do Estado de São Paulo como parte de iniciativas de modernização e otimização de processos.

Status

PRODUÇÃO ATIVA - Sistema deployed e funcionando 24/7 no Google Cloud Run.

• Dashboard Online: Disponível publicamente com instância sempre ativa
• Estabilidade: Imagem imutável com versões pinadas
• Monitoramento: Logs e métricas disponíveis no Google Cloud Console
• Manutenção: Sistema autogerenciado com alta disponibilidade

---

Desenvolvido para a Secretaria de Educação do Estado de São Paulo