qiaoqichaoandClaude Code
d6bc8485f5
覆盖 AC-15/16/34/37/41（BR-15/16/40、E-11/24）。
后端：
- contracts/improvement.py：ImprovementCandidate + ContrastReport/ContrastMetrics。
零分母不得给比率或覆盖率（样本不足不是 0%）；非独立评测不得给改进/退化结论；
已发布必须引用既有不可变版本；没有对照证据不得进入待审核或已发布。
- services/improvements.py：
· evaluate_contrast 在服务端判定泄漏——预测锁定前读到标签即整次评测作废（E-11），
保留集来源进开发集的样本作废并单列，指标按分子/可观察分母/覆盖率/未观察分开报；
· transition 状态机：draft→evaluating→ready→in_review→approved→released，
自批拒绝、退化与结论不明拒绝发布、发布幂等且只引用既有版本、撤回只影响新运行。
- api/prescreen.py：候选列表、提出与状态机三个端点；评测请求体提交样本，
泄漏与指标一律由服务端计算，不接受客户端交来的"成品报告"。
- contracts/prescreen.py：补 E-11/E-24 错误码与 409 映射。
前端一致性修正：
- src/lib/prescreen-run.ts 的呈现判定改用后端既有词汇
（empty/list/grouped/radar/faceted，与 services/review_plan.presentation 一致），
避免前后端各一套判定导致界面画出后端判定为不该画雷达的图。
演示交付：
- scripts/xingbang_prescreen_demo.py：按 08 §7 八步演示，只驱动已实现入口，
未实现的步骤（批量清单、历史提炼、卡片治理）如实标注原因；
工程演示与模型效果分列，本地专项/Jev/真实概率一律标未验证或未接通。
- backend/test_demo_script.py：冒烟断言八步状态、未实现原因与分列口径。
验证：backend 全量 unittest 519 项 OK；前端 npm run build 通过。
Co-Authored-By: Claude Code <noreply@anthropic.com>
80 lines
4.7 KiB
JavaScript
80 lines
4.7 KiB
JavaScript
/**
|
||
* T09 预审工作台与沙盘界面源码守卫。
|
||
*
|
||
* 这是**源码断言**，不是浏览器端到端测试（docs/v2/06-validation.md §2 已明确
|
||
* 现有 UI 脚本的性质）。它锁住的是可机械核对的约束：数值只能来自服务端、
|
||
* 演示值只在演示域、雷达只画 3–8 维、乱序响应丢弃、失败保留基线、
|
||
* 图的等价文字与键盘可达。
|
||
*/
|
||
const assert = require("node:assert/strict");
|
||
const fs = require("node:fs");
|
||
const path = require("node:path");
|
||
|
||
const root = path.resolve(__dirname, "..");
|
||
const read = (file) => fs.readFileSync(path.join(root, file), "utf8");
|
||
|
||
const panel = read("src/components/xingbang/PrescreenPanel.tsx");
|
||
const lib = read("src/lib/prescreen-run.ts");
|
||
const workbench = read("src/app/xingbang-workbench/page.tsx");
|
||
|
||
// 1. 挂载在既有工作台内，不新建路由（04-ui-spec §1：不恢复已合并的旧页面）
|
||
assert.match(workbench, /import PrescreenPanel from "@\/components\/xingbang\/PrescreenPanel"/, "工作台应导入预审面板");
|
||
assert.match(workbench, /<PrescreenPanel /, "工作台应渲染预审面板");
|
||
for (const banned of ["prescreen", "sandbox", "simulation"]) {
|
||
assert.ok(!fs.existsSync(path.join(root, "src/app", banned)), `不得为 T09 新建路由 src/app/${banned}`);
|
||
}
|
||
|
||
// 2. 复用既有样式，不新增样式表
|
||
assert.ok(!/^import .*\.css";/m.test(panel), "面板应复用 workspace.css 既有 class，不新增样式表");
|
||
|
||
// 3. 数值只能来自服务端：前端不得复制演示情景表（AC-30/31）
|
||
for (const [name, source] of [["panel", panel], ["lib", lib]]) {
|
||
assert.ok(!/0\.(42|58|51|64)\b/.test(source), `${name} 不得硬编码演示概率值`);
|
||
assert.ok(!/"(00|10|01|11)"\s*:/.test(source), `${name} 不得在客户端复制演示情景表`);
|
||
}
|
||
assert.match(panel, /simulation\.probability_view/, "情景数值必须取自服务端响应");
|
||
|
||
// 4. 演示值只在演示域显示，且紧邻"人工设定"说明（AC-12/30、DESIGN §38）
|
||
assert.match(panel, /demoValue\(run\?\.data_domain/, "演示值必须按数据域判定后才显示");
|
||
assert.match(panel, /未完成真实历史校准/, "未校准时必须说明为何不显示概率");
|
||
assert.match(panel, /正式审批由人工决定/, "演示值旁必须有用途边界说明");
|
||
assert.match(lib, /domain !== "demo"/, "lib 必须在非演示域返回 null");
|
||
|
||
// 5. 雷达只对同刻度 3–8 维绘制，其余给完整列表；空维度不补占位轴（AC-44）
|
||
assert.match(lib, /RADAR_MIN = 3/);
|
||
assert.match(lib, /RADAR_MAX = 8/);
|
||
assert.match(lib, /layout: "radar"/);
|
||
assert.match(lib, /DimensionLayout = "empty" \| "list" \| "grouped" \| "radar" \| "faceted"/, "呈现词汇必须与后端 review_plan.presentation 一致");
|
||
assert.match(lib, /EMPTY_DIMENSIONS = "当前方案尚未配置核查维度"/);
|
||
assert.match(panel, /shown\.layout === "radar" && <RadarChart/, "只有判定为雷达时才画雷达");
|
||
assert.match(panel, /shown\.layout === "empty" && <div className="ra-empty">/, "空维度用空状态，不补六轴");
|
||
assert.match(panel, /文字列表与图等价/, "图必须有等价文字列表");
|
||
|
||
// 6. 乱序与过期响应必须丢弃（AC-31）
|
||
assert.match(panel, /ticket !== seq\.current/, "旧请求晚到必须丢弃");
|
||
assert.match(panel, /returned !== \[\.\.\.keys\]\.sort\(\)\.join\(","\)/, "结果与当前选择不一致时必须丢弃");
|
||
|
||
// 7. 失败保留基线并标未完成；计算中不得先给乐观增幅
|
||
assert.match(panel, /该情景未完成。基线数值与原有意见保持不变/, "失败必须保留基线");
|
||
assert.match(panel, /不会先给一个乐观增幅/, "计算中不得预告结果");
|
||
assert.match(panel, /不是各项增量的简单相加/, "沙盘必须说明组合非加和");
|
||
|
||
// 8. 键盘可达与无障碍
|
||
assert.match(panel, /<input type="checkbox"/, "假设动作必须是原生可聚焦控件");
|
||
assert.match(panel, /aria-live="polite"/, "变化的数值区必须有 aria-live");
|
||
assert.match(panel, /aria-label=\{`查看 \$\{item\.id\} 的依据`\}/, "维度依据入口必须有可读名称");
|
||
assert.ok(/<svg[^>]*aria-label=/.test(panel.replace(/\n/g, " ")), "雷达必须有文字等价说明");
|
||
|
||
// 9. 来源与数据域用文字＋图标共同区分，不靠颜色单独传意（AC-42）
|
||
assert.match(lib, /text: "历史提炼"/);
|
||
assert.match(lib, /text: "人工创建"/);
|
||
assert.match(lib, /text: "制度导入"/);
|
||
assert.match(lib, /icon: "history"/);
|
||
assert.match(panel, /domain\.text/, "数据域必须以文字呈现");
|
||
|
||
// 10. 阶段是序数，不得换算成概率
|
||
assert.match(lib, /雷达面积不换算成百分比|STAGE_LEGEND/, "必须说明阶段与概率无关");
|
||
assert.ok(!/probability\s*[:=]\s*[0-9]/.test(panel), "面板不得写入任何概率数值");
|
||
|
||
console.log("prescreen-ui: PASS");
|