4. 传递单数据结构:字段定义、状态流转模型与关键属性
传递单是审查意见驱动归档流程中的核心载体,它记录了变更内容从“提出”到“归档”的完整流转轨迹。理解传递单的数据结构,是配置传递单与变更记录联动规则的前提。本节从字段定义、状态模型和关键属性三个维度展开。
4.1 传递单字段定义
传递单的字段设计需兼顾业务语义与系统可扩展性。下表列出标准传递单的核心字段及其说明:
| 字段分组 | 字段名称 | 数据类型 | 说明 |
|---|---|---|---|
| 标识与溯源 | 传递单ID | 字符串(UUID) | 全局唯一标识,用于关联变更记录与归档包 |
| 来源系统 | 枚举 | 标识传递单发起方,如“审查系统”、“变更管理平台” | |
| 目标系统 | 枚举 | 标识传递单接收方,如“归档系统”、“配置库” | |
| 内容与描述 | 变更摘要 | 文本(256字符) | 简要描述变更内容,用于快速检索 |
| 变更详情 | 富文本 | 包含审查意见、修改说明、影响范围等完整信息 | |
| 关联与依赖 | 关联变更记录ID | 字符串列表 | 与该传递单关联的变更记录集合,支持一对多联动 |
| 父传递单ID | 字符串(可选) | 用于拆分或合并场景,指向原始传递单 | |
| 时间与状态 | 创建时间 | 时间戳 | 传递单生成时刻 |
| 状态 | 枚举 | 当前流转阶段,详见状态流转模型 | |
| 审计与签名 | 操作人 | 字符串 | 最后修改或确认的操作者标识 |
配置提示: 在联动配置中,“关联变更记录ID”字段是传递单与变更记录建立映射的关键。建议在系统设计时将该字段设为索引,以提升跨表查询性能。
4.2 状态流转模型
传递单的状态机定义了其生命周期中的合法状态及转换条件。标准模型包含以下五个核心状态:
- 草稿(Draft):传递单初始状态,允许编辑字段内容,尚未提交流转。
- 待审查(Pending Review):提交至审查环节,锁定关键字段,等待审查意见反馈。
- 审查中(In Review):审查人员正在处理,可附加意见或要求补充材料。
- 已通过(Approved):审查通过,触发归档包生成或变更记录联动更新。
- 已归档(Archived):最终状态,传递单与归档包绑定,不可再修改。
状态转换规则如下表所示:
| 当前状态 | 触发动作 | 目标状态 | 联动行为 |
|---|---|---|---|
| 草稿 | 提交 | 待审查 | 锁定字段,生成审查任务 |
| 待审查 | 开始审查 | 审查中 | 通知审查人员,记录开始时间 |
| 审查中 | 通过 | 已通过 | 更新关联变更记录状态,触发归档包预生成 |
| 审查中 | 驳回 | 草稿 | 解锁字段,退回修改,记录驳回原因 |
| 已通过 | 归档 | 已归档 | 绑定归档包,关闭变更记录联动 |
避坑提醒: 状态流转必须保持单向性,避免出现“已归档”回退到“草稿”的非法路径。在配置联动规则时,建议在“已通过”状态设置强制校验:若关联变更记录未完成,则禁止进入“已归档”。
4.3 关键属性详解
在传递单的众多属性中,以下三个属性对联动配置影响最大:
4.3.1 传递单ID
作为全局唯一标识,传递单ID是连接变更记录与归档包的桥梁。在数据库设计中,建议采用UUID格式,避免分布式环境下的ID冲突。联动配置中,变更记录通过“外键传递单ID”字段引用该值,实现一对多或一对一关联。
4.3.2 来源与目标
“来源”和“目标”属性定义了传递单的流转方向。在审查意见驱动的场景中,来源通常为“审查系统”,目标为“归档系统”。这两个属性在联动规则中用于判断:
- 当来源为“审查系统”且状态变为“已通过”时,自动触发变更记录的状态更新。
- 当目标为“归档系统”且状态变为“已归档”时,自动执行归档包的打包与存储。
4.3.3 状态
状态属性是联动配置的核心触发器。在配置管理工具中,通常通过“状态变更事件”来驱动后续动作。例如:
// 伪代码:状态变更联动规则示例
if (传递单.状态 == "已通过" && 传递单.来源 == "审查系统") {
变更记录.状态 = "待归档";
变更记录.归档截止时间 = now() + 7天;
生成归档包预检任务();
}
最佳实践: 在配置联动规则时,建议将“状态”与“来源/目标”组合作为复合条件,避免单一状态变更引发误触发。例如,仅当“已通过”且“来源为审查系统”时才联动变更记录,而非所有“已通过”的传递单。
4.4 传递单数据结构SVG图
下图展示了传递单的核心数据结构及其与变更记录、归档包的关系:
4.5 状态流转模型SVG图
下图以状态机形式展示传递单的完整流转路径:
配置要点: 在实现状态流转时,建议在“已通过”状态增加联动校验:检查关联变更记录是否满足归档前置条件(如审查意见已闭环、变更记录状态为“待归档”)。若条件不满足,则阻止状态转换并返回错误提示。