Orisumi

Example Entity

实体页的章节和每一章写什么

开头用一段话说明这种业务实体表达什么、是否作为观测内容,以及由哪个 Observer 形成。本页的结构图借用 Input Event 的节点,实际写作时换成自己的节点。

粒度

写什么构成一个实体,何时延续同一个实体,何时新建。用一个具体例子说明边界。更新和结束由业务代码判断。

身份

写怎样判断是同一个实体:依据哪些来源标识,标识在什么范围内有效,重启或重放时怎样处理。业务实体的身份与程序实例的身份分开写。

引用

字段目标
<角色>VersionId引用的目标及其业务含义

字段名以 VersionId 结尾,见 SCHEMA-8。没有引用时写“没有引用”。

事实时间

写对应的 Observation 是时间点还是时段、边界取自哪里、未知的边界怎样表示、补全时怎样更新。不作为观测内容的实体,写它的时间由哪些观测表达。

EntitySchema

项目值
SchemaId稳定的 UUIDv7,未确定时写“待定”
显示名称displayName
说明description:业务事实、粒度和事实时间的取值,必须填写
资源名resourceName,未确定时写“待定”
字段类型必填可空含义
字段名string 等是或否是或否含义、来源和省略的条件

引用和普通字段写在同一张表中,用类型 reference 区分。对象成员和数组元素逐项列出。声明格式见 EntitySchema · 字段约束。

示例

给出一个符合本页 EntitySchema 的业务实体,格式见 Input Event · 示例。

待定

  • 逐项列出尚未确认的字段、约束、标识或业务规则。

贡献者

页面历史