Skip to main content
GET-SINAPI — plataforma privada para consulta e análise de custos SINAPI

GET-SINAPI

PLATAFORMA DESKTOP · CONSULTA SINAPI · ENGENHARIA DE CUSTOS

Aplicação privada para Windows que transforma publicações oficiais da CAIXA/SINAPI em consultas, análises, comparações e orçamentos rastreáveis.

Python React FastAPI SQLite Windows

Dados oficiais. Processamento local. Decisões de engenharia com rastreabilidade.


Visão geral

O GET-SINAPI é um aplicativo desktop privado para Windows. Ele reúne uma interface React, uma API local FastAPI, processamento Python e persistência SQLite. O launcher inicia os serviços na própria máquina e abre a plataforma no navegador padrão; o usuário não precisa iniciar manualmente os servidores.

O produto utiliza o PulseSINAPI como referência de experiência funcional, mas mantém pipeline e regras próprias para ingestão, qualidade, cálculo e rastreabilidade dos dados oficiais.

Distribuição atual: executável Windows privado. A aplicação não é um serviço web público nem possui autenticação centralizada na nuvem.

Funcionalidades disponíveis na aplicação

  • Dashboard com indicadores derivados da base efetivamente carregada.
  • Consulta de insumos com pesquisa, filtros e paginação.
  • Consulta de composições e detalhamento de componentes e coeficientes.
  • Comparação de preços por UF e competência, conforme cobertura disponível.
  • Cesta de orçamento e cálculo de totais.
  • Histórico das competências presentes na base local.
  • Relatórios e exportações disponibilizados pela versão atual.
  • Atualização da base com acompanhamento de estado e progresso.
  • Integridade, auditoria e informações de origem dos dados.
  • Gestão local de contas de acesso.

A disponibilidade de resultados depende das competências e dos arquivos oficiais efetivamente baixados, processados e validados. O sistema não deve apresentar dados ausentes como se fossem preços iguais a zero.

Capturas e arquitetura

Arquitetura local do GET-SINAPI: launcher Windows, React, FastAPI, Python e SQLite

A arquitetura é inteiramente local na distribuição atual:

Componente Tecnologia Responsabilidade
Aplicação desktop Python / PyInstaller Inicialização e encerramento dos serviços
Interface React + Vite + TypeScript Navegação, filtros, tabelas e visualizações
API FastAPI Consultas, autenticação local e operações
Processamento Python Coleta, validação, normalização e cálculos
Persistência SQLite Dados SINAPI e informações locais
Autenticação PBKDF2 + sessão local Login e controle de contas neste computador

Autenticação local

O primeiro acesso permite configurar a conta administradora. O identificador pode ser o e-mail do usuário, acompanhado de uma senha com no mínimo 12 caracteres.

  • O primeiro usuário cadastrado recebe o perfil de administrador.
  • O administrador pode cadastrar outras contas locais pela área de gestão de acessos.
  • As senhas não são armazenadas em texto puro: o backend deriva o hash com PBKDF2-HMAC-SHA256 e salt individual.
  • A sessão local tem duração de até oito horas.
  • Os registros de autenticação são mantidos no arquivo security/users.json, dentro do diretório de dados da aplicação.

Limite importante: as contas são locais e pertencem ao diretório de dados daquele computador. Cadastrar usuários em uma instalação não cria automaticamente contas nas instalações dos demais engenheiros. Ainda não há login centralizado, revogação remota, sincronização de contas ou compartilhamento central de orçamentos.

Armazenamento e diretório de dados

A aplicação utiliza SQLite local. O diretório de dados pode ser definido por configuração de ambiente; na distribuição desktop, o launcher prepara o ambiente de execução e mantém logs locais.

Não compartilhe o arquivo de banco ou o diretório de autenticação contendo dados operacionais sem avaliar previamente as implicações de segurança e consistência. Para vários engenheiros trabalharem com a mesma base e os mesmos orçamentos, será necessária uma camada de sincronização central — não faz parte do modelo atual.

Instalação e utilização

  1. Baixe o pacote Windows disponibilizado na área de Releases ou no artefato de build autorizado.
  2. Extraia o ZIP em uma pasta local.
  3. Execute GET-SINAPI-V3.exe.
  4. No primeiro acesso, configure o usuário administrador e a senha.
  5. Nos acessos seguintes, entre com as credenciais locais.

O launcher inicia a API e o frontend localmente, aguarda os serviços responderem e então abre a interface no navegador padrão.

Exportação em lote pelo terminal

Além do executável desktop, o pacote Python disponibiliza a interface de terminal pelo comando getsinapi. O menu interativo permite selecionar:

  • Todas as categorias ou apenas insumos, composições e componentes.
  • Uma competência específica ou todas as competências carregadas.
  • Uma UF específica ou todas as UFs disponíveis.
  • Regime de desoneração e modalidade de encargos.
  • Pesquisa por código ou descrição.
  • Saída em Excel (.xlsx), CSV ou nos dois formatos.

A exportação completa gera uma visão consolidada com os registros selecionados e arquivos/abas individualizados por categoria. No Excel, o consolidado e cada categoria ficam em abas próprias; no CSV, são gerados um arquivo consolidado e arquivos separados por categoria. Os CSVs usam UTF-8 com BOM e delimitador ponto e vírgula para melhor abertura no Excel em configurações regionais brasileiras.

Instalação e execução

Após a publicação da versão que contém essa funcionalidade no PyPI:

python -m pip install --upgrade get-sinapi
getsinapi

Ou execute diretamente o menu de exportação:

getsinapi export

O comando consulta a base SQLite local já carregada; não refaz o download dos pacotes oficiais a cada exportação. Na instalação desktop, utiliza o mesmo diretório de dados configurado pelo launcher. Em instalações independentes, defina GETSINAPI_DATABASE_PATH para apontar ao arquivo getsinapi.sqlite3 correto. A funcionalidade de terminal não substitui nem altera o executável Windows.

Desenvolvimento local

Requisitos: Python 3.11+ e Node.js 20+.

Backend

py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -e ".[dev]"
$env:GETSINAPI_DATABASE_PATH = "data/getsinapi.sqlite3"
uvicorn getsinapi.api.main:app --reload

API local: http://127.0.0.1:8000
Health check: http://127.0.0.1:8000/api/health
Documentação OpenAPI: http://127.0.0.1:8000/docs

Frontend

Em outro terminal:

cd frontend
npm install
npm run dev

Frontend de desenvolvimento: http://localhost:5173. O Vite encaminha as chamadas /api para a API local.

Qualidade e testes

ruff check .
pytest -v

O workflow Windows também compila o frontend, empacota a aplicação com PyInstaller e executa um smoke test da interface e do endpoint de saúde antes de publicar o artefato.

Pipeline e integridade dos dados

Camada Responsabilidade
Bronze Preservação dos pacotes oficiais recebidos
Staging Extração controlada e inventário dos arquivos
Silver Normalização, tipagem e validação
Gold Estruturas consolidadas para consulta e análise
Aplicação Consulta, comparação, cálculo e orçamento

Princípios:

  • Publicações oficiais da CAIXA como fonte de referência.
  • Nenhum dado sintético em produção.
  • Distinção entre zero publicado, valor ausente e falha de extração.
  • Preservação de competência, UF, regime e origem.
  • Valores monetários e coeficientes tratados com precisão decimal.
  • Atualizações incrementais e idempotentes, preservando o histórico válido.
  • Rastreabilidade até publicação, arquivo e referência de origem, conforme metadados disponíveis.

Cobertura e limitações conhecidas

  • A cobertura histórica depende dos pacotes efetivamente publicados, coletados e processados.
  • Os layouts legados anteriores a 2025 exigem tratamento específico; não se deve presumir cobertura histórica integral.
  • O armazenamento é SQLite local.
  • A autenticação é local, sem provedor externo.
  • Não há sincronização de dados ou orçamentos entre computadores.
  • A distribuição atual é desktop Windows; uma versão web hospedada não faz parte do escopo vigente.

Stack tecnológica

Python · React · TypeScript · Vite · FastAPI · SQLite · SQLAlchemy · Pandas · Pytest · Ruff · PyInstaller · GitHub Actions.

Licença e dados de terceiros

O código-fonte é distribuído sob a licença MIT, conforme o arquivo LICENSE. Essa licença não altera os direitos, termos de uso ou atribuição aplicáveis às publicações, marcas e dados de terceiros, incluindo os dados oficiais do SINAPI.


GET-SINAPI
NR TECH · Engenharia de Dados e Custos

Precisão na origem. Consistência no processamento. Confiança na consulta.

Metadata

Release files for get-sinapi 3.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for get-sinapi 3.1.3
File Size Uploaded Provenance Actions
get_sinapi-3.1.3.tar.gz 63.0 kB With provenance Details for get_sinapi-3.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for get-sinapi 3.1.3
File Interpreter ABI Platform Actions
get_sinapi-3.1.3-py3-none-any.whl Python 3 none any Details for get_sinapi-3.1.3-py3-none-any.whl

Total release size: 121.5 kB

Release files / get_sinapi-3.1.3.tar.gz

Download URL get_sinapi-3.1.3.tar.gz
Size 63.0 kB
Tags Source
SHA-256 checksum
How to use checksums
95e4eb3b69e6680f27bcfc9d6d0afd7b181697575d2547353e8f5d89bebc852a
BLAKE2b-256 checksum
How to use checksums
9608095b08322a20f140c55323042dc23d6024c081d94349a15a2b39e7b6d9b8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / get_sinapi-3.1.3-py3-none-any.whl

Download URL get_sinapi-3.1.3-py3-none-any.whl
Size 58.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8dea263d877034059028790fecc842b50d87493ea2d0c04bed9149152af9f04c
BLAKE2b-256 checksum
How to use checksums
a3d6a383fb5a8643c4928d2bc6ad8310b64f32bece3313b37ee799e1472717ed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for get-sinapi 3.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for get_sinapi-3.1.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page