用途:为建筑项目的数据追踪来源、转换和流动,支持审计追溯、合规、数据治理以及数据问题调试。
主要能力:
- 登记数据源(名称、系统、位置、负责人)和数据实体(表、文件、字段、记录)。
- 记录转换步骤,类型包括抽取、转换、加载、聚合、连接、过滤、计算、手动编辑、导入、导出,并保存输入输出实体、逻辑说明、执行人和时间。
- 计算数据校验和(SHA256 前16位)用于校验。
- 追溯上游来源(trace_upstream)和下游依赖(trace_downstream),支持深度限制。
- 查看实体变更历史(get_entity_history)。
- 影响分析(impact_analysis),统计受影响的实体及层级分布。
- 血缘校验(validate_lineage),检查孤立实体、断裂引用和循环依赖。
- 生成 Mermaid 血缘关系图(generate_lineage_graph)。
- 导出完整血缘数据(export_lineage)并生成报告(generate_report)。
使用方式:通过 Python 类 ConstructionDataLineageTracker 实例化并传入项目 ID,依次注册数据源、实体,记录转换,再调用追溯或报告方法。依赖 Python 标准库(dataclasses、typing、datetime、enum、json、hashlib、uuid)。
适用场景:施工项目中的审计合规、数据问题定位、变更影响评估、法规与保险所需的来源证明。
限制:资料未提供安装命令、收费方式、具体平台支持或性能指标;实现为代码示例,需自行集成到项目环境中。