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.
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
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
- Baixe o pacote Windows disponibilizado na área de Releases ou no artefato de build autorizado.
- Extraia o ZIP em uma pasta local.
- Execute
GET-SINAPI-V3.exe. - No primeiro acesso, configure o usuário administrador e a senha.
- 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.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| get_sinapi-3.1.2.tar.gz | 62.8 kB | With provenance | Details for get_sinapi-3.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| get_sinapi-3.1.2-py3-none-any.whl | Python 3 | none | any | Details for get_sinapi-3.1.2-py3-none-any.whl |
Total release size: 121.1 kB
Release files / get_sinapi-3.1.2.tar.gz
| Download URL | get_sinapi-3.1.2.tar.gz |
|---|---|
| Size | 62.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
df4baef164d2d6d586748453ba31b69c4d329f4d3fecacd52839955a2c2a080e
|
|
BLAKE2b-256 checksum How to use checksums |
624f14ee135fa37677db0eaae5671c214eac44c52d31e2fa9f1cba400ba85cf8
|
| 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 logRelease files / get_sinapi-3.1.2-py3-none-any.whl
| Download URL | get_sinapi-3.1.2-py3-none-any.whl |
|---|---|
| Size | 58.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
844f9677048ae0f7abc0090f6f3ec5fdb02a30e73ad8a4151d46541af46f1541
|
|
BLAKE2b-256 checksum How to use checksums |
5613258c92905ce393ac19c44612281e0a53ee79c2f624a289efe6344bf03854
|
| 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 logSecurity for get-sinapi 3.1.2
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.
Attestation for get_sinapi-3.1.2.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 logA 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.