@oj-module/cli 0.2.66 → 0.2.68

package/templates/src/app/api/_platform/market/api.ts

@@ -33,6 +33,7 @@ import { createTrustStore } from "../_lifecycle/trust";
 import { computeUninstallImpact, runUninstall } from "../_lifecycle/uninstall";
 import { respond } from "../_shared/respond";
 import { assertSuperAdmin } from "../_shared/service/infra/access";
+import { pageArgs } from "../_shared/service/infra/query";
 import { journalHeadOf, readCanonicalOrigin, siteOrigin, withSiteOrigin } from "../_shared/site-facade";
 import { BOOTSTRAP_KEY, seedBootstrapKey } from "./bootstrap";
 import { httpIndexSource, indexPathOf } from "./index-source";
@@ -64,7 +65,7 @@ export interface MarketEnv {
 	modulesJsonPath: string
 	/** API 前缀（smoke 探针 URL 前缀） */
 	apiPrefix: string
-	/** 站点 config.yaml 路径（reloading 段 vars.ojm_install_seq 自增落盘处；缺省 config.yaml） */
+	/** 站点 config.yaml 路径（reloading 段 anonymous_paths 接线落盘处；缺省 config.yaml） */
 	configPath?: string
 	/** canonical origin（REG-CS6：相对 URL 补全用，取自 config.yaml vars.canonical_origin，绝不读请求头 Host） */
 	canonicalOrigin?: string
@@ -236,7 +237,14 @@ function execOf(env: MarketEnv): ExecFace {
 
 function reloadOf(env: MarketEnv): ReloadFace {
 	const g = globalThis as { server?: { reloadConfig: ReloadFace["reloadConfig"] } };
-	return env.reload ?? { reloadConfig: () => g.server!.reloadConfig() };
+	// env 显式注入优先；其次平台 server.reloadConfig（生产 oj 提供，oj 0.1.123+ 支持 force 透传）；
+	// 均缺失（dev/test 无 server）回落 no-op——等价于「不 reload」，保持卸载旧语义（reload 实际掉
+	// 挂载依赖 US-1 上游 manifests 摘要驱动，未到位前回落 no-op 不阻断卸载主流程）；force 透传给宿主。
+	if (env.reload !== undefined)
+		return env.reload;
+	if (g.server?.reloadConfig !== undefined)
+		return { reloadConfig: (force?: boolean) => g.server!.reloadConfig(force) };
+	return { reloadConfig: async () => ({ unchanged: true, applied: [], restart_pending: [] }) };
 }
 
 function sha384Of(env: MarketEnv): (data: Uint8Array) => string {
@@ -249,6 +257,23 @@ function sha256Of(env: MarketEnv): (data: Uint8Array) => string {
 	return env.sha256Hex ?? ((data: Uint8Array) => g.crypto!.sha256Hex!(data));
 }
 
+/**
+ * 宿主能力集（P0 §3.9 / §2.3）：从 ojInfo().build.capabilities 读取（v0.1.122 增量能力位闭集：
+ * reload.assemble_modules / reload.anon_per_reload / reload.cron_survives）。注入安装上下文后，
+ * preflight 据 manifest.requiresCapabilities 做写锁前门禁——宿主缺能力即 fail-closed（零痕迹）。
+ * ojInfo 不可用时回落空数组（等同未上报 → 若模板声明了 requiresCapabilities 则拒装）。
+ */
+function capabilitiesOf(): string[] {
+	try {
+		const info = (globalThis as { ojInfo?: () => any }).ojInfo?.();
+		const caps = info?.build?.capabilities;
+		return Array.isArray(caps) ? caps : [];
+	}
+	catch {
+		return [];
+	}
+}
+
 /** CDN 基址：注入面优先，缺省读设置表（值/缺省值俱空 = 未配置；表异常视同未配置，消费端给可读错误） */
 async function cdnBaseOf(env: MarketEnv): Promise<string | null> {
 	if (env.cdnBase) {
@@ -694,6 +719,8 @@ async function installBody(env: MarketEnv): Promise<{ task_id: string }> {
 	if (name === "")
 		fail(400, "name is required");
 	const reqVersion = body.version == null || body.version === "" ? null : String(body.version);
+	// force 透传（oj 0.1.123+ reloadConfig(force)）：body.force 或 query.force=1 任一为真即强制重装配
+	const force = body.force === true || String((http as { query?: Record<string, unknown> }).query?.force ?? "") === "1";
 
 	let manifest: unknown;
 	let version: string;
@@ -786,7 +813,10 @@ async function installBody(env: MarketEnv): Promise<{ task_id: string }> {
 			hostVersions: await hostVersionsOf(env),
 			// 宿主平台编排面 API 版本（C2-11 peerPlatform 比对真源；与 meta 端点 apiVersion、_platform/manifest.yaml 版本同源，手工同步）
 			hostApiVersion: API_VERSION,
+			// 宿主能力集（P0 §3.9）：ojInfo().build.capabilities，preflight 的 requiresCapabilities 门禁据此生效
+			capabilities: capabilitiesOf(),
 			trustPath: env.trustPath,
+			force,
 			registryId: env.registryId,
 			cancel: () => {
 				if (!cancelled) {
@@ -818,10 +848,16 @@ interface IndexRow {
 	available: string[]
 	/** 最新版 changelog（C2-08，R27 卡片版本对比；分片条目缺 changelog → null） */
 	changelog: unknown
-	/** 最新版发布方（manifest author，C2-07；分片条目缺 author → null） */
+	/** 最新版发布方（manifest author，C2-07；分片条目缺 author → null，自报字段） */
 	publisher: string | null
+	/** 最新版包级签名 key_id（Form B archive.signature.key_id，经 Ed25519 验签的发布身份；缺签名 → null） */
+	publisher_key: string | null
 	/** 最新版许可（manifest license，C2-07 SPDX 简化式；分片条目缺/非字符串 → null） */
 	license: string | null
+	/** 方案简介（manifest summary，C2-04 单行 1..200；分片条目缺/非字符串 → null） */
+	summary: string | null
+	/** 方案详细描述（manifest description，C2-05 ≤2000；分片条目缺/非字符串 → null） */
+	description: string | null
 	/** 本地安装的发布方 key 状态（P2-6 sidecar；未装 → null） */
 	trust_state: "trusted" | "untrusted" | "absent" | null
 	/** 本地安装记录的签名 key id（sidecar archive.key_id；未装/P1 时代条目 → null） */
@@ -853,19 +889,32 @@ async function lastInstallOperatorOf(name: string): Promise<string | null> {
  *
  * 三级化后市场页的拉取形态：1 catalog + catalog 指向的全部分片（去重）——`available`
  * 回滚候选要版本全集，故页面比安装多拉几片；安装侧仍 ≤ 1 catalog + 1 shard（resolveCdn）。
- * 版本条目即 Form B manifest：latest 的 changelog/publisher 直接从分片条目取，不再有
- * 独立的聚合清单拉取。分片拉取/验签失败即 502（REG-CS1：可用性不再压过完整性）。
+ * 版本条目即 Form B manifest：latest 的 changelog/publisher/summary/description 直接从
+ * 分片条目取，不再有独立的聚合清单拉取。分片拉取/验签失败即 502（REG-CS1：可用性不再
+ * 压过完整性）。
  */
-async function indexBody(env: MarketEnv): Promise<IndexRow[]> {
-	// 对账即服务（P1-10 接线③）：市场页刷新即对账时点——锁 ↔ 账本 head 自愈 + enabled 不一致
-	// 自动修复先行（失败只记日志，不阻断索引），失败站点的市场页每次打开都在尝试自愈
-	await reconcileOf(env);
+interface IndexSnapshot {
+	base: string
+	/** catalog 的签名时效（发布时间兜底；索引缺时效 → null） */
+	issuedAt: number | null
+	solutions: Array<{ name: string, shards: number[] }>
+	shardDocs: Map<number, ShardSolution[]>
+}
+
+/**
+ * 读整份签名索引（catalog + 它指向的全部分片）。
+ *
+ * 市场卡片（indexBody）与发布历史（syncReleases）都要「全量版本视图」，读取与验签只有这一份：
+ * 两处各写一遍 `fetchIndex` 循环，迟早漂移成「卡片看得见、历史看不见」。
+ */
+async function readIndexSnapshot(env: MarketEnv): Promise<IndexSnapshot> {
 	const base = await cdnBaseOf(env);
 	if (base === null)
 		fail(503, "未配置市场地址（framework.market_cdn_url）——卡片区显示「未配置市场地址」（PRD §5.3）");
 	await assertOriginForRelativeBase(env, base);
 	const source = await indexSourceOf(env, base);
 	const catalog = await fetchIndex(env, source, base, "catalog");
+	const times = await indexTimesOfText(catalog.text);
 	const { pins, solutions } = await parseCatalog(catalog.text, base);
 	// 拉取 catalog 指向的全部分片（去重、升序确定性）；每片都过签名 + 钉值同代校验
 	const shardDocs = new Map<number, ShardSolution[]>();
@@ -873,6 +922,14 @@ async function indexBody(env: MarketEnv): Promise<IndexRow[]> {
 		const shard = await fetchIndex(env, source, base, "shard", no, pins.get(no)!);
 		shardDocs.set(no, await parseShard(shard.text, `shards/${no}.yaml`));
 	}
+	return { base, issuedAt: times?.issued_at ?? null, solutions, shardDocs };
+}
+
+async function indexBody(env: MarketEnv): Promise<IndexRow[]> {
+	// 对账即服务（P1-10 接线③）：市场页刷新即对账时点——锁 ↔ 账本 head 自愈 + enabled 不一致
+	// 自动修复先行（失败只记日志，不阻断索引），失败站点的市场页每次打开都在尝试自愈
+	await reconcileOf(env);
+	const { solutions, shardDocs } = await readIndexSnapshot(env);
 	const local = (await createStateStore(env.statePath)).read().solutions;
 	const rows: IndexRow[] = [];
 	const seen = new Set<string>();
@@ -898,6 +955,11 @@ async function indexBody(env: MarketEnv): Promise<IndexRow[]> {
 		const manifestOf = (version: string | null): Record<string, unknown> | undefined =>
 			version === null ? undefined : merged.find(v => String(v.version) === version);
 		const m = manifestOf(latest) ?? manifestOf(side?.version ?? null);
+		// 发布者：取最新版 Form B archive.signature.key_id（Ed25519 验签过的签名身份，离线可验）；
+		// manifest.author 是自报字段，二者不同。缺签名/畸形 → null（不拿自报值冒充）。
+		const rawArchive: unknown = m?.archive;
+		const rawSig: unknown = isObj(rawArchive) ? rawArchive.signature : undefined;
+		const publisherKey = isObj(rawSig) && typeof rawSig.key_id === "string" ? rawSig.key_id : null;
 		rows.push({
 			name,
 			latest,
@@ -907,7 +969,10 @@ async function indexBody(env: MarketEnv): Promise<IndexRow[]> {
 			available,
 			changelog: m?.changelog ?? null,
 			publisher: typeof m?.author === "string" ? m.author : null,
+			publisher_key: publisherKey,
 			license: typeof m?.license === "string" ? m.license : null,
+			summary: typeof m?.summary === "string" ? m.summary : null,
+			description: typeof m?.description === "string" ? m.description : null,
 			trust_state: side?.trust_state ?? null,
 			key_id: side?.archive?.key_id ?? null,
 			operator: await lastInstallOperatorOf(name),
@@ -924,7 +989,10 @@ async function indexBody(env: MarketEnv): Promise<IndexRow[]> {
 				available: [],
 				changelog: null,
 				publisher: null,
+				publisher_key: null,
 				license: null,
+				summary: null,
+				description: null,
 				trust_state: side.trust_state ?? null,
 				key_id: side.archive?.key_id ?? null,
 				operator: await lastInstallOperatorOf(name),
@@ -934,6 +1002,106 @@ async function indexBody(env: MarketEnv): Promise<IndexRow[]> {
 	return rows;
 }
 
+/** 发布历史行（市场索引里出现过的每个 product@version） */
+interface ReleaseRow {
+	id: number
+	product: string
+	version: string
+	key_id: string | null
+	sha256: string | null
+	size: number | null
+	published_at: number
+	/** 时间来源：file = tgz 的 Last-Modified；index = 索引生成时间兜底 */
+	published_at_source: "file" | "index"
+	yanked: number
+}
+
+/**
+ * 取单版本的「发布时间」。
+ *
+ * 优先 HEAD 分发包读 `Last-Modified`——那是包落进 CDN 的时刻，也就是真正的发版时间。
+ * 读不到（源不吐该头 / 网络失败 / file 名缺失）才回落到索引生成时间：`ojm market publish`
+ * 与 `build-index` 在推荐流程里紧邻执行，两者差值只有重建索引的耗时。
+ *
+ * 只对**首次入库**的版本调一次（已入库的 published_at 不再改写）——历史一旦记录就是事实，
+ * 不该被后续重新发布/重新建索引刷新。
+ */
+async function archivePublishedAt(env: MarketEnv, base: string, file: unknown, fallback: number): Promise<{ at: number, source: "file" | "index" }> {
+	if (typeof file !== "string" || file === "")
+		return { at: fallback, source: "index" };
+	try {
+		// HEAD 不在 FetchInitFace 的最小形状里（安装面只需要 GET），但运行时 fetch 原生支持：
+		// 这里显式窄化一次，避免为「读一个头」再造第二种下载实现。
+		const head = await fetchOf(env) as unknown as (url: string, init?: { method?: string }) => Promise<{ headers?: { get: (n: string) => string | null } }>;
+		const res = await head(`${base}/${encodeURIComponent(file)}`, { method: "HEAD" });
+		const raw = res.headers?.get?.("last-modified") ?? res.headers?.get?.("Last-Modified") ?? null;
+		if (raw !== null && raw !== "") {
+			const at = Math.floor(Date.parse(raw) / 1000);
+			if (Number.isFinite(at) && at > 0)
+				return { at, source: "file" };
+		}
+	}
+	catch {}
+	return { at: fallback, source: "index" };
+}
+
+/**
+ * 把索引里出现过的版本同步进 `market_release`（幂等：只补新行）。
+ *
+ * 为什么不做成「发版时由 CLI 上报」：`ojm market publish` 是纯本地操作（不登录、可离线），
+ * 加一条上报链路就得再造一套写端授权的信任面；而**签名索引本身就是发版事实**——
+ * 站点已经在读它，历史直接从这里落库，既不用新协议，也不会出现「上报成功但包里没有」的分叉。
+ *
+ * 索引拉取/验签失败由调用方兜住（历史是观测面，不阻断页面：返回已入库行 + syncError）。
+ */
+async function syncReleases(env: MarketEnv): Promise<void> {
+	const snapshot = await readIndexSnapshot(env);
+	const fallbackAt = snapshot.issuedAt ?? (env.now?.() ?? Math.floor(Date.now() / 1000));
+	const now = env.now?.() ?? Math.floor(Date.now() / 1000);
+
+	const existingRows = await db.table("market_release").select(["id", "product", "version", "yanked"]).all() as Array<Record<string, unknown>>;
+	const existing = new Map(existingRows.map(r => [`${String(r.product)}@${String(r.version)}`, { id: Number(r.id), yanked: Number(r.yanked) }]));
+
+	for (const sol of snapshot.shardDocs.values()) {
+		for (const entry of sol) {
+			for (const v of entry.versions) {
+				const version = typeof v.version === "string" ? v.version : "";
+				if (version === "")
+					continue;
+				const dedupeKey = `${entry.name}@${version}`;
+				const yanked = v.yanked === true ? 1 : 0;
+				const prior = existing.get(dedupeKey);
+				if (prior !== undefined) {
+					// 已入库的 published_at 是事实、不再改写；但 yank 状态是「当前是否在架」，跟随索引
+					if (prior.yanked !== yanked)
+						await db.table("market_release").update({ yanked }).where({ field: "id", op: "eq", value: prior.id }).run();
+					continue;
+				}
+				const archive = isObj(v.archive) ? v.archive : {};
+				const sig = isObj(archive.signature) ? archive.signature : {};
+				const { at, source } = await archivePublishedAt(env, snapshot.base, archive.file, fallbackAt);
+				try {
+					await db.table("market_release").insert({
+						product: entry.name,
+						version,
+						key_id: typeof sig.key_id === "string" ? sig.key_id : null,
+						sha256: typeof archive.sha256 === "string" ? archive.sha256 : null,
+						size: typeof archive.size === "number" ? archive.size : null,
+						published_at: at,
+						published_at_source: source,
+						yanked,
+						first_seen_at: now,
+					}).run();
+					existing.set(dedupeKey, { id: -1, yanked });
+				}
+				catch {
+					// 并发同步（两个页面同时打开）撞唯一键：另一路已写入，跳过即可
+				}
+			}
+		}
+	}
+}
+
 /** 四端点组（oj v0.1.64 嵌套组：组名 = 路径段）；全业务体经 respond 收口（status 语义不落 500） */
 export function createMarketApi(env: MarketEnv) {
 	return {
@@ -1131,6 +1299,7 @@ export function createMarketApi(env: MarketEnv) {
 						state: await createStateStore(env.statePath),
 						modulesJsonPath: env.modulesJsonPath,
 						operator: (await operatorOf()) ?? undefined,
+						reload: reloadOf(env),
 					});
 					// P3-11 宿主打磨：方案已不存在 = 资源缺失语义 → 404（非 200 {ok:false}）；
 					// 其余领域拒绝（空锁拒启/级联失败等）维持 200 {ok:false} 人话在 message。
@@ -1156,6 +1325,42 @@ export function createMarketApi(env: MarketEnv) {
 				});
 			},
 		},
+
+		// GET /api/_platform/market/releases —— 发布历史（登录即可读；与市场卡片同口径的「浏览开放」）。
+		//
+		// 数据源是签名索引本身：每次读取先把索引里出现过的 product@version 补进 market_release
+		// （只补新行，published_at 一次写定），再按发布时间倒序分页返回。索引拉不到/验签失败
+		// 不阻断查询：返回已入库行 + syncError，页面照常显示历史并提示「暂时读不到索引」。
+		"releases": {
+			async get() {
+				await respond(async () => {
+					const uid = (http as { user?: { id?: unknown } }).user?.id;
+					if (uid == null)
+						fail(401, "unauthorized");
+					let syncError: string | null = null;
+					try {
+						await syncReleases(env);
+					}
+					catch (e) {
+						syncError = e instanceof Error ? e.message : String(e);
+					}
+					const q = (http.query ?? {}) as Record<string, unknown>;
+					const { page, size, offset } = pageArgs({ page: q.page, size: q.limit });
+					const total = Number(
+						(await db.table("market_release").select([{ fn: "count", as: "c" }]).all() as Array<Record<string, unknown>>)[0]?.c ?? 0,
+					);
+					const list = total === 0
+						? []
+						: await db.table("market_release")
+							.select(["id", "product", "version", "key_id", "sha256", "size", "published_at", "published_at_source", "yanked"])
+							.orderBy([{ field: "published_at", dir: "desc" }, { field: "id", dir: "desc" }])
+							.limit(size)
+							.offset(offset)
+							.all() as unknown as ReleaseRow[];
+					return { list, total, page, size, syncError };
+				});
+			},
+		},
 	};
 }
 
@@ -1169,7 +1374,7 @@ marketApi.install.post.schema = {
 	body: {
 		type: "object",
 		required: ["source", "name"],
-		properties: { source: { type: "string", enum: ["cdn", "file"] }, name: { type: "string" }, version: { type: ["string", "null"] } },
+		properties: { source: { type: "string", enum: ["cdn", "file"] }, name: { type: "string" }, version: { type: ["string", "null"] }, force: { type: "boolean" } },
 	},
 };
 marketApi.install.post.response = { type: "object", properties: { task_id: { type: "string" } }, additionalProperties: true };
@@ -1193,5 +1398,25 @@ marketApi["uninstall-impact"].get.response = { type: "object", additionalPropert
 marketApi.uninstall.post.schema = { body: { type: "object", required: ["name"], properties: { name: { type: "string" } } } };
 marketApi.uninstall.post.response = { type: "object", additionalProperties: true };
 marketApi.history.get.response = { type: "array", items: { type: "object", additionalProperties: true } };
+marketApi.releases.get.schema = {
+	query: {
+		type: "object",
+		properties: {
+			page: { type: "number", minimum: 1 },
+			limit: { type: "number", minimum: 1, maximum: 200 },
+		},
+	},
+};
+marketApi.releases.get.response = {
+	type: "object",
+	required: ["list", "total", "page", "size"],
+	properties: {
+		list: { type: "array", items: { type: "object", additionalProperties: true } },
+		total: { type: "number" },
+		page: { type: "number" },
+		size: { type: "number" },
+		syncError: { type: ["string", "null"] },
+	},
+};
 
 export default marketApi;

package/templates/src/app/api/_platform/migrations/0001__baseline.mysql.sql

@@ -0,0 +1,178 @@
+-- 0001__baseline（mysql 方言）：_platform 全部表结构基线。压平口径见 0001__baseline.sql 头注释。
+--
+-- 方言差异（沿用历史迁移的既有惯例，逐条都有先例）：
+--   · TEXT 不能带字面默认值、不能直接做唯一键/主键 → 需要的那几列收窄为 VARCHAR；
+--   · 字符串默认值写成表达式 DEFAULT ('x')（mysql ≥8.0.13 对 TEXT 系只允许表达式默认）；
+--   · AUTOINCREMENT → BIGINT AUTO_INCREMENT；秒级 epoch 的整型取 BIGINT；
+--   · 保留字（key / group / order）用反引号（mysql 默认 sql_mode 下双引号是字符串字面量）；
+--   · 无 CREATE INDEX IF NOT EXISTS → 索引写在 CREATE TABLE 内，由迁移账本保证只执行一次。
+
+CREATE TABLE IF NOT EXISTS users (
+  id BIGINT AUTO_INCREMENT PRIMARY KEY,
+  tenant_id VARCHAR(255) NOT NULL DEFAULT 'default',
+  corp_id VARCHAR(255) NULL,
+  username VARCHAR(255) NOT NULL,
+  password_hash TEXT NOT NULL,
+  avatar_base64 TEXT NOT NULL DEFAULT (''),
+  source TEXT NOT NULL DEFAULT ('local'),
+  display_name TEXT,
+  must_change BIGINT NOT NULL DEFAULT 0,
+  is_forbidden BIGINT NOT NULL DEFAULT 0,
+  email TEXT,
+  phone_number TEXT,
+  description TEXT,
+  activated INTEGER NOT NULL DEFAULT 0,
+  position VARCHAR(255) NULL,
+  external_status INTEGER NULL,
+  employee_no VARCHAR(64) NULL,
+  UNIQUE KEY uk_users_tenant_username (tenant_id, username),
+  -- 无部分索引：NULL 在 mysql 唯一键里可重复出现，效果等同「有值才唯一」
+  UNIQUE KEY uk_users_employee_no (tenant_id, employee_no)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_setting (
+  `key` VARCHAR(255) PRIMARY KEY,
+  module TEXT NOT NULL,
+  `group` TEXT NOT NULL,
+  type TEXT NOT NULL DEFAULT ('string'),
+  value TEXT,
+  default_value TEXT,
+  label_key TEXT,
+  options TEXT,
+  secret BIGINT NOT NULL DEFAULT 0,
+  update_time BIGINT NOT NULL DEFAULT 0,
+  deprecated BIGINT NOT NULL DEFAULT 0,
+  group_label_key TEXT
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_oplog (
+  id BIGINT AUTO_INCREMENT PRIMARY KEY,
+  create_time BIGINT NOT NULL,
+  user_id BIGINT NOT NULL DEFAULT 0,
+  username TEXT NOT NULL DEFAULT ('system'),
+  action TEXT NOT NULL,
+  module TEXT NOT NULL DEFAULT ('framework'),
+  version TEXT,
+  target TEXT,
+  detail TEXT,
+  level BIGINT NOT NULL DEFAULT 6,
+  tenant_id VARCHAR(255) NOT NULL DEFAULT 'default',
+  KEY idx_sys_oplog_time (create_time, id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_solution_route (
+  path VARCHAR(255) PRIMARY KEY,
+  -- module 参与索引 → 必须收窄为 VARCHAR：mysql 的 TEXT 列建索引必须给前缀长度
+  -- （历史 0010 的 mysql 版在这里直接 ERROR 1170，MySQL 全新安装根本起不来）
+  module VARCHAR(255) NOT NULL,
+  category TEXT NOT NULL,
+  `order` BIGINT NOT NULL DEFAULT 0,
+  title_key TEXT,
+  required_permission TEXT,
+  deprecated BIGINT NOT NULL DEFAULT 0,
+  enabled BIGINT NOT NULL DEFAULT 1,
+  KEY idx_sys_solution_route_module (module)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_role (
+  name VARCHAR(255) PRIMARY KEY,
+  module TEXT NOT NULL,
+  title TEXT,
+  description TEXT,
+  builtin BIGINT NOT NULL DEFAULT 0,
+  deprecated BIGINT NOT NULL DEFAULT 0,
+  title_key TEXT
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_permission (
+  code VARCHAR(255) PRIMARY KEY,
+  module TEXT NOT NULL,
+  title_key TEXT,
+  deprecated BIGINT NOT NULL DEFAULT 0
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_role_permission (
+  role_name VARCHAR(255) NOT NULL,
+  permission_code VARCHAR(255) NOT NULL,
+  PRIMARY KEY (role_name, permission_code)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_user_role (
+  user_id BIGINT NOT NULL,
+  role_name VARCHAR(255) NOT NULL,
+  tenant_id VARCHAR(255) NOT NULL DEFAULT 'default',
+  PRIMARY KEY (user_id, role_name)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_refresh_token (
+  token_hash VARCHAR(255) PRIMARY KEY,
+  user_id BIGINT NOT NULL,
+  expires_at BIGINT NOT NULL,
+  revoked BIGINT NOT NULL DEFAULT 0,
+  created_at BIGINT NOT NULL,
+  tenant_id VARCHAR(255) NOT NULL DEFAULT 'default',
+  KEY idx_sys_refresh_token_user (user_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_rate_window (
+  rate_key VARCHAR(255) PRIMARY KEY,
+  window_start BIGINT NOT NULL,
+  count BIGINT NOT NULL
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_login_throttle (
+  pair_key VARCHAR(255) PRIMARY KEY,
+  fail_count BIGINT NOT NULL,
+  blocked_until BIGINT NOT NULL DEFAULT 0
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS market_history (
+  id BIGINT AUTO_INCREMENT PRIMARY KEY,
+  solution VARCHAR(255) NOT NULL,
+  version VARCHAR(255) NOT NULL,
+  action VARCHAR(64) NOT NULL,
+  status VARCHAR(64) NOT NULL,
+  operator VARCHAR(255),
+  message TEXT,
+  created_at BIGINT NOT NULL
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS reg_source_seq (
+  -- 主键参与索引 → 受 InnoDB 3072 字节上限约束：utf8mb4 每字符 4 字节，
+  -- 768 字符正好顶满，取 700 留余量（历史 0014 用 1024 → ERROR 1071，同样起不来）
+  source_url VARCHAR(700) NOT NULL,
+  max_seq BIGINT NOT NULL,
+  updated_at BIGINT NOT NULL,
+  PRIMARY KEY (source_url)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_department (
+  id BIGINT AUTO_INCREMENT PRIMARY KEY,
+  tenant_id VARCHAR(255) NOT NULL,
+  origin VARCHAR(32) NOT NULL DEFAULT 'local',
+  origin_id VARCHAR(128) NOT NULL,
+  parent_id BIGINT NULL,
+  name VARCHAR(255),
+  name_en VARCHAR(255),
+  order_no INTEGER NOT NULL DEFAULT 0,
+  sync_visible INTEGER NOT NULL DEFAULT 1,
+  deleted INTEGER NOT NULL DEFAULT 0,
+  seen_job_id BIGINT,
+  update_time BIGINT NOT NULL,
+  UNIQUE KEY uk_sys_department_origin (tenant_id, origin, origin_id),
+  KEY idx_sys_department_parent (tenant_id, parent_id, deleted, order_no)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS sys_dept_member (
+  id BIGINT AUTO_INCREMENT PRIMARY KEY,
+  tenant_id VARCHAR(255) NOT NULL,
+  user_id BIGINT NOT NULL,
+  dept_id BIGINT NOT NULL,
+  order_no INTEGER NOT NULL DEFAULT 0,
+  is_leader INTEGER NOT NULL DEFAULT 0,
+  is_main INTEGER NOT NULL DEFAULT 0,
+  update_time BIGINT NOT NULL,
+  UNIQUE KEY uk_sys_dept_member (tenant_id, user_id, dept_id),
+  KEY idx_sys_dept_member_dept (tenant_id, dept_id, order_no),
+  KEY idx_sys_dept_member_user (tenant_id, user_id, is_main)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;