ZCD 人力服务hr-0.3.0 · 业务规范

人力服务 · 业务与证据

逐版复盘与改正记录

每个版本同时保留产品、代码、错误原因和验收证据。修改完成与验证通过分开记录。

当前修订 0.3.1

2026-09-09 · 业务闭环已验证;补全运营详情及正式站验证记录

当前完整 Git 提交与部署身份 · 本轮实际验证结果 · 机器可读复盘记录

R01 · 已修正并验证

导航时反复闪出登录框

原来
页面先显示登录框,再异步确认已有会话。
原因
未区分“正在确认会话”和“确认未登录”两个状态。
本轮改法
初始隐藏登录框;仅会话确认无效后显示;保留重登录与并发响应防护。
验收要求
连续页面导航、首登、错误码、会话失效测试。
实际证据
预览站连续12页切换,登录框闪现0次;三种大小写登录通过。

R02 · 已修正并验证

人员、订单、派遣混在一起

原来
创建订单与选择上下文、从名册派遣被排成含糊步骤。
原因
没有先定义业务对象和记录粒度。
本轮改法
独立人员、班次、订单、派遣;表单登记册写明对象、编号和前置关系。
验收要求
从名册与班次建单,派遣引用同一人员和计划;后台关联编号一致。
实际证据
完整 npm test、链接检查与构建通过;详见本轮验证页和同版本测试代码。

R03 · 已修正并验证

缺少班次和排班依据

原来
只填班次名称,无法知道标准工时。
原因
把名称当作完整规则,未保存规则版本。
本轮改法
新增班次标准、计划休息和订单/派遣快照;按具体时间查冲突。
验收要求
修改模板不改变历史订单;跨班次名的重叠排班被拒绝。
实际证据
完整 npm test、链接检查与构建通过;详见本轮验证页和同版本测试代码。

R04 · 已修正并验证

把计算值交给现场手填

原来
休息分钟和加班分钟缺少事实与标准依据。
原因
混淆输入事实、计算列与审核决定。
本轮改法
收集实际休息区间或无休息确认;服务端计算净工时、正常工时与待审核超时。
验收要求
三小时标准与四小时实际;跨夜、休息重叠、累计分段、伪造分钟测试。
实际证据
A/B/C实际网页计算结果分别为净240/210/210分钟,计费240/180/210分钟。

R05 · 已修正并验证

前台与运营没有完整映射说明

原来
无法逐条解释现场字段在管理端和数据库中的位置。
原因
界面先行,缺少统一字段登记册。
本轮改法
每表列字段来源、公式、数据库映射与入口;运营显示同源记录分类和详情。 0.3.1进一步补齐订单费率、预算与备注,显示班次名称和版本、绩效异常、附件说明与实收字节。
验收要求
字段映射执行数据库列校验,实际记录跨页面核对。
实际证据
登记册逐字段映射通过数据库列检查;三条订单完成到结算和附件读回。 新增详情保留关键采集值的回归断言,避免有数据但页面漏展示。

R06 · 已修正并验证

开发原型不完整、不同步

原来
部分金数据和手机页面只有一段说明,旧原型仍手填分钟。
原因
原型由另一份手写字段维护,更新时容易脱节。
本轮改法
11 张表的两套原型由同一登记册生成,注明规范版本和未接入状态。
验收要求
两端表单数量、字段和版本一致;按钮不伪报保存成功。
实际证据
完整 npm test、链接检查与构建通过;详见本轮验证页和同版本测试代码。

R07 · 已修正并验证

技术用语进入一线操作

原来
人员关联键、英文状态等出现在操作文案。
原因
把实现字段名直接当作产品用语。
本轮改法
一线页面使用中文业务名称;技术键只留在开发字典。
验收要求
浏览器检查表单、状态和异常提示。
实际证据
完整 npm test、链接检查与构建通过;详见本轮验证页和同版本测试代码。

R08 · 已修正并验证

修改经验没有按版本保留

原来
只能看到成品,难以追溯此前哪里错、改了什么。
原因
发布记录只列功能,没有记录问题和验证依据。
本轮改法
加入逐版复盘、问题编号、代码链接与验证页;历史条目明确为补记。
验收要求
每次发布均能从版本页进入复盘,并追溯完整提交。
实际证据
完整 npm test、链接检查与构建通过;详见本轮验证页和同版本测试代码。

R09 · 已修正并验证

附件等待与清理状态不完整

原来
真实浏览器测试中,大素材上传接近超时;中断附件删除后,页面仍显示删除按钮。
原因
上传没有明确超时;按钮仅按页面模式显示,没有同时检查附件及订单状态。
本轮改法
上传增加90秒超时;已删除或已锁定订单不再显示删除操作。测试使用清晰标识的模拟网页截图,保留真实文件写入和读取验证。
验收要求
小型PNG经真实API写入R2并读回;中断条目可以清理;已删除或锁定后不可继续删除。
实际证据
真实小型PNG上传及读取成功;已删除/锁定状态不显示删除按钮的回归测试通过。

此前版本回顾

历史问题为本轮依据既有提交及用户反馈补记,不伪称当时已有这份复盘。

0.2.0

已改:独立人员名册、订单详情、按名册派遣;修正早期登录竞态。

当时尚缺:仍缺班次标准;休息和加班手填;原型字段不齐。

对应代码提交 f665083

以后每版必须留下什么

  1. 用户反馈和问题编号,明确表现与影响。
  2. 根因、修改范围、字段或规则版本变化。
  3. 可重现的验收结果;未验收项不标为已完成。
  4. 代码提交、部署版本及历史数据兼容情况。
  5. 尚未覆盖的业务范围和下一次调整依据。

本公司的具体案例在此保留;通用样板规范的既有入口位于技术平台标准库