Example Entity
实体页的章节和每一章写什么
开头用一段话说明这种业务实体表达什么、是否作为观测内容,以及由哪个 Observer 形成。本页的结构图借用 Input Event 的节点,实际写作时换成自己的节点。
粒度
写什么构成一个实体,何时延续同一个实体,何时新建。用一个具体例子说明边界。更新和结束由业务代码判断。
身份
写怎样判断是同一个实体:依据哪些来源标识,标识在什么范围内有效,重启或重放时怎样处理。业务实体的身份与程序实例的身份分开写。
引用
| 字段 | 目标 |
|---|---|
<角色>VersionId | 引用的目标及其业务含义 |
字段名以 VersionId 结尾,见 SCHEMA-8。没有引用时写“没有引用”。
事实时间
写对应的 Observation 是时间点还是时段、边界取自哪里、未知的边界怎样表示、补全时怎样更新。不作为观测内容的实体,写它的时间由哪些观测表达。
EntitySchema
| 项目 | 值 |
|---|---|
| SchemaId | 稳定的 UUIDv7,未确定时写“待定” |
| 显示名称 | displayName |
| 说明 | description:业务事实、粒度和事实时间的取值,必须填写 |
| 资源名 | resourceName,未确定时写“待定” |
| 字段 | 类型 | 必填 | 可空 | 含义 |
|---|---|---|---|---|
| 字段名 | string 等 | 是或否 | 是或否 | 含义、来源和省略的条件 |
引用和普通字段写在同一张表中,用类型 reference 区分。对象成员和数组元素逐项列出。声明格式见 EntitySchema · 字段约束。
示例
给出一个符合本页 EntitySchema 的业务实体,格式见 Input Event · 示例。
待定
- 逐项列出尚未确认的字段、约束、标识或业务规则。