人力服务 · 定义、事实与证据

字段、计算与指标字典

字段身份在 hr-0.4.0 首次稳定登记。事实、引用、规则、计算、审批和系统字段分开表达，字段 ID 不以显示顺序或页面布局为准。

事实

人或设备观察到的事件、数值、时间，不凭公式臆造。

引用

选择已存在的业务记录，保存编号。

规则

商业约定或班次标准，有来源和生效版本。

计算

由事实及规则计算，页面只读，服务端重算。

审批

授权人员作出的决定，保留人和时间。

系统

编号、版本、审计及保存状态，由服务端维护。

计算、事实和汇总

现场填写的是事实，规则由规范配置，计算结果由服务端重算，审核决定只改变批准状态。出勤、绩效、验收和附件是不同粒度的事实；订单结算在订单粒度聚合。不要在附件或多条出勤连接后重复累计订单金额。

HR-F01 · 人员建档与核验 · hr-0.4.0

字段身份	名称 / 键	类别与类型	来源或计算依赖	规则与保存位置
`HR-F01-C001` 定义 1.0.0 引入 hr-0.4.0	人员编号 `personnelCode`	事实文本	来源：db:personnel_people.personnel_code	必填；公司内唯一，不用姓名代替关联编号。 `personnel_people.personnel_code`
`HR-F01-C002` 定义 1.0.0 引入 hr-0.4.0	法定姓名 `legalName`	事实文本	来源：db:personnel_people.legal_name	必填；修改已核验姓名需要重新核验。 `personnel_people.legal_name`
`HR-F01-C003` 定义 1.0.0 引入 hr-0.4.0	显示姓名 `displayName`	事实文本	来源：db:personnel_people.display_name	必填；用于现场识别。 `personnel_people.display_name`
`HR-F01-C004` 定义 1.0.0 引入 hr-0.4.0	联系电话 `phone`	事实电话	来源：db:personnel_people.phone	选填；只作联系信息。 `personnel_people.phone`
`HR-F01-C005` 定义 1.0.0 引入 hr-0.4.0	岗位 `roleName`	规则文本	来源：db:personnel_people.role_name	必填；派遣岗位必须与订单匹配。 `personnel_people.role_name`
`HR-F01-C006` 定义 1.0.0 引入 hr-0.4.0	技能 `skills`	事实列表	来源：db:personnel_people.skills_json	选填；数组保存。 `personnel_people.skills_json`
`HR-F01-C007` 定义 1.0.0 引入 hr-0.4.0	身份核验结果 `identityStatus`	审批枚举	来源：db:personnel_people.identity_status	待核验、已核验、未通过；审核人员操作。 `personnel_people.identity_status`
`HR-F01-C008` 定义 1.0.0 引入 hr-0.4.0	身份核验方式 `identityMethod`	事实文本	来源：db:personnel_people.identity_method	核验时记录依据和方式。 `personnel_people.identity_method`
`HR-F01-C009` 定义 1.0.0 引入 hr-0.4.0	核验凭据参考 `identityReference`	事实文本	来源：db:personnel_people.identity_reference_masked	仅保留脱敏末四位；不保存完整证件号。 `personnel_people.identity_reference_masked`
`HR-F01-C010` 定义 1.0.0 引入 hr-0.4.0	岗位资格核验 `qualificationStatus`	审批枚举	来源：db:personnel_people.qualification_status	派遣前须已核验。 `personnel_people.qualification_status`
`HR-F01-C011` 定义 1.0.0 引入 hr-0.4.0	可派遣情况 `availability`	规则枚举	来源：db:personnel_people.availability	可派遣或不可派遣，另校验时间冲突。 `personnel_people.availability`
`HR-F01-C012` 定义 1.0.0 引入 hr-0.4.0	在册状态 `status`	规则枚举	来源：db:personnel_people.status	在册或归档；归档不抹去历史。 `personnel_people.status`
`HR-F01-C013` 定义 1.0.0 引入 hr-0.4.0	人员备注 `notes`	事实长文本	来源：db:personnel_people.notes	选填，不放完整证件。 `personnel_people.notes`
`HR-F01-C014` 定义 1.0.0 引入 hr-0.4.0	人员记录编号 `id`	系统编号	来源：db:personnel_people.id	服务端生成，派遣引用此编号。 `personnel_people.id`
`HR-F01-C015` 定义 1.0.0 引入 hr-0.4.0	记录修订号 `version`	系统整数	来源：db:personnel_people.version	更新必须提交此前读取的版本。 `personnel_people.version`
`HR-F01-C016` 定义 1.0.0 引入 hr-0.4.0	核验人 `identityVerifiedBy`	系统编号	来源：db:personnel_people.verified_by	服务端记录审核者。 `personnel_people.verified_by`
`HR-F01-C017` 定义 1.0.0 引入 hr-0.4.0	核验时间 `identityVerifiedAt`	系统日期时间	来源：db:personnel_people.verified_at	服务端时间。 `personnel_people.verified_at`

定义采集运营分析开发原型

HR-F02 · 班次标准 · hr-0.4.0

字段身份	名称 / 键	类别与类型	来源或计算依赖	规则与保存位置
`HR-F02-C001` 定义 1.0.0 引入 hr-0.4.0	班次编号 `code`	规则文本	来源：db:personnel_shifts.code	必填；稳定且唯一。 `personnel_shifts.code`
`HR-F02-C002` 定义 1.0.0 引入 hr-0.4.0	班次名称 `name`	规则文本	来源：db:personnel_shifts.name	必填；例如三小时白班。 `personnel_shifts.name`
`HR-F02-C003` 定义 1.0.0 引入 hr-0.4.0	计划上工时间 `startTime`	规则时间	来源：db:personnel_shifts.start_time	必填；津巴布韦当地时间。 `personnel_shifts.start_time`
`HR-F02-C004` 定义 1.0.0 引入 hr-0.4.0	计划下工时间 `endTime`	规则时间	来源：db:personnel_shifts.end_time	必填；早于开始表示次日，相等无效。 `personnel_shifts.end_time`
`HR-F02-C005` 定义 1.0.0 引入 hr-0.4.0	计划休息区间 `breaks`	规则区间列表	来源：db:personnel_shifts.breaks_json	每项开始、结束；班次内且不重叠；不代表实际休息。 `personnel_shifts.breaks_json`
`HR-F02-C006` 定义 1.0.0 引入 hr-0.4.0	标准工作分钟 `standardMinutes`	计算分钟	来源：db:personnel_shifts.standard_minutes 依赖：HR-F02-C003、HR-F02-C004、HR-F02-C005	计划跨度减计划休息，由系统计算。 `personnel_shifts.standard_minutes`
`HR-F02-C007` 定义 1.0.0 引入 hr-0.4.0	班次说明 `notes`	规则长文本	来源：db:personnel_shifts.notes	选填，记录约定。 `personnel_shifts.notes`
`HR-F02-C008` 定义 1.0.0 引入 hr-0.4.0	班次状态 `status`	规则枚举	来源：db:personnel_shifts.status	有效或归档；已引用记录保持快照。 `personnel_shifts.status`
`HR-F02-C009` 定义 1.0.0 引入 hr-0.4.0	班次记录编号 `id`	系统编号	来源：db:personnel_shifts.id	服务端生成。 `personnel_shifts.id`
`HR-F02-C010` 定义 1.0.0 引入 hr-0.4.0	班次修订号 `version`	系统整数	来源：db:personnel_shifts.version	版本化更新。 `personnel_shifts.version`

定义采集运营分析开发原型

HR-F03 · 客户服务订单 · hr-0.4.0

字段身份	名称 / 键	类别与类型	来源或计算依赖	规则与保存位置
`HR-F03-C001` 定义 1.0.0 引入 hr-0.4.0	客户名称 `clientName`	事实文本	来源：db:personnel_orders.client_name	必填；当前客户按文本记录，尚未独立客户主档。 `personnel_orders.client_name`
`HR-F03-C002` 定义 1.0.0 引入 hr-0.4.0	合同编号 `contractRef`	引用文本	来源：db:personnel_orders.contract_ref	必填；关联商务约定。 `personnel_orders.contract_ref`
`HR-F03-C003` 定义 1.0.0 引入 hr-0.4.0	服务地点 `site`	事实文本	来源：db:personnel_orders.site	必填。 `personnel_orders.site`
`HR-F03-C004` 定义 1.0.0 引入 hr-0.4.0	服务日期 `serviceDate`	事实日期	来源：db:personnel_orders.service_date	必填；班次开始所在日期。 `personnel_orders.service_date`
`HR-F03-C005` 定义 1.0.0 引入 hr-0.4.0	班次标准 `shiftTemplateId`	引用选择	来源：db:personnel_orders.shift_template_id	必填；选择有效班次，不手输班次名称。 `personnel_orders.shift_template_id`
`HR-F03-C006` 定义 1.0.0 引入 hr-0.4.0	需求人数 `requestedPeople`	规则整数	来源：db:personnel_orders.requested_people	必填且大于零；派遣人数必须一致。 `personnel_orders.requested_people`
`HR-F03-C007` 定义 1.0.0 引入 hr-0.4.0	需求岗位 `roleName`	规则文本	来源：db:personnel_orders.role_name	必填；与名册岗位匹配。 `personnel_orders.role_name`
`HR-F03-C008` 定义 1.0.0 引入 hr-0.4.0	结算币种 `currency`	规则文本	来源：db:personnel_orders.currency	必填；不同币种不得相加。 `personnel_orders.currency`
`HR-F03-C009` 定义 1.0.0 引入 hr-0.4.0	客户每小时费率 `clientHourRate`	规则金额	来源：db:personnel_orders.client_hour_rate_minor	必填非负；录入元，存储最小货币单位。 `personnel_orders.client_hour_rate_minor`
`HR-F03-C010` 定义 1.0.0 引入 hr-0.4.0	人工每小时成本 `labourHourCost`	规则金额	来源：db:personnel_orders.labour_hour_cost_minor	必填非负；与客户费率分开。 `personnel_orders.labour_hour_cost_minor`
`HR-F03-C011` 定义 1.0.0 引入 hr-0.4.0	订单预算 `budgetAmount`	规则金额	来源：db:personnel_orders.budget_amount_minor	必填非负；不自动等于结算金额。 `personnel_orders.budget_amount_minor`
`HR-F03-C012` 定义 1.0.0 引入 hr-0.4.0	需求备注 `notes`	事实长文本	来源：db:personnel_orders.notes	选填。 `personnel_orders.notes`
`HR-F03-C013` 定义 1.0.0 引入 hr-0.4.0	计划开始 `plannedStartAt`	计算日期时间	来源：db:personnel_orders.planned_start_at 依赖：HR-F03-C004、HR-F02-C003	服务日期与班次落为具体带时区的时间。 `personnel_orders.planned_start_at`
`HR-F03-C014` 定义 1.0.0 引入 hr-0.4.0	计划结束 `plannedEndAt`	计算日期时间	来源：db:personnel_orders.planned_end_at 依赖：HR-F03-C004、HR-F02-C004	支持次日。 `personnel_orders.planned_end_at`
`HR-F03-C015` 定义 1.0.0 引入 hr-0.4.0	每人标准分钟 `standardMinutes`	计算分钟	来源：db:personnel_orders.standard_minutes 依赖：HR-F02-C006	创建时的班次标准快照。 `personnel_orders.standard_minutes`
`HR-F03-C016` 定义 1.0.0 引入 hr-0.4.0	班次来源版本 `shiftTemplateVersion`	系统整数	来源：db:personnel_orders.shift_template_version	保留创建时版本。 `personnel_orders.shift_template_version`
`HR-F03-C017` 定义 1.0.0 引入 hr-0.4.0	班次快照 `shiftSnapshot`	系统对象	来源：db:personnel_orders.shift_snapshot_json	规则和计划休息快照；不随模板修改。 `personnel_orders.shift_snapshot_json`
`HR-F03-C018` 定义 1.0.0 引入 hr-0.4.0	计算规范版本 `ruleVersion`	系统文本	来源：db:personnel_orders.rule_version	新记录 hr-0.3.0；历史记录明确标记。 `personnel_orders.rule_version`
`HR-F03-C019` 定义 1.0.0 引入 hr-0.4.0	订单状态 `status`	系统枚举	来源：db:personnel_orders.status	由业务操作推进，不手工随意改值。 `personnel_orders.status`
`HR-F03-C020` 定义 1.0.0 引入 hr-0.4.0	订单编号 `id`	系统编号	来源：db:personnel_orders.id	所有履约记录引用它。 `personnel_orders.id`
`HR-F03-C021` 定义 1.0.0 引入 hr-0.4.0	订单修订号 `version`	系统整数	来源：db:personnel_orders.version	每次操作带原版本防止覆盖。 `personnel_orders.version`

定义采集运营分析开发原型

HR-F04 · 人员派遣与排班 · hr-0.4.0

字段身份	名称 / 键	类别与类型	来源或计算依赖	规则与保存位置
`HR-F04-C001` 定义 1.0.0 引入 hr-0.4.0	所选人员 `personId`	引用多选	来源：db:personnel_assignments.person_id	从合格名册选择；每人产生一条派遣记录。 `personnel_assignments.person_id`
`HR-F04-C002` 定义 1.0.0 引入 hr-0.4.0	所选订单 `orderId`	引用编号	来源：db:personnel_assignments.order_id	上下文选择，不是新增表单。 `personnel_assignments.order_id`
`HR-F04-C003` 定义 1.0.0 引入 hr-0.4.0	排班开始 `plannedStartAt`	计算日期时间	来源：db:personnel_assignments.planned_start_at 依赖：HR-F03-C012	继承订单具体计划；禁止同一人员排班重叠。 `personnel_assignments.planned_start_at`
`HR-F04-C004` 定义 1.0.0 引入 hr-0.4.0	排班结束 `plannedEndAt`	计算日期时间	来源：db:personnel_assignments.planned_end_at 依赖：HR-F03-C013	保留跨日的完整日期。 `personnel_assignments.planned_end_at`
`HR-F04-C005` 定义 1.0.0 引入 hr-0.4.0	标准分钟 `standardMinutes`	计算分钟	来源：db:personnel_assignments.standard_minutes 依赖：HR-F03-C014	此人此派遣的标准额度。 `personnel_assignments.standard_minutes`
`HR-F04-C006` 定义 1.0.0 引入 hr-0.4.0	排班依据 `schedule`	系统对象	来源：db:personnel_assignments.schedule_json	保留班次与来源信息。 `personnel_assignments.schedule_json`
`HR-F04-C007` 定义 1.0.0 引入 hr-0.4.0	人员编号快照 `personnelCode`	系统文本	来源：db:personnel_assignments.personnel_code	派遣时保留。 `personnel_assignments.personnel_code`
`HR-F04-C008` 定义 1.0.0 引入 hr-0.4.0	姓名快照 `displayName`	系统文本	来源：db:personnel_assignments.display_name	人员改名不改历史派遣。 `personnel_assignments.display_name`
`HR-F04-C009` 定义 1.0.0 引入 hr-0.4.0	岗位快照 `roleName`	系统文本	来源：db:personnel_assignments.role_name	派遣时岗位。 `personnel_assignments.role_name`
`HR-F04-C010` 定义 1.0.0 引入 hr-0.4.0	派遣状态 `status`	系统枚举	来源：db:personnel_assignments.status	已派遣、已替换等。 `personnel_assignments.status`
`HR-F04-C011` 定义 1.0.0 引入 hr-0.4.0	派遣编号 `id`	系统编号	来源：db:personnel_assignments.id	出勤、绩效关联键。 `personnel_assignments.id`

定义采集运营分析开发原型

HR-F05 · 出勤与实际休息 · hr-0.4.0

字段身份	名称 / 键	类别与类型	来源或计算依赖	规则与保存位置
`HR-F05-C001` 定义 1.0.0 引入 hr-0.4.0	派遣人员 `assignmentId`	引用选择	来源：db:personnel_timesheets.assignment_id	必填；只能选当前订单有效派遣。 `personnel_timesheets.assignment_id`
`HR-F05-C002` 定义 1.0.0 引入 hr-0.4.0	出勤情况 `attendance`	事实枚举	来源：db:personnel_timesheets.attendance	出勤或缺勤；缺勤不产生工时。 `personnel_timesheets.attendance`
`HR-F05-C003` 定义 1.0.0 引入 hr-0.4.0	实际上工 `startedAt`	事实日期时间	来源：db:personnel_timesheets.started_at	出勤必填；津巴布韦时间输入，UTC 保存。 `personnel_timesheets.started_at`
`HR-F05-C004` 定义 1.0.0 引入 hr-0.4.0	实际下工 `endedAt`	事实日期时间	来源：db:personnel_timesheets.ended_at	出勤必填；完整日期，晚于上工。 `personnel_timesheets.ended_at`
`HR-F05-C005` 定义 1.0.0 引入 hr-0.4.0	实际休息区间 `breaks`	事实区间列表	来源：db:personnel_timesheets.breaks_json	每项 startedAt、endedAt；工作区间内且不重叠。 `personnel_timesheets.breaks_json`
`HR-F05-C006` 定义 1.0.0 引入 hr-0.4.0	确认本段无休息 `noBreakConfirmed`	事实确认	来源：db:personnel_timesheets.no_break_confirmed	无休息区间时必须明确确认，缺失不能默认为零。 `personnel_timesheets.no_break_confirmed`
`HR-F05-C007` 定义 1.0.0 引入 hr-0.4.0	出勤说明 `replacementNote`	事实长文本	来源：db:personnel_timesheets.replacement_note	异常、缺勤等说明。 `personnel_timesheets.replacement_note`
`HR-F05-C008` 定义 1.0.0 引入 hr-0.4.0	实际休息分钟 `breakMinutes`	计算分钟	来源：db:personnel_timesheets.break_minutes 依赖：HR-F05-C005	实际休息各区间时长之和；不可手填。 `personnel_timesheets.break_minutes`
`HR-F05-C009` 定义 1.0.0 引入 hr-0.4.0	实际净工作分钟 `effectiveMinutes`	计算分钟	来源：db:personnel_timesheets.effective_minutes 依赖：HR-F05-C003、HR-F05-C004、HR-F05-C005	下工减上工减休息。 `personnel_timesheets.effective_minutes`
`HR-F05-C010` 定义 1.0.0 引入 hr-0.4.0	正常工作分钟 `regularMinutes`	计算分钟	来源：db:personnel_timesheets.regular_minutes 依赖：HR-F05-C009、HR-F05-C013	min(本段净工时,max(0,标准工时−此前净工时))。 `personnel_timesheets.regular_minutes`
`HR-F05-C011` 定义 1.0.0 引入 hr-0.4.0	超出标准分钟 `overtimeMinutes`	计算分钟	来源：db:personnel_timesheets.overtime_minutes 依赖：HR-F05-C009、HR-F05-C010	本段净工时减本段正常工时；不是审核结果。 `personnel_timesheets.overtime_minutes`
`HR-F05-C012` 定义 1.0.0 引入 hr-0.4.0	加班审核状态 `overtimeStatus`	审批枚举	来源：db:personnel_timesheets.overtime_status	有加班自动待审核；另由 HR-F07 决定。 `personnel_timesheets.overtime_status`
`HR-F05-C013` 定义 1.0.0 引入 hr-0.4.0	标准额度快照 `standardMinutes`	系统分钟	来源：db:personnel_timesheets.standard_minutes	引用排班标准，旧记录不补造。 `personnel_timesheets.standard_minutes`
`HR-F05-C014` 定义 1.0.0 引入 hr-0.4.0	计算规范 `ruleVersion`	系统文本	来源：db:personnel_timesheets.rule_version	记录使用的计算规则。 `personnel_timesheets.rule_version`
`HR-F05-C015` 定义 1.0.0 引入 hr-0.4.0	出勤记录编号 `id`	系统编号	来源：db:personnel_timesheets.id	加班审核引用。 `personnel_timesheets.id`
`HR-F05-C016` 定义 1.0.0 引入 hr-0.4.0	出勤修订号 `version`	系统整数	来源：db:personnel_timesheets.version	审核并发控制。 `personnel_timesheets.version`

定义采集运营分析开发原型

HR-F06 · 绩效与服务结果 · hr-0.4.0

字段身份	名称 / 键	类别与类型	来源或计算依赖	规则与保存位置
`HR-F06-C001` 定义 1.0.0 引入 hr-0.4.0	派遣人员 `assignmentId`	引用选择	来源：db:personnel_performance.assignment_id	当前订单有效派遣。 `personnel_performance.assignment_id`
`HR-F06-C002` 定义 1.0.0 引入 hr-0.4.0	完成数量 `quantity`	事实数值	来源：db:personnel_performance.quantity	非负，必须连同单位解释。 `personnel_performance.quantity`
`HR-F06-C003` 定义 1.0.0 引入 hr-0.4.0	数量单位 `unit`	规则文本	来源：db:personnel_performance.unit	必填；不同单位不能直接相加。 `personnel_performance.unit`
`HR-F06-C004` 定义 1.0.0 引入 hr-0.4.0	质量评分 `qualityScore`	事实数值	来源：db:personnel_performance.quality_score	0–100；评价事实，不自动代表产量。 `personnel_performance.quality_score`
`HR-F06-C005` 定义 1.0.0 引入 hr-0.4.0	评价依据 `evidenceBasis`	事实长文本	来源：db:personnel_performance.evidence_basis	必填，可注明附件编号。 `personnel_performance.evidence_basis`
`HR-F06-C006` 定义 1.0.0 引入 hr-0.4.0	返工与异常 `reworkOrIncident`	事实长文本	来源：db:personnel_performance.rework_or_incident	选填。 `personnel_performance.rework_or_incident`
`HR-F06-C007` 定义 1.0.0 引入 hr-0.4.0	绩效记录编号 `id`	系统编号	来源：db:personnel_performance.id	服务端生成。 `personnel_performance.id`

定义采集运营分析开发原型

HR-F07 · 加班审核 · hr-0.4.0

字段身份	名称 / 键	类别与类型	来源或计算依赖	规则与保存位置
`HR-F07-C001` 定义 1.0.0 引入 hr-0.4.0	出勤记录 `id`	引用选择	来源：db:personnel_timesheets.id	所选出勤编号。 `personnel_timesheets.id`
`HR-F07-C002` 定义 1.0.0 引入 hr-0.4.0	加班决定 `status`	审批枚举	来源：db:personnel_timesheets.overtime_status	批准或拒绝；本期整段审核，不提供部分批准。 `personnel_timesheets.overtime_status`
`HR-F07-C003` 定义 1.0.0 引入 hr-0.4.0	出勤版本 `timesheetVersion`	系统整数	来源：db:personnel_timesheets.version	提交当前版本，冲突需重新读取。 `personnel_timesheets.version`
`HR-F07-C004` 定义 1.0.0 引入 hr-0.4.0	审核人 `overtimeDecidedBy`	系统编号	来源：db:personnel_timesheets.overtime_decided_by	从登录会话记录。 `personnel_timesheets.overtime_decided_by`
`HR-F07-C005` 定义 1.0.0 引入 hr-0.4.0	审核时间 `overtimeDecidedAt`	系统日期时间	来源：db:personnel_timesheets.overtime_decided_at	服务端时间。 `personnel_timesheets.overtime_decided_at`

定义采集运营分析开发原型

HR-F08 · 客户验收 · hr-0.4.0

字段身份	名称 / 键	类别与类型	来源或计算依赖	规则与保存位置
`HR-F08-C001` 定义 1.0.0 引入 hr-0.4.0	验收决定 `decision`	审批枚举	来源：db:personnel_acceptance.decision	接受、拒绝、争议、退回。 `personnel_acceptance.decision`
`HR-F08-C002` 定义 1.0.0 引入 hr-0.4.0	客户验收人 `reviewerName`	事实文本	来源：db:personnel_acceptance.reviewer_name	必填；系统另记录操作人。 `personnel_acceptance.reviewer_name`
`HR-F08-C003` 定义 1.0.0 引入 hr-0.4.0	验收说明 `reason`	事实长文本	来源：db:personnel_acceptance.reason	记录决定依据。 `personnel_acceptance.reason`
`HR-F08-C004` 定义 1.0.0 引入 hr-0.4.0	订单编号 `orderId`	引用编号	来源：db:personnel_acceptance.order_id	与服务订单关联。 `personnel_acceptance.order_id`
`HR-F08-C005` 定义 1.0.0 引入 hr-0.4.0	验收记录编号 `id`	系统编号	来源：db:personnel_acceptance.id	保留历次意见，不覆盖。 `personnel_acceptance.id`

定义采集运营分析开发原型

HR-F09 · 结算核对与锁定 · hr-0.4.0

字段身份	名称 / 键	类别与类型	来源或计算依赖	规则与保存位置
`HR-F09-C001` 定义 1.0.0 引入 hr-0.4.0	服务订单 `orderId`	引用选择	来源：db:personnel_settlements.order_id	读取订单及其履约记录。 `personnel_settlements.order_id`
`HR-F09-C002` 定义 1.0.0 引入 hr-0.4.0	正常分钟合计 `regularMinutes`	计算分钟	来源：db:personnel_settlements.regular_minutes 依赖：HR-F05-C010	同一订单正常工时求和。 `personnel_settlements.regular_minutes`
`HR-F09-C003` 定义 1.0.0 引入 hr-0.4.0	批准加班分钟 `approvedOvertimeMinutes`	计算分钟	来源：db:personnel_settlements.approved_overtime_minutes 依赖：HR-F05-C011、HR-F07-C002	只计已批准加班。 `personnel_settlements.approved_overtime_minutes`
`HR-F09-C004` 定义 1.0.0 引入 hr-0.4.0	本期结算分钟 `billableMinutes`	计算分钟	来源：db:personnel_settlements.billable_minutes 依赖：HR-F09-C002、HR-F09-C003	正常分钟＋已批准加班。 `personnel_settlements.billable_minutes`
`HR-F09-C005` 定义 1.0.0 引入 hr-0.4.0	结算币种 `currency`	系统文本	来源：db:personnel_settlements.currency	订单币种快照。 `personnel_settlements.currency`
`HR-F09-C006` 定义 1.0.0 引入 hr-0.4.0	客户服务收入 `revenueMinor`	计算最小货币单位	来源：db:personnel_settlements.revenue_minor 依赖：HR-F09-C004、HR-F03-C008	结算分钟×客户时费率÷60，按货币最小单位四舍五入。 `personnel_settlements.revenue_minor`
`HR-F09-C007` 定义 1.0.0 引入 hr-0.4.0	直接人工成本 `directLabourCostMinor`	计算最小货币单位	来源：db:personnel_settlements.direct_labour_cost_minor 依赖：HR-F09-C004、HR-F03-C009	本期采用相同结算分钟×人工时费率÷60。 `personnel_settlements.direct_labour_cost_minor`
`HR-F09-C008` 定义 1.0.0 引入 hr-0.4.0	收入减直接人工 `grossDifferenceMinor`	计算最小货币单位	来源：db:personnel_settlements.gross_difference_minor 依赖：HR-F09-C006、HR-F09-C007	不含其他费用，不称净利润。 `personnel_settlements.gross_difference_minor`
`HR-F09-C009` 定义 1.0.0 引入 hr-0.4.0	结算依据快照 `snapshot`	系统对象	来源：db:personnel_settlements.snapshot_json	保存来源与结果，锁定后不随上游变动。 `personnel_settlements.snapshot_json`
`HR-F09-C010` 定义 1.0.0 引入 hr-0.4.0	锁定结果 `locked`	系统确认	来源：db:personnel_settlements.locked	通过服务端验收条件后置为锁定。 `personnel_settlements.locked`
`HR-F09-C011` 定义 1.0.0 引入 hr-0.4.0	结算编号 `id`	系统编号	来源：db:personnel_settlements.id	唯一关联订单。 `personnel_settlements.id`
`HR-F09-C012` 定义 1.0.0 引入 hr-0.4.0	结算版本 `version`	系统整数	来源：db:personnel_settlements.version	保留锁定版本。 `personnel_settlements.version`

定义采集运营分析开发原型

HR-F10 · 照片、视频与证据 · hr-0.4.0

字段身份	名称 / 键	类别与类型	来源或计算依赖	规则与保存位置
`HR-F10-C001` 定义 1.0.0 引入 hr-0.4.0	关联订单 `orderId`	引用编号	来源：db:personnel_media.order_id	当前订单。 `personnel_media.order_id`
`HR-F10-C002` 定义 1.0.0 引入 hr-0.4.0	采集环节 `stage`	事实选择	来源：db:personnel_media.stage	派遣、到场、出勤、绩效、验收。 `personnel_media.stage`
`HR-F10-C003` 定义 1.0.0 引入 hr-0.4.0	附件用途 `purpose`	事实文本	来源：db:personnel_media.purpose	必填，例如到场确认。 `personnel_media.purpose`
`HR-F10-C004` 定义 1.0.0 引入 hr-0.4.0	现场说明 `description`	事实长文本	来源：db:personnel_media.description	必填；模拟材料必须标明模拟。 `personnel_media.description`
`HR-F10-C005` 定义 1.0.0 引入 hr-0.4.0	拍摄时间 `capturedAt`	事实日期时间	来源：db:personnel_media.captured_at	可选；不能拿上传时间冒充拍摄时间。 `personnel_media.captured_at`
`HR-F10-C006` 定义 1.0.0 引入 hr-0.4.0	文件名 `originalName`	事实文件	来源：db:personnel_media.original_name	浏览器读取文件名称。 `personnel_media.original_name`
`HR-F10-C007` 定义 1.0.0 引入 hr-0.4.0	文件类型 `contentType`	系统文本	来源：db:personnel_media.content_type	图像或视频白名单；服务端校验。 `personnel_media.content_type`
`HR-F10-C008` 定义 1.0.0 引入 hr-0.4.0	申报文件大小 `sizeBytes`	系统字节	来源：db:personnel_media.size_bytes	浏览器读取；当前每份不超过 25 MiB。 `personnel_media.size_bytes`
`HR-F10-C009` 定义 1.0.0 引入 hr-0.4.0	视频时长 `durationSeconds`	系统秒	来源：db:personnel_media.duration_seconds	浏览器读取视频元数据；服务端验证数值，不宣称已做云端转码校验。 `personnel_media.duration_seconds`
`HR-F10-C010` 定义 1.0.0 引入 hr-0.4.0	实收字节 `byteCount`	系统字节	来源：db:personnel_media.byte_count	服务端从真实文件计算。 `personnel_media.byte_count`
`HR-F10-C011` 定义 1.0.0 引入 hr-0.4.0	内容校验值 `contentHash`	系统文本	来源：db:personnel_media.content_hash	服务端计算，用于一致性。 `personnel_media.content_hash`
`HR-F10-C012` 定义 1.0.0 引入 hr-0.4.0	上传状态 `status`	系统枚举	来源：db:personnel_media.status	待上传、已上传、失败、已删除。 `personnel_media.status`
`HR-F10-C013` 定义 1.0.0 引入 hr-0.4.0	失败原因 `failureReason`	系统文本	来源：db:personnel_media.failure_reason	运营排障用。 `personnel_media.failure_reason`
`HR-F10-C014` 定义 1.0.0 引入 hr-0.4.0	对象存储位置 `objectKey`	系统私有文本	来源：db:personnel_media.object_key	服务端私有，不向页面暴露；按附件编号授权访问。 `personnel_media.object_key`
`HR-F10-C015` 定义 1.0.0 引入 hr-0.4.0	附件编号 `id`	系统编号	来源：db:personnel_media.id	业务关联标识。 `personnel_media.id`
`HR-F10-C016` 定义 1.0.0 引入 hr-0.4.0	附件修订号 `version`	系统整数	来源：db:personnel_media.version	删除或变更使用版本校验。 `personnel_media.version`

定义采集运营分析开发原型

HR-F11 · 派遣替换 · hr-0.4.0

字段身份	名称 / 键	类别与类型	来源或计算依赖	规则与保存位置
`HR-F11-C001` 定义 1.0.0 引入 hr-0.4.0	原派遣人员 `originalAssignmentId`	引用选择	来源：db:personnel_assignments.replaced_assignment_id	选当前有效派遣；有出勤时禁止直接替换。 `personnel_assignments.replaced_assignment_id`
`HR-F11-C002` 定义 1.0.0 引入 hr-0.4.0	替代人员 `personId`	引用选择	来源：db:personnel_assignments.person_id	需合格、可用且无排班冲突。 `personnel_assignments.person_id`
`HR-F11-C003` 定义 1.0.0 引入 hr-0.4.0	替换原因 `reason`	事实长文本	来源：db:personnel_assignments.replacement_reason	必填；原记录保留。 `personnel_assignments.replacement_reason`
`HR-F11-C004` 定义 1.0.0 引入 hr-0.4.0	新派遣编号 `id`	系统编号	来源：db:personnel_assignments.id	服务端生成。 `personnel_assignments.id`

定义采集运营分析开发原型

共享控制字段

控制字段 ID	键	定义
`HR-COM-C001` 定义 1.0.0 · 引入 hr-0.4.0	`expectedVersion`	变更已有记录必须附带此前读取的记录版本；冲突后重新读取，不覆盖。
`HR-COM-C002` 定义 1.0.0 · 引入 hr-0.4.0	`Idempotency-Key`	每次新提交使用独立请求编号；网络重试沿用原编号，防止重复建单。
`HR-COM-C003` 定义 1.0.0 · 引入 hr-0.4.0	`created_at / updated_at / created_by`	服务端审计事实；不是现场自行输入。

下载完整登记册 JSON · 服务接口契约