《移动游戏产品的架构·网络、资源与热更新》10.1 商店允许更新什么

// file: src/hotfix/store-policy.ts
// tier: L1
// verify: node --test test/hotfix/store-policy.test.ts

export type Platform = "android" | "ios";
export type ChangeSurface = "resource" | "config" | "script" | "native";
export type UpdateRoute = "hotfix" | "split" | "store" | "blocked";

export interface ChangeRequest {
  readonly id: string;
  readonly surface: ChangeSurface;
  readonly platforms: readonly Platform[];
  readonly bytes: number;
  readonly rollbackMinutes: number;
  readonly touchesPaymentFlow?: boolean;
  readonly changesGachaOdds?: boolean;
  readonly changesCoreRules?: boolean;
  readonly changesPermissions?: boolean;
  readonly changesPrivacyDeclaration?: boolean;
}

export interface StorePolicy {
  readonly name: string;
  readonly codeHotfixPlatforms: readonly Platform[];
  readonly rollbackBudgetMinutes: number;
  readonly batchBudgetBytes: number;
}

export interface PolicyDecision {
  readonly id: string;
  readonly route: UpdateRoute;
  readonly hotfixPlatforms: readonly Platform[];
  readonly storePlatforms: readonly Platform[];
  readonly reasons: readonly string[];
  readonly withinRollbackBudget: boolean;
}

export interface BatchReport {
  readonly policy: string;
  readonly decisions: readonly PolicyDecision[];
  readonly hotfixBytes: number;
  readonly withinBatchBudget: boolean;
  readonly counts: Readonly<Record<UpdateRoute, number>>;
}

export const MB = 1024 * 1024;

export const TIDE_ARK_POLICY: StorePolicy = {
  name: "潮汐方舟",
  codeHotfixPlatforms: ["android"],
  rollbackBudgetMinutes: 15,
  batchBudgetBytes: 45 * MB,
};

export const TIDE_MATCH3_POLICY: StorePolicy = {
  name: "潮汐消消",
  codeHotfixPlatforms: [],
  rollbackBudgetMinutes: 30,
  batchBudgetBytes: 12 * MB,
};

interface RedLine {
  readonly flag: keyof ChangeRequest;
  readonly label: string;
}

const RED_LINES: readonly RedLine[] = [
  { flag: "touchesPaymentFlow", label: "改动支付流程" },
  { flag: "changesGachaOdds", label: "改动抽奖概率" },
  { flag: "changesCoreRules", label: "改动核心玩法规则" },
  { flag: "changesPermissions", label: "改动原生权限" },
  { flag: "changesPrivacyDeclaration", label: "改动隐私声明" },
];

function validateRequest(request: ChangeRequest): void {
  if (request.id.trim() === "") throw new Error("change id is required");
  if (!Number.isInteger(request.bytes) || request.bytes < 0) {
    throw new Error(`invalid bytes for ${request.id}: ${request.bytes}`);
  }
  if (!Number.isInteger(request.rollbackMinutes) || request.rollbackMinutes < 0) {
    throw new Error(`invalid rollback minutes for ${request.id}: ${request.rollbackMinutes}`);
  }
  if (request.platforms.length === 0) {
    throw new Error(`no platforms for ${request.id}`);
  }
  if (new Set(request.platforms).size !== request.platforms.length) {
    throw new Error(`duplicate platform in ${request.id}`);
  }
}

export function classifyChange(
  request: ChangeRequest,
  policy: StorePolicy,
): PolicyDecision {
  validateRequest(request);

  const red = RED_LINES.filter((line) => request[line.flag] === true);
  if (red.length > 0) {
    return {
      id: request.id,
      route: "blocked",
      hotfixPlatforms: [],
      storePlatforms: [...request.platforms],
      reasons: red.map((line) => `红线：${line.label}`),
      withinRollbackBudget: false,
    };
  }

  if (request.surface === "native") {
    return {
      id: request.id,
      route: "store",
      hotfixPlatforms: [],
      storePlatforms: [...request.platforms],
      reasons: ["原生代码与权限只能随商店整包发布"],
      withinRollbackBudget: false,
    };
  }

  const withinRollbackBudget = request.rollbackMinutes <= policy.rollbackBudgetMinutes;
  const reasons: string[] = [];
  let hotfixPlatforms: Platform[];

  if (request.surface === "script") {
    hotfixPlatforms = request.platforms.filter((platform) =>
      policy.codeHotfixPlatforms.includes(platform),
    );
    if (hotfixPlatforms.length < request.platforms.length && withinRollbackBudget) {
      reasons.push("该平台只接受资源与配置热更");
    }
  } else {
    hotfixPlatforms = [...request.platforms];
  }

  if (!withinRollbackBudget) {
    hotfixPlatforms = [];
    reasons.push(
      `回滚 ${request.rollbackMinutes} 分钟超出 ${policy.rollbackBudgetMinutes} 分钟预算`,
    );
  }

  const hotfixSet = new Set(hotfixPlatforms);
  const storePlatforms = request.platforms.filter((platform) => !hotfixSet.has(platform));
  const route: UpdateRoute =
    hotfixPlatforms.length === 0
      ? "store"
      : storePlatforms.length === 0
        ? "hotfix"
        : "split";

  return {
    id: request.id,
    route,
    hotfixPlatforms,
    storePlatforms,
    reasons,
    withinRollbackBudget,
  };
}

export function planBatch(
  requests: readonly ChangeRequest[],
  policy: StorePolicy,
): BatchReport {
  const seen = new Set<string>();
  for (const request of requests) {
    if (seen.has(request.id)) throw new Error(`duplicate change id: ${request.id}`);
    seen.add(request.id);
  }

  const decisions = requests.map((request) => classifyChange(request, policy));
  const counts: Record<UpdateRoute, number> = {
    hotfix: 0,
    split: 0,
    store: 0,
    blocked: 0,
  };
  let hotfixBytes = 0;

  for (let index = 0; index < requests.length; index += 1) {
    const decision = decisions[index];
    counts[decision.route] += 1;
    if (decision.route === "hotfix" || decision.route === "split") {
      hotfixBytes += requests[index].bytes;
    }
  }

  return {
    policy: policy.name,
    decisions,
    hotfixBytes,
    withinBatchBudget: hotfixBytes <= policy.batchBudgetBytes,
    counts,
  };
}

export function formatBatchReport(report: BatchReport): string {
  const lines = ["change\troute\thotfix\tstore\tnotes"];
  for (const decision of report.decisions) {
    const hotfix =
      decision.hotfixPlatforms.length > 0 ? decision.hotfixPlatforms.join(",") : "-";
    const store =
      decision.storePlatforms.length > 0 ? decision.storePlatforms.join(",") : "-";
    const notes = decision.reasons.length > 0 ? decision.reasons.join("; ") : "-";
    lines.push(`${decision.id}\t${decision.route}\t${hotfix}\t${store}\t${notes}`);
  }
  lines.push(
    `summary\thotfix=${report.counts.hotfix}\tsplit=${report.counts.split}\tstore=${report.counts.store}\tblocked=${report.counts.blocked}\tbytes=${(report.hotfixBytes / MB).toFixed(2)}MB\tbudget=${report.withinBatchBudget ? "ok" : "exceeded"}`,
  );
  return lines.join("\n");
}

change	route	hotfix	store	notes
ui	hotfix	android,ios	-	-
battle-script	split	android	ios	该平台只接受资源与配置热更
ios-native	store	-	android,ios	原生代码与权限只能随商店整包发布
first-charge	blocked	-	android,ios	红线：改动支付流程
summary	hotfix=1	split=1	store=1	blocked=1	bytes=2.00MB	budget=ok