compraspublica-shared 0.9.0__tar.gz

compraspublica_shared-0.9.0/.github/workflows/ci.yml

@@ -0,0 +1,86 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: pytest · Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install package (com deps mínimas)
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .[test]
+
+      - name: Lint (black + isort)
+        run: |
+          pip install black isort
+          black --check --diff compraspublica_shared tests
+          isort --check-only --diff compraspublica_shared tests
+
+      - name: Type check (mypy)
+        run: |
+          pip install mypy
+          mypy compraspublica_shared
+
+      - name: Pytest (com cobertura)
+        run: |
+          pytest --cov=compraspublica_shared --cov-report=term --cov-fail-under=80
+
+  build-wheel:
+    name: Build sdist + wheel
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    name: Publicar no PyPI (v1.0.0+)
+    needs: build-wheel
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1

compraspublica_shared-0.9.0/.gitignore

@@ -0,0 +1,53 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+*.egg
+build/
+dist/
+.eggs/
+.installed.cfg
+*.egg-info
+
+# Virtual environments
+.venv/
+venv/
+env/
+.env
+
+# Test cache
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+.cache
+coverage.xml
+*.cover
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Logs
+*.log
+logs/
+
+# ComprasPublica cache (runtime, gerado)
+$HOME/.compraspubl/
+*.cache

compraspublica_shared-0.9.0/CHANGELOG.md

@@ -0,0 +1,140 @@
+# Changelog
+
+Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
+
+O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/),
+e este projeto adere a [Semantic Versioning](https://semver.org/lang/pt-BR/).
+
+## [0.2.0] - 2026-09-20
+
+### Adicionado
+- **módulo `tse`** — prestação de contas eleitorais:
+  - `tse.baixar(ano)` — baixa/parsa CSVs do TSE → 3 parquets MT
+  - `tse.cruzamento_fornecedor(cnpj)` — cruzamento ad-hoc sem credores_analise
+  - `tse.cruzar(slug, ano)` — usa `credores_analise.json` do órgão
+- **módulo `cnes`** — DATASUS FTP:
+  - `cnes.baixar_uf(uf)` baixa/converte `.dbc`→DataFrame
+  - `cnes.leitos_de(uf, cnes)` soma leitos (existentes/SUS/nSUS/contratados)
+  - `cnes.estabelecimentos_de(st_df, cnpj)` filtra linhas
+  - `cnes.resumo(uf, cnpj)` snapshot consolidado (alvará, SUS, leitos)
+- **módulo `cadprev`** — SPREV dados abertos:
+  - `cadprev.consulta(tabela, **filtros)` paginação automática
+  - recortes: `cnpj_ente`, `identificacao`, `carteira`, `forma_gestao`,
+    `credenciadas`, `fundos_analisados`, `aplicacoes_resgate`,
+    `governanca`, `atas_comite`, `crp`
+  - `cadprev.resumo(cnpj_ente)` visão consolidada + `alertas`
+    (concentração >25%, desenquadramento CMN, custo >0,6% a.a.,
+    CRP vencido, DAIR em atraso)
+- **módulo `portal_transparencia`** — cliente API CGU:
+  - `PortalTransparencia(token=..., token_path=...)` com rate limit 400/min
+  - `pessoa_juridica`, `sancoes_cnpj`, `contratos_fornecedor`,
+    `pep`, `servidor_por_cpf`
+  - leitura de token: env `PORTAL_TRANSPARENCIA_TOKEN` →
+    `~/.compraspubl/portal_transparencia_token.json` →
+    `D:/Dev/EnemyDisclosure/shared_data/portal_transparencia_token.json`
+- **módulo `emendas`** — CGU focal:
+  - `emendas_por_autor(nome, ano)` — paginado + campos `valorXxxNum` (float)
+  - `emendas_para_municipio(nome, ano, municipio_substr)` — filtro client-side
+
+### Mudança
+- `_config.py` — adicionados:
+  - `TSE_CACHE_DIR`, `CNES_CACHE_DIR`
+  - `TSE_BASE_OLD`, `PORTAL_TRANSPARENCIA_BASE`, `CADPREV_BASE`
+  - `DATASUS_FTP`, `DATASUS_CNES_BASE`
+- bump para 0.2.0 em `__init__.py` + `pyproject.toml`
+
+## [0.3.0] - 2026-09-20
+
+### Adicionado
+- **módulo `amm_diario`** — Diário Oficial dos Municípios de MT:
+  - `editions(ate_pagina, desde)` — lista edições recentes
+  - `baixar(url)` — PDF com cache local
+  - `nomeacoes(pdf, municipio)` — regex de CPF perto de gatilhos de
+    nomeação/comissão
+  - `cruzar_com_socios(nomeados, socios_por_cpf)` — comissionado × QSA
+  - Deps opcionais `[amm]` = `pdfplumber`
+- **módulo `geocode`** — Nominatim/OSM:
+  - `geocodificar(...)` — lat/lon + `suspeito` (residencial/vazio/sem nº)
+  - `normalizar_cep(...)` — BrasilAPI /cep/v2 higieniza antes
+  - `haversine_m(...)`, `agrupar_por_ponto(...)` — clustering por ponto
+  - **`score_fachada_geografica(cnpj, geo, mesmo_ponto_n, valor_pago, cnae,
+    distancia_obra_km)`** — score 0-100 de fachada combinando sinais
+    (residencial + valor alto, terreno vago, sem número, múltiplos CNPJs
+    no mesmo ponto, CNAE industrial + residencial, distância sede→obra).
+    **Ressalva fixa: "indício não é prova".**
+- `_config.py`: adicionado `AMM_CACHE_DIR`
+
+### Mudança
+- bump para 0.3.0
+- **187 testes verdes** (+48 da E2) · cobertura **80,0%** (gate restaurado)
+- Compat retroativa Enemy: 57 testes continuam passando
+- **Roadmap**: P9.E14 estendido com "telhinha de mapa satélite + geo score"
+  no CompraPublica.AI (`#/geo`)
+
+## [0.2.0] - 2026-09-20
+
+### Adicionado
+- **módulo `tse`** — prestação de contas eleitorais (TSE prestação 2024):
+  - `tse.parquet_loader.baixar(ano)` — baixa/parsa CSVs do TSE → 3 parquets MT
+  - `tse.cruzamento.cruzar(slug, ano)` — usa `credores_analise.json`
+  - `tse.cruzamento.cruzamento_fornecedor(cnpj, ano)` — ad-hoc sem credores
+- **módulo `cnes`** — DATASUS FTP bulk:
+  - `cnes.baixar_uf(uf)`, `cnes.estabelecimentos_de(st, cnpj)`
+  - `cnes.leitos_de(uf, cnes)`, `cnes.resumo(uf, cnpj)`
+  - Deps opcionais `[cnes]` = `pyreaddbc` + `dbfread`
+- **módulo `cadprev`** — SPREV dados abertos (RPPS):
+  - `cadprev.consulta(tabela, **filtros)` paginação automática
+  - recortes: `cnpj_ente`, `identificacao`, `carteira`, `forma_gestao`,
+    `credenciadas`, `fundos_analisados`, `aplicacoes_resgate`,
+    `governanca`, `atas_comite`, `crp`
+  - `cadprev.resumo(cnpj_ente)` — visão consolidada + `alertas`
+    (concentração >25%, desenquadramento CMN, custo >0,6% a.a.,
+    CRP vencido, DAIR em atraso, gestor certificação vencida)
+- **módulo `portal_transparencia`** — cliente API CGU:
+  - `PortalTransparencia(token=..., token_path=...)` com rate limit 400/min
+  - `pessoa_juridica`, `sancoes_cnpj`, `contratos_fornecedor`,
+    `pep`, `servidor_por_cpf`
+  - leitura de token: env `PORTAL_TRANSPARENCIA_TOKEN` →
+    `COMPPUBL_PT_TOKEN_FILE` (env) →
+    `~/.compraspubl/portal_transparencia_token.json` →
+    fallback legacy `D:/Dev/EnemyDisclosure/shared_data/portal_transparencia_token.json`
+- **módulo `emendas`** — CGU focal:
+  - `emendas_por_autor(nome, ano)` — paginado + campos `valorXxxNum` (float)
+  - `emendas_para_municipio(nome, ano, municipio_substr)` — filtro client-side
+
+### Mudança
+- `_config.py` — adicionados:
+  - `TSE_CACHE_DIR`, `CNES_CACHE_DIR`
+  - `TSE_BASE_OLD`, `PORTAL_TRANSPARENCIA_BASE`, `CADPREV_BASE`
+  - `DATASUS_FTP`, `DATASUS_CNES_BASE`
+- bump para 0.2.0 em `__init__.py` + `pyproject.toml`
+- **139 testes verdes** (+78 testes novos) · cobertura **78,3%**
+  (gate temporário 75% — E9 fecha para 80%+)
+- Compat retroativa Enemy: **57 testes continuam passando**
+
+### Bug fix
+- `_valor_brl("1234.56")` — formato EN agora respeita ponto como decimal
+  (antes virava 123456.0)
+
+## [0.1.0] - 2026-09-20
+
+### Adicionado
+- **bootstrap**: estrutura do pacote Python pip-installable (`pyproject.toml`,
+  `setup.py`, `README.md`, `LICENSE`, `.gitignore`, `CHANGELOG.md`).
+- **módulo `sancoes`**: CEIS, CNEP, CEPIM, Acordos de Leniência — base local
+  cacheada, match por raiz de 8 dígitos, CLI `atualizar` e função
+  `checar(cnpj)`.
+- **módulo `brasilapi`**: BrasilAPI + fallback Minha Receita, cache local
+  com TTL, função `cnpj(cnpj)` retornando Receita completa + QSA + capital
+  + endereço + telefone + e-mail.
+- **`_config.py`**: lê env vars (`COMPPUBL_CACHE_DIR`, `COMPPUBL_HTTP_UA`,
+  `COMPPUBL_RATE_LIMIT`, `COMPPUBL_LOG_LEVEL`, `COMPPUBL_SANCOES_DIR`,
+  `COMPPUBL_BRASILAPI_CACHE`).
+- **`_log.py`**: logger configurado por env var.
+- **`erros.py`**: exceções tipadas (`CNPJInvalido`, `SancaoNaoEncontrada`,
+  `CacheMiss`, `FonteNaoConfigurada`, `RedeFalha`).
+- **scripts CLI**: `compraspubl-sancoes` (`atualizar`, `checar CNPJ`),
+  `compraspubl-brasilapi` (`enriquecer CNPJ [CNPJ...]`).
+- **CI GitHub Actions**: pytest em 3 Python versions (3.11, 3.12, 3.13).
+- **Compat retroativa** com `core/fontes/sancoes.py` e
+  `core/fontes/brasilapi.py` do EnemyDisclosure (wrappers thin).

compraspublica_shared-0.9.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Renato Rosa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

compraspublica_shared-0.9.0/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: compraspublica-shared
+Version: 0.9.0
+Summary: Forense pública de contratações — camada compartilhada EnemyDisclosure ↔ CompraPublica.AI
+Author-email: Renato Rosa <renato0503@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Renato Rosa
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Source Code, https://github.com/renato0503/compraspublica-shared
+Project-URL: Documentation, https://github.com/renato0503/compraspublica-shared/blob/main/README.md
+Project-URL: Issue Tracker, https://github.com/renato0503/compraspublica-shared/issues
+Keywords: auditoria-publica,compras-governamentais,lei-14-133,tce-mt,brasilapi,ceis,pncp,forense
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Legal Industry
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31
+Requires-Dist: pandas>=2.0
+Requires-Dist: pydantic>=2.5
+Provides-Extra: all
+Requires-Dist: curl-cffi>=0.7; extra == "all"
+Requires-Dist: scrapling>=0.2; extra == "all"
+Requires-Dist: playwright>=1.40; extra == "all"
+Requires-Dist: pyreaddbc>=1.0; extra == "all"
+Requires-Dist: dbfread>=2.0; extra == "all"
+Requires-Dist: networkx>=3.2; extra == "all"
+Requires-Dist: pdfplumber>=0.10; extra == "all"
+Requires-Dist: groq>=0.4; extra == "all"
+Provides-Extra: http
+Requires-Dist: curl-cffi>=0.7; extra == "http"
+Requires-Dist: scrapling>=0.2; extra == "http"
+Requires-Dist: playwright>=1.40; extra == "http"
+Provides-Extra: cnes
+Requires-Dist: pyreaddbc>=1.0; extra == "cnes"
+Requires-Dist: dbfread>=2.0; extra == "cnes"
+Provides-Extra: amm
+Requires-Dist: pdfplumber>=0.10; extra == "amm"
+Provides-Extra: test
+Requires-Dist: pytest>=7.4; extra == "test"
+Requires-Dist: pytest-cov>=4.1; extra == "test"
+Requires-Dist: pytest-mock>=3.11; extra == "test"
+Requires-Dist: httpx>=0.26; extra == "test"
+Requires-Dist: respx>=0.20; extra == "test"
+Provides-Extra: dev
+Requires-Dist: compraspublica-shared[all,test]; extra == "dev"
+Requires-Dist: mypy>=1.7; extra == "dev"
+Requires-Dist: black>=23.10; extra == "dev"
+Requires-Dist: isort>=5.12; extra == "dev"
+Requires-Dist: flake8>=6.1; extra == "dev"
+Requires-Dist: pre-commit>=3.5; extra == "dev"
+Dynamic: license-file
+
+# compraspublica-shared
+
+**Forense pública de contratações** — camada compartilhada entre [EnemyDisclosure](../EnemyDisclosure)
+(auditoria independente dos portais da transparência de 11 órgãos MT) e
+[CompraPublica.AI](../CompraPublica.AI) (painel de gestão do ciclo de contratações,
+Lei 14.133/2021).
+
+> **Missão**: trazer o motor de auditoria forense (CEIS/CNEP, BrasilAPI, TSE,
+> CNES, CADPREV, B-suite forense) para dentro do fluxo oficial de contratação —
+> de modo que pregoeiros, autoridades e cidadãos falem a mesma língua sobre
+> **risco de fornecedores**.
+
+## Capacidades (v0.1.0)
+
+- **Sanções federais** (CEIS · CNEP · CEPIM · Acordos de Leniência)
+  - Base local cacheada, match por **raiz de 8 dígitos** (pega grupo
+    econômico)
+  - `checar(cnpj)` → lista de sanções vigentes com órgão sancionador,
+    fundamentação legal, datas
+  - `atualizar()` → baixa/atualiza as 4 bases do Portal da Transparência
+
+- **Receita Federal via BrasilAPI** (grátis, sem chave)
+  - `cnpj(cnpj)` → razão social, QSA, capital social, CNAE, situação,
+    endereço, telefone, e-mail
+  - Fallback automático para **Minha Receita** (`minhareceita.org`) quando
+    BrasilAPI 404
+  - Cache local com TTL
+
+## Instalação
+
+### Modo dev (do código-fonte, editável)
+
+```bash
+git clone https://github.com/renato0503/compraspublica-shared
+cd compraspublica-shared
+pip install -e .[dev]            # tudo (deps + testes)
+# ou mínima:
+pip install -e .[test]           # só deps de runtime + teste
+```
+
+### Modo usuário (PyPI, depois de v1.0.0)
+
+```bash
+pip install compraspublica-shared[all]
+```
+
+### Sem dev (apenas consumo in-process)
+
+```bash
+pip install compraspublica-shared           # deps mínimas (~10 MB)
+pip install compraspublica-shared[http]     # + curl-cffi/Scrapling (~50 MB)
+pip install compraspublica-shared[cnes]      # + DATASUS FTP
+pip install compraspublica-shared[amm]       # + AMM diário oficial MT (PDF)
+```
+
+## Uso rápido
+
+```python
+from compraspublica_shared import sancoes, brasilapi
+
+# 1. Verificar se fornecedor está sancionado
+sancoes_encontradas = sancoes.checar("27.814.736/0001-50")
+# [{
+#   'base': 'CEIS',
+#   'razao_social': 'Conceito Serviços Técnicos LTDA',
+#   'sancao': 'Suspensão',
+#   'fundamento': 'Lei 8.666 art. 87 III',
+#   'orgao': 'Prefeitura de Tangará da Serra',
+#   'inicio': '17/08/2026',
+#   'fim': '17/02/2027',
+#   'raiz_apenas': False,
+# }]
+tem_sancao_vigente = bool(sancoes_encontradas)
+
+# 2. Buscar dados na Receita Federal
+ficha = brasilapi.cnpj("27.814.736/0001-50")
+# {
+#   'cnpj': '27814736000150',
+#   'razao_social': 'Conceito Serviços Técnicos',
+#   'capital_social': 50000.0,
+#   'situacao': 'ATIVA',
+#   'qsa': [{'nome': 'Fulano de Tal', 'cpf_cnpj': '***123456**',
+#            'qualificacao': 'Sócio-Administrador', 'entrada': '2024-01-15'}],
+#   'telefone': '6530285000',
+#   'email': 'financeiro@conceito.com',
+#   '_fonte': 'brasilapi',
+# }
+```
+
+## CLI
+
+```bash
+# Atualiza as 4 bases de sanções (CEIS, CNEP, CEPIM, Leniência)
+compraspubl-sancoes atualizar
+
+# Enriquece uma lista de CNPJs via BrasilAPI
+compraspubl-brasilapi enriquecer 27814736000150 14971626000150
+
+# A partir de um CSV com coluna 'cnpj'
+compraspubl-brasilapi enriquecer --csv fornecedores.csv
+```
+
+## Variáveis de ambiente
+
+| Var | Default | Função |
+|---|---|---|
+| `COMPPUBL_CACHE_DIR` | `$HOME/.compraspubl/cache` | Diretório de cache local (sancoes, brasilapi, http) |
+| `COMPPUBL_HTTP_UA` | `compraspublica-bot/1.0 (...)` | User-Agent para chamadas HTTP |
+| `COMPPUBL_RATE_LIMIT` | `0.35` | Segundos entre chamadas a APIs externas |
+| `COMPPUBL_LOG_LEVEL` | `INFO` | Nível de log |
+| `COMPPUBL_SANCOES_DIR` | `<cache>/sancoes/` | Path do cache de CEIS/CNEP/CEPIM/Leniência |
+| `COMPPUBL_BRASILAPI_CACHE` | `<cache>/brasilapi.json` | Path do cache de BrasilAPI |
+| `COMPPUBL_USE_SCRAPFLY` | `false` | Habilita fallback SaaS (precisa `SCRAPFLY_KEY`) |
+
+## Princípios inegociáveis
+
+1. **"Indício ≠ prova"** — toda flag retornada carrega a ressalva no payload.
+2. **100% dados públicos** — todas as fontes são abertas (BrasilAPI, Portal
+   da Transparência, TSE, etc.).
+3. **Trilha de auditoria** — cada chamada é loggable para auditoria
+   reversa.
+4. **LGPD opt-in** — QSA só exposto se o caller declarar permissão; opt-out
+   documentado.
+5. **Zero BaaS dentro da lib** — SQLite local + cache em disco + chamadas
+   HTTP gratuitas.
+
+## Roadmap de versões
+
+| Versão | Status | Conteúdo |
+|---|---|---|
+| **0.1.0** | ✅ (atual) | bootstrap + sanções + BrasilAPI |
+| 0.2.0 | 🕒 | TSE + CNES + CADPREV + Emendas |
+| 0.3.0 | 🕒 | AMM + Geocode |
+| 0.4.0 | 🕒 | Cascata multi-fonte de preço |
+| 0.5.0 | 🕒 | Schema canônico + 9 B-módulos forenses |
+| 0.6.0 | 🕒 | HTTP blindado 4 níveis |
+| 0.7.0 | 🕒 | Score consolidado + Graf mini + Pydantic |
+| 0.8.0 | 🕒 | API FastAPI standalone |
+| 0.9.0 | 🕒 | Testes 85% cobertura + CI matrix |
+| **1.0.0** | 🕒 | Release estável após 1 mês em prod |
+
+## Documentação adicional
+
+- `docs/instalacao.md` — guia detalhado de instalação
+- `EDPocket.md` (no repositório do EnemyDisclosure) — visão completa da
+  integração com o CompraPublica.AI
+- `sprint.md` (no repositório do EnemyDisclosure) — roadmap de
+  desenvolvimento
+
+## Licença
+
+MIT — veja `LICENSE`.

compraspublica_shared-0.9.0/README.md

@@ -0,0 +1,152 @@
+# compraspublica-shared
+
+**Forense pública de contratações** — camada compartilhada entre [EnemyDisclosure](../EnemyDisclosure)
+(auditoria independente dos portais da transparência de 11 órgãos MT) e
+[CompraPublica.AI](../CompraPublica.AI) (painel de gestão do ciclo de contratações,
+Lei 14.133/2021).
+
+> **Missão**: trazer o motor de auditoria forense (CEIS/CNEP, BrasilAPI, TSE,
+> CNES, CADPREV, B-suite forense) para dentro do fluxo oficial de contratação —
+> de modo que pregoeiros, autoridades e cidadãos falem a mesma língua sobre
+> **risco de fornecedores**.
+
+## Capacidades (v0.1.0)
+
+- **Sanções federais** (CEIS · CNEP · CEPIM · Acordos de Leniência)
+  - Base local cacheada, match por **raiz de 8 dígitos** (pega grupo
+    econômico)
+  - `checar(cnpj)` → lista de sanções vigentes com órgão sancionador,
+    fundamentação legal, datas
+  - `atualizar()` → baixa/atualiza as 4 bases do Portal da Transparência
+
+- **Receita Federal via BrasilAPI** (grátis, sem chave)
+  - `cnpj(cnpj)` → razão social, QSA, capital social, CNAE, situação,
+    endereço, telefone, e-mail
+  - Fallback automático para **Minha Receita** (`minhareceita.org`) quando
+    BrasilAPI 404
+  - Cache local com TTL
+
+## Instalação
+
+### Modo dev (do código-fonte, editável)
+
+```bash
+git clone https://github.com/renato0503/compraspublica-shared
+cd compraspublica-shared
+pip install -e .[dev]            # tudo (deps + testes)
+# ou mínima:
+pip install -e .[test]           # só deps de runtime + teste
+```
+
+### Modo usuário (PyPI, depois de v1.0.0)
+
+```bash
+pip install compraspublica-shared[all]
+```
+
+### Sem dev (apenas consumo in-process)
+
+```bash
+pip install compraspublica-shared           # deps mínimas (~10 MB)
+pip install compraspublica-shared[http]     # + curl-cffi/Scrapling (~50 MB)
+pip install compraspublica-shared[cnes]      # + DATASUS FTP
+pip install compraspublica-shared[amm]       # + AMM diário oficial MT (PDF)
+```
+
+## Uso rápido
+
+```python
+from compraspublica_shared import sancoes, brasilapi
+
+# 1. Verificar se fornecedor está sancionado
+sancoes_encontradas = sancoes.checar("27.814.736/0001-50")
+# [{
+#   'base': 'CEIS',
+#   'razao_social': 'Conceito Serviços Técnicos LTDA',
+#   'sancao': 'Suspensão',
+#   'fundamento': 'Lei 8.666 art. 87 III',
+#   'orgao': 'Prefeitura de Tangará da Serra',
+#   'inicio': '17/08/2026',
+#   'fim': '17/02/2027',
+#   'raiz_apenas': False,
+# }]
+tem_sancao_vigente = bool(sancoes_encontradas)
+
+# 2. Buscar dados na Receita Federal
+ficha = brasilapi.cnpj("27.814.736/0001-50")
+# {
+#   'cnpj': '27814736000150',
+#   'razao_social': 'Conceito Serviços Técnicos',
+#   'capital_social': 50000.0,
+#   'situacao': 'ATIVA',
+#   'qsa': [{'nome': 'Fulano de Tal', 'cpf_cnpj': '***123456**',
+#            'qualificacao': 'Sócio-Administrador', 'entrada': '2024-01-15'}],
+#   'telefone': '6530285000',
+#   'email': 'financeiro@conceito.com',
+#   '_fonte': 'brasilapi',
+# }
+```
+
+## CLI
+
+```bash
+# Atualiza as 4 bases de sanções (CEIS, CNEP, CEPIM, Leniência)
+compraspubl-sancoes atualizar
+
+# Enriquece uma lista de CNPJs via BrasilAPI
+compraspubl-brasilapi enriquecer 27814736000150 14971626000150
+
+# A partir de um CSV com coluna 'cnpj'
+compraspubl-brasilapi enriquecer --csv fornecedores.csv
+```
+
+## Variáveis de ambiente
+
+| Var | Default | Função |
+|---|---|---|
+| `COMPPUBL_CACHE_DIR` | `$HOME/.compraspubl/cache` | Diretório de cache local (sancoes, brasilapi, http) |
+| `COMPPUBL_HTTP_UA` | `compraspublica-bot/1.0 (...)` | User-Agent para chamadas HTTP |
+| `COMPPUBL_RATE_LIMIT` | `0.35` | Segundos entre chamadas a APIs externas |
+| `COMPPUBL_LOG_LEVEL` | `INFO` | Nível de log |
+| `COMPPUBL_SANCOES_DIR` | `<cache>/sancoes/` | Path do cache de CEIS/CNEP/CEPIM/Leniência |
+| `COMPPUBL_BRASILAPI_CACHE` | `<cache>/brasilapi.json` | Path do cache de BrasilAPI |
+| `COMPPUBL_USE_SCRAPFLY` | `false` | Habilita fallback SaaS (precisa `SCRAPFLY_KEY`) |
+
+## Princípios inegociáveis
+
+1. **"Indício ≠ prova"** — toda flag retornada carrega a ressalva no payload.
+2. **100% dados públicos** — todas as fontes são abertas (BrasilAPI, Portal
+   da Transparência, TSE, etc.).
+3. **Trilha de auditoria** — cada chamada é loggable para auditoria
+   reversa.
+4. **LGPD opt-in** — QSA só exposto se o caller declarar permissão; opt-out
+   documentado.
+5. **Zero BaaS dentro da lib** — SQLite local + cache em disco + chamadas
+   HTTP gratuitas.
+
+## Roadmap de versões
+
+| Versão | Status | Conteúdo |
+|---|---|---|
+| **0.1.0** | ✅ (atual) | bootstrap + sanções + BrasilAPI |
+| 0.2.0 | 🕒 | TSE + CNES + CADPREV + Emendas |
+| 0.3.0 | 🕒 | AMM + Geocode |
+| 0.4.0 | 🕒 | Cascata multi-fonte de preço |
+| 0.5.0 | 🕒 | Schema canônico + 9 B-módulos forenses |
+| 0.6.0 | 🕒 | HTTP blindado 4 níveis |
+| 0.7.0 | 🕒 | Score consolidado + Graf mini + Pydantic |
+| 0.8.0 | 🕒 | API FastAPI standalone |
+| 0.9.0 | 🕒 | Testes 85% cobertura + CI matrix |
+| **1.0.0** | 🕒 | Release estável após 1 mês em prod |
+
+## Documentação adicional
+
+- `docs/instalacao.md` — guia detalhado de instalação
+- `EDPocket.md` (no repositório do EnemyDisclosure) — visão completa da
+  integração com o CompraPublica.AI
+- `sprint.md` (no repositório do EnemyDisclosure) — roadmap de
+  desenvolvimento
+
+## Licença
+
+MIT — veja `LICENSE`.