《移动游戏产品的架构·商业化与发行工程》13.2 发行清单与上线门禁

// file: src/release/release-gate.ts
// tier: L1
// verify: node --test test/release/release-gate.test.ts
export type ReleaseStatus = "pass" | "partial" | "fail";

export type ReleaseStage =
  | "content"
  | "build"
  | "channel"
  | "payment"
  | "compliance"
  | "gray"
  | "launch";

export interface ReleaseItem {
  readonly id: string;
  readonly stage: ReleaseStage;
  readonly required: boolean;
  readonly status: ReleaseStatus;
  readonly evidence: string;
}

export interface StageReport {
  readonly stage: ReleaseStage;
  readonly pass: number;
  readonly partial: number;
  readonly fail: number;
  readonly blocked: boolean;
}

export interface ReleaseReport {
  readonly ready: boolean;
  readonly total: number;
  readonly blocking: readonly ReleaseItem[];
  readonly missingEvidence: readonly string[];
  readonly stages: readonly StageReport[];
  readonly reasons: readonly string[];
}

export const RELEASE_STAGES: readonly ReleaseStage[] = [
  "content",
  "build",
  "channel",
  "payment",
  "compliance",
  "gray",
  "launch",
];

export function evaluateRelease(items: readonly ReleaseItem[]): ReleaseReport {
  const reasons: string[] = [];
  const normalized: ReleaseItem[] = [];

  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 blocking = normalized.filter(
    (item) => item.required && item.status !== "pass",
  );
  const missingEvidence = normalized
    .filter((item) => item.evidence.trim() === "")
    .map((item) => item.id);

  const stages: StageReport[] = RELEASE_STAGES.map((stage) => {
    const scoped = normalized.filter((item) => item.stage === stage);
    const pass = scoped.filter((item) => item.status === "pass").length;
    const partial = scoped.filter((item) => item.status === "partial").length;
    const fail = scoped.filter((item) => item.status === "fail").length;
    const blocked = scoped.some(
      (item) => item.required && item.status !== "pass",
    );
    return { stage, pass, partial, fail, blocked };
  });

  if (normalized.length === 0) {
    reasons.push("no release items");
  }
  if (blocking.length > 0) {
    reasons.push(`${blocking.length} required item(s) block release`);
  }

  return {
    ready: normalized.length > 0 && blocking.length === 0,
    total: normalized.length,
    blocking,
    missingEvidence,
    stages,
    reasons,
  };
}

export function blockingStages(report: ReleaseReport): readonly ReleaseStage[] {
  return report.stages.filter((stage) => stage.blocked).map((stage) => stage.stage);
}

export function openStages(report: ReleaseReport): readonly ReleaseStage[] {
  return report.stages
    .filter((stage) => stage.pass === 0)
    .map((stage) => stage.stage);
}

export function formatRelease(report: ReleaseReport): string {
  const header = "stage\tpass\tpartial\tfail\tblocked";
  const rows = report.stages.map(
    (stage) =>
      `${stage.stage}\t${stage.pass}\t${stage.partial}\t${stage.fail}\t${stage.blocked}`,
  );
  return [header, ...rows].join("\n");
}

export const DEFAULT_RELEASE: readonly ReleaseItem[] = [
  { id: "build-hash", stage: "build", required: true, status: "pass", evidence: "dist/latest.json" },
  { id: "build-sign", stage: "build", required: true, status: "pass", evidence: "sign/report.txt" },
  { id: "channel-packs", stage: "channel", required: true, status: "pass", evidence: "pack/manifest.json" },
  { id: "sdk-init-order", stage: "channel", required: true, status: "pass", evidence: "test/channel/sdk-contract.test.ts" },
  { id: "catalog-version", stage: "payment", required: true, status: "pass", evidence: "catalog/v42.json" },
  { id: "receipt-verify", stage: "payment", required: true, status: "pass", evidence: "test/biz/receipt-verify.test.ts" },
  { id: "order-idempotent", stage: "payment", required: true, status: "pass", evidence: "test/biz/order-fsm.test.ts" },
  { id: "privacy-sdk-list", stage: "compliance", required: true, status: "pass", evidence: "compliance/sdk-list.csv" },
  { id: "minor-protection", stage: "compliance", required: true, status: "pass", evidence: "compliance/minor-plan.md" },
  { id: "gray-5pct", stage: "gray", required: true, status: "pass", evidence: "gray/2026-11-05.json" },
  { id: "rollback-drill", stage: "launch", required: true, status: "pass", evidence: "drill/rollback-1105.log" },
  { id: "press-kit", stage: "content", required: false, status: "pass", evidence: "marketing/press-kit.zip" },
];