问题、复发与防复发规则

状态说明

旧版本曾标记“已修正并验证”的内容不会被删除；后来发现范围不足时，保留旧快照，并在这里明确重新打开。例如 DEV-005 对应旧 R05，DEV-008 对应旧 R08。

错误表现：有效会话导航时页面先显示登录框，随后消失。

业务影响：打断连续操作，让权限管理显得不可靠。

原因：界面未区分会话检查中与确认未登录。 （已由代码确认）

完整修正：检查期隐藏登录框，只在确认 401 后显示；继续覆盖首次登录、失效重登和并发响应。

防复发规则

所有权限壳必须有 checking/authenticated/anonymous 三态。

1. 首屏进入 checking
2. 成功后渲染业务
3. 仅明确未登录时显示登录框
4. 会话失效可重登

禁止：先显示登录框再异步隐藏

检查点：连续跨页、冷启动、过期会话分别用浏览器检查。

出现与复发链

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

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

原因：先排页面，再定义业务对象和记录粒度。 （今日回填判断）

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

防复发规则

任何新表单先写“一条记录代表什么”及主键、引用和状态所有者。

1. 定粒度
2. 定主键
3. 定引用
4. 定状态责任方
5. 再画页面

禁止：用步骤编号代替数据关系；在同一表单重复主档

检查点：关系图、数据库约束和三条业务记录必须指向相同 ID。

出现与复发链

错误表现：只有班次名称，没有标准起止、计划休息或历史版本。

业务影响：无法判断加班，也会让修改模板后历史订单含义漂移。

原因：把名称当作完整规则，没有保存订单和派遣使用的班次快照。 （已由代码和反馈确认）

完整修正：班次独立版本化；订单和派遣保存适用快照；实际出勤引用具体派遣。

防复发规则

可变规则进入交易时必须保存当时版本或不可变快照。

1. 建规则版本
2. 交易引用版本
3. 保存关键快照
4. 验证改新不改旧

禁止：只存展示名称；查询时套用最新模板重算历史

检查点：修改班次后旧订单结果不变；重叠排班被服务端拒绝。

出现与复发链

错误表现：休息分钟、加班分钟与上下工时间并列为人工输入。

业务影响：同一事实可以产生互相矛盾的数据，无法审计也无法稳定分析。

原因：事实、引用规则、计算列、审核决定和汇总度量没有分层。 （用户反馈与代码确认）

完整修正：现场记录实际区间或无休息确认；服务端按班次和累积额度计算；审核仅决定超时是否计费。

防复发规则

每字段必须标注事实/引用/规则/计算/审批/系统，并明确谁可写。

1. 先收事实
2. 引用版本化规则
3. 服务端计算
4. 单独审核
5. 分析端聚合

禁止：让用户填写可由已知事实算出的值；在前端独立复制公式

检查点：拒绝客户端伪造分钟；跨夜、重叠休息、分段累计均有针对性测试。

出现与复发链

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

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

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

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

防复发规则

任何表单发布前必须通过四视图矩阵和同一 record ID 追溯。

1. 定义唯一表单
2. 提交真实记录
3. 运营列表找到该记录
4. 详情展示来源字段
5. 分析从该记录聚合并可回查

禁止：把整个工作台当作单张表入口；用页面存在代替记录对应

检查点：11 表矩阵无空链接；三条案例逐条从提交追到运营和分析。

出现与复发链

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

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

原因：各端单独维护字段。 （已由生成逻辑确认）

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

防复发规则

一处业务定义，多端映射；版本一致不代表实施状态一致。

1. 更新字段定义
2. 生成三端映射
3. 分别标实现状态
4. 逐字段比对

禁止：复制粘贴另一套字段；把原型写成已上线

检查点：表单数量、字段编号、规则版本一致；实际连接状态单独验证。

出现与复发链

错误表现：英文键和内部技术词出现在一线表单。

业务影响：现场人员难以理解，误填概率上升。

原因：把实现字段名当作业务名称。 （用户反馈确认）

完整修正：一线界面用清楚中文；必要时中英文并列；API 键只在字段字典。

防复发规则

显示名、稳定字段编号和 API 键分开管理。

1. 业务人员可读名称
2. 开发键映射
3. 浏览器检查最终文案

禁止：裸露内部枚举或缩写

检查点：采集、错误提示和状态逐页检查，不只搜索源码。

出现与复发链

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

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

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

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

防复发规则

没有完整开发周期档案，不得把复盘标为完成。

1. 收反馈
2. 登记错误与影响
3. 区分直接原因和推断
4. 写完整改法
5. 记录实际实施
6. 逐项验证
7. 登记发布和未决
8. 复发时反链首次事件

禁止：用‘优化了’代替改动；用‘测试通过’代替实际结果；静默重写旧验收

检查点：发布负责人逐栏核对；任何空项保留待办而非删掉。

出现与复发链

错误表现：大素材接近超时，中断或锁定后操作按钮状态不准确。

业务影响：现场弱网可能重复操作或误以为可以删除证据。

原因：上传缺明确超时，按钮未同时检查附件和订单状态。 （真实浏览器验收发现）

完整修正：增加有界等待；删除/锁定状态隐藏操作；用真实小图验证 R2 写入和读回。

防复发规则

媒体验证分元数据、对象字节、状态、权限和弱网重试。

1. 初始化
2. 限额上传
3. 完成校验
4. 授权读回
5. 锁定
6. 检查禁用

禁止：只看按钮成功提示；用小图结果声称视频已验收

检查点：按媒体类型和网络场景分别记录实际字节、状态码及局限。

出现与复发链

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

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

原因：页面各自写标题，没有从同一登记源派生。 （当前结构确认）

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

防复发规则

表单代码与规范名称是不可分的唯一身份。

1. 登记规范名
2. 生成所有标题
3. 禁止局部改名
4. 构建扫描差异

禁止：为了页面自然另起近义名称

检查点：逐表在定义、采集、运营、分析和三端名称一致。

出现与复发链

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

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

原因：只有表单和整体规范版本，字段被当作数组位置管理。 （当前登记册确认）

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

防复发规则

字段编号永久稳定；含义不兼容时新建编号并记录迁移。

1. 分配编号
2. 记录版本
3. 声明类型与写入方
4. 引用源字段
5. 登记变更

禁止：按页面排序重新编号；让 API 键承担版本语义

检查点：编号唯一、引用存在、版本可解析、删除不复用。

出现与复发链

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

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

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

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

防复发规则

表单是纵向主轴，系统板块是同一表单的不同视图。

1. 为表单建矩阵
2. 生成独立入口
3. 运营只管理记录
4. 分析引用同源数据
5. 三端链接同一规范

禁止：把 11 表塞入一个无法定位的长页；复制同一表单到多个页面

检查点：从任一表单详情能进入四视图与三端状态，返回路径清楚。

出现与复发链

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

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

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

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

防复发规则

每个指标先写血缘再画图。

1. 确定业务问题
2. 确定粒度
3. 列源字段
4. 写公式和筛选
5. 用三条记录手算
6. 核对页面

禁止：为了每表有图而制造无意义 KPI；直接连接一对多表后重复金额

检查点：三条模拟记录的手算值与 Web 分析一致，并能回查订单/人员/出勤/结算。

出现与复发链