基于Python标准库的建筑数据血缘追踪方案，提供从数据源到报告的完整审计链路，满足合规要求并快速定位数据问题。
说明：
Data Lineage Tracker 是一款专为建筑行业设计的数据血缘追踪工具，通过 Python 实现从数据源到最终报告的完整链路记录。该工具采用纯标准库开发，无需外部依赖，支持审计合规、问题追溯和影响分析等关键数据治理需求。
**核心用法**
用户通过 `ConstructionDataLineageTracker` 类初始化项目追踪器，依次注册数据源（如 Procore、Sage 300）、数据实体（表、文件、字段），并使用 `record_transformation` 记录 ETL 过程中的转换步骤。工具支持双向血缘追溯：`trace_upstream` 追溯数据来源，`trace_downstream` 分析变更影响。同时提供 `generate_lineage_graph` 生成 Mermaid 可视化图表，以及 `export_lineage` 导出 JSON 格式审计数据。
**显著优点**
首先，纯 Python 标准库实现确保了零依赖风险和高兼容性，使用 `hashlib.sha256` 进行数据校验保障完整性。其次，完整覆盖数据治理需求：支持10种转换类型（提取、聚合、计算等），提供循环依赖检测和断链验证。第三，可视化能力突出，自动生成 Mermaid 流程图便于理解数据流向。最后，架构灵活，通过 dataclass 定义核心模型，易于扩展适配特定业务场景。
**潜在缺点与局限性**
当前实现主要作为概念验证和开发框架，缺乏生产级特性：数据仅存储于内存，无持久化机制；缺少并发控制和事务支持；未实现用户认证和权限管理。此外，T3 级别的社区来源意味着代码未经大规模生产验证，企业使用时需自行承担维护责任。性能方面，大规模数据（百万级实体）的追溯查询可能存在效率瓶颈。
**适合的目标群体**
主要面向建筑行业的数据工程师、BI 开发者和项目数据管理员，适用于需要满足 SOX、ISO 等合规审计要求的中大型建筑项目。同时适合作为数据治理教学示例，或作为企业级数据血缘系统的原型基础。
**使用风险**
性能风险方面，当前内存存储模式限制数据规模，且血缘追溯使用递归算法，深层链路可能导致栈溢出。数据持久化风险在于程序退出即丢失所有血缘记录，需自行实现数据库持久化。安全方面，虽然代码本身无恶意行为，但缺乏输入验证机制，不当使用可能导致数据不一致。建议生产环境部署前进行代码审查、添加参数校验，并配套实现数据备份策略。
