《移动游戏产品的架构·客户端与移动运行时》13.3 卷一评审与进入卷二

// file: src/lab/review-gate.ts
// tier: L1
// verify: node --test test/lab/review-gate.test.ts

export type ReviewStatus = "pass" | "partial" | "fail";

export interface ReviewItem {
  readonly id: string;
  readonly group: string;
  readonly status: ReviewStatus;
  readonly evidence: string;
}

export interface GroupSummary {
  readonly group: string;
  readonly pass: number;
  readonly partial: number;
  readonly fail: number;
}

export interface GateResult {
  readonly passed: boolean;
  readonly total: number;
  readonly counts: Readonly<Record<ReviewStatus, number>>;
  readonly groups: readonly GroupSummary[];
  readonly blockers: readonly ReviewItem[];
  readonly reasons: readonly string[];
}

export const REVIEW_GROUPS = [
  "分层与依赖",
  "生命周期与恢复",
  "配置",
  "资源与内存",
  "UI 与输入",
  "帧率与功耗",
  "存档",
  "区域化",
  "可观测性",
] as const;

export function evaluateGate(items: readonly ReviewItem[]): GateResult {
  const reasons: string[] = [];
  const normalized: ReviewItem[] = [];

  for (const item of items) {
    if (item.status === "pass" && item.evidence.trim() === "") {
      reasons.push(`${item.id}: pass without evidence counts as partial`);
      normalized.push({ ...item, status: "partial" });
      continue;
    }
    normalized.push(item);
  }

  const counts: Record<ReviewStatus, number> = { pass: 0, partial: 0, fail: 0 };
  for (const item of normalized) {
    counts[item.status] += 1;
  }

  const groups = REVIEW_GROUPS.map((group) => {
    const scoped = normalized.filter((item) => item.group === group);
    return {
      group,
      pass: scoped.filter((item) => item.status === "pass").length,
      partial: scoped.filter((item) => item.status === "partial").length,
      fail: scoped.filter((item) => item.status === "fail").length,
    };
  });

  const blockers = normalized.filter((item) => item.status !== "pass");
  if (normalized.length === 0) {
    reasons.push("no review items");
  }

  return {
    passed: normalized.length > 0 && blockers.length === 0,
    total: normalized.length,
    counts,
    groups,
    blockers,
    reasons,
  };
}

export function openGroups(result: GateResult): readonly string[] {
  return result.groups.filter((group) => group.pass === 0).map((group) => group.group);
}

export function formatGate(result: GateResult): string {
  const header = "group\tpass\tpartial\tfail";
  const rows = result.groups.map(
    (group) => `${group.group}\t${group.pass}\t${group.partial}\t${group.fail}`,
  );
  return [header, ...rows].join("\n");
}

export const DEFAULT_REVIEW: readonly ReviewItem[] = [
  { id: "layers", group: "分层与依赖", status: "pass", evidence: "src/core/layers.ts" },
  { id: "boundaries", group: "分层与依赖", status: "pass", evidence: "src/core/boundaries.ts" },
  { id: "lifecycle", group: "生命周期与恢复", status: "pass", evidence: "src/runtime/lifecycle.ts" },
  { id: "recovery", group: "生命周期与恢复", status: "pass", evidence: "src/runtime/recovery.ts" },
  { id: "config", group: "配置", status: "pass", evidence: "src/config/schema.ts" },
  { id: "memory", group: "资源与内存", status: "pass", evidence: "src/resource/memory-budget.ts" },
  { id: "ui", group: "UI 与输入", status: "pass", evidence: "src/ui/popup-arbiter.ts" },
  { id: "frame", group: "帧率与功耗", status: "pass", evidence: "src/runtime/frame-budget.ts" },
  { id: "save", group: "存档", status: "pass", evidence: "src/save/merge.ts" },
  { id: "i18n", group: "区域化", status: "pass", evidence: "src/i18n/timezone.ts" },
  { id: "crash", group: "可观测性", status: "pass", evidence: "src/obs/crash-model.ts" },
  { id: "sampling", group: "可观测性", status: "pass", evidence: "src/obs/sampling.ts" },
];