实体设计
一、概述
实体设计是构建数据模型的核心模块。通过实体定义，开发者可以设计数据库表结构，并作为流程节点中的数据源参与查询、更新、删除等操作。
产品支持三种类型的实体模板，并提供字段、关系、约束、导航等全面配置能力，帮助用户快速完成业务建模。
二、实体创建方式
1.1 从零开始创建
- 全新设计数据库结构
- 通过可视化界面添加表/列/关系
- 适合全新系统开发场景
1.2 从数据库导入
- 反向解析现有数据库（支持：MYSQL/PostgreSQL/SQL Server/Oracle/SQLite）
- 自动识别表结构、外键、索引
- 生成可编辑的实体模型（支持二次优化）
1.3 创建步骤
右击实体设计，选择添加 > 新建项。
三、实体类型模板
| 类型 | 预置字段 | 启用条件 | 适用场景 |
|---|---|---|---|
| 空白表 | 无 | 无 | 基础数据存储 |
| 审计表 | CreatorId，CreateAt，UpdaterId，UpdateAt | 需开启系统认证 | 需要操作追踪的业务表 |
四、核心配置功能
4.1 常规
- 表名：数据库物理表名。
- 架构：数据库Schema。
- 显示名称：界面显示名称。
- 描述：功能说明。
4.2 列配置
| 属性 | 说明 | 示例 |
|---|---|---|
| 列名 | 数据库字段名 | ProductPrice |
| 显示名称 | 界面展示名称 | 商品单价 |
| 数据类型 | 类型+长度/精度 | Decimal(10,2) |
| 主键 | 数据库主键（可设计多个主键） | 是 |
| 可空 | 是否允许为空（默认允许） | 是 |
| 集合 | 标记为数组类型 | 是 |
| 默认值 | 三选一：静态值（0），表达式（Now()），SQL(uuid_generate_v4()) | CURRENT_TIMESTAMP |
| 描述 | 字段注释 | 含税价格，单位：元 |
| 计算列 | 基于其他列的虚拟列 | qty*price |
序列可以替代流水号生成单号等业务，比流水号性能更高，并且是线程安全的：基于数据库生成（SQLite和MySQL不支持序列）。
五、外键配置
可为实体字段设置外键关系。
| 属性 | 说明 |
|---|---|
| 外键名称 | 唯一标识，系统默认自动生成，也可手动修改 |
| 引用实体及字段 | 指定目标主表与主键字段 |
| 删除规则 | 支持以下规则：不执行任何操作、级联删除、设置为空、设置默认值 |
| 描述 | 外键说明 |
六、索引配置
用于提升查询性能或约束唯一性。
| 属性 | 说明 |
|---|---|
| 索引名称 | 可手动定义，或使用系统默认命名 |
| 是否唯一 | 设置是否为唯一索引 |
| 字段升降序 | 每个字段可设置升序/降序 |
| 描述 | 索引说明 |
七、导航属性配置
用于实体之间的访问与导航。
7.1 一对一
-
在当前实体添加外键字段。
-
对该外键字段添加唯一索引。
7.2 一对多
在"多"端实体添加外键字段。
7.3 多对多
- 创建一张中间表。
- 包含两个外键字段，分别指向两边实体。
- 将两个字段联合设为复合主键。
