Plataforma de Gestão Ambiental

Aplicativo desktop para gestão territorial e monitoramento ambiental no município de São Carlos - SP.

A versão publicada mais recente é a v1.1.20. Ela consolida o app como uma plataforma operacional com módulos de Compensações, TCRAs, painel, operações, mapa, autenticação, sincronização oficial e distribuição para Windows.

Download

Baixe a versão mais recente em GitHub Releases.

Os artefatos de release podem incluir:

• instalador Windows;
• pacote .zip;
• arquivo .sha256;
• latest.json para atualização automática;
• notas e guia de distribuição;
• script de verificação de checksum.

Módulos principais

Acesso

• Entrada separada para Produção e Demonstração.
• Produção com autenticação institucional e base oficial sincronizada.
• Demonstração com base local isolada para treinamento e testes.
• Suporte a perfis de acesso e troca de senha quando habilitado no ambiente oficial.

Compensações

• Lista principal voltada para consulta e triagem diária.
• Cadastro em janela própria, com formulário, revisão rápida e mapa integrado.
• Mapa ampliado para análise espacial e apoio ao endereço cadastrado.
• Geocodificação individual e em lote para preencher coordenadas e microbacia.
• Consulta por ofício/processo, endereço, microbacia, caixa, status e demais campos operacionais.
• Plantios vinculados, quantidade de mudas e controle de compensação.
• Geração de ficha individual.

TCRAs

• Cadastro, consulta e acompanhamento de Termos de Compromisso de Recuperação Ambiental.
• Controle de status operacional, prazos, relatório periódico, órgão/MPSP e responsável.
• Histórico de eventos do termo, com atalhos para relatório, vistoria, despacho e cumprimento.
• Detalhes em janela própria, com resumo, prazos, eventos e observações.
• Fila operacional com alertas de relatório pendente, prazo vencido, falta de responsável, ausência de número e termos sem movimentação.
• Auditoria e histórico para rastrear alterações relevantes.
• Exportação de relatórios em Excel e PDF.

Painel e Operações

• Indicadores do recorte atual.
• Visão por microbacia, pendências e status.
• Acompanhamento de sincronização, escrita, base local e base oficial.
• Histórico de operações e eventos de auditoria.
• Diagnóstico de suporte, backups e informações de ambiente.

Mapa

• Base cartográfica com microbacias.
• Marcador principal e pontos de plantio.
• Camadas GIS adicionais.
• Street View e mapa ampliado.
• Mapa de calor por dados cadastrados.

Capturas

Visão geral da aplicação

Splash screen

Stack principal

• Python 3.12
• PySide6
• SQLite local
• Supabase
• openpyxl
• pandas
• reportlab
• geopandas
• shapely
• pyogrio
• fiona
• pyproj
• requests
• PyInstaller
• pytest

Estrutura do projeto

Compensacoes_app/
|-- app/           Código principal da aplicação
|-- assets/        Ícones e recursos visuais
|-- data/          Planilha modelo, microbacias e cache local
|-- docs/          Documentação de operação e release
|-- scripts/       Automações de validação, build e release
|-- supabase/      Migrações e seed do banco remoto
|-- tests/         Suíte automatizada
|-- run.py         Ponto de entrada da aplicação
|-- README.md
`-- requirements.txt

Como executar localmente

No Windows PowerShell:

git clone https://github.com/DavidWIA2/Compensacoes_app.git
cd Compensacoes_app
python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
python run.py

Se você já usa a venv local do projeto:

.\.venv\Scripts\python.exe run.py

Testes e validação

Rodar a suíte completa:

.\.venv\Scripts\python.exe -m pytest -q

Validação rápida do app e do ambiente:

.\scripts\validate.ps1 -PythonExe .\.venv\Scripts\python.exe

Build e distribuição

Build local de release:

.\scripts\build_release.ps1 -PythonExe .\.venv\Scripts\python.exe -Clean

O app consulta por padrão:

https://github.com/DavidWIA2/Compensacoes_app/releases/latest/download/latest.json

A variável COMPENSACOES_UPDATE_URL pode ser usada para apontar o atualizador para outro manifesto.

Para detalhes de empacotamento, instalador, publicação e assinatura de código, veja docs/release.md.

Supabase

O repositório possui a base de integração com Supabase:

• migrations em supabase/migrations/;
• seed seguro em supabase/seed.sql;
• script administrativo de carga em scripts/sync_sqlite_to_supabase.py.

Guias relacionados:

• docs/supabase.md
• docs/supabase-transition-plan.md

Variáveis públicas de ambiente

Produção:

COMPENSACOES_SUPABASE_PROD_URL=https://seu-projeto.supabase.co
COMPENSACOES_SUPABASE_PROD_PUBLISHABLE_KEY=sb_publishable_...

Demonstração online opcional:

COMPENSACOES_SUPABASE_DEMO_URL=https://seu-projeto-demo.supabase.co
COMPENSACOES_SUPABASE_DEMO_PUBLISHABLE_KEY=sb_publishable_...

Sem projeto demo configurado, o app mantém a demonstração com base local fictícia.

Distribuição sem assinatura

O app pode ser distribuído internamente sem assinatura digital. Nesse caso, publique também o arquivo .sha256 e valide o artefato com:

.\verify_release_checksum.ps1 -ArtifactPath .\Compensacoes-vX.Y.Z-win64.zip

Releases

As versões publicadas ficam em GitHub Releases.

Autor

David Wiliam Pinheiro de Oliveira