核心用法
Data Lineage Tracker 是一个专为建筑行业设计的数据血缘追踪系统，通过 Python 代码示例展示如何记录数据从源系统到最终报告的完整流转路径。主要功能包括：
- 数据源注册：登记 Procore、Sage 300 等系统的数据来源和责任人
- 实体血缘记录：追踪表、文件、字段等级别的数据实体及其父子关系
- 转换步骤记录：记录 ETL 操作（JOIN、AGGREGATE、CALCULATE 等）的输入输出映射
- 双向血缘追溯：
trace_upstream()追溯数据来源，trace_downstream()分析变更影响 - 可视化输出：生成 Mermaid 图表展示血缘关系，导出 JSON/ Markdown 报告
显著优点
安全架构优异：零第三方依赖，仅使用 Python 标准库（dataclasses, hashlib, uuid），无网络请求、无动态代码执行，安全评级达 S 级（92 分）。
行业针对性强：针对建筑项目审计合规需求设计，内置成本核算、预算对比等典型场景的示例代码。
审计友好：完整记录 transformation 的 performed_by、performed_at、logic 字段，满足 SOX、ISO 合规要求。
可扩展设计：基于 dataclass 的数据模型易于扩展，校验逻辑（validate_lineage）可检测循环依赖和孤儿实体。
潜在局限
非生产级实现：当前为代码示例（code example），无持久化存储（数据库/文件），所有数据驻留内存，进程结束即丢失。
无并发控制：未实现多用户场景下的写入冲突处理。
性能边界：血缘追溯使用递归实现，超大规模图（>10万节点）可能出现性能瓶颈。
适合人群
- 建筑企业数据治理团队，需要理解血缘追踪概念并基于此开发内部系统
- 审计合规人员，需要生成数据 provenance 报告满足监管要求
- 数据工程师，参考其标准库实现模式构建轻量级血缘追踪模块
常规风险
数据敏感性问题：导出的 JSON 报告可能包含成本、预算等商业敏感数据，分享前需脱敏。
完整性依赖人工录入：血缘准确性完全依赖于 record_transformation() 的调用时机和参数正确性，遗漏记录将导致血缘断裂。
无身份验证：代码示例中 performed_by 为字符串字段，无集成企业身份系统，存在冒名操作风险（生产环境需自行补强）。