data-model-designer

🏗️ 建筑项目数据模型设计专家

DataDrivenConstruction 出品的建筑数据建模工具,可快速生成实体关系图、SQL 模式及 JSON 结构,解决建筑工程数据碎片化与集成难题。

收藏
7.7k
安装
2k
版本
v2.1.0
CLS 安全性认证2026-05-11
点击查看完整报告 >

使用说明

Data Model Designer 是一款专为建筑工程领域设计的数据建模工具,旨在系统性解决施工项目中数据碎片化、结构不一致及跨系统集成困难等行业痛点。该 Skill 基于 Python 数据类(dataclass)实现,提供了一套完整的实体定义、关系管理和多格式导出能力,帮助用户快速构建从概念模型到物理数据库的完整数据架构。

核心用法围绕 ConstructionDataModel 类展开。用户通过实例化该类创建项目特定的数据模型,首先利用内置的 ConstructionEntities 工厂方法快速添加标准建筑实体(如项目基本信息、WBS 进度活动、成本核算项),或通过灵活的 create_entity 方法自定义实体结构,支持字段类型、约束条件(主键、外键、非空)的精细配置。随后通过 create_relationship 建立实体间关联(1:1、1:N、N:M),最终可一键生成 PostgreSQL/MySQL 等方言的 SQL DDL 语句、JSON Schema 验证规则,以及 Mermaid 格式的 ER 图,实现设计即代码(Design as Code)的高效工作流程。

显著优点体现在行业适配性上:预置了符合工程管理惯例的标准实体模板,大幅降低建模门槛;支持 SQL、JSON Schema、ER 图三种主流输出格式,满足 DBA、前端、业务分析师等不同角色需求;纯 Python 代码实现逻辑完全透明,便于企业根据内部规范二次开发;仅依赖 typing、dataclasses 等标准库,零外部依赖降低了供应链风险。

潜在局限性不容忽视:作为 T3 来源的社区工具,长期维护更新存在不确定性;数据类型系统相对基础,缺乏对 GIS 空间数据、BIM IFC 属性、时序数据等建筑工程特有类型的原生支持;生成的 SQL 较为标准化,未包含索引策略、分区方案、触发器等数据库性能优化要素;当前版本仅提供单机内存操作示例,缺乏并发控制、事务管理等企业级特性。

该 Skill 最适合建筑企业数据架构师、BIM 实施工程师及施工管理信息化团队,特别适用于多系统数据治理前期标准制定、企业级数据仓库维度建模、以及需要向非技术人员可视化展示数据关系的场景。

使用风险主要在于:提供的代码片段需开发者手动集成到现有系统框架,无法直接作为服务运行;缺少与现有 BIM 软件(如 Revit、Tekla)的自动数据同步机制;实体间的业务规则验证逻辑较为简单,复杂校验需自行扩展;建议在生产环境使用前进行充分测试,特别是外键约束在特定数据库方言下的兼容性验证。

安全解读

核心用法

Data Model Designer 是一款面向建筑工程领域的专业数据建模工具,核心功能包括:

1. 实体定义与管理
通过 ConstructionDataModel 类创建项目级数据模型,支持自定义实体(Entity)定义,包含字段类型(STRING/INTEGER/FLOAT/DATE等)、约束条件(主键、外键、唯一、非空)及默认值配置。内置标准建筑实体:项目(projects)、进度活动(activities)、成本项(cost_items)。

2. 关系建模
支持三种关系类型:一对一(1:1)、一对多(1:N)、多对多(N:M),通过 create_relationship 方法建立实体间关联,自动处理外键字段映射。

3. 多格式导出

  • SQL DDL:自动生成 PostgreSQL 等方言的建表语句,含主外键约束
  • JSON Schema:生成符合 JSON Schema 标准的校验规则
  • Mermaid ER 图:生成可视化实体关系图代码

4. 模型校验
内置 validate_model 方法检测缺失实体、孤立关系、无主键等常见问题。

显著优点

  • 领域专业化:针对建筑行业预置标准实体,降低建模门槛
  • 零依赖安全:纯 Python 示例代码,无第三方库依赖,供应链风险为零
  • 多格式兼容:一键生成 SQL/JSON/Mermaid 三种行业标准格式
  • 类型安全完整:枚举类型约束 DataType/RelationType/ConstraintType,避免字符串硬编码错误

潜在局限

  • 文档型技能限制:当前为 Markdown 文档形态,代码块需用户手动复制执行,非交互式工具
  • 方言覆盖有限:SQL 生成仅内置 PostgreSQL 映射,MySQL/SQL Server/Oracle 需手动调整类型映射
  • 复杂关系支持不足:多对多关系需手动创建中间表,无自动拆分解耦
  • 无版本控制:缺乏模型版本演进、迁移脚本生成能力

适合人群

  • 建筑信息化工程师:需为 BIM/ERP 系统设计底层数据结构的实施人员
  • 数据架构师:负责多系统数据整合、主数据管理(MDM)的专业人员
  • 施工企业 IT 部门:搭建自有项目管理平台的开发团队
  • 高校研究者:进行建筑数据标准化、IFC 映射相关学术研究

常规风险

  • 执行风险低:无可执行代码,无运行时安全风险
  • 数据合规:示例代码无敏感数据收集,符合 GDPR/CCPA
  • 来源可信:维护者 datadrivenconstruction 为 T2 级可信组织,GitHub 公开可溯源
  • 许可证待明确:当前未声明开源许可证,商用前建议联系维护者确认授权条款

data-model-designer 内容

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