背景与目标
维护者 2026-09-03 要求:以软件公司为纬度,为各个岗位做 KPI 考核,按此要求做一套基础数据,并测试一遍。
现有演示种子(市场部/运营部/人力资源部 + 4 家分公司)是通用企业样例,操作手册 62 张截图依赖它,不能替换。本单新增一套「软件公司」基础数据档案,并用它把第 4 章全流程真实跑通一遍,作为后续演示、验收用例与数据准备阶段的样板。
口径决定(调度员假设,维护者可推翻;推翻即打回本单)
独立种子档案,不替换默认 :新增 software 档案,以环境变量 OS_SEED_PROFILE=software 启用;不设变量时行为与当前 main 完全一致(手册截图依赖默认档案)。
「各岗位」在一期口径下通过「到人分工 + 个人承接项」表达 (设计方案 §8 到人口径):员工按岗位挂到部门板块,承接本岗位典型指标。个人考核单是设计方案 V1.1 第 24 项,客户未确认,不做 。
用户不可种子 (CLAUDE.md D4):岗位人员账号、流程岗位分配、到人分工、分管领导(均引用 sys_user)由运行期脚本创建,不进种子。
分公司保留 3 家(华东/华南/华北,销售型分公司),用来让「分公司核对(并行)」节点有真实业务含义:销售相关下达以分公司为核对方。
范围
A. 种子档案(src/data/ 下新增档案模块,src/data/index.ts 按 OS_SEED_PROFILE 选档)
组织树 :总公司 + 部门 ≥ 8(研发部、产品部、测试部、销售部、市场部、客户成功部、人力行政部、财务部)+ 分公司 3 家(华东/华南/华北)。编码唯一、上级存在。
指标库 :每部门 ≥ 3 项,整体覆盖四种计分方式(线性/阶梯/区间/公式)、两种方向、三种数据来源;阶梯指标带完整区间表;公式指标只用 actual / target / weight / 完成率;名称与口径说明按软件公司实际(如:版本按期交付率、线上严重故障数、需求交付周期、缺陷逃逸率、自动化测试覆盖率、签约金额完成率、回款率、线索数、获客成本、续费率、客户满意度、工单响应及时率、关键岗位招聘完成率、离职率、费用预算偏差率、报表准时率——由开发方按部门职责定,名称按需求 §1.4 术语与 std-copy 四条红线)。数字字段四件套显式声明。
方案 :「2026 年第 3 季度考核」(季度,2026-07-01 ~ 2026-09-30),四节点默认流程(部门填报 → 分公司核对(并行)→ 人力审核 → 领导审批);参与主体 = 全部部门 + 3 分公司,主体权重齐全;指标下达每主体权重合计 100,目标值取软件公司合理量级;销售相关下达的核对方为对应分公司。
夹具覆盖 :src/data/align-demo-units.ts 的租户对齐夹具按 DEMO_UNIT_IDS 工作(Sharing rules with a business-unit recipient silently grant nothing when the unit row has organization_id = NULL objectstack#14547 的临时夹具),新档案的组织单元 id 必须一并进入夹具覆盖范围,否则按方案的共享规则对新单元静默失效。
B. 运行期数据脚本(scripts/ 下新增,或扩展现有 e2e-flow.mjs 的档案参数)
创建岗位账号(业务岗位 ≥ 8:研发工程师、测试工程师、产品经理、销售经理、市场专员、客户成功经理、HRBP、财务专员;流程岗位六类各 ≥ 1)并分配流程岗位;
为业务岗位人员建到人分工(员工 × 部门板块 × 分工权重 × 个人系数,系数含 ≠1 的样例)与个人承接项(每人 ≥ 1,承接本岗位典型指标);
为方案设置分管领导(≥ 2 位,分管范围不同);
脚本可重复执行(幂等或明确要求空库)。
C. 全流程实测(本单交付的核心)
API 脚本:发布 → 各主体填报实际值(含超额、未达、临界三类样本)→ 提交 → 分公司核对(含一处争议及其处理)→ 人力审核(含一次驳回与重提)→ 领导审批 → 加减分(提出 + 审批)→ 数据调整(源数据、结果各一)→ 四维汇总 → 归档;每步断言;得分断言按设计方案 §7 表 4 手算预期,不从实现反推。
UI 实测:用岗位账号(部门填报人员、分公司核对人员、人力审核、人力负责人、分管领导)在浏览器走关键步骤,截图 ≥ 12 张,覆盖成功与拦截分支(未填不能提交、驳回原因必填、归档后不可改)。
数据范围断言:部门填报人员只见本部门填报单;分公司核对人员只见本分公司核对任务;分管领导只见分管主体;到人结果只见本人。
D. 文档
README 或 CLAUDE.md 补一行档案启用方式与脚本用法;操作手册不改 。
不做
个人考核单、通知/待办、指标模板库(均属 V1.1 待确认项);修改默认演示种子;修改 src/lib/scoring.ts 与 src/hooks/sheet.hook.ts;修复平台问题(界面英文标签、页签溢出、相对日期等已单独上报平台,截图中出现照实记录即可)。
验收标准
OS_SEED_PROFILE=software pnpm dev 空库启动后,指标库、方案、参与主体、指标下达全部可见且数据完整;不设变量启动与 main 行为一致;pnpm verify 绿。
方案发布前完整性检查通过(权重合计 100、目标齐全、争议关闭、节点合法);发布后填报单数 = 参与主体数,每张填报单明细行带目标/权重/计分规则冻结副本。
全流程脚本一次跑完,断言全部 PASS;至少 3 条得分断言给出手算过程(线性封顶、阶梯、区间插值各一)。
四维结果均非空且排名正确;到人得分 = Σ(部门板块得分 × 分工权重 × 个人系数)+ Σ(承接项得分率 × 承接权重);分管领导得分 = 分管主体按主体权重加权平均。
三类岗位账号的数据范围断言通过(越权访问被明确拒绝)。
测试报告按 os-project-dev-test 模板挂本单评论,截图走孤儿分支 acceptance-evidence、40 位 commit SHA 图链;需求符合度清单挂本单评论,逐条三态。
全部用户可见文案过 std-copy 四条红线;数字字段四件套齐全;pnpm validate 零错。
测试计划草稿(细化自证)
T1 空库按档案启动、种子计数 | T2 未设变量启动 = 默认档案 | T3 发布检查:故意抹掉一个目标值 → 拦截并逐条提示 | T4 发布成功、填报单/明细计数 | T5 填报保存即出分 + 计算说明 | T6 未填不能提交 | T7 提交冻结 | T8 分公司并行核对、争议阻断、处理后推进 | T9 人力驳回(原因必填)退回上一节点、重提 | T10 领导审批通过 → 四维结果生成 | T11 加减分审批后重算 | T12 源数据调整触发重算 / 结果调整标记「已调整」 | T13 归档快照校验和、归档后改数被拒 | T14 岗位账号数据范围 | T15 pnpm verify
依赖与风险
依赖:无(基线 main)。
风险:分管领导、到人分工引用用户,只能脚本建 → 已按口径 3 处理;夹具覆盖遗漏 → 已列入范围 A;第 4 章流程在默认四节点下人力驳回只能退到分公司核对(见交接记录第四节),脚本按现状走「退回上一节点」,不改状态机。
交付物
种子档案模块 + 运行期脚本 + 全流程脚本断言输出 + 带截图测试报告 + 需求符合度清单 + 一行文档 + PR。
背景与目标
维护者 2026-09-03 要求:以软件公司为纬度,为各个岗位做 KPI 考核,按此要求做一套基础数据,并测试一遍。
现有演示种子(市场部/运营部/人力资源部 + 4 家分公司)是通用企业样例,操作手册 62 张截图依赖它,不能替换。本单新增一套「软件公司」基础数据档案,并用它把第 4 章全流程真实跑通一遍,作为后续演示、验收用例与数据准备阶段的样板。
口径决定(调度员假设,维护者可推翻;推翻即打回本单)
software档案,以环境变量OS_SEED_PROFILE=software启用;不设变量时行为与当前 main 完全一致(手册截图依赖默认档案)。sys_user)由运行期脚本创建,不进种子。范围
A. 种子档案(
src/data/下新增档案模块,src/data/index.ts按OS_SEED_PROFILE选档)actual / target / weight / 完成率;名称与口径说明按软件公司实际(如:版本按期交付率、线上严重故障数、需求交付周期、缺陷逃逸率、自动化测试覆盖率、签约金额完成率、回款率、线索数、获客成本、续费率、客户满意度、工单响应及时率、关键岗位招聘完成率、离职率、费用预算偏差率、报表准时率——由开发方按部门职责定,名称按需求 §1.4 术语与 std-copy 四条红线)。数字字段四件套显式声明。src/data/align-demo-units.ts的租户对齐夹具按DEMO_UNIT_IDS工作(Sharing rules with a business-unit recipient silently grant nothing when the unit row has organization_id = NULL objectstack#14547 的临时夹具),新档案的组织单元 id 必须一并进入夹具覆盖范围,否则按方案的共享规则对新单元静默失效。B. 运行期数据脚本(
scripts/下新增,或扩展现有e2e-flow.mjs的档案参数)C. 全流程实测(本单交付的核心)
D. 文档
不做
个人考核单、通知/待办、指标模板库(均属 V1.1 待确认项);修改默认演示种子;修改
src/lib/scoring.ts与src/hooks/sheet.hook.ts;修复平台问题(界面英文标签、页签溢出、相对日期等已单独上报平台,截图中出现照实记录即可)。验收标准
OS_SEED_PROFILE=software pnpm dev空库启动后,指标库、方案、参与主体、指标下达全部可见且数据完整;不设变量启动与 main 行为一致;pnpm verify绿。acceptance-evidence、40 位 commit SHA 图链;需求符合度清单挂本单评论,逐条三态。pnpm validate零错。测试计划草稿(细化自证)
T1 空库按档案启动、种子计数 | T2 未设变量启动 = 默认档案 | T3 发布检查:故意抹掉一个目标值 → 拦截并逐条提示 | T4 发布成功、填报单/明细计数 | T5 填报保存即出分 + 计算说明 | T6 未填不能提交 | T7 提交冻结 | T8 分公司并行核对、争议阻断、处理后推进 | T9 人力驳回(原因必填)退回上一节点、重提 | T10 领导审批通过 → 四维结果生成 | T11 加减分审批后重算 | T12 源数据调整触发重算 / 结果调整标记「已调整」 | T13 归档快照校验和、归档后改数被拒 | T14 岗位账号数据范围 | T15
pnpm verify依赖与风险
交付物
种子档案模块 + 运行期脚本 + 全流程脚本断言输出 + 带截图测试报告 + 需求符合度清单 + 一行文档 + PR。