Skip to content

🏗️ AutoINCC API v1.0.0 — Dados Abertos, Resiliência Distribuída e Inteligência de Custos da Construção Civil

Latest
Latest

Choose a tag to compare

View all tags
@LAMP-LUCAS LAMP-LUCAS released this 04 Sep 17:37
· 17 commits to main since this release
v1.0.0
2f7d981

"A transparência e a automação de séries temporais de custos são a fundação da engenharia de precisão e da gestão orçamentária no Brasil."

Temos o orgulho de lançar oficialmente a AutoINCC API v1.0.0, uma solução completa, robusta e open-source para extração, normalização, enriquecimento analítico e distribuição do Índice Nacional de Custo da Construção (INCC) — incluindo suas variantes setoriais INCC-M, INCC-DI, Materiais & Equipamentos, Serviços e Mão de Obra.

Desenvolvida sob os rigorosos princípios de Clean Architecture, Domain-Driven Design (DDD) e Test-Driven Development (TDD), a AutoINCC API junta-se ao ecossistema do autoSINAPI e do autoCUB como pilar essencial da inteligência orçamentária para a construção civil brasileira, acessível através do portal oficial mundoaec.com.

🌟 Principais Destaques & Capacidades

1. 🔄 Pipeline ETL Automatizado e Humanizado (Polite Crawling)

  • Extração multi-série: Integração nativa com a API SGS do Banco Central do Brasil (SGS 7447, SGS 192, etc.) e adaptadores extensíveis para FGV IBRE.
  • Polite Crawling: Delays aleatórios gaussiano-uniformes e headers rotativos para garantir ética e zero sobrecarga aos servidores públicos.
  • Armazenamento Star Schema: Tabelas dimensionais (dim_tempo, dim_categoria_incc) e tabela fato particionada (fato_incc) com integridade referencial estrita e deduplicação idempotente por UPSERT (ON CONFLICT).

2. ⚡ Resiliência e Distribuição em Escala

  • Task Queue Assíncrona com Celery & Redis: Disparo manual ou automatizado de rotinas pesadas de ETL sem travar a thread de atendimento da API.
  • Cache Inteligente Multi-Camada: Cache HTTP e in-memory via Redis com invalidação atômica pós-ingestão.
  • Idempotência Garantida: Re-execuções parciais ou totais do pipeline não duplicam registros nem distorcem acumulados históricos.

3. 📊 Camada Analítica Avançada (DaaS)

Além de fornecer dados históricos brutos, a API fornece inteligência estatística pré-processada:

  • Acumulados Históricos Oficiais: Variação mensal (%), acumulado em 12 meses (%) e acumulado no ano vigente (% YTD).
  • Decomposição Estrutural de Custos: Relação de peso e volatilidade entre Materiais, Serviços e Mão de Obra.
  • Correlações do Setor AEC: Coeficientes de correlação de Pearson e dispersão com índices irmãos (SINAPI e CUB).
  • Projeções de Tendência: Médias móveis ponderadas e análise de momentum para reajustes contratuais imobiliários.

4. 🛡️ Segurança, Conformidade e Documentação Viva

  • Licença GNU GPLv3: Garantia de software livre para toda a comunidade técnica e científica.
  • Auditoria de Segurança: Repositório 100% blindado, sem vazamento de segredos, tokens ou dados sensíveis.
  • OpenAPI 3.1.0 & Swagger UI Interativo: Documentação viva, clara e didática, com exemplos práticos de consumo para desenvolvedores e analistas de dados.
  • Portal Oficial: Totalmente integrado às soluções e ferramentas do ecossistema no mundoaec.com.

🚀 Como Iniciar com Docker Compose

Suba todo o ecossistema (PostgreSQL 15, Redis 7, Celery Worker, Init Container e FastAPI) com um único comando:

# 1. Clone o repositório
git clone https://github.com/LAMP-LUCAS/autoINCC_API.git
cd autoINCC_API

# 2. Configure suas variáveis de ambiente
cp .env.example .env

# 3. Inicialize todos os serviços orquestrados
docker-compose up -d --build

Acesse o Swagger UI em: http://localhost:8000/docs

📦 O que há de novo na v1.0.0

  • Estrutura completa de tabelas Star Schema em PostgreSQL 15 (dim_tempo, dim_categoria_incc, fato_incc).
  • Coleta automatizada com polite crawling e resiliência a falhas de rede.
  • Fila Celery integrada com Redis para jobs em background.
  • Suíte completa de testes automatizados unitários e de integração (pytest).
  • Pipeline de CI/CD via GitHub Actions com matriz Python 3.11/3.12 e validação de container Docker.
  • Licenciamento oficial sob GPLv3.
  • Hub oficial de distribuição e APIs conectado ao mundoaec.com.

Mundo AEC & Ecossistema de Dados Abertos para Construção Civil
Desenvolvido por LAMP-LUCAS para a comunidade AEC brasileira.

Assets 2
Loading