《移动游戏产品的架构·商业化与发行工程》13.3 卷三评审与进入卷四

// file: src/lab/review-gate-biz.ts
// tier: L1
// verify: node --test test/lab/review-gate-biz.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 openGroups: readonly string[];
  readonly reasons: readonly string[];
}

export const REVIEW_GROUPS = [
  "收入与口径",
  "账号与登录",
  "渠道与包体",
  "支付与商品",
  "订单与对账",
  "广告与归因",
  "风控与数据",
  "运营与触达",
  "合规与发行",
] 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");
  const openGroups = groups.filter((group) => group.pass === 0).map((group) => group.group);

  if (normalized.length === 0) {
    reasons.push("no review items");
  }
  if (counts.partial > 0) {
    reasons.push(`${counts.partial} partial item(s) block the gate`);
  }
  if (counts.fail > 0) {
    reasons.push(`${counts.fail} failed item(s) block the gate`);
  }

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

export function failingGroups(result: GateResult): readonly string[] {
  return result.groups.filter((group) => group.fail > 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: "revenue", group: "收入与口径", status: "pass", evidence: "src/biz/revenue-mix.ts" },
  { id: "unit-economics", group: "收入与口径", status: "pass", evidence: "src/biz/unit-economics.ts" },
  { id: "identity", group: "账号与登录", status: "pass", evidence: "src/biz/identity.ts" },
  { id: "session", group: "账号与登录", status: "pass", evidence: "src/biz/login-session.ts" },
  { id: "channel", group: "渠道与包体", status: "pass", evidence: "src/biz/channel-build.ts" },
  { id: "catalog", group: "支付与商品", status: "pass", evidence: "src/biz/catalog.ts" },
  { id: "receipt", group: "支付与商品", status: "pass", evidence: "src/biz/receipt-verify.ts" },
  { id: "order", group: "订单与对账", status: "pass", evidence: "src/biz/order-fsm.ts" },
  { id: "attribution", group: "广告与归因", status: "pass", evidence: "src/biz/attribution.ts" },
  { id: "risk", group: "风控与数据", status: "pass", evidence: "src/biz/risk-engine.ts" },
  { id: "campaign", group: "运营与触达", status: "pass", evidence: "src/biz/campaign.ts" },
  { id: "privacy", group: "合规与发行", status: "pass", evidence: "src/biz/privacy-manifest.ts" },
];