← 返回首页

自建业务实体与动态记录

# anenreo 自建业务实体与动态记录

## 目标

允许用户在 PC 数据模型中心创建新的业务实体，例如学习资料、宠物、收藏品或投资项目，并通过字段、字典、表单和视图定义形成真实可录入、可查询、可版本化的数据链路。

## 关键边界

动态实体不是任意代码生成器。配置可以决定字段、控件、分组、字典、时间和附件类型，但不能写入任意 Vue、JavaScript、SQL 或 HTTP 脚本。权限、加密、事务、幂等、删除和高风险规则仍由后端确定性代码实施。

## 数据结构

- `entity_type_definition`：实体语义、来源、存储策略、隐私和生命周期。
- `field_definition`：字段类型、字典、时间精度、附件种类、敏感等级和 AI 策略。
- `relation_type_definition`：实体之间的有向关系、基数和审核规则。
- `form_definition` / `form_version`：创建、编辑、审核和移动采集表单版本。
- `view_definition`：列表、卡片、详情、时间轴、日历、看板和图谱视图定义。
- `dynamic_record` / `dynamic_record_revision`：正式动态记录及不可变修订历史。

## 完整运行链路

```text
PC 创建实体
→ 添加字段并绑定字典/时间/附件
→ 发布表单
→ Web 或移动端读取已发布表单
→ 动态渲染并校验
→ DynamicRecordService 事务写入当前记录与修订
→ 列表、详情、编辑、归档、恢复、销毁和导出
```

## Web 与移动端

Web 提供完整数据模型配置与自建实体工作台；移动端只消费已经发布的实体和表单，提供列表、创建、详情和编辑，不允许修改 Schema、Provider 或密钥。

## 版本与删除

- 实体、字段、表单和视图均有 revision。
- 系统视图模板为只读，只能克隆为用户视图后修改。
- 动态记录支持归档、恢复、永久销毁和修订历史。
- 永久销毁不等于普通归档，必须经过明确确认并留下审计事件。