核心用法
Validation Rules Builder 是一款面向建筑行业的数据质量验证工具，采用 Python 实现，支持正则表达式与逻辑规则双重验证机制。核心功能包括：
1. 多类型规则引擎：支持 REGEX（正则匹配）、RANGE（数值范围）、ENUM（枚举值）、REQUIRED（必填项）、CUSTOM（自定义函数）等 6 种规则类型，满足不同场景的数据校验需求。
2. 建筑行业预设模式：内置 WBS 编码（^[0-9]{2}\.[0-9]{2}\.[0-9]{2}$）、成本编码（^[A-Z]{1,3}-[0-9]{3,6}$）、活动 ID、图纸编号、标高名称等 10 余种建筑专用正则模板，开箱即用。
3. 流式 API 设计：通过链式调用（.add_regex_rule().add_range_rule()）快速构建复杂验证规则集，支持批量数据验证并生成结构化报告（含错误统计、记录索引定位）。
4. 分级严重度管控：ERROR/WARNING/INFO 三级严重度，可灵活配置阻断策略，适配数据清洗、质量报告等不同场景。
显著优点
- 专业性强：深度贴合建筑行业数据规范（CSI 编码体系、ISO 日期、BIM 标准），避免通用工具的适配成本
- 扩展性高：支持自定义正则模式注入与 Python 函数级校验，可处理跨字段逻辑（如起止日期合理性）
- 集成友好：纯 Python 实现，无外部依赖，可嵌入 ETL 管道、BIM 插件或成本管理系统
- 报告详尽：批量验证输出包含记录索引、字段名、错误消息、原始值，便于精准定位问题
潜在局限
- 无可视化界面：仅提供编程接口，业务人员需技术团队支持配置规则
- 正则性能瓶颈：超大规模数据集（百万级记录）全量正则匹配可能存在性能开销
- 缺少修复建议：仅标记错误，不自动提供数据清洗或修正方案
- 跨表引用受限：REFERENCE 类型规则在示例中定义但未完整实现，复杂关联验证能力有限
适合人群
- 建筑数据工程师 / BIM 经理：需要标准化模型元素与属性数据
- 成本管理顾问：验证估算数据、成本编码合规性
- 进度计划工程师：检查活动 ID、日期逻辑、完成百分比合理性
- 企业 IT 团队：构建数据质量门禁（Data Quality Gate）于数据湖或 ERP 集成流程
常规风险
- 规则配置错误：过于宽松的正则可能导致脏数据通过，过于严格则可能产生误报
- 敏感数据暴露：验证日志可能包含项目成本、进度等商业敏感信息，需管控日志访问权限
- 依赖字段缺失：验证逻辑未处理字段缺失异常（如
record.get()返回 None 后的类型转换），需确保输入数据 Schema 稳定 - Python 版本兼容性：使用
dataclass等 Python 3.7+ 特性，旧环境需升级