feat(v2): T11 改进治理与演示交付——对照门禁、泄漏作废、三模块演示脚本

覆盖 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>
This commit is contained in:
2026-09-30 09:25:25 +08:00
co-authored by Claude Code
parent f2bbac03e7
commit d6bc8485f5
10 changed files with 1018 additions and 14 deletions
+3 -3
View File
@@ -159,11 +159,11 @@ export default function PrescreenPanel({project, request, busy, setBusy, setErro
</div>
<h3>核查维度({dimensions.length})</h3>
{shown.kind === "empty" && <div className="ra-empty"><h2>{EMPTY_DIMENSIONS}</h2>
{shown.layout === "empty" && <div className="ra-empty"><h2>{EMPTY_DIMENSIONS}</h2>
<p>方案没有维度时不补占位轴,也不给出任何结论。</p></div>}
{shown.kind !== "empty" && <>
{shown.layout !== "empty" && <>
<p>{shown.reason}</p>
{shown.kind === "radar" && <RadarChart dimensions={dimensions} scenarioStages={scenarioStages} />}
{shown.layout === "radar" && <RadarChart dimensions={dimensions} scenarioStages={scenarioStages} />}
<div className="xb-finding">
<div>
{dimensions.map((item) => {
+14 -7
View File
@@ -49,15 +49,22 @@ export const RUN_STATUS_LABELS: Record<string, string> = {
completed: "已完成", partial: "部分完成", failed: "未完成", cancelled: "已取消",
};
/** 维度呈现方式。同刻度 3–8 维才画雷达;其余给完整列表,绝不补占位轴(AC-44)。 */
export function presentationFor(dimensions: {scale_id?: string}[]): {kind: "empty" | "radar" | "bars" | "list" | "faceted"; reason: string} {
/** 维度呈现方式。同刻度 3–8 维才画雷达;其余给完整列表,绝不补占位轴(AC-44)。
*
* 词汇与后端 services/review_plan.presentation() 保持一致
* (empty/list/grouped/radar/faceted),避免前后端各有一套判定导致界面
* 画出后端判定为"不该画雷达"的图。
*/
export type DimensionLayout = "empty" | "list" | "grouped" | "radar" | "faceted";
export function presentationFor(dimensions: {scale_id?: string}[]): {layout: DimensionLayout; reason: string} {
const total = dimensions.length;
if (!total) return {kind: "empty", reason: EMPTY_DIMENSIONS};
if (!total) return {layout: "empty", reason: EMPTY_DIMENSIONS};
const scales = new Set(dimensions.map((item) => item.scale_id || ""));
if (scales.size > 1) return {kind: "faceted", reason: "维度刻度不一致,按分面展示;不强行归一化,避免比较不可比的量"};
if (total < RADAR_MIN) return {kind: "bars", reason: `仅 ${total} 个维度,用状态列表比雷达更清楚`};
if (total > RADAR_MAX) return {kind: "list", reason: `${total} 个维度超出雷达可读范围,改用分组列表且全部维度仍可查看`};
return {kind: "radar", reason: "同一刻度且 3–8 维,可用雷达并附等价文字列表"};
if (scales.size > 1) return {layout: "faceted", reason: "维度刻度不一致,按分面展示;不强行归一化,避免比较不可比的量"};
if (total < RADAR_MIN) return {layout: "list", reason: `仅 ${total} 个维度,用状态列表比雷达更清楚`};
if (total > RADAR_MAX) return {layout: "grouped", reason: `${total} 个维度超出雷达可读范围,改用分组列表且全部维度仍可查看`};
return {layout: "radar", reason: "同一刻度且 3–8 维,可用雷达并附等价文字列表"};
}
export function stageName(stage: number | null | undefined): string {