carrier-risk-platform

Carrier Risk Platform 是一个开源解决方案，旨在基于联邦 FMCSA（联邦汽车运输安全管理局）数据，为承运人提供时点准确的风险评分。该项目采用稳健的技术栈，核心包括用于工作流编排的 Apache Airflow、用于数据转换的 dbt，以及用于基础设施即代码的 Terraform。 该仓库包含全面的 CI/CD 工作流，以确保代码质量和安全性。这些检查在拉取请求和推送到主分支时运行，使用 GitHub 托管的运行器。关键验证步骤包括经过脱敏的 Gitleaks 机密扫描、Ruff 代码检查与格式化、使用 mypy 进行严格类型检查，以及带有分支覆盖率强制要求的完整 pytest 测试套件。系统强制执行较高的代码覆盖率基线（约 88%），并要求 `ingest` 和 `orchestration` 等关键模块中变更行至少达到 80% 的覆盖率。 数据完整性通过 dbt 构建来维护，这些构建强制执行模型契约、幂等性回归和时间测试。基础设施测试通过 Terraform 处理，它会验证配置并演练模拟提供程序计划，而不部署实际云资源。测试期间使用 PostgreSQL 作为本地数据库夹具，凭据会安全生成并掩码处理。该平台设计为部署在 AWS 上，利用 Terraform 进行资源管理。