@oj-module/cli 0.2.53 → 0.2.54

package/templates/src/_platform/api/contacts/api.ts

@@ -6,7 +6,7 @@ import { searchContacts } from "../_shared/service/domain/contacts";
 import { assertTenantSelf } from "../_shared/service/infra/access";
 import { rateLimit } from "../_shared/service/infra/rate";
 
-export default {
+const handler = {
 	// GET /api/_platform/contacts?keyword=&limit= —— 人员目录（AC1-22~24）。
 	async get() {
 		await respond(async () => {
@@ -23,3 +23,31 @@ export default {
 		});
 	},
 };
+
+// 入参：keyword 必填（服务层红线 2~64 字符），limit 可选（钳 200）
+handler.get.schema = {
+	query: {
+		type: "object",
+		required: ["keyword"],
+		properties: {
+			keyword: { type: "string", minLength: 2 },
+			limit: { type: "number" },
+		},
+	},
+};
+
+// 出参：目录红线只出 id/username/display_name（不含 email/avatar/roles）
+handler.get.response = {
+	type: "array",
+	items: {
+		type: "object",
+		required: ["id", "username", "display_name"],
+		properties: {
+			id: { type: "number" },
+			username: { type: "string" },
+			display_name: { type: ["string", "null"] },
+		},
+	},
+};
+
+export default handler;

package/templates/src/_platform/api/contacts/detail/api.ts

@@ -4,7 +4,7 @@ import { contactDetail } from "../../_shared/service/domain/contacts";
 import { assertTenantSelf } from "../../_shared/service/infra/access";
 import { rateLimit } from "../../_shared/service/infra/rate";
 
-export default {
+const handler = {
 	async get() {
 		await respond(async () => {
 			const uid = http.user?.id;
@@ -19,3 +19,27 @@ export default {
 		});
 	},
 };
+
+// 入参：id 必填（详情按 id 取单条）
+handler.get.schema = {
+	query: {
+		type: "object",
+		required: ["id"],
+		properties: { id: { type: "number" } },
+	},
+};
+
+// 出参：详情比目录多 email/avatar（安全评审 P2：仅详情端点给）
+handler.get.response = {
+	type: "object",
+	required: ["id", "username", "display_name", "email", "avatar_base64"],
+	properties: {
+		id: { type: "number" },
+		username: { type: "string" },
+		display_name: { type: ["string", "null"] },
+		email: { type: ["string", "null"] },
+		avatar_base64: { type: ["string", "null"] },
+	},
+};
+
+export default handler;

package/templates/src/_platform/api/solutions/api.ts

@@ -167,7 +167,7 @@ async function listMigrationFiles(env: SolutionsEnv, name: string, version: stri
 }
 
 export function createSolutionsApi(env: SolutionsEnv) {
-	return {
+	const api = {
 		// GET /api/_platform/solutions/routes —— 前端归并数据源（登录即可）。
 		routes: {
 			async get() {
@@ -217,6 +217,65 @@ export function createSolutionsApi(env: SolutionsEnv) {
 			},
 		},
 	};
+
+	// ---- 契约（v0.1.72：入参 .schema / 出参平级 .response）----
+	// 路由行出参：SolutionRouteRow（前端归并与深检共用形状）
+	const routeRow = {
+		type: "object",
+		required: ["path", "module", "category", "order", "title_key", "required_permission", "enabled"],
+		properties: {
+			path: { type: "string" },
+			module: { type: "string" },
+			category: { type: "string", enum: ["main", "admin", "hidden"] },
+			order: { type: "number" },
+			title_key: { type: ["string", "null"] },
+			required_permission: { type: ["string", "null"] },
+			enabled: { type: "boolean" },
+		},
+	};
+	api.routes.get.response = { type: "array", items: routeRow };
+
+	// 深检报告出参：VerifyReport（ok/checks/advise）
+	const verifyReport = {
+		type: "object",
+		required: ["ok", "checks", "advise"],
+		properties: {
+			ok: { type: "boolean" },
+			checks: {
+				type: "array",
+				items: {
+					type: "object",
+					required: ["id", "severity", "subject", "advise_key"],
+					properties: {
+						id: { type: "string" },
+						severity: { type: "string", enum: ["error", "warn", "info"] },
+						subject: { type: "string" },
+						advise_key: { type: "string" },
+					},
+				},
+			},
+			advise: { type: "array", items: { type: "string" } },
+		},
+	};
+	// verify：name 必填（端点门，缺参 400）
+	api.verify.post.schema = {
+		query: {
+			type: "object",
+			required: ["name"],
+			properties: { name: { type: "string", minLength: 1 } },
+		},
+	};
+	api.verify.post.response = verifyReport;
+	api.verify.last.get.schema = {
+		query: {
+			type: "object",
+			required: ["name"],
+			properties: { name: { type: "string", minLength: 1 } },
+		},
+	};
+	api.verify.last.get.response = verifyReport;
+
+	return api;
 }
 
 export default createSolutionsApi(solutionsEnv());

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

@@ -4,6 +4,29 @@
 import { z } from "@oj-module/runtime";
 
 export const schemas = {
+	"platformContactsGet": {
+		query: z.object({
+	"keyword": z.string().min(2),
+	"limit": z.number().optional()
+}),
+		data: z.array(z.object({
+	"id": z.number(),
+	"username": z.string(),
+	"display_name": z.string().nullable()
+})),
+	},
+	"platformContactsDetailGet": {
+		query: z.object({
+	"id": z.number()
+}),
+		data: z.object({
+	"id": z.number(),
+	"username": z.string(),
+	"display_name": z.string().nullable(),
+	"email": z.string().nullable(),
+	"avatar_base64": z.string().nullable()
+}),
+	},
 	"platformMarketInstallPost": {
 		body: z.object({
 	"source": z.enum(["cdn", "file"]),
@@ -101,19 +124,6 @@ export const schemas = {
 		data: z.array(z.object({
 
 }).catchall(z.unknown())),
-	},
-	"platformOrgTreeGet": {
-		query: z.object({
-	"scope": z.enum(["self", "all"]).optional()
-}),
-		data: z.array(z.object({
-	"id": z.number(),
-	"parentId": z.number().nullable(),
-	"name": z.string().nullable(),
-	"nameEn": z.string().nullable().optional(),
-	"orderNo": z.number(),
-	"memberCount": z.number()
-})),
 	},
 	"platformOrgDepartmentsGet": {
 		query: z.object({
@@ -136,6 +146,16 @@ export const schemas = {
 	"page": z.number(),
 	"size": z.number(),
 	"truncated": z.boolean()
+}),
+	},
+	"platformOrgIsMemberGet": {
+		query: z.object({
+	"scope": z.enum(["self", "all"]).optional(),
+	"uid": z.number().optional(),
+	"dept": z.number()
+}),
+		data: z.object({
+	"isMember": z.boolean()
 }),
 	},
 	"platformOrgMembersGet": {
@@ -160,24 +180,6 @@ export const schemas = {
 	"page": z.number(),
 	"size": z.number(),
 	"truncated": z.boolean()
-}),
-	},
-	"platformOrgUserGet": {
-		query: z.object({
-	"scope": z.enum(["self", "all"]).optional(),
-	"uid": z.number().optional()
-}),
-		data: z.object({
-	"userId": z.number(),
-	"username": z.string(),
-	"displayName": z.string().nullable().optional(),
-	"position": z.string().nullable(),
-	"mainDeptId": z.number().nullable(),
-	"mainDeptPath": z.array(z.string()),
-	"departments": z.array(z.object({
-	"deptId": z.number(),
-	"deptPath": z.array(z.string())
-}))
 }),
 	},
 	"platformOrgPickerGet": {
@@ -218,14 +220,76 @@ export const schemas = {
 	"userIds": z.array(z.number())
 }),
 	},
-	"platformOrgIsMemberGet": {
+	"platformOrgTreeGet": {
+		query: z.object({
+	"scope": z.enum(["self", "all"]).optional()
+}),
+		data: z.array(z.object({
+	"id": z.number(),
+	"parentId": z.number().nullable(),
+	"name": z.string().nullable(),
+	"nameEn": z.string().nullable().optional(),
+	"orderNo": z.number(),
+	"memberCount": z.number()
+})),
+	},
+	"platformOrgUserGet": {
 		query: z.object({
 	"scope": z.enum(["self", "all"]).optional(),
-	"uid": z.number().optional(),
-	"dept": z.number()
+	"uid": z.number().optional()
 }),
 		data: z.object({
-	"isMember": z.boolean()
+	"userId": z.number(),
+	"username": z.string(),
+	"displayName": z.string().nullable().optional(),
+	"position": z.string().nullable(),
+	"mainDeptId": z.number().nullable(),
+	"mainDeptPath": z.array(z.string()),
+	"departments": z.array(z.object({
+	"deptId": z.number(),
+	"deptPath": z.array(z.string())
+}))
+}),
+	},
+	"platformSolutionsRoutesGet": {
+		data: z.array(z.object({
+	"path": z.string(),
+	"module": z.string(),
+	"category": z.enum(["main", "admin", "hidden"]),
+	"order": z.number(),
+	"title_key": z.string().nullable(),
+	"required_permission": z.string().nullable(),
+	"enabled": z.boolean()
+})),
+	},
+	"platformSolutionsVerifyPost": {
+		query: z.object({
+	"name": z.string().min(1)
+}),
+		data: z.object({
+	"ok": z.boolean(),
+	"checks": z.array(z.object({
+	"id": z.string(),
+	"severity": z.enum(["error", "warn", "info"]),
+	"subject": z.string(),
+	"advise_key": z.string()
+})),
+	"advise": z.array(z.string())
+}),
+	},
+	"platformSolutionsVerifyLastGet": {
+		query: z.object({
+	"name": z.string().min(1)
+}),
+		data: z.object({
+	"ok": z.boolean(),
+	"checks": z.array(z.object({
+	"id": z.string(),
+	"severity": z.enum(["error", "warn", "info"]),
+	"subject": z.string(),
+	"advise_key": z.string()
+})),
+	"advise": z.array(z.string())
 }),
 	},
 };

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

@@ -33,7 +33,7 @@ export function create_platformClient(ctx: ModuleContext) {
 	}
 	ctx.register.apiPrefix(API_PREFIX);
 	bindRequest(ctx.utils.request);
-	return { platformContactsGet, platformContactsDetailGet, platformMarketInstallPost, platformMarketInstallCancelPost, platformMarketTaskGet, platformMarketEnablePost, platformMarketMetaGet, platformMarketTrustGet, platformMarketTrustPost, platformMarketTrustKeyPost, platformMarketTrustKeyDelete, platformMarketIndexGet, platformMarketUninstallImpactGet, platformMarketUninstallPost, platformMarketHistoryGet, platformSolutionsRoutesGet, platformSolutionsVerifyPost, platformSolutionsVerifyLastGet, platformOrgTreeGet, platformOrgDepartmentsGet, platformOrgMembersGet, platformOrgUserGet, platformOrgPickerGet, platformOrgResolvePost, platformOrgIsMemberGet };
+	return { platformContactsGet, platformContactsDetailGet, platformMarketInstallPost, platformMarketInstallCancelPost, platformMarketTaskGet, platformMarketEnablePost, platformMarketMetaGet, platformMarketTrustGet, platformMarketTrustPost, platformMarketTrustKeyPost, platformMarketTrustKeyDelete, platformMarketIndexGet, platformMarketUninstallImpactGet, platformMarketUninstallPost, platformMarketHistoryGet, platformOrgDepartmentsGet, platformOrgIsMemberGet, platformOrgMembersGet, platformOrgPickerGet, platformOrgResolvePost, platformOrgTreeGet, platformOrgUserGet, platformSolutionsRoutesGet, platformSolutionsVerifyPost, platformSolutionsVerifyLastGet };
 }
 
 /**
@@ -64,14 +64,23 @@ async function toApiError(e: unknown): Promise<unknown> {
 	return e;
 }
 
-export async function platformContactsGet(): Promise<unknown> {
+export type PlatformContactsGetQuery = z.input<(typeof schemas)["platformContactsGet"]["query"]>;
+export type PlatformContactsGetData = z.infer<(typeof schemas)["platformContactsGet"]["data"]>;
+
+export async function platformContactsGet(query: PlatformContactsGetQuery): Promise<PlatformContactsGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/contacts`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`_platform/contacts`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformContactsGetData>>();
 		// 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 unknown;
+		const data = env.data as PlatformContactsGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformContactsGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformContactsGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -79,14 +88,23 @@ export async function platformContactsGet(): Promise<unknown> {
 	}
 }
 
-export async function platformContactsDetailGet(): Promise<unknown> {
+export type PlatformContactsDetailGetQuery = z.input<(typeof schemas)["platformContactsDetailGet"]["query"]>;
+export type PlatformContactsDetailGetData = z.infer<(typeof schemas)["platformContactsDetailGet"]["data"]>;
+
+export async function platformContactsDetailGet(query: PlatformContactsDetailGetQuery): Promise<PlatformContactsDetailGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/contacts/detail`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`_platform/contacts/detail`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformContactsDetailGetData>>();
 		// 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 unknown;
+		const data = env.data as PlatformContactsDetailGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformContactsDetailGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformContactsDetailGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -402,14 +420,23 @@ export async function platformMarketHistoryGet(): Promise<PlatformMarketHistoryG
 	}
 }
 
-export async function platformSolutionsRoutesGet(): Promise<unknown> {
+export type PlatformOrgDepartmentsGetQuery = z.input<(typeof schemas)["platformOrgDepartmentsGet"]["query"]>;
+export type PlatformOrgDepartmentsGetData = z.infer<(typeof schemas)["platformOrgDepartmentsGet"]["data"]>;
+
+export async function platformOrgDepartmentsGet(query: PlatformOrgDepartmentsGetQuery): Promise<PlatformOrgDepartmentsGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/solutions/routes`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`_platform/org/departments`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformOrgDepartmentsGetData>>();
 		// 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 unknown;
+		const data = env.data as PlatformOrgDepartmentsGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformOrgDepartmentsGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformOrgDepartmentsGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -417,14 +444,23 @@ export async function platformSolutionsRoutesGet(): Promise<unknown> {
 	}
 }
 
-export async function platformSolutionsVerifyPost(): Promise<unknown> {
+export type PlatformOrgIsMemberGetQuery = z.input<(typeof schemas)["platformOrgIsMemberGet"]["query"]>;
+export type PlatformOrgIsMemberGetData = z.infer<(typeof schemas)["platformOrgIsMemberGet"]["data"]>;
+
+export async function platformOrgIsMemberGet(query: PlatformOrgIsMemberGetQuery): Promise<PlatformOrgIsMemberGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.post(`_platform/solutions/verify`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`_platform/org/is-member`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformOrgIsMemberGetData>>();
 		// 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 unknown;
+		const data = env.data as PlatformOrgIsMemberGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformOrgIsMemberGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformOrgIsMemberGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -432,14 +468,23 @@ export async function platformSolutionsVerifyPost(): Promise<unknown> {
 	}
 }
 
-export async function platformSolutionsVerifyLastGet(): Promise<unknown> {
+export type PlatformOrgMembersGetQuery = z.input<(typeof schemas)["platformOrgMembersGet"]["query"]>;
+export type PlatformOrgMembersGetData = z.infer<(typeof schemas)["platformOrgMembersGet"]["data"]>;
+
+export async function platformOrgMembersGet(query: PlatformOrgMembersGetQuery): Promise<PlatformOrgMembersGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/solutions/verify/last`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`_platform/org/members`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformOrgMembersGetData>>();
 		// 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 unknown;
+		const data = env.data as PlatformOrgMembersGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformOrgMembersGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformOrgMembersGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -447,22 +492,22 @@ export async function platformSolutionsVerifyLastGet(): Promise<unknown> {
 	}
 }
 
-export type PlatformOrgTreeGetQuery = z.input<(typeof schemas)["platformOrgTreeGet"]["query"]>;
-export type PlatformOrgTreeGetData = z.infer<(typeof schemas)["platformOrgTreeGet"]["data"]>;
+export type PlatformOrgPickerGetQuery = z.input<(typeof schemas)["platformOrgPickerGet"]["query"]>;
+export type PlatformOrgPickerGetData = z.infer<(typeof schemas)["platformOrgPickerGet"]["data"]>;
 
-export async function platformOrgTreeGet(query: PlatformOrgTreeGetQuery): Promise<PlatformOrgTreeGetData> {
+export async function platformOrgPickerGet(query: PlatformOrgPickerGetQuery): Promise<PlatformOrgPickerGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/org/tree`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformOrgTreeGetData>>();
+		const env = await client.get(`_platform/org/picker`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformOrgPickerGetData>>();
 		// 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 PlatformOrgTreeGetData;
+		const data = env.data as PlatformOrgPickerGetData;
 		if (import.meta.env.DEV) {
 			const { schemas } = await import("./api.schemas");
-			const r = schemas["platformOrgTreeGet"].data.safeParse(data);
+			const r = schemas["platformOrgPickerGet"].data.safeParse(data);
 			if (!r.success)
-				throw new ContractApiError(-1, `[契约违例] platformOrgTreeGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+				throw new ContractApiError(-1, `[契约违例] platformOrgPickerGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
 		}
 		return data;
 	}
@@ -471,22 +516,23 @@ export async function platformOrgTreeGet(query: PlatformOrgTreeGetQuery): Promis
 	}
 }
 
-export type PlatformOrgDepartmentsGetQuery = z.input<(typeof schemas)["platformOrgDepartmentsGet"]["query"]>;
-export type PlatformOrgDepartmentsGetData = z.infer<(typeof schemas)["platformOrgDepartmentsGet"]["data"]>;
+export type PlatformOrgResolvePostQuery = z.input<(typeof schemas)["platformOrgResolvePost"]["query"]>;
+export type PlatformOrgResolvePostBody = z.input<(typeof schemas)["platformOrgResolvePost"]["body"]>;
+export type PlatformOrgResolvePostData = z.infer<(typeof schemas)["platformOrgResolvePost"]["data"]>;
 
-export async function platformOrgDepartmentsGet(query: PlatformOrgDepartmentsGetQuery): Promise<PlatformOrgDepartmentsGetData> {
+export async function platformOrgResolvePost(input: { query: PlatformOrgResolvePostQuery, body: PlatformOrgResolvePostBody }): Promise<PlatformOrgResolvePostData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/org/departments`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformOrgDepartmentsGetData>>();
+		const env = await client.post(`_platform/org/resolve`, { searchParams: input.query as Record<string, string | number | boolean>, json: input.body }).json<OjEnvelope<PlatformOrgResolvePostData>>();
 		// 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 PlatformOrgDepartmentsGetData;
+		const data = env.data as PlatformOrgResolvePostData;
 		if (import.meta.env.DEV) {
 			const { schemas } = await import("./api.schemas");
-			const r = schemas["platformOrgDepartmentsGet"].data.safeParse(data);
+			const r = schemas["platformOrgResolvePost"].data.safeParse(data);
 			if (!r.success)
-				throw new ContractApiError(-1, `[契约违例] platformOrgDepartmentsGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+				throw new ContractApiError(-1, `[契约违例] platformOrgResolvePost 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
 		}
 		return data;
 	}
@@ -495,22 +541,22 @@ export async function platformOrgDepartmentsGet(query: PlatformOrgDepartmentsGet
 	}
 }
 
-export type PlatformOrgMembersGetQuery = z.input<(typeof schemas)["platformOrgMembersGet"]["query"]>;
-export type PlatformOrgMembersGetData = z.infer<(typeof schemas)["platformOrgMembersGet"]["data"]>;
+export type PlatformOrgTreeGetQuery = z.input<(typeof schemas)["platformOrgTreeGet"]["query"]>;
+export type PlatformOrgTreeGetData = z.infer<(typeof schemas)["platformOrgTreeGet"]["data"]>;
 
-export async function platformOrgMembersGet(query: PlatformOrgMembersGetQuery): Promise<PlatformOrgMembersGetData> {
+export async function platformOrgTreeGet(query: PlatformOrgTreeGetQuery): Promise<PlatformOrgTreeGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/org/members`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformOrgMembersGetData>>();
+		const env = await client.get(`_platform/org/tree`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformOrgTreeGetData>>();
 		// 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 PlatformOrgMembersGetData;
+		const data = env.data as PlatformOrgTreeGetData;
 		if (import.meta.env.DEV) {
 			const { schemas } = await import("./api.schemas");
-			const r = schemas["platformOrgMembersGet"].data.safeParse(data);
+			const r = schemas["platformOrgTreeGet"].data.safeParse(data);
 			if (!r.success)
-				throw new ContractApiError(-1, `[契约违例] platformOrgMembersGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+				throw new ContractApiError(-1, `[契约违例] platformOrgTreeGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
 		}
 		return data;
 	}
@@ -543,22 +589,21 @@ export async function platformOrgUserGet(query: PlatformOrgUserGetQuery): Promis
 	}
 }
 
-export type PlatformOrgPickerGetQuery = z.input<(typeof schemas)["platformOrgPickerGet"]["query"]>;
-export type PlatformOrgPickerGetData = z.infer<(typeof schemas)["platformOrgPickerGet"]["data"]>;
+export type PlatformSolutionsRoutesGetData = z.infer<(typeof schemas)["platformSolutionsRoutesGet"]["data"]>;
 
-export async function platformOrgPickerGet(query: PlatformOrgPickerGetQuery): Promise<PlatformOrgPickerGetData> {
+export async function platformSolutionsRoutesGet(): Promise<PlatformSolutionsRoutesGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/org/picker`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformOrgPickerGetData>>();
+		const env = await client.get(`_platform/solutions/routes`).json<OjEnvelope<PlatformSolutionsRoutesGetData>>();
 		// 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 PlatformOrgPickerGetData;
+		const data = env.data as PlatformSolutionsRoutesGetData;
 		if (import.meta.env.DEV) {
 			const { schemas } = await import("./api.schemas");
-			const r = schemas["platformOrgPickerGet"].data.safeParse(data);
+			const r = schemas["platformSolutionsRoutesGet"].data.safeParse(data);
 			if (!r.success)
-				throw new ContractApiError(-1, `[契约违例] platformOrgPickerGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+				throw new ContractApiError(-1, `[契约违例] platformSolutionsRoutesGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
 		}
 		return data;
 	}
@@ -567,23 +612,22 @@ export async function platformOrgPickerGet(query: PlatformOrgPickerGetQuery): Pr
 	}
 }
 
-export type PlatformOrgResolvePostQuery = z.input<(typeof schemas)["platformOrgResolvePost"]["query"]>;
-export type PlatformOrgResolvePostBody = z.input<(typeof schemas)["platformOrgResolvePost"]["body"]>;
-export type PlatformOrgResolvePostData = z.infer<(typeof schemas)["platformOrgResolvePost"]["data"]>;
+export type PlatformSolutionsVerifyPostQuery = z.input<(typeof schemas)["platformSolutionsVerifyPost"]["query"]>;
+export type PlatformSolutionsVerifyPostData = z.infer<(typeof schemas)["platformSolutionsVerifyPost"]["data"]>;
 
-export async function platformOrgResolvePost(input: { query: PlatformOrgResolvePostQuery, body: PlatformOrgResolvePostBody }): Promise<PlatformOrgResolvePostData> {
+export async function platformSolutionsVerifyPost(query: PlatformSolutionsVerifyPostQuery): Promise<PlatformSolutionsVerifyPostData> {
 	const client = ensureReq();
 	try {
-		const env = await client.post(`_platform/org/resolve`, { searchParams: input.query as Record<string, string | number | boolean>, json: input.body }).json<OjEnvelope<PlatformOrgResolvePostData>>();
+		const env = await client.post(`_platform/solutions/verify`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformSolutionsVerifyPostData>>();
 		// 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 PlatformOrgResolvePostData;
+		const data = env.data as PlatformSolutionsVerifyPostData;
 		if (import.meta.env.DEV) {
 			const { schemas } = await import("./api.schemas");
-			const r = schemas["platformOrgResolvePost"].data.safeParse(data);
+			const r = schemas["platformSolutionsVerifyPost"].data.safeParse(data);
 			if (!r.success)
-				throw new ContractApiError(-1, `[契约违例] platformOrgResolvePost 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+				throw new ContractApiError(-1, `[契约违例] platformSolutionsVerifyPost 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
 		}
 		return data;
 	}
@@ -592,22 +636,22 @@ export async function platformOrgResolvePost(input: { query: PlatformOrgResolveP
 	}
 }
 
-export type PlatformOrgIsMemberGetQuery = z.input<(typeof schemas)["platformOrgIsMemberGet"]["query"]>;
-export type PlatformOrgIsMemberGetData = z.infer<(typeof schemas)["platformOrgIsMemberGet"]["data"]>;
+export type PlatformSolutionsVerifyLastGetQuery = z.input<(typeof schemas)["platformSolutionsVerifyLastGet"]["query"]>;
+export type PlatformSolutionsVerifyLastGetData = z.infer<(typeof schemas)["platformSolutionsVerifyLastGet"]["data"]>;
 
-export async function platformOrgIsMemberGet(query: PlatformOrgIsMemberGetQuery): Promise<PlatformOrgIsMemberGetData> {
+export async function platformSolutionsVerifyLastGet(query: PlatformSolutionsVerifyLastGetQuery): Promise<PlatformSolutionsVerifyLastGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`_platform/org/is-member`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformOrgIsMemberGetData>>();
+		const env = await client.get(`_platform/solutions/verify/last`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformSolutionsVerifyLastGetData>>();
 		// 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 PlatformOrgIsMemberGetData;
+		const data = env.data as PlatformSolutionsVerifyLastGetData;
 		if (import.meta.env.DEV) {
 			const { schemas } = await import("./api.schemas");
-			const r = schemas["platformOrgIsMemberGet"].data.safeParse(data);
+			const r = schemas["platformSolutionsVerifyLastGet"].data.safeParse(data);
 			if (!r.success)
-				throw new ContractApiError(-1, `[契约违例] platformOrgIsMemberGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+				throw new ContractApiError(-1, `[契约违例] platformSolutionsVerifyLastGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
 		}
 		return data;
 	}