人力服务 · 定义、事实与证据
表单登记册
登记册定义了 11 张表单的稳定编号、字段身份、关系和五个使用边界。采集页面是每张表的入口；同一编号在运营、分析和开发原型中保持可追溯。
定义版本与记录版本不同
hr-0.4.0 是表单和字段定义版本。它不表示每一条已存业务记录被自动迁移。表单、字段、关系和共享控制的定义版本；不是每一条已存业务记录已经迁移到该定义。
历史记录保留其创建时的规则快照、字段可得性和 ruleVersion；不得用当前定义回填或改写历史事实。
五个视图边界
| 视图 | 回答的问题 | 允许的动作 |
|---|---|---|
| 定义 | 字段、规则、来源与关系是什么？ | 阅读和审查定义。 |
| 采集 | 这次业务事实应如何录入？ | 创建或提交符合前置条件的事实。 |
| 运营 | 哪些记录待处理、待审核或被阻断？ | 按权限推进业务决定。 |
| 分析 | 锁定后的事实和指标说明什么？ | 按粒度、期间、币种查询汇总。 |
| 开发 | 三端如何按同一字段定义实现？ | 查看 Web 链接与未接入原型。 |
HR-F01 · 定义 hr-0.4.0
人员建档与核验
记录粒度：一名人员一条名册记录
一人可有多次派遣；被业务引用后归档保留，不硬删。
17 个字段，每个字段均有不可复用的字段 ID、定义版本与引入版本。
接口与保存位置
GET / POST / PATCH / DELETE /personnel/peoplepersonnel_people
HR-F02 · 定义 hr-0.4.0
班次标准
记录粒度：一种班次的一版标准
订单引用班次并保存快照；班次后续修订不改变旧订单。
10 个字段，每个字段均有不可复用的字段 ID、定义版本与引入版本。
接口与保存位置
GET / POST / PATCH /personnel/shiftspersonnel_shifts
HR-F03 · 定义 hr-0.4.0
客户服务订单
记录粒度：一个客户、一天、一个班次及岗位的一项需求
一份订单对应多名派遣人员、多条履约记录和至多一份锁定结算。
21 个字段，每个字段均有不可复用的字段 ID、定义版本与引入版本。
接口与保存位置
GET / POST / PATCH /personnel/orderspersonnel_orders
HR-F04 · 定义 hr-0.4.0
人员派遣与排班
记录粒度：一个订单下的一人一次排班
订单与人员通过派遣关联；出勤和绩效引用派遣编号。
11 个字段，每个字段均有不可复用的字段 ID、定义版本与引入版本。
接口与保存位置
POST /personnel/orders/:id/dispatchpersonnel_assignments
HR-F05 · 定义 hr-0.4.0
出勤与实际休息
记录粒度：一名派遣人员的一段工作区间或一条缺勤说明
同一派遣可有多段不重叠出勤；累计扣减同一班次标准，不能分段规避加班。
16 个字段，每个字段均有不可复用的字段 ID、定义版本与引入版本。
接口与保存位置
POST /personnel/orders/:id/timesheetspersonnel_timesheets
HR-F06 · 定义 hr-0.4.0
绩效与服务结果
记录粒度：一名派遣人员的一次成果记录
绩效引用派遣，与工时分别记录，不把评分当工时。
7 个字段，每个字段均有不可复用的字段 ID、定义版本与引入版本。
接口与保存位置
POST /personnel/orders/:id/performancepersonnel_performance
HR-F07 · 定义 hr-0.4.0
加班审核
记录粒度：一条出勤中待审核加班的一次决定
读取 HR-F05 计算的加班事实；审批改变计费资格，不改事实时长。
5 个字段，每个字段均有不可复用的字段 ID、定义版本与引入版本。
接口与保存位置
POST /personnel/timesheets/:id/overtimepersonnel_timesheets
HR-F08 · 定义 hr-0.4.0
客户验收
记录粒度：一份订单的一次客户验收意见
订单提交后方可验收；退回进入返工，接受后才可结算。
5 个字段，每个字段均有不可复用的字段 ID、定义版本与引入版本。
接口与保存位置
POST /personnel/orders/:id/acceptancepersonnel_acceptance
HR-F09 · 定义 hr-0.4.0
结算核对与锁定
记录粒度：一份订单的一份锁定结算
必须已接受且无待审核加班、未完成附件；锁定后不能覆盖，修改应走后续独立调整流程。
12 个字段，每个字段均有不可复用的字段 ID、定义版本与引入版本。
接口与保存位置
POST /personnel/orders/:id/settlement-preview ; POST /personnel/orders/:id/transitionpersonnel_settlements
HR-F10 · 定义 hr-0.4.0
照片、视频与证据
记录粒度：一个订单阶段的一份附件
D1 存元数据；R2 存字节；运营按订单、阶段和附件编号检索。不是另建一份孤立图库。
16 个字段，每个字段均有不可复用的字段 ID、定义版本与引入版本。
接口与保存位置
POST /personnel/media/init ; PUT /personnel/media/:idpersonnel_media
HR-F11 · 定义 hr-0.4.0
派遣替换
记录粒度：一名原派遣与一名替代人员的关系
原派遣保留为已替换，新记录指向原记录。本期只支持原人员尚未记录出勤的替换。
4 个字段，每个字段均有不可复用的字段 ID、定义版本与引入版本。
接口与保存位置
POST /personnel/orders/:id/assignments/replacementpersonnel_assignments