ZCD 人力服务0.4.0 · 开发周期档案

人力服务 · 开发周期档案

0.4.0 · 以表单为核心重建采集、运营、分析与开发周期档案

只修改人力服务公司样板:为 11 张表建立稳定身份和字段版本,让每张表从定义、采集、运营、分析到三端开发可追溯;同时重构开发与版本知识,使每次反馈、错误、修正、验证和发布形成完整小循环。通用规则另在既有技术平台沉淀。

周期身份

正式站技术验证通过;用户体验反馈持续跟踪

时间:2026-09-09 起

提交:711c5618a7 · 3e54ce98f0 · 1b14ba7483 · 855ec4eaf2 · 2829c5f8c2

标签:交付标签 v0.4.0;候选标签 v0.4.0-rc.1 / v0.4.0-rc.2
部署:完整生产验收:97e3c163-a055-4eb7-bb53-333b8d86d5c4 / https://97e3c163.zcd-personnel.pages.dev;正式访问 https://zcd-personnel.pages.dev。最后回执更新不改变业务代码,当前部署提交见网站版本回执。

当前网站版本、完整提交与运行代码指纹 · 0.4.0 原始验收记录

本轮反馈与来源

摘录与复述分开标记;没有把更早对话拼成伪造的完整原文。

你先把所有的名称给我统一一下。

用户反馈摘录

你的所有的字段都是必须是跟着版本号走的。

用户反馈摘录

你的每一张表单,它都应该在表单管理的里面进行体现。同时它在运营管理这个里头,它也有相应的运营后台。

用户反馈摘录

你在这个开发与版本里面,你的复盘不够完整,而且这个复盘的结构……是打了大大的折扣的。

用户反馈摘录

开发与版本除三端状态外需要从架构、内容和业务逻辑全部重构;完整保留每次错误、影响、修正意见、实施、验证和版本结果,并把反复出现的问题提炼成集团层防复发规则。

用户反馈复述

本轮对话完整留存

以下两段分别完整保留:上一轮助手提出的六部分修改逻辑,以及用户随后对开发与版本知识沉淀提出的完整加强意见。它们是本次 0.4.0 计划的直接来源。更早对话只在 development-cycles.json 中保存选摘与忠实复述,不声称完整。 为网页阅读做了格式转写:标题和表格转为连续文字;正文保留,不声称逐字节保存原 Markdown。

上一轮六部分修改逻辑(完整留存)

助手方案原文

你的判断是对的。现在的主要问题,是同一张表单在不同板块里没有被当成同一个业务对象来管理。所以名称会变、入口会串,采集页面会出现在运营管理里,后面的分析也找不到明确的来源。

这一轮先把关系讲清楚,不修改代码、不提交、不发布,等你确认后再执行。

我核对了现有结构:目前实际登记了 11 张表单,HR-F01~HR-F11。你指出的两个问题都存在:HR-F10 的名称不一致;运营管理中的部分入口,确实直接跳回了采集工作台。

一、以每张表单为基础,把几个板块逐一对应起来

你强调“表单要放在足够重要的位置”,这一点应该落实到整个系统的组织方式:

一张表单,一个固定身份,一套字段定义,对应采集、管理、分析和三端开发。

各板块的职责应该明确分开:

表单管理:定义表单名称、编号、字段、计算规则、关联关系和版本。所有页面依据这里的定义,不能各自起名、各自解释字段。

Web 采集工作台:按表单录入业务事实,显示自动计算结果,提交记录。每张表单有独立入口;计算结果不能冒充人工填写项。

运营管理:查看记录列表和详情,核对、审批、处理状态,追踪修改。不嵌入新增人员、创建订单等采集页面;需要新增时跳转对应表单。

数据分析:从已保存的记录计算指标,展示分布、趋势和异常。每个指标能追溯到具体表单、字段和记录。

三端开发:展示同一张表单的 Web 实现、金数据设计和安卓原型。共用同一套业务规范;Web 链接直接打开采集工作台里的同一张表单。

其中,“审批意见”“驳回原因”等是运营处理产生的信息,需要记录。它们有自己的表单编号和字段定义,属于明确的处理动作,不能和新增人员、填写出勤等现场采集混在一起。

二、每张表单都应该展开,不能继续藏在一个长工作台里

以你指出的人员建档为例,应该形成下面的对应关系:

表单管理:用途、谁填写、字段字典、核验要求、与派遣的关系、版本。

Web 采集工作台:独立的人员建档页面,填写人员资料并提交。

运营管理:人员名册、人员详情、核验状态、停用状态和修改记录。

数据分析:已建档人数、待核验人数、人员状态分布等,有明确统计口径。

三端开发:同一表单的 Web 入口、金数据设计、安卓原型及对应版本。

这样,你在采集端新增一个人,运营端看到的就是同一条人员记录。分析中的人数也来自这份名册。

运营管理可以有“新增人员”按钮,但点击后进入 HR-F01 的采集页面,不再把整张新增表嵌在名册下面。

结算也一样:点击运营管理中的 HR-F09 结算核对与锁定,应该看到结算记录、关联订单、金额构成、核对状态和锁定详情。不能跳回整个 Web 工作台,让你再去找。

每张表单都会有对应的分析入口。具体分析可以结合多张关联表,例如结算金额需要引用出勤、审核和计价规则;页面必须说明来源,不能为每张表随意凑一个图。

三、名称统一,需要从定义源头解决

我建议沿用登记册现有的名称,统一到所有入口:

HR-F01 人员建档与核验;HR-F02 班次标准;HR-F03 客户服务订单;HR-F04 人员派遣与排班;HR-F05 出勤与实际休息;HR-F06 绩效与服务结果;HR-F07 加班审核;HR-F08 客户验收;HR-F09 结算核对与锁定;HR-F10 照片、视频与证据;HR-F11 派遣替换。

以后菜单、页面标题、按钮、字段字典、三端原型,都读取这份登记册。

例如 HR-F10 可以显示为:采集:HR-F10 照片、视频与证据;管理:HR-F10 照片、视频与证据 · 记录管理;分析:HR-F10 照片、视频与证据 · 数据分析。基础名称始终一致,后缀只说明当前位置的用途。

四、字段编号和版本,必须能追溯到具体定义

目前有整体业务规范版本,但没有把每个字段的稳定编号和定义版本明确展示出来。你指出的缺口成立。

这里要分清三个编号:表单编号,如 HR-F05,识别这是哪一张表单;字段编号,如 HR-F05-C001,识别这是表单中的哪一个字段;记录编号,识别这是哪一次实际提交的数据。

字段字典至少应该清楚展示:字段编号、中文名称、英文键名、字段定义版本、字段类别、填写或计算方式、引用来源、数据库位置、校验规则、变更记录。

字段类别也要明确区分:人工事实、引用信息、计算结果;分析中的汇总指标另列口径。例如:实际上工、实际下工是采集事实;班次引用班次标准;实际休息起止是采集事实;休息分钟、实际净工时根据事实计算;待审核加班依据实际工时和对应班次规则计算;已批准加班总时长依据审核结果汇总。

字段编号一旦分配,就不因页面排序变化而改变,也不把已废弃的编号拿去表示另一件事。编号与现有英文键名、数据库字段建立映射,不需要为了增加编号,把数据库列名全部重命名。

版本上,每一版表单都固定引用哪些版本的字段和计算规则。以后规则改变,必须记录影响了哪些页面、原型和指标;历史记录保留当时适用的规则依据。

五、你提出的“环节定义、关系、红线”,需要单独讲清楚

这里有两类关系,需要分别说明:

第一类是刚才的系统分工:表单管理、采集、运营、分析、开发分别做什么。

第二类是人力服务本身的业务顺序:人员与班次准备 → 客户订单 → 派遣排班 → 出勤与服务记录 → 审核和验收 → 结算。

照片视频贯穿相关环节;派遣替换是执行中的调整,不能为了凑顺序,把它们硬排成最后两步。

我会在表单管理下设置“环节定义与约束”,对每个业务环节明确写出:开始前必须具备什么;使用哪几张表单,引用哪些上游记录;完成后产生什么,交给哪个环节;什么情况必须阻止继续,什么情况允许退回修正;修正之后,哪些下游结果需要重新核对。

例如:人员未满足核验和可派遣条件,就不能直接进入派遣;没有对应班次依据,就不能得出可靠的加班结果;结算锁定后,上游修正必须进入明确的调整流程,不能悄悄改变已锁定金额。

六、下一轮修改的顺序也要跟着这个关系走

确认后,我会只处理人力服务公司,按下面顺序推进:

1. 统一 11 张表单的身份、名称、字段编号和版本规则。
2. 把每张表单拆成独立入口,建立采集、运营、分析、三端开发的对应表。
3. 修正页面职责和跳转,移走运营管理中混入的采集页面。
4. 同步三端设计,再用模拟记录验证:提交在哪里、管理在哪里、分析引用在哪里。
5. 把本次错误、原因、修正和验证结果写入对应版本复盘,随代码一起提交、推送和发布。

你已经认可的树状导航和三端联动会保留。需要重新建立的是树下面这些内容的对应关系:从任何一张表单出发,你都能找到它的定义、填写入口、实际记录、分析结果和开发版本,不需要猜它被放在哪里。

以上是这次待你确认的修改逻辑;本轮尚未实施。

用户对开发与版本知识沉淀的加强意见(完整留存)

用户原话

你这个我看了一下你的这个反馈啊,大概是这么个意思,大概是这么个意思。我觉得你这个,我再给你指出几个问题啊。第一,你这个全面修改肯定是不用说的,对吧?第一、第二,你的这些这个做的过程当中,一些规则该抽象的,我觉得你这个没有抽象的很好,包括这个版本管理和这个犯的错误,包括应该做什么把它做好。我看了一下你的开发与版本,这个我觉得你的总结并不到位。你在现在告诉我的这个里面做的挺好的,但是你在实际知识沉淀的过程当中,我觉得你这个管理的并不好,这个知识沉淀的不到位,反思的不够深刻,内容留存的不够完整。我觉得你这个事情要重点的再加强一下,好吧?你现在讲的这些东西,尤其是哪些是错误的,哪些是应该改正的。你在这个开发与版本里面,你的复盘不够完整,而且这个复盘的结构,你的这个开发与版本这个里面的这个内容,我觉得跟你这个现在相比,或者是跟你之前的这个这个对话相比,是打了大大的折扣的,这个是不好的。我希望你能够尽量完整的保留,好吧?就是几个字符而已,小case,麻烦你把这个犯的错和需要做的东西,就像你比如说我看你最后这一句,一二三四五六,对吧?你这个东西需要一个更完整、更清晰的保留。你现在这个结构是不OK的,你需要怎么增加、怎么调改。相当于你现在在整个版本管理里头,我觉得做的并不好,做的并不好,好吧?这是我给你重点需要着重指出的部分。至于你剩下的关于这几个东西板块,特别是这几个大的环节怎么去改正的,我觉得你这个看起来应该是不错的,看起来应该是不错的,对。然后你这个因为你,我再指出一点啊,就是你这个版本管理就是你的犯的错,所有错误如实的完整的详细的记录和接下来要形成的修改的意见。然后一二三四五六这些要点细节是非常非常重要的。你后面这个叫什么?你还会犯其他的错,你还会犯一样的错。你这个部分版本管理的这个部分,其实就是这个在集团层面需要严格去避免,或者是说既要严格避免犯的错,同时对于怎么去把它做好,也有充分的指导意见和细节。细节研判的这么一个详实的案例材料。你现在这个做的并不好,细节不够充分,然后这个深度也不够,然后这个完整记录也差。我觉得你应该把这几个版本,根据这个现场对话的记录,对于这个开发与版本,这个哪些东西是做的不够好的,然后接下来要怎么去进行优化,每一次的这个整个小循环滚动开发这个小循环,我觉得你这个需要全部重新架构,这个开发与版本这个里头啊,把它这个做好。除了这个三端开发状态之外,我觉得你剩下这几个什么版本记录哦,主板复盘呢,本轮验证来源档案这几个乱七八糟的东西,我觉得你需要从架构到内容到里面的整个业务逻辑进行全部重构,全部重构,好吧?这是这个开发与版本,这次我觉得你重点改的应该在这个地方。然后至于你剩下这几个东西,对吧?Web采集工作台、运营管理、表单管理、数据分析,已经刚刚你刚刚已经说的差不多了,你这个内容里面的差不多了。我先这个看你改出来是什么样子,好吧?我觉得你说的还是基本上是没什么大问题,只有看你做了才知道。你把这个东西充分的理解一下,该加强的要加强,该充分管理的充分管理,好吧?

错误、影响和本轮处理方向

DEV-002 · 人员、订单和派遣记录粒度混在一起

本轮技术验证通过;用户体验待反馈

表现:一个长工作台把建档、客户需求和人员派遣排成模糊步骤。

影响:无法确定谁是主档、谁是交易、谁引用谁;运营详情和分析容易重复计算。

原因:先排页面,再定义业务对象和记录粒度。 (今日回填判断)

修正:分别建立人员、班次、订单、派遣、出勤、审核、验收和结算对象,并用稳定编号关联。

DEV-005 · 采集、运营和分析没有逐表单对应

本轮技术验证通过;用户体验待反馈

表现:运营菜单回跳长采集工作台;新增人员表嵌在运营名册页;结算管理无法明确对应表单;分析缺逐表来源。

影响:数据虽然存在,使用者无法从提交找到管理记录和指标,运营责任与采集责任混淆。

原因:0.3.1 只证明部分字段映射和三条订单读回,没有证明 11 张表单在四类视图中一一对应。旧 R05 的“已修正并验证”范围过大。 (后续反馈修正旧结论)

修正:以表单登记源生成定义、Web 处理、运营记录和分析对象链接;运营新增按钮跳转采集,不复制采集表。

DEV-006 · 三端原型来自不同字段来源

本轮技术验证通过;用户体验待反馈

表现:旧金数据和 Android 原型是手写摘要,字段改变后未同步。

影响:测试版本和目标应用验证的不是同一业务规范。

原因:各端单独维护字段。 (已由生成逻辑确认)

修正:从同一登记册生成原型;Web 实现、金数据设计和 Android 原型分别记录实现状态。

DEV-008 · 版本复盘压缩了真实反馈和修正过程

本轮技术验证通过;用户体验待反馈

表现:旧复盘多为一行 before/cause/change 和“测试通过”,没有完整保留反馈、业务影响、修改任务、实际差异、证据局限和后来复发。

影响:后续开发无法从历史判断为什么这样设计,同类错误再次出现;集团标准也缺少可信案例。

原因:把发布摘要当成开发周期档案;只保存结论,没有保存判断链和验收边界。原 R08 自称已验证,但后来反馈证明完成标准不够。 (用户反馈修正旧结论)

修正:每个周期同页保存反馈摘录与复述、错误、任务、结果、验证、发布、未决;保留旧 JSON 快照并追加重评。

DEV-010 · 同一表单在各页面使用不同名称

本轮技术验证通过;用户体验待反馈

表现:例如登记册 HR-F10 为“照片、视频与证据”,Web 工作台显示“业务附件”。

影响:用户无法确认是否同一对象;开发、运营和分析会形成多套口径。

原因:页面各自写标题,没有从同一登记源派生。 (当前结构确认)

修正:锁定 11 个规范名称;用途只作为后缀,例如“· 采集”“· 记录管理”“· 数据分析”。

DEV-011 · 字段缺稳定编号和逐字段版本

本轮技术验证通过;用户体验待反馈

表现:字段字典有中文名、API 键和数据库位置,但没有稳定字段编号与定义版本。

影响:公式、度量、引用、原型和变更历史无法可靠指向同一字段。

原因:只有表单和整体规范版本,字段被当作数组位置管理。 (当前登记册确认)

修正:增加类似 HR-F05-C001 的不可复用编号及 definitionVersion、introducedIn、retiredIn;引用和公式使用字段编号。

DEV-012 · 表单没有作为独立业务抓手展开

本轮技术验证通过;用户体验待反馈

表现:Web 采集只有一个长入口;表单定义藏在登记册;运营出现新增采集表或回跳整页。

影响:无法逐表开发、验证和定位问题,也无法保证前端与后台一一对应。

原因:以页面板块组织功能,而不是以表单身份贯穿不同工作视图。 (用户反馈与导航确认)

修正:每张表单拥有独立定义和 Web 入口;运营与分析保留相应入口;三端版本附着于同一表单。

DEV-013 · 数据分析缺逐指标血缘和实际记录对应

本轮技术验证通过;用户体验待反馈

表现:分析页面有汇总结构,但不能说明每个指标来自哪张表、哪些字段和哪些记录。

影响:模拟数据进入后仍无法验证管理和分析是否读取了同一事实,指标可信度不足。

原因:前端和运营没有先建立逐表映射,导致分析层无稳定来源。 (用户反馈确认)

修正:为每个表单建立分析主题;跨表指标明确粒度、关联键、字段编号、公式、筛选、单位和币种,并允许回到组成记录。

完整修改任务

  1. 统一 11 张表单的唯一名称;所有菜单和视图从同一登记源读取基础名称,只允许增加用途后缀。
  2. 给每个字段分配不随排序变化的字段编号,并保存英文键、定义版本、来源、计算、数据库映射和变更历史。
  3. 把每张表单拆成独立 Web 处理入口;Web 采集页面与三端开发中的 Web 链接是同一实现。
  4. 运营管理只做记录列表、详情、核对、审批和状态处理;新增人员、创建订单等按钮跳往对应表单,不在运营页复制采集表。
  5. 为每张表单建立对应分析对象;指标可以组合多表,但必须声明表单、字段编号、记录粒度、筛选、单位和公式。
  6. 新增环节定义与约束:准备、需求、派遣、履约、审核验收、结算;媒体贯穿,替换属于履约调整。每环节写明进入条件、输出、阻断、退回和重算影响。
  7. 重建开发周期档案:反馈、问题、计划、结果、证据、发布、未决同页;旧版原始 JSON 快照保留,后续重评不覆盖旧结论。
  8. 建立问题复发追踪和平台防复发标准;每轮按表单和业务案例执行针对性检查。

实际实施结果

  • 11张表单统一名称、固定编号和5类视图链接;124个字段具有稳定ID、定义版本及锁表,旧规范快照保留。
  • Web采集、运营记录、数据分析按表单独立打开;运营不嵌入新增表,字段详情保留实际休息等数组事实,并以中文标签显示。
  • 新增环节定义与约束,保留班次、休息、审核、替换、媒体和锁定业务;三端设计与同一Web入口同步,金数据/Android仍标明设计状态。
  • 开发资料重构为含两个0.4候选版本的逐版本检查点、4个周期、13个问题及复发链,保存本轮完整反馈及方案、历史原始JSON和校验哈希。
  • 本机隔离网页实际完成三条差异化服务,33个视图、字段字典、三端选择、会话和390像素手机布局复核通过。此处R2为内存替身,不能当作云端对象存储证据。
  • 根代理在草稿审查发现输入能力遗漏、并发版本字段和状态处理缺口;逐项修正后复核。空订单F07报错及随后F01新建空状态回归均在发布前修正,最终空库重建三例并重跑全部视图通过。
  • 最终审查修正已有记录误入新增表单的风险:查看、编辑/核验、加班审核、同单新增分别命名,已锁定订单无修改入口,不支持编辑的record参数只展示只读说明。
  • 版本回执原先将git status成功返回的空字符串替换成unknown,导致干净构建误报dirty;修正空状态处理并明确源码检查范围,最终候选和生产回执均为dirtyBuild=false。增加生产基线逐字段只读对比脚本,旧候选回执保留原值。
  • 正式站11表×3视图通过,原有3人、2班次、6订单及其工时、审计和媒体逐字段保持不变。历史4份原始JSON的SHA-256复核一致。

本节与修改计划分开:计划不自动转成完成。

验证:预期、实际、证据和局限

检查预期实际证据局限
首次空库检查失败(历史保留)无订单时11表均有正常空状态F01至F06通过;F07读取null.timesheets报错history/cycle-0.4-initial-matrix.json这是未发布草稿的失败记录,后续通过不覆盖它。
最终三条逐表录入A无休息批准60分钟加班;B休息30分钟并拒绝30分钟加班;C跨夜两段休息并替换人员三例都经真实网页提交并锁定:净240/210/210分钟;计费240/180/210分钟;收入40/30/35美元;直接人工24/18/21美元。verification-v0.4.0.json → local.cases / actions本机隔离SQLite和R2替身;不修改正式站六条订单。
逐表视图与手机布局11张表×采集/运营/分析33个入口,统一名称、粒度、导航;会话不闪框33入口通过;390px五类页面无整页溢出;浏览器错误0;124字段ID可见,三端链接定位对应表。verification-v0.4.0.json → localMatrix模拟数据覆盖;真实客户规则仍须现场反馈。
自动回归字段契约、身份版本、计算、API事务、授权和链接有效npm test、npm run check、npm run build通过同版测试脚本与构建记录不能替代逐表浏览器业务验证。
最终Cloudflare预览发布身份一致,同一数据在各视图可见,历史数据不变3e54ce98候选的33个视图、10类文档、5类手机页面通过;错误为0;运行代码指纹与本机最终验证一致。verification-v0.4.0.json → preview预览验证使用独立环境;正式站另有只读核验,不能混用数据。
云端实际录入与对象存储三条网页模拟服务经Cloudflare预览D1/R2保存并锁定候选711c561上A/B/C完整通过;每单小型PNG已上传并授权读取,结算40/30/35美元。verification-v0.4.0.json → previewEntry此记录对应711c561;最终记录入口修正候选另跑33视图。
正式发布与历史数据保全正式提交与版本正确;11表33视图可用;原有六单与人员班次不变2829c5f8生产提交的33视图及手机检查通过;3人、2班次、6订单全部详情含审计和媒体逐字段与发布前一致;admin/Admin/ADMIN可登录,匿名和错误码返回401。verification-v0.4.0.json → production模拟业务样板,真实客户验收尚未完成;代码回滚不等于数据回滚。

未决事项

  • 金数据账户和Power BI接入继续暂停,Android为原型。
  • 真实员工/现场视频转码、断点续传和完整薪资制度未在本轮验收;当前为受控模拟样板。
  • 新结构的用户体验验收等待发布后反馈;后续发现问题会重新打开并保留本轮结论。