@oj-module/cli 0.2.1 → 0.2.5

package/templates/web/src/exception/pages/404/index.tsx

@@ -0,0 +1,30 @@
+import { ArrowLeftOutlined } from "@ant-design/icons";
+import { Button, Result } from "antd";
+import { useTranslation } from "react-i18next";
+import { useNavigate } from "react-router";
+
+export default function Exception404() {
+	const { t } = useTranslation();
+	const navigate = useNavigate();
+
+	const Result404 = (
+		<Result
+			status="404"
+			title="404"
+			subTitle={t("exception:404SubTitle")}
+			extra={(
+				<Button
+					icon={<ArrowLeftOutlined />}
+					type="primary"
+					onClick={() => {
+						navigate(import.meta.env.VITE_BASE_HOME_PATH);
+					}}
+				>
+					{t("common.backHome")}
+				</Button>
+			)}
+		/>
+	);
+
+	return Result404;
+}

package/templates/web/src/exception/pages/500/index.tsx

@@ -0,0 +1,30 @@
+import { ArrowLeftOutlined } from "@ant-design/icons";
+import { Button, Result } from "antd";
+import { useTranslation } from "react-i18next";
+import { useNavigate } from "react-router";
+
+export default function Exception500() {
+	const { t } = useTranslation();
+	const navigate = useNavigate();
+
+	const Result500 = (
+		<Result
+			status="500"
+			title="500"
+			subTitle={t("exception:500SubTitle")}
+			extra={(
+				<Button
+					icon={<ArrowLeftOutlined />}
+					type="primary"
+					onClick={() => {
+						navigate(import.meta.env.VITE_BASE_HOME_PATH);
+					}}
+				>
+					{t("common.backHome")}
+				</Button>
+			)}
+		/>
+	);
+
+	return Result500;
+}

package/templates/web/src/exception/pages/unknown-component/index.tsx

@@ -0,0 +1,38 @@
+import { AppstoreOutlined, ArrowLeftOutlined } from "@ant-design/icons";
+
+import { Button, Result, Typography } from "antd";
+import { useTranslation } from "react-i18next";
+import { useNavigate } from "react-router";
+
+const { Paragraph } = Typography;
+
+export default function UnknownComponent() {
+	const { t } = useTranslation();
+	const navigate = useNavigate();
+
+	return (
+		<Result
+			status="warning"
+			icon={<AppstoreOutlined />}
+			title={t("exception:menu.exceptionUnknownComponent")}
+			subTitle={t("exception:unknownComponentSubTitle")}
+			extra={(
+				<div>
+					<Paragraph code copyable={{ text: location.href }}>
+						{location.href}
+					</Paragraph>
+					<Button
+						icon={<ArrowLeftOutlined />}
+						type="primary"
+						onClick={() => {
+							navigate(import.meta.env.VITE_BASE_HOME_PATH);
+						}}
+					>
+						{t("common.backHome")}
+					</Button>
+				</div>
+
+			)}
+		/>
+	);
+}

package/templates/web/src/home/__client/api.schemas.ts

@@ -0,0 +1,22 @@
+/* eslint-disable */
+// 生成物：ojm api 从契约生成，勿手改（改动请改契约文件后重跑 ojm api）
+// AC-D15：仅供 DEV 校验动态 import，生产构建不进产物
+import { z } from "@oj-module/runtime";
+
+export const schemas = {
+	"homeLinePost": {
+		body: z.object({
+	"range": z.string()
+}),
+		data: z.array(z.number()),
+	},
+	"homePieGet": {
+		query: z.object({
+	"by": z.union([z.string(), z.number()]).optional()
+}),
+		data: z.array(z.object({
+	"value": z.number(),
+	"code": z.string()
+})),
+	},
+};

package/templates/web/src/home/__client/api.ts

@@ -0,0 +1,113 @@
+/* eslint-disable */
+// 生成物：ojm api 从契约生成，勿手改（改动请改契约文件后重跑 ojm api）
+import { ContractApiError } from "@oj-module/runtime/contract/errors";
+import type { ScopedRequestLike } from "@oj-module/runtime/contract/errors";
+import type { ModuleContext } from "@oj-module/runtime";
+import type { z } from "@oj-module/runtime";
+import type { schemas } from "./api.schemas";
+
+/** oj 信封（AC-D16）：code=0 成功；非 0 时 HTTP status=code，由 toApiError 归一为 ContractApiError */
+interface OjEnvelope<T> { code: number, msg?: string, data?: T }
+
+let req: ScopedRequestLike | undefined;
+
+/** 线上 API 前缀（ojm api 从契约抽取，唯一真源，勿手改）：请求基址 + 前缀登记用 */
+export const API_PREFIX = "/home";
+
+/** 认领身份前缀（契约 apiPrefix，字面等于模块目录名）：跨模块认领护栏对比基准 */
+export const MODULE_PREFIX = "/home";
+
+/**
+ * 模块 entry 的 onInit 里一行创建（构造即 install）：完成 apiPrefix 登记 +
+ * scoped request 绑定，返回绑好前缀的端点函数集合。一模块一 client；
+ * 重复构造幂等安全（前缀重复登记同值、request 重绑同值）。
+ */
+export function createHomeClient(ctx: ModuleContext) {
+	// 跨模块认领护栏（DEV）：工厂知道自己该属于谁（MODULE_PREFIX = 契约 apiPrefix），
+	// ctx 又带 module.name——名实不符说明别的模块在替本模块创建 client，会共享 request
+	// 单槽、卸载互相耦合；跨模块需求应由本模块创建后经 provider 暴露。
+	// 注意对比基准是 MODULE_PREFIX（目录名）而非 API_PREFIX——D-M8 映射时线上前缀
+	// 属于别的命名空间，认领身份仍按目录名。
+	if (import.meta.env.DEV && ctx.module.name !== MODULE_PREFIX.slice(1)) {
+		console.warn(`[ojm-api] 模块 "${ctx.module.name}" 正在认领 ${MODULE_PREFIX} 的 client——跨模块认领会共享 request 单槽、卸载互相耦合；应由 "${MODULE_PREFIX.slice(1)}" 模块在自身 onInit 创建，跨模块需求经 provider 暴露。`);
+	}
+	ctx.register.apiPrefix(API_PREFIX);
+	bindRequest(ctx.utils.request);
+	return { homeLinePost, homePieGet };
+}
+
+/**
+ * @deprecated 请改用 createHomeClient(ctx)——工厂构造即完成
+ * 前缀登记 + request 绑定，不会出现「登记了前缀没绑 request」的半接线状态。
+ */
+export function bindRequest(r: ScopedRequestLike): void {
+	req = r;
+}
+
+function ensureReq(): ScopedRequestLike {
+	if (!req)
+		throw new ContractApiError(-1, "[ojm-api] 请求未绑定——请在模块 entry.ts 的 onInit 里调用 createHomeClient(ctx)（或 bindRequest(ctx.utils.request)）。");
+	return req;
+}
+
+/** ky HTTPError → ContractApiError（错误体为信封时取 code/msg）；契约违例与原错误原样透传 */
+async function toApiError(e: unknown): Promise<unknown> {
+	if (e instanceof ContractApiError)
+		return e;
+	// ky 2.x 构造 HTTPError 时已用 getReader() 消费掉原 response 体（res.clone().json() 按规范抛 TypeError，
+	// 体方法一律失效），解析好的错误体在公开字段 error.data——故读 error.data，勿改回 clone().json()。
+	const err = e as { data?: { code?: unknown, msg?: string }, response?: Response } | null;
+	const res = err?.response;
+	const d = err?.data;
+	if (res instanceof Response && d && typeof d.code === "number")
+		return new ContractApiError(d.code, d.msg ?? res.statusText);
+	return e;
+}
+
+export type HomeLinePostBody = z.input<(typeof schemas)["homeLinePost"]["body"]>;
+export type HomeLinePostData = z.infer<(typeof schemas)["homeLinePost"]["data"]>;
+
+export async function homeLinePost(body: HomeLinePostBody): Promise<HomeLinePostData> {
+	const client = ensureReq();
+	try {
+		const env = await client.post(`home/line`, { json: body }).json<OjEnvelope<HomeLinePostData>>();
+		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
+		if (typeof env.code === "number" && env.code !== 0)
+			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
+		const data = env.data as HomeLinePostData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["homeLinePost"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] homeLinePost 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
+		return data;
+	}
+	catch (e) {
+		throw await toApiError(e);
+	}
+}
+
+export type HomePieGetQuery = z.input<(typeof schemas)["homePieGet"]["query"]>;
+export type HomePieGetData = z.infer<(typeof schemas)["homePieGet"]["data"]>;
+
+export async function homePieGet(query: HomePieGetQuery): Promise<HomePieGetData> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`home/pie`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<HomePieGetData>>();
+		// 2xx + code!==0 也是业务错误（§6.2 通道 a）：oj 不会这么发，但契约机制的价值恰是防漂移
+		if (typeof env.code === "number" && env.code !== 0)
+			throw new ContractApiError(env.code, env.msg ?? "业务错误（信封 code 非 0）");
+		const data = env.data as HomePieGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["homePieGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] homePieGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
+		return data;
+	}
+	catch (e) {
+		throw await toApiError(e);
+	}
+}

package/templates/web/src/login/locales/en-US.json

@@ -16,5 +16,11 @@
 			"mismatch": "Passwords do not match",
 			"submit": "Change & sign in again"
 		}
+	},
+	"method": {
+		"local": "Password",
+		"ldap": "LDAP",
+		"sso": "SSO",
+		"sso.action": "Sign in with SSO"
 	}
 }

package/templates/web/src/login/locales/zh-CN.json

@@ -16,5 +16,11 @@
 			"mismatch": "两次输入的新密码不一致",
 			"submit": "修改并重新登录"
 		}
+	},
+	"method": {
+		"local": "账号密码",
+		"ldap": "LDAP",
+		"sso": "SSO",
+		"sso.action": "使用 SSO 登录"
 	}
 }

package/templates/web/src/login/pages/login.tsx

@@ -1,9 +1,11 @@
-import { getRedirectPath, useAuthStore } from "@oj-module/runtime";
-import { Alert, Button, Form, Input, Typography } from "antd";
-import { useState } from "react";
+import { fetchLoginMethods, getRedirectPath, useAuthStore } from "@oj-module/runtime";
+import { Alert, Button, Form, Input, Tabs, Typography } from "antd";
+import { useEffect, useState } from "react";
 import { useTranslation } from "react-i18next";
 import { useLocation, useNavigate } from "react-router";
 
+type LoginMethod = "local" | "ldap" | "sso";
+
 interface LoginFormValues {
 	username: string
 	password: string
@@ -13,8 +15,13 @@ interface LoginFormValues {
  * 登录页内容区。
  *
  * 只写内容区：视口/品牌区/工具区/页脚由框架 FullscreenLayout 兜住。
- * 只依赖框架出口（useAuthStore / getRedirectPath）与共享依赖（antd / react-router），
- * 零框架内部 import。
+ * 只依赖框架出口（useAuthStore / getRedirectPath / fetchLoginMethods）与共享依赖
+ * （antd / react-router），零框架内部 import。
+ *
+ * 登录方式由后端匿名端点 `GET /system/login-methods` 发现（local 恒在，
+ * ldap/sso 由系统设置开关）。多于一种方式时渲染切换 tab；local/ldap 走同一表单，
+ * 仅把 `method` 透传给运行时 `login()`（其按 method 路由到 auth/login / auth/ldap-login）；
+ * sso 走重定向（端点由宿主/平台提供，模板仅负责跳转）。
  */
 export default function LoginPage() {
 	const { t } = useTranslation();
@@ -23,12 +30,29 @@ export default function LoginPage() {
 	const login = useAuthStore(s => s.login);
 	const [error, setError] = useState<string>();
 	const [loading, setLoading] = useState(false);
+	const [methods, setMethods] = useState<LoginMethod[]>(["local"]);
+	const [active, setActive] = useState<LoginMethod>("local");
 
-	async function onFinish(values: LoginFormValues) {
+	useEffect(() => {
+		fetchLoginMethods()
+			.then((r) => {
+				const m = r.methods.filter((x): x is LoginMethod => x === "local" || x === "ldap" || x === "sso");
+				if (!m.length)
+					return;
+				setMethods(m);
+				if (!m.includes("local"))
+					setActive(m[0]);
+			})
+			.catch(() => {
+				// 发现失败时回落单表单（local），不阻断登录。
+			});
+	}, []);
+
+	async function onFinish(values: LoginFormValues, method: LoginMethod) {
 		setLoading(true);
 		setError(undefined);
 		try {
-			await login(values);
+			await login({ ...values, method });
 			navigate(getRedirectPath(search));
 		}
 		catch (e) {
@@ -39,6 +63,27 @@ export default function LoginPage() {
 		}
 	}
 
+	function ssoLogin() {
+		// SSO 重定向端点由宿主/平台提供（如 GET /auth/sso），模板侧仅跳转。
+		window.location.assign("/auth/sso");
+	}
+
+	const showTabs = methods.length > 1;
+
+	const form = (method: LoginMethod) => (
+		<Form<LoginFormValues> layout="vertical" onFinish={values => onFinish(values, method)}>
+			<Form.Item name="username" label={t("login:page.username")} rules={[{ required: true }]}>
+				<Input autoFocus />
+			</Form.Item>
+			<Form.Item name="password" label={t("login:page.password")} rules={[{ required: true }]}>
+				<Input.Password />
+			</Form.Item>
+			<Button type="primary" htmlType="submit" block loading={loading}>
+				{t("login:page.submit")}
+			</Button>
+		</Form>
+	);
+
 	return (
 		<>
 			<Typography.Title level={3}>
@@ -48,17 +93,21 @@ export default function LoginPage() {
 				{t("login:page.subtitle")}
 			</Typography.Paragraph>
 			{error && <Alert style={{ marginBottom: 16 }} type="error" message={error} showIcon />}
-			<Form<LoginFormValues> layout="vertical" onFinish={onFinish}>
-				<Form.Item name="username" label={t("login:page.username")} rules={[{ required: true }]}>
-					<Input autoFocus />
-				</Form.Item>
-				<Form.Item name="password" label={t("login:page.password")} rules={[{ required: true }]}>
-					<Input.Password />
-				</Form.Item>
-				<Button type="primary" htmlType="submit" block loading={loading}>
-					{t("login:page.submit")}
-				</Button>
-			</Form>
+			{showTabs
+				? (
+					<Tabs
+						activeKey={active}
+						onChange={key => setActive(key as LoginMethod)}
+						items={methods.map(m => ({
+							key: m,
+							label: t(`login:method.${m}`),
+							children: m === "sso"
+								? <Button type="primary" block onClick={ssoLogin}>{t("login:method.sso.action")}</Button>
+								: form(m),
+						}))}
+					/>
+				)
+				: form("local")}
 		</>
 	);
 }

package/templates/web/src/oj-market/__tests__/CardGrid.test.tsx

@@ -0,0 +1,93 @@
+import type { IndexRow } from "../types";
+import { screen } from "@testing-library/react";
+import { describe, expect, it, vi } from "vitest";
+import { CardGrid } from "../components/CardGrid";
+import { InMemoryMarketClient } from "./marketClient.fake";
+import { renderWithProviders } from "./render";
+
+const installed: IndexRow = {
+	name: "alpha",
+	latest: "1.2.0",
+	installed: "1.1.0",
+	enabled: true,
+	upgradable: true,
+};
+const notInstalled: IndexRow = {
+	name: "beta",
+	latest: "0.9.0",
+	installed: null,
+	enabled: null,
+	upgradable: false,
+};
+const disabledRow: IndexRow = {
+	name: "gamma",
+	latest: "2.0.0",
+	installed: "2.0.0",
+	enabled: false,
+	upgradable: false,
+};
+
+describe("cardGrid 卡片网格（BDD）", () => {
+	const handlers = {
+		onInstall: vi.fn(),
+		onEnableToggle: vi.fn(),
+		onDetails: vi.fn(),
+		onHistory: vi.fn(),
+		onUninstall: vi.fn(),
+		onRollback: vi.fn(),
+		onRetry: vi.fn(),
+	};
+
+	it("given 已装可升级+已停用的卡片 When 渲染 Then 显示 upgradable/enabled/disabled 标识与动作按钮", () => {
+		renderWithProviders(
+			<CardGrid rows={[installed, disabledRow]} {...handlers} />,
+			new InMemoryMarketClient(),
+		);
+		expect(screen.getByTestId("card-alpha")).toBeTruthy();
+		expect(screen.getByText("可升级")).toBeTruthy();
+		expect(screen.getByText("已启用")).toBeTruthy();
+		expect(screen.getByTestId("card-gamma")).toBeTruthy();
+		expect(screen.getByText("已停用")).toBeTruthy();
+		// 已装方案应有 启用/停用 + 卸载 按钮
+		expect(screen.getAllByText("卸载").length).toBeGreaterThan(0);
+	});
+
+	it("given 已装可升级卡片 When 渲染 Then 双版本展示「已装 → 最新」且有回滚按钮", () => {
+		renderWithProviders(<CardGrid rows={[installed]} {...handlers} />, new InMemoryMarketClient());
+		const versions = screen.getByTestId("card-versions-alpha");
+		expect(versions.textContent).toContain("1.1.0");
+		expect(versions.textContent).toContain("1.2.0");
+		expect(screen.getByTestId("card-rollback-alpha")).toBeTruthy();
+	});
+
+	it("given 未安装卡片 When 渲染 Then 安装按钮显示「安装」而非「升级」，且无回滚按钮", () => {
+		renderWithProviders(<CardGrid rows={[notInstalled]} {...handlers} />, new InMemoryMarketClient());
+		expect(screen.getByText("安装")).toBeTruthy();
+		expect(screen.queryByText("升级")).toBeNull();
+		expect(screen.queryByTestId("card-rollback-beta")).toBeNull();
+	});
+
+	it("given 点击回滚 When 渲染 Then 回调 onRollback 携带该行", () => {
+		renderWithProviders(<CardGrid rows={[installed]} {...handlers} />, new InMemoryMarketClient());
+		screen.getByTestId("card-rollback-alpha").click();
+		expect(handlers.onRollback).toHaveBeenCalledWith(installed);
+	});
+
+	it("given 空列表 When 渲染 Then 显示空态", () => {
+		renderWithProviders(<CardGrid rows={[]} {...handlers} />, new InMemoryMarketClient());
+		expect(screen.getByTestId("card-grid-empty")).toBeTruthy();
+	});
+
+	it("given loading=true When 渲染 Then 显示加载态", () => {
+		renderWithProviders(<CardGrid rows={[]} loading {...handlers} />, new InMemoryMarketClient());
+		expect(screen.getByTestId("card-grid-loading")).toBeTruthy();
+	});
+
+	it("given error When 渲染 Then 显示错误态并可重试", () => {
+		renderWithProviders(<CardGrid rows={[]} error="boom" {...handlers} />, new InMemoryMarketClient());
+		const retry = screen.getByTestId("card-grid-retry");
+		expect(retry).toBeTruthy();
+		retry.click();
+		expect(handlers.onRetry).toHaveBeenCalled();
+	});
+});

package/templates/web/src/oj-market/__tests__/HistoryDrawer.test.tsx

@@ -0,0 +1,28 @@
+import type { IndexRow, MarketHistory } from "../types";
+import { screen } from "@testing-library/react";
+import { describe, expect, it } from "vitest";
+import { HistoryDrawer } from "../components/HistoryDrawer";
+import { InMemoryMarketClient } from "./marketClient.fake";
+import { renderWithProviders } from "./render";
+
+const row: IndexRow = { name: "alpha", latest: "1.2.0", installed: "1.2.0", enabled: true, upgradable: false };
+const rows: MarketHistory[] = [
+	{ id: 1, solution: "alpha", version: "1.2.0", action: "install", status: "done", operator: "u1", message: null, created_at: 1700000000 },
+	{ id: 2, solution: "beta", version: "0.9.0", action: "uninstall", status: "failed", operator: "u2", message: "locked", created_at: 1700000100 },
+];
+
+describe("historyDrawer 操作历史（BDD）", () => {
+	it("given 历史记录 When 打开 Then 按当前方案过滤并展示", async () => {
+		const client = new InMemoryMarketClient({ historyRows: rows });
+		renderWithProviders(<HistoryDrawer row={row} open onClose={() => {}} />, client);
+		await screen.findByTestId("history-table");
+		expect(screen.getByText("1.2.0")).toBeTruthy();
+		expect(screen.queryByText("0.9.0")).toBeNull();
+	});
+
+	it("given 空历史 When 打开 Then 显示空提示", async () => {
+		const client = new InMemoryMarketClient({ historyRows: [] });
+		renderWithProviders(<HistoryDrawer row={row} open onClose={() => {}} />, client);
+		await screen.findByText("暂无操作记录");
+	});
+});

package/templates/web/src/oj-market/__tests__/InstallDialog.test.tsx

@@ -0,0 +1,69 @@
+import type { IndexRow, TaskRecord } from "../types";
+import { screen, waitFor } from "@testing-library/react";
+import { describe, expect, it } from "vitest";
+import { InstallDialog } from "../components/InstallDialog";
+import { InMemoryMarketClient } from "./marketClient.fake";
+import { renderWithProviders } from "./render";
+
+const row: IndexRow = { name: "alpha", latest: "1.2.0", installed: null, enabled: null, upgradable: false };
+
+describe("installDialog 安装进度（BDD）", () => {
+	it("given 安装成功终态 When 打开 Then 轮询渲染 100% 成功", async () => {
+		const done: TaskRecord = {
+			id: "t1",
+			name: "alpha",
+			version: "1.2.0",
+			status: "done",
+			stage: "done",
+			progress: 100,
+			message: "ok",
+			stages: [],
+		};
+		const client = new InMemoryMarketClient({ taskRecord: done, installResult: { task_id: "t1" } });
+		renderWithProviders(<InstallDialog row={row} open onClose={() => {}} />, client);
+		await waitFor(() => expect(screen.getByTestId("install-message").textContent).toBe("ok"), { timeout: 5000 });
+		expect(client.calls.filter(c => c.startsWith("install:")).length).toBe(1);
+		expect(client.calls.filter(c => c.startsWith("task:")).length).toBeGreaterThanOrEqual(1);
+	});
+
+	it("given 安装失败终态 When 打开 Then 渲染 reason + 不可重试标记", async () => {
+		const failed: TaskRecord = {
+			id: "t1",
+			name: "alpha",
+			version: "1.2.0",
+			status: "failed",
+			stage: "verifying",
+			progress: 40,
+			message: "verify failed",
+			stages: [{ stage: "verifying", ok: false, message: "bad hash" }],
+			error: { reason: "包校验失败", retryable: false, hintKey: "lifecycle.stage.verifying.hint" },
+		};
+		const client = new InMemoryMarketClient({ taskRecord: failed, installResult: { task_id: "t1" } });
+		renderWithProviders(<InstallDialog row={row} open onClose={() => {}} />, client);
+		await waitFor(() => expect(screen.getByText("包校验失败")).toBeTruthy(), { timeout: 5000 });
+		expect(screen.getByText("不可重试")).toBeTruthy();
+	});
+
+	it("given 回滚（显式旧版 version）When 打开 Then 以该版本触发 install 且标题为「回滚中」", async () => {
+		const done: TaskRecord = {
+			id: "t1",
+			name: "alpha",
+			version: "1.1.0",
+			status: "done",
+			stage: "done",
+			progress: 100,
+			message: "ok",
+			stages: [],
+		};
+		const client = new InMemoryMarketClient({ taskRecord: done, installResult: { task_id: "t1" } });
+		const rollbackRow: IndexRow = { name: "alpha", latest: "1.2.0", installed: "1.2.0", enabled: true, upgradable: false };
+		renderWithProviders(
+			<InstallDialog row={rollbackRow} open onClose={() => {}} version="1.1.0" mode="rollback" />,
+			client,
+		);
+		await waitFor(() => expect(screen.getByTestId("install-message").textContent).toBe("ok"), { timeout: 5000 });
+		// 以显式旧版（而非 latest 1.2.0）触发安装
+		expect(client.calls).toContain("install:alpha@1.1.0");
+		expect(screen.getByText("回滚中")).toBeTruthy();
+	});
+});

package/templates/web/src/oj-market/__tests__/RollbackDialog.test.tsx

@@ -0,0 +1,43 @@
+import type { IndexRow, MarketHistory } from "../types";
+import { screen, waitFor } from "@testing-library/react";
+import { describe, expect, it, vi } from "vitest";
+import { RollbackDialog } from "../components/RollbackDialog";
+import { InMemoryMarketClient } from "./marketClient.fake";
+import { renderWithProviders } from "./render";
+
+const row: IndexRow = { name: "alpha", latest: "1.2.0", installed: "1.2.0", enabled: true, upgradable: false };
+
+const history: MarketHistory[] = [
+	{ id: 3, solution: "alpha", version: "1.2.0", action: "upgrade", status: "done", operator: "admin", message: null, created_at: 3 },
+	{ id: 2, solution: "alpha", version: "1.1.0", action: "install", status: "done", operator: "admin", message: null, created_at: 2 },
+	{ id: 1, solution: "alpha", version: "1.0.0", action: "install", status: "done", operator: "admin", message: null, created_at: 1 },
+];
+
+describe("rollbackDialog 回滚版本选择（BDD）", () => {
+	it("given 已装 1.2.0 且有更早历史版本 When 打开 Then 列出候选旧版（不含已装）并默认选较新旧版，确认回滚之", async () => {
+		const onRollback = vi.fn();
+		renderWithProviders(
+			<RollbackDialog row={row} open onClose={() => {}} onRollback={onRollback} />,
+			new InMemoryMarketClient({ historyRows: history }),
+		);
+		await waitFor(() => expect(screen.getByTestId("rollback-versions")).toBeTruthy(), { timeout: 5000 });
+		const group = screen.getByTestId("rollback-versions");
+		// 候选 = < 已装：1.1.0 与 1.0.0；已装 1.2.0 不在候选
+		expect(group.textContent).toContain("1.1.0");
+		expect(group.textContent).toContain("1.0.0");
+		// 默认选中较新的旧版 1.1.0 → 确认回滚携带该版本
+		screen.getByRole("button", { name: "确认回滚" }).click();
+		expect(onRollback).toHaveBeenCalledWith(row, "1.1.0");
+	});
+
+	it("given 无更早历史版本 When 打开 Then 显示无候选提示且确认禁用", async () => {
+		const onRollback = vi.fn();
+		renderWithProviders(
+			<RollbackDialog row={row} open onClose={() => {}} onRollback={onRollback} />,
+			new InMemoryMarketClient({ historyRows: history.slice(0, 1) }), // 仅 1.2.0（已装）
+		);
+		await waitFor(() => expect(screen.getByTestId("rollback-empty")).toBeTruthy(), { timeout: 5000 });
+		expect(screen.getByRole("button", { name: "确认回滚" })).toBeDisabled();
+		expect(onRollback).not.toHaveBeenCalled();
+	});
+});

package/templates/web/src/oj-market/__tests__/UninstallConfirm.test.tsx

@@ -0,0 +1,30 @@
+import type { IndexRow } from "../types";
+import { screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { describe, expect, it, vi } from "vitest";
+import { UninstallConfirm } from "../components/UninstallConfirm";
+import { InMemoryMarketClient } from "./marketClient.fake";
+import { renderWithProviders } from "./render";
+
+const row: IndexRow = { name: "alpha", latest: "1.2.0", installed: "1.2.0", enabled: true, upgradable: false };
+
+describe("uninstallConfirm 卸载二次确认（BDD）", () => {
+	it("given 影响面预检返回受影响角色 When 打开 Then 展示预检清单并二次确认回调", async () => {
+		const client = new InMemoryMarketClient({ impact: { name: "alpha", affectedRoles: 2, affectedUsers: 5 } });
+		const onConfirmed = vi.fn();
+		renderWithProviders(
+			<UninstallConfirm row={row} open onClose={() => {}} onConfirmed={onConfirmed} />,
+			client,
+		);
+		await screen.findByTestId("uninstall-impact");
+		expect(screen.getByText("影响面预检")).toBeTruthy();
+		await userEvent.click(screen.getByRole("button", { name: "确认卸载" }));
+		expect(onConfirmed).toHaveBeenCalledWith(row);
+	});
+
+	it("given 孤立方案（无受影响）When 打开 Then 显示空影响面提示", async () => {
+		const client = new InMemoryMarketClient({ impact: { name: "alpha", affectedRoles: 0, affectedUsers: 0 } });
+		renderWithProviders(<UninstallConfirm row={row} open onClose={() => {}} onConfirmed={vi.fn()} />, client);
+		await screen.findByText("无受影响角色或用户（孤立方案）");
+	});
+});