@oj-module/cli 0.2.50 → 0.2.54

package/templates/src/web/api/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/web/web/__client/api.schemas.ts

@@ -4,5 +4,33 @@
 import { z } from "@oj-module/runtime";
 
 export const schemas = {
+	"webGetAsyncRoutesGet": {
+		data: z.array(z.object({
+	"path": z.string().optional(),
+	"component": z.string().optional(),
+	"children": z.array(z.object({
 
+})).optional()
+})),
+	},
+	"webHelloGet": {
+		data: z.object({
+	"message": z.string(),
+	"user": z.number().nullable()
+}),
+	},
+	"webUserInfoGet": {
+		data: z.object({
+	"id": z.string(),
+	"avatar": z.string(),
+	"username": z.string(),
+	"displayName": z.string(),
+	"email": z.string(),
+	"phoneNumber": z.string(),
+	"description": z.string(),
+	"roles": z.array(z.string()),
+	"mustChange": z.boolean(),
+	"permissions": z.array(z.string())
+}),
+	},
 };

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

@@ -64,14 +64,22 @@ async function toApiError(e: unknown): Promise<unknown> {
 	return e;
 }
 
-export async function webGetAsyncRoutesGet(): Promise<unknown> {
+export type WebGetAsyncRoutesGetData = z.infer<(typeof schemas)["webGetAsyncRoutesGet"]["data"]>;
+
+export async function webGetAsyncRoutesGet(): Promise<WebGetAsyncRoutesGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`web/get-async-routes`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`web/get-async-routes`).json<OjEnvelope<WebGetAsyncRoutesGetData>>();
 		// 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 WebGetAsyncRoutesGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["webGetAsyncRoutesGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] webGetAsyncRoutesGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -79,14 +87,22 @@ export async function webGetAsyncRoutesGet(): Promise<unknown> {
 	}
 }
 
-export async function webHelloGet(): Promise<unknown> {
+export type WebHelloGetData = z.infer<(typeof schemas)["webHelloGet"]["data"]>;
+
+export async function webHelloGet(): Promise<WebHelloGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`web/hello`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`web/hello`).json<OjEnvelope<WebHelloGetData>>();
 		// 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 WebHelloGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["webHelloGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] webHelloGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {
@@ -94,14 +110,22 @@ export async function webHelloGet(): Promise<unknown> {
 	}
 }
 
-export async function webUserInfoGet(): Promise<unknown> {
+export type WebUserInfoGetData = z.infer<(typeof schemas)["webUserInfoGet"]["data"]>;
+
+export async function webUserInfoGet(): Promise<WebUserInfoGetData> {
 	const client = ensureReq();
 	try {
-		const env = await client.get(`web/user-info`).json<OjEnvelope<unknown>>();
+		const env = await client.get(`web/user-info`).json<OjEnvelope<WebUserInfoGetData>>();
 		// 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 WebUserInfoGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["webUserInfoGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] webUserInfoGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
 		return data;
 	}
 	catch (e) {

package/templates/tsconfig.paths.json

@@ -8,7 +8,6 @@
 		"paths": {
 			"#/_platform/*": ["./src/_platform/api/*"],
 			"#/auth/*": ["./src/auth/api/*"],
-			"#/demo/*": ["./src/demo/api/*"],
 			"#/home/*": ["./src/home/api/*"],
 			"#/notification/*": ["./src/notification/api/*"],
 			"#/personal-center/*": ["./src/personal-center/api/*"],

package/templates/web.config.ts

@@ -10,34 +10,26 @@
  * 登记了不存在的前端入口才报错。
  *
  * 注意：这里的登记顺序只影响模块加载顺序，**不决定侧边栏导航顺序**——
- * 菜单顺序由各模块 entry 路由的 handle.order 决定（≥0 主菜单区升序；
- * <0 底部固定区，pin 在侧边栏底部；同 order 按根 path 字母序）。
- * `home` 必须第一个登记（shell 的 "/" 重定向到它）。
+ * 菜单顺序由各根路由的 handle.order 决定（≥0 主菜单区升序；<0 底部固定区，
+ * pin 在侧边栏底部；同 order 按根 path 字母序）。
  */
 const allModules = [
-	// /home 必须是首个模块：shell 的 "/" → VITE_BASE_HOME_PATH（=/home）重定向
-	{ name: "home", entry: "src/home/web/entry.ts" },
-	// /login 路由由模块提供：shell 宿主不挂 runtime 内置 baseRoutes
-	{ name: "login", entry: "src/login/web/entry.ts" },
-	// 个人中心：runtime 用户菜单固定导航 /personal-center/my-profile，缺则点击落空
-	{ name: "personal-center", entry: "src/personal-center/web/entry.ts" },
-	// 通知：onInit 注册 notificationsApi provider（四方法全必填），
-	// 通知铃的互动（单条已读/全部已读/清空）由此生效；未登记则永远回落内置只读兜底
-	{ name: "notification", entry: "src/notification/web/entry.ts" },
-	// 系统管理：用户/成员资格/角色权限/操作日志/站点设置/登录方式（oj 后端 /api/system/*）
-	{ name: "system", entry: "src/system/web/entry.ts" },
+	// 框架内置页面：首页/登录/个人中心/通知/系统管理聚合成**一个多根模块**。
+	// 各根按 handle.order 排序（/home 1、/personal-center 110、/system -100 底部），
+	// 与拆分时的菜单逐项一致；/login、/change-password、/notification-center 走 hideInMenu。
+	{ name: "app", entry: "src/app/web/entry.ts" },
 	// 解决方案市场：第一方能力（消费 _platform 编排面 /api/_platform/market/*，
-	// R29：第三方方案不得仿照此调用面），默认随脚手架下发
+	// R29：第三方方案不得仿照此调用面），默认随脚手架下发。保持独立模块——
+	// 可选能力，删目录即可下线。
 	{ name: "oj-market", entry: "src/oj-market/web/entry.ts" },
 	// #region demo-only
-	// 以下为模板内置的演示模块（demo/about/access/exception/outside/route-nest），
+	// 以下为模板内置的演示模块（about/access/exception/outside/route-nest），
 	// 用于把 templates 当可运行 demo 直接跑；其文件不在 `ojm init` 的
 	// init.include.yaml 白名单里，不拷入新工程，故本区间连同这些条目会被
 	// init 一并剥离，脚手架产出的配置不会残留指向缺失文件的死条目。
 	//
 	// 注意：新布局的清单是「扫描 + 覆盖」并集——注释掉不会让它们消失，
 	// 扫描仍会捡到 `src/<name>/web/entry.ts`。要「不构建」必须写 `enabled: false`。
-	{ name: "demo", entry: "src/demo/web/entry.ts", enabled: false },
 	{ name: "about", entry: "src/about/web/entry.ts", enabled: false },
 	{ name: "access", entry: "src/access/web/entry.ts", enabled: false },
 	{ name: "exception", entry: "src/exception/web/entry.ts", enabled: false },
@@ -50,4 +42,17 @@ export default {
 	/** 产物 URL 前缀，留空表示同源相对路径 */
 	baseUrl: "",
 	modules: allModules,
+	/**
+	 * 生成 client 的归属模块：`api 前缀 → 承载其 __client 的 web 模块`。
+	 *
+	 * 多根聚合模块把多个业务域的页面/client 收进 `src/app/web`，故五个 api 前缀的
+	 * 生成物都落在 `src/app/web/<api 前缀>/__client`（与页面同级，页面相对导入不变）。
+	 * 不配则回落同名模块（`src/<api 前缀>/web/__client`，历史行为）。
+	 */
+	clientOwners: {
+		"home": "app",
+		"personal-center": "app",
+		"notification": "app",
+		"system": "app",
+	},
 };

package/vendor/host-versions.json

@@ -8,9 +8,9 @@
 		"react-router": "7.18.2",
 		"react-router/dom": "7.18.2",
 		"@tanstack/react-query": "5.102.8",
-		"@oj-module/runtime": "0.2.50",
-		"@oj-module/runtime/contract": "0.2.50",
-		"@oj-module/runtime/contract/errors": "0.2.50",
+		"@oj-module/runtime": "0.2.54",
+		"@oj-module/runtime/contract": "0.2.54",
+		"@oj-module/runtime/contract/errors": "0.2.54",
 		"@plane/kit": "0.1.20",
 		"@plane/editor": "0.1.20",
 		"antd": "6.6.1",