@oj-module/cli 0.2.53 → 0.2.56

package/templates/src/app/api/web/get-async-routes/api.ts

@@ -0,0 +1,23 @@
+// GET /api/web/get-async-routes —— 后端动态路由（Bearer 守卫保护）。
+// demo 返回空数组：模块路由由 web/src 静态注入；需要后端路由时按
+// 宿主 RouteObject 形状返回。
+const handler = {
+	get() {
+		json.ok([]);
+	},
+};
+
+// 出参：宿主 RouteObject 形状的数组（demo 恒空数组；页面路由由前端静态注入）
+handler.get.response = {
+	type: "array",
+	items: {
+		type: "object",
+		properties: {
+			path: { type: "string" },
+			component: { type: "string" },
+			children: { type: "array", items: { type: "object" } },
+		},
+	},
+};
+
+export default handler;

package/templates/src/app/api/web/hello/api.ts

@@ -0,0 +1,22 @@
+// GET /api/web/hello —— 演示业务端点（Bearer 守卫保护）。
+// 改完保存即生效（oj dev/ts 热更）；新增/删除模块目录需重启 ojm dev。
+const handler = {
+	get() {
+		json.ok({
+			message: "hello from oj",
+			user: http.user?.id ?? null,
+		});
+	},
+};
+
+// 出参：演示端点（hello 文案 + 当前用户 id）
+handler.get.response = {
+	type: "object",
+	required: ["message", "user"],
+	properties: {
+		message: { type: "string" },
+		user: { type: ["number", "null"] },
+	},
+};
+
+export default handler;

package/templates/src/{web/api → app/api/web}/user-info/api.ts

@@ -2,7 +2,7 @@
 // B4：roles 出自 sys_user_role 权威源（users.roles JSON 列已被 0003 移除，D10）——
 // 体验层角色走本资料接口，不进 JWT claims；avatar 读 avatar_base64，email 读 0007 迁移列。
 // 响应一律走 json.ok/json.fail 信封（oj 红线）。
-export default {
+const handler = {
 	async get() {
 		const uid = http.user?.id;
 		if (!uid) {
@@ -35,3 +35,23 @@ export default {
 		}
 	},
 };
+
+// 出参：登录链用户资料（roles 出自 sys_user_role，permissions 预留恒空）
+handler.get.response = {
+	type: "object",
+	required: ["id", "avatar", "username", "displayName", "email", "phoneNumber", "description", "roles", "mustChange", "permissions"],
+	properties: {
+		id: { type: "string" },
+		avatar: { type: "string" },
+		username: { type: "string" },
+		displayName: { type: "string" },
+		email: { type: "string" },
+		phoneNumber: { type: "string" },
+		description: { type: "string" },
+		roles: { type: "array", items: { type: "string" } },
+		mustChange: { type: "boolean" },
+		permissions: { type: "array", items: { type: "string" } },
+	},
+};
+
+export default handler;

package/templates/src/{_platform/web → app/web/_platform}/__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 → app/web/_platform/__client/index.ts}

@@ -17,6 +17,9 @@ export const API_PREFIX = "/_platform";
 /** 认领身份前缀（契约 apiPrefix，字面等于模块目录名）：跨模块认领护栏对比基准 */
 export const MODULE_PREFIX = "/_platform";
 
+/** 认领方模块（web.config clientOwners 指定）：跨模块认领护栏对比基准 */
+export const MODULE_OWNER = "/app";
+
 /**
  * 模块 entry 的 onInit 里一行创建（构造即 install）：完成 apiPrefix 登记 +
  * scoped request 绑定，返回绑好前缀的端点函数集合。一模块一 client；
@@ -28,12 +31,12 @@ export function create_platformClient(ctx: ModuleContext) {
 	// 单槽、卸载互相耦合；跨模块需求应由本模块创建后经 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 暴露。`);
+	if (import.meta.env.DEV && ctx.module.name !== MODULE_OWNER.slice(1)) {
+		console.warn(`[ojm-api] 模块 "${ctx.module.name}" 正在认领 ${MODULE_PREFIX} 的 client——跨模块认领会共享 request 单槽、卸载互相耦合；应由 "${MODULE_OWNER.slice(1)}" 模块在自身 onInit 创建，跨模块需求经 provider 暴露。`);
 	}
 	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 +67,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 +91,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 +423,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 +447,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 +471,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 +495,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 +519,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 +544,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 +592,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 +615,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 +639,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;
 	}