@oj-module/cli 0.2.6 → 0.2.14

package/templates/web/src/oj-market/pages/MarketApp.tsx

@@ -1,5 +1,6 @@
 import type { IndexRow, TaskRecord } from "../types";
-import { Typography } from "antd";
+import { useUserStore } from "@oj-module/runtime";
+import { Alert, Typography } from "antd";
 import React, { useState } from "react";
 import { useTranslation } from "react-i18next";
 import { useMarketClient } from "../api/context";
@@ -16,6 +17,9 @@ export default function MarketApp() {
 	const { t } = useTranslation();
 	const client = useMarketClient();
 	const index = useMarketIndex();
+	// 管理权限 = superadmin（与后端 assertSuperAdmin 口径一致）。仅屏蔽写操作，浏览（详情/历史）对所有登录用户开放。
+	const roles = useUserStore(s => s.roles);
+	const canManage = roles.includes("superadmin");
 
 	const [detailRow, setDetailRow] = useState<IndexRow | null>(null);
 	const [installRow, setInstallRow] = useState<IndexRow | null>(null);
@@ -81,11 +85,21 @@ export default function MarketApp() {
 			<Typography.Title level={4}>{t("oj-market:card:title")}</Typography.Title>
 			<Typography.Paragraph type="secondary">{t("oj-market:card:subtitle")}</Typography.Paragraph>
 
+			{!canManage && (
+				<Alert
+					type="info"
+					showIcon
+					style={{ marginBottom: 16 }}
+					message={t("oj-market:card:superOnly")}
+				/>
+			)}
+
 			<CardGrid
 				loading={index.status === "loading"}
 				error={index.status === "error" ? index.error : null}
 				rows={rows}
 				busyName={busyName}
+				canManage={canManage}
 				onInstall={handleInstall}
 				onEnableToggle={handleEnableToggle}
 				onDetails={r => setDetailRow(r)}
@@ -99,6 +113,7 @@ export default function MarketApp() {
 				row={detailRow}
 				open={detailRow != null}
 				onClose={() => setDetailRow(null)}
+				canManage={canManage}
 				onInstall={handleInstall}
 				onHistory={(r) => {
 					setDetailRow(null);

package/templates/web/src/personal-center/__client/api.schemas.ts

@@ -4,6 +4,15 @@
 import { z } from "@oj-module/runtime";
 
 export const schemas = {
+	"personalCenterProfilePost": {
+		body: z.object({
+	"username": z.string().optional(),
+	"email": z.string().optional(),
+	"phoneNumber": z.string().optional(),
+	"description": z.string().optional()
+}),
+		data: z.null(),
+	},
 	"personalCenterUploadPost": {
 		data: z.string(),
 	},

package/templates/web/src/personal-center/__client/api.ts

@@ -33,7 +33,7 @@ export function createPersonalCenterClient(ctx: ModuleContext) {
 	}
 	ctx.register.apiPrefix(API_PREFIX);
 	bindRequest(ctx.utils.request);
-	return { personalCenterUploadPost };
+	return { personalCenterProfilePost, personalCenterUploadPost };
 }
 
 /**
@@ -64,6 +64,30 @@ async function toApiError(e: unknown): Promise<unknown> {
 	return e;
 }
 
+export type PersonalCenterProfilePostBody = z.input<(typeof schemas)["personalCenterProfilePost"]["body"]>;
+export type PersonalCenterProfilePostData = z.infer<(typeof schemas)["personalCenterProfilePost"]["data"]>;
+
+export async function personalCenterProfilePost(body: PersonalCenterProfilePostBody): Promise<PersonalCenterProfilePostData> {
+	const client = ensureReq();
+	try {
+		const env = await client.post(`personal-center/profile`, { json: body }).json<OjEnvelope<PersonalCenterProfilePostData>>();
+		// 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 PersonalCenterProfilePostData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["personalCenterProfilePost"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] personalCenterProfilePost 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
+		return data;
+	}
+	catch (e) {
+		throw await toApiError(e);
+	}
+}
+
 export type PersonalCenterUploadPostData = z.infer<(typeof schemas)["personalCenterUploadPost"]["data"]>;
 
 export async function personalCenterUploadPost(): Promise<PersonalCenterUploadPostData> {

package/templates/web/src/personal-center/entry.ts

@@ -3,6 +3,8 @@ import { ProfileCardIcon, RiAccountCircleLine, useAuthStore } from "@oj-module/r
 
 import { createElement, lazy } from "react";
 
+import { createPersonalCenterClient } from "./__client/api";
+
 const MyProfile = lazy(() => import("./pages/my-profile"));
 
 const routes: AppRouteRecordRaw[] = [
@@ -40,6 +42,9 @@ const mod: ModuleDefinition = {
 		// P4-3：接管头像上传端点（D9）。antd Upload 直连 action，headers 在上传瞬间
 		// 取当前 token 注入 Bearer（token 存 runtime auth store，跨渲染期读 getState）。
 		async onInit(ctx) {
+			// 构造即接线：登记契约前缀 /personal-center + 绑定 scoped request，
+			// 页面直接 import 的 personalCenterProfilePost 才有可用的请求通道
+			createPersonalCenterClient(ctx);
 			const provider: UploadApiProvider = {
 				action: "/api/personal-center/upload",
 				headers: (): Record<string, string> => {

package/templates/web/src/personal-center/pages/my-profile/index.tsx

@@ -5,10 +5,13 @@ import {
 	ProFormTextArea,
 } from "@ant-design/pro-components";
 import { BasicContent, FormAvatarItem, useUserStore } from "@oj-module/runtime";
-import { Form, Input } from "antd";
+import { App, Form, Input } from "antd";
+
+import { personalCenterProfilePost } from "../../__client/api";
 
 export default function Profile() {
 	const currentUser = useUserStore();
+	const { message } = App.useApp();
 	const getAvatarURL = () => {
 		if (currentUser) {
 			if (currentUser.avatar) {
@@ -20,8 +23,27 @@ export default function Profile() {
 		return "";
 	};
 
-	const handleFinish = async () => {
-		window.$message?.success("更新基本信息成功");
+	// 真实入库：POST /api/personal-center/profile（只传资料四字段，avatar 走 upload 通道），
+	// 成功后重拉 user-info 刷新全局 store（表单 initialValues 随之更新）。
+	const handleFinish = async (values: {
+		username?: string
+		email?: string
+		phoneNumber?: string
+		description?: string
+	}) => {
+		try {
+			await personalCenterProfilePost({
+				username: values.username,
+				email: values.email,
+				phoneNumber: values.phoneNumber,
+				description: values.description,
+			});
+			await useUserStore.getState().getUserInfo();
+			message.success("更新基本信息成功");
+		}
+		catch (e) {
+			message.error(`更新基本信息失败：${e instanceof Error ? e.message : String(e)}`);
+		}
 	};
 
 	return (

package/templates/web/src/system/entry.ts

@@ -20,7 +20,8 @@ const routes: AppRouteRecordRaw[] = [
 		handle: {
 			icon: createElement(SettingOutlined),
 			title: "system:menu.system",
-			order: 100,
+			// 负 order = 底部固定区：系统管理 pin 在侧边栏底部（2026-10-20 序轴约定）
+			order: -100,
 			layout: "container",
 		},
 		children: [

package/templates/web.config.ts

@@ -2,12 +2,15 @@
  * 模块工程配置：共享依赖一律不进 dependencies（宿主 importmap 提供），
  * 这里只登记模块清单（entry 相对本工程根）。
  *
- * 模块顺序即导航顺序：`home` 必须第一个（shell 的 "/" 重定向到它）。
+ * 注意：这里的登记顺序只影响模块加载顺序，**不决定侧边栏导航顺序**——
+ * 菜单顺序由各模块 entry 路由的 handle.order 决定（≥0 主菜单区升序；
+ * <0 底部固定区，pin 在侧边栏底部；同 order 按根 path 字母序）。
+ * `home` 必须第一个登记（shell 的 "/" 重定向到它）。
  */
 const allModules = [
 	// /home 必须是首个模块：shell 的 "/" → VITE_BASE_HOME_PATH（=/home）重定向
 	{ name: "home", entry: "web/src/home/entry.ts" },
-	{ name: "demo", entry: "web/src/demo/entry.ts" },
+	// { name: "demo", entry: "web/src/demo/entry.ts" },
 	// /login 路由由模块提供：shell 宿主不挂 runtime 内置 baseRoutes
 	{ name: "login", entry: "web/src/login/entry.ts" },
 	// 个人中心：runtime 用户菜单固定导航 /personal-center/my-profile，缺则点击落空
@@ -17,19 +20,19 @@ const allModules = [
 	{ name: "notification", entry: "web/src/notification/entry.ts" },
 	// 系统管理：用户/成员资格/角色权限/操作日志/站点设置/登录方式（oj 后端 /api/system/*）
 	{ name: "system", entry: "web/src/system/entry.ts" },
+	// 解决方案市场：第一方能力（消费 _platform 编排面 /api/_platform/market/*，
+	// R29：第三方方案不得仿照此调用面），默认随脚手架下发
+	{ name: "oj-market", entry: "web/src/oj-market/entry.ts" },
 	// #region demo-only
 	// 以下为模板内置的演示模块（about/access/exception/outside/route-nest），
 	// 用于把 templates 当可运行 demo 直接跑；其文件不在 `ojm init` 的
 	// init.include.yaml 白名单里，不拷入新工程，故本区间连同这些条目会被
 	// init 一并剥离，脚手架产出的配置不会残留指向缺失文件的死条目。
-	{ name: "about", entry: "web/src/about/entry.ts" },
-	{ name: "access", entry: "web/src/access/entry.ts" },
-	{ name: "exception", entry: "web/src/exception/entry.ts" },
-	{ name: "outside", entry: "web/src/outside/entry.ts" },
-	{ name: "route-nest", entry: "web/src/route-nest/entry.ts" },
-	// 解决方案市场：第一方能力（消费 _platform 编排面 /api/_platform/market/*），
-	// 模板自带以便自演示；新工程默认不带，同上由 init 剥离。
-	{ name: "oj-market", entry: "web/src/oj-market/entry.ts" },
+	// { name: "about", entry: "web/src/about/entry.ts" },
+	// { name: "access", entry: "web/src/access/entry.ts" },
+	// { name: "exception", entry: "web/src/exception/entry.ts" },
+	// { name: "outside", entry: "web/src/outside/entry.ts" },
+	// { name: "route-nest", entry: "web/src/route-nest/entry.ts" },
 	// #endregion demo-only
 ];
 

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.6",
-		"@oj-module/runtime/contract": "0.2.6",
-		"@oj-module/runtime/contract/errors": "0.2.6",
+		"@oj-module/runtime": "0.2.14",
+		"@oj-module/runtime/contract": "0.2.14",
+		"@oj-module/runtime/contract/errors": "0.2.14",
 		"@plane/kit": "0.1.20",
 		"@plane/editor": "0.1.20",
 		"antd": "6.6.1",

package/templates/api/src/_platform/_shared/service/oplog.ts

@@ -1,47 +0,0 @@
-// 操作日志查询（AC1-29/D13：admin 可查；读操作不记审计的红线不适用——本表本身就是审计）。
-// 过滤维度：action 精确 / username 前缀 / module 精确；分页复用 query.ts（limit 钳 200/truncated）。
-import { likePattern, paged } from "./query";
-
-export interface OplogRow {
-	id: number
-	create_time: number
-	user_id: number
-	username: string
-	action: string
-	module: string
-	version: string | null
-	target: string | null
-	detail: string | null
-	level: number
-}
-
-export interface OplogPage {
-	list: OplogRow[]
-	total: number
-	truncated: boolean
-}
-
-export async function searchOplog(filter: { action?: unknown, username?: unknown, module?: unknown, limit?: unknown }): Promise<OplogPage> {
-	const conds: string[] = [];
-	const params: unknown[] = [];
-	if (filter.action) {
-		conds.push("action = ?");
-		params.push(String(filter.action));
-	}
-	if (filter.module) {
-		conds.push("module = ?");
-		params.push(String(filter.module));
-	}
-	if (filter.username) {
-		conds.push("username like ? escape '!'");
-		params.push(likePattern(filter.username));
-	}
-	const where = conds.length ? `where ${conds.join(" and ")}` : "";
-	const r = await paged<OplogRow>(
-		`select * from sys_oplog ${where} order by id desc`,
-		`select count(*) as c from sys_oplog ${where}`,
-		params,
-		{ size: filter.limit },
-	);
-	return { list: r.list, total: r.total, truncated: r.truncated };
-}

package/templates/api/src/notifications/api.ts

@@ -1,32 +0,0 @@
-// GET /api/notifications —— 通知列表（runtime 通知铃的内置 root 级兜底端点）。
-//
-// runtime 的 fetchNotifications 在未注册 notificationsApi provider 时，直接
-// `request.get("notifications")` → 本端点；返回 NotificationItem[]（信封内 data）。
-// 查 notifications 表，is_read(0/1) 映射为布尔 isRead；Bearer 守卫保护。
-//
-// G5：本目录只保留只读兜底——表结构/种子迁归 api/src/notification/ 模块
-// （评审 b3 双模块同表冲突决策）；查询须返回 id（G4 NotificationItem.id 必填）。
-//
-// 注意：root 级路径无法写进业务契约（defineApi 要求 route 以 "/" 开头），
-// 故本模块已在 api/.ojm-api-exempt.json 豁免，ojm api --check 不会误报。
-export default {
-	async get() {
-		try {
-			const rows = await db.query(
-				"SELECT id, avatar, date, is_read, message, title FROM notifications ORDER BY id DESC",
-				[],
-			);
-			json.ok(rows.map(r => ({
-				id: Number(r.id),
-				avatar: String(r.avatar),
-				date: String(r.date),
-				isRead: Number(r.is_read) === 1,
-				message: String(r.message),
-				title: String(r.title),
-			})));
-		}
-		catch (e) {
-			json.fail(500, String(e));
-		}
-	},
-};

package/templates/api/src/notifications/manifest.yaml

@@ -1,5 +0,0 @@
-name: notifications
-desc: 通知兜底（runtime 通知铃未接 provider 时的 root 级 /api/notifications 只读回落；表结构/种子归 notification 模块）
-version: 0.1.0
-deps: # root 兜底只读查询 notifications 表（S003：跨模块表须声明依赖，同库只读先例见 personal-center → _platform）
-  notification: ^0.1.0

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

@@ -1,8 +0,0 @@
-/* eslint-disable */
-// 生成物：ojm api 从契约生成，勿手改（改动请改契约文件后重跑 ojm api）
-// AC-D15：仅供 DEV 校验动态 import，生产构建不进产物
-import { z } from "@oj-module/runtime";
-
-export const schemas = {
-
-};

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

@@ -1,80 +0,0 @@
-/* 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 = "/notifications";
-
-/** 认领身份前缀（契约 apiPrefix，字面等于模块目录名）：跨模块认领护栏对比基准 */
-export const MODULE_PREFIX = "/notifications";
-
-/**
- * 模块 entry 的 onInit 里一行创建（构造即 install）：完成 apiPrefix 登记 +
- * scoped request 绑定，返回绑好前缀的端点函数集合。一模块一 client；
- * 重复构造幂等安全（前缀重复登记同值、request 重绑同值）。
- */
-export function createNotificationsClient(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 { notificationsGet };
-}
-
-/**
- * @deprecated 请改用 createNotificationsClient(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 里调用 createNotificationsClient(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 async function notificationsGet(): Promise<unknown> {
-	const client = ensureReq();
-	try {
-		const env = await client.get(`notifications`).json<OjEnvelope<unknown>>();
-		// 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;
-		return data;
-	}
-	catch (e) {
-		throw await toApiError(e);
-	}
-}