核心用法
Validation Rules Builder 是一款面向建筑工程领域的结构化数据验证工具，基于 Python 实现。其核心功能包括：
1. 多类型规则引擎：支持正则表达式（Regex）、数值范围（Range）、枚举值（Enum）、必填项（Required）、自定义函数（Custom）等六种验证类型，通过链式 API 快速构建验证规则集。
2. 预置建筑行业标准模式：内置 WBS 编码（XX.XX.XX）、成本编码（A-123456）、图纸编号、楼层命名、网格线等 10 余种建筑领域专用正则模板，开箱即用。
3. 批量验证与报告：可单条或批量验证数据记录，返回结构化结果，包含错误/警告计数、问题字段定位、原始值追溯，便于集成至 ETL 流程或 CI/CD 数据管道。
4. 构造专用封装类：提供 ConstructionValidators 静态工厂方法，一键生成成本项、进度活动、BIM 元素等场景化验证器。
显著优点
- 领域针对性：区别于通用校验库，深度适配 AEC（建筑、工程、施工）行业数据规范，减少重复造轮子。
- 可扩展架构：支持自定义正则模式与自定义验证函数，满足企业级私有规范需求。
- 流式接口：
add_xxx_rule()均返回self，支持链式调用，代码简洁可读。 - 分级 severity：区分 ERROR / WARNING / INFO，允许非阻断性校验，灵活适配不同数据治理策略。
潜在缺点与局限性
- 语言限制：仅提供 Python 实现，非 Python 技术栈需自行移植或封装为微服务。
- 性能瓶颈：大量正则匹配与批量数据验证在百万级记录场景下可能成为性能热点，未内置并行化或增量校验机制。
- 日期/跨字段逻辑薄弱：原生日期校验仅支持 ISO 格式字符串匹配，复杂跨字段逻辑（如“结束日期必须大于开始日期”）需通过
add_custom_rule自行实现，易引入运行时异常。 - 无持久化层：规则集仅存在于内存，重启后需重新构建，不支持规则版本管理与热更新。
适合人群
- 数据工程师 / ETL 开发者：构建建筑数据仓库前的清洗与质检环节。
- BIM 数据管理员：批量检查 IFC/COBie 导出数据的字段合规性。
- 成本 / 进度控制工程师：验证导入 ERP 或项目管理系统的成本编码、WBS 结构完整性。
- 软件开发团队：为建筑 SaaS 产品快速集成后端数据校验层。
常规风险
1. 正则拒绝服务（ReDoS）：若允许用户输入自定义正则模式，可能引入指数级回溯风险，导致 CPU 耗尽。
2. 敏感数据泄露：验证日志可能记录原始字段值，若包含造价、合同金额等商业机密，需脱敏处理。
3. 依赖注入：add_custom_rule 接受任意 Callable，若未对输入函数进行沙箱隔离，可能执行恶意代码。
4. 误报与漏报：过于严格的枚举规则可能拒绝合法但未预见的新增状态值；宽松的正则可能放过边缘格式错误。
技术生态
- 依赖：纯 Python 标准库（
re,dataclasses,typing等），零第三方依赖，Python 3.7+ 兼容。 - 集成建议：可打包为 Lambda/Container，通过 JSON Schema 映射暴露为 REST API；或与 Apache Airflow、Great Expectations 框架结合，增强数据管道可观测性。