validation-rules-builder

🏗️ 建筑数据智能验证与规则引擎

🥥62总安装量 15评分人数 17
100% 的用户推荐

来自 DataDrivenConstruction 的建筑数据验证方案,提供 RegEx 与逻辑规则引擎,确保 BIM 元素、成本代码及进度数据质量,助力构建标准化施工数据体系。

S

安全性较高,可在多数场景中优先使用

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 纯文档型资产,无危险函数调用(eval/exec/system/subprocess)
  • ✅ 无网络通信及用户数据收集行为,数据隐私安全
  • ✅ 代码仅使用 Python 标准库,无外部依赖及已知 CVE 漏洞
  • ⚠️ 代码示例为演示用途,生产环境需根据实际需求适配测试
  • ⚠️ 使用 `add_custom_rule` 方法时,自定义验证函数需用户自行确保安全性

使用说明

Validation Rules Builder 是一款专为建筑行业设计的数据验证规则构建技能,基于 Python 提供了一套完整的数据质量保障方案。该技能通过声明式 API 帮助用户快速构建针对施工数据的验证规则,确保 BIM 元素、成本代码、WBS 结构及进度数据的规范性和一致性。

核心用法围绕 ValidationRulesBuilder 类展开,支持六种验证类型:正则表达式(RegEx)验证适用于 WBS 代码(如 ^[0-9]{2}\.[0-9]{2}\.[0-9]{2}$)、成本代码等结构化字段;范围验证用于数值边界检查;枚举验证确保字段值在预定义集合内;必填验证防止数据缺失;自定义函数验证支持复杂业务逻辑;日期验证保障时间数据格式正确。技能采用流式接口设计(Fluent Interface),支持链式调用如 .add_required_rule().use_pattern().add_range_rule() 构建验证管道,并提供 ConstructionValidators 预置验证器快速应用于常见场景。

显著优点包括:针对建筑行业预置 10+ 种专业正则模式(如活动 ID、图纸编号、标高名称);支持错误(Error)、警告(Warning)、信息(Info)三级严重度分级;批量验证功能可处理大规模数据集并生成统计报告;代码结构清晰,仅依赖 Python 标准库(re、dataclasses、enum),零外部依赖风险。

潜在缺点在于:当前版本仅为代码示例和文档,非即插即用的 SaaS 服务,需开发者集成到现有系统;正则表达式在处理超大型 BIM 数据集时可能存在性能瓶颈;自定义验证函数(custom_func)的异常处理机制较为简单,复杂逻辑可能掩盖错误;缺乏可视化规则编辑器,非技术人员使用门槛较高。

适合目标群体包括:建筑数据工程师(负责 ERP/BIM 数据清洗)、施工管理软件开发者(集成验证模块)、BIM 协调员(制定数据交付标准)、成本工程师(验证工程量清单编码)以及 PMO 数据管理员(确保进度计划数据质量)。

使用风险主要涉及:示例代码需根据生产环境适配,直接复制使用可能不符合特定业务规则;自定义验证函数若包含复杂逻辑可能引入无限循环或内存泄漏;正则表达式在匹配复杂模式时存在回溯风险(Catastrophic Backtracking),建议对大文件分批验证;此外,该技能不提供持久化存储,验证规则需用户自行管理版本。

validation-rules-builder 内容

手动下载zip · 3.8 kB
SKILL.mdtext/markdown
请选择文件