carrier-risk-platform

A Carrier Risk Platform é uma solução de código aberto projetada para fornecer pontuação de risco precisa em um ponto no tempo para transportadoras com base em dados federais da FMCSA (Federal Motor Carrier Safety Administration). O projeto utiliza uma pilha de tecnologia robusta centrada no Apache Airflow para orquestração de fluxos de trabalho, dbt para transformação de dados e Terraform para infraestrutura como código. O repositório inclui fluxos de trabalho abrangentes de CI/CD que garantem a qualidade e a segurança do código. Essas verificações são executadas em pull requests e pushes para a branch principal, utilizando runners hospedados no GitHub. As principais etapas de validação incluem varredura do Gitleaks com dados sensíveis redigidos, linting e formatação com Ruff, verificação estrita de tipos com mypy e uma suíte completa de pytest com imposição de cobertura de branches. O sistema impõe uma linha de base alta de cobertura de código (aproximadamente 88%) e exige pelo menos 80% de cobertura para linhas alteradas em módulos críticos como `ingest` e `orchestration`. A integridade dos dados é mantida por meio de builds do dbt que impõem contratos de modelos, regressões de idempotência e testes temporais. O teste de infraestrutura é realizado via Terraform, que valida configurações e exercita planos de provedores simulados sem implantar recursos reais na nuvem. O PostgreSQL é usado para fixtures de banco de dados local durante os testes, com credenciais geradas e mascaradas com segurança. A plataforma foi projetada para ser implantada na AWS, aproveitando o Terraform para gerenciamento de recursos.