@oj-module/cli 0.2.2 → 0.2.5

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

@@ -0,0 +1,335 @@
+/* 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 = "/_platform";
+
+/** 认领身份前缀（契约 apiPrefix，字面等于模块目录名）：跨模块认领护栏对比基准 */
+export const MODULE_PREFIX = "/_platform";
+
+/**
+ * 模块 entry 的 onInit 里一行创建（构造即 install）：完成 apiPrefix 登记 +
+ * scoped request 绑定，返回绑好前缀的端点函数集合。一模块一 client；
+ * 重复构造幂等安全（前缀重复登记同值、request 重绑同值）。
+ */
+export function create_platformClient(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 { platformContactsGet, platformContactsDetailGet, platformMarketInstallPost, platformMarketInstallCancelPost, platformMarketTaskGet, platformMarketEnablePost, platformMarketMetaGet, platformMarketTrustGet, platformMarketTrustPost, platformMarketTrustKeyPost, platformMarketTrustKeyDelete, platformMarketIndexGet, platformMarketUninstallImpactGet, platformMarketUninstallPost, platformMarketHistoryGet, platformSolutionsRoutesGet, platformSolutionsVerifyPost, platformSolutionsVerifyLastGet };
+}
+
+/**
+ * @deprecated 请改用 create_platformClient(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 里调用 create_platformClient(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 platformContactsGet(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`_platform/contacts`).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);
+	}
+}
+
+export async function platformContactsDetailGet(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`_platform/contacts/detail`).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);
+	}
+}
+
+export async function platformMarketInstallPost(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.post(`_platform/market/install`).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);
+	}
+}
+
+export async function platformMarketInstallCancelPost(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.post(`_platform/market/install/cancel`).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);
+	}
+}
+
+export async function platformMarketTaskGet(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`_platform/market/task`).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);
+	}
+}
+
+export async function platformMarketEnablePost(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.post(`_platform/market/enable`).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);
+	}
+}
+
+export async function platformMarketMetaGet(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`_platform/market/meta`).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);
+	}
+}
+
+export async function platformMarketTrustGet(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`_platform/market/trust`).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);
+	}
+}
+
+export async function platformMarketTrustPost(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.post(`_platform/market/trust`).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);
+	}
+}
+
+export async function platformMarketTrustKeyPost(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.post(`_platform/market/trust/key`).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);
+	}
+}
+
+export async function platformMarketTrustKeyDelete(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.delete(`_platform/market/trust/key`).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);
+	}
+}
+
+export async function platformMarketIndexGet(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`_platform/market/index`).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);
+	}
+}
+
+export async function platformMarketUninstallImpactGet(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`_platform/market/uninstall-impact`).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);
+	}
+}
+
+export async function platformMarketUninstallPost(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.post(`_platform/market/uninstall`).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);
+	}
+}
+
+export async function platformMarketHistoryGet(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`_platform/market/history`).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);
+	}
+}
+
+export async function platformSolutionsRoutesGet(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`_platform/solutions/routes`).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);
+	}
+}
+
+export async function platformSolutionsVerifyPost(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.post(`_platform/solutions/verify`).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);
+	}
+}
+
+export async function platformSolutionsVerifyLastGet(): Promise<unknown> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`_platform/solutions/verify/last`).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);
+	}
+}

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

@@ -0,0 +1,42 @@
+import type { AppRouteRecordRaw, ModuleDefinition } from "@oj-module/runtime";
+
+import { CopyrightOutlined } from "@ant-design/icons";
+
+import { createElement, lazy } from "react";
+
+const About = lazy(() => import("./pages/index"));
+
+const routes: AppRouteRecordRaw[] = [
+	{
+		path: "/about",
+		handle: {
+			layout: "container",
+			order: 120,
+			title: "about:menu.about",
+			icon: createElement(CopyrightOutlined),
+		},
+		children: [
+			{
+				index: true,
+				Component: About,
+				handle: {
+					title: "about:menu.about",
+					icon: createElement(CopyrightOutlined),
+				},
+			},
+		],
+	},
+];
+
+const mod: ModuleDefinition = {
+	name: "about",
+	description: "关于页面模块",
+	version: "1.0.0",
+	routes,
+	i18n: {
+		"zh-CN": () => import("./locales/zh-CN.json"),
+		"en-US": () => import("./locales/en-US.json"),
+	},
+};
+
+export default mod;

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

@@ -0,0 +1,16 @@
+{
+	"aboutProject": "About Project",
+	"descriptions": "react-ant-admin is a mid to backend solution based on React Hooks, Vite, and TypeScript. It is designed to help you quickly build enterprise level backend projects. It can help you in adopting new technologies and other aspects.",
+	"projectMessage": "Project Message",
+	"version": "Version",
+	"lastBuildTime": "Last Build Time",
+	"license": "License",
+	"previewAddress": "Preview URL",
+	"documentAddress": "Documentation URL",
+	"author": "Author",
+	"dependencies": "Prod Dependencies",
+	"devDependencies": "Dev Dependencies",
+	"menu": {
+		"about": "About"
+	}
+}

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

@@ -0,0 +1,16 @@
+{
+	"aboutProject": "关于项目",
+	"descriptions": "react-antd-admin 是一个基于 React Hooks、Vite 和 TypeScript 的中后台解决方案。它旨在帮助您快速搭建企业级中后台项目。无论是在采用新技术方面还是其他方面，它都能为您提供帮助。",
+	"projectMessage": "项目信息",
+	"version": "版本",
+	"lastBuildTime": "最后构建时间",
+	"license": "开源许可协议",
+	"previewAddress": "预览地址",
+	"documentAddress": "文档地址",
+	"author": "作者",
+	"dependencies": "生产依赖",
+	"devDependencies": "开发依赖",
+	"menu": {
+		"about": "关于"
+	}
+}

package/templates/web/src/about/pages/constants.ts

@@ -0,0 +1,20 @@
+import { getAppInfo } from "@oj-module/runtime";
+
+// P6.5：devDependencies 不再注入应用元信息（清单入 bundle 属信息
+// 泄露），此数组恒为空，about 页对应卡片随之自动隐藏。
+// 契约（P6.5/AppInfo）：不同宿主注入的应用元信息字段可缺省
+// （runtime 产物即不携带 dependencies）——缺字段必须走空态而非崩溃，
+// 一律经 getAppInfo() 读取。此前直接 Object.keys(dependencies) 在宿主
+// 形态直接崩整页（React Router ErrorBoundary，202609010056 暴露）
+const { dependencies } = getAppInfo().pkg;
+
+export const dependenciesItems = Object.keys(dependencies ?? {}).map((dep) => {
+	const value = dependencies?.[dep as keyof typeof dependencies];
+	return {
+		key: dep,
+		label: dep,
+		children: value,
+	};
+});
+
+export const devDependenciesItems: { key: string, label: string, children: string }[] = [];

package/templates/web/src/about/pages/index.tsx

@@ -0,0 +1,135 @@
+import { BasicContent, getAppInfo } from "@oj-module/runtime";
+
+import { Badge, Card, Col, Descriptions, Row, Tag, theme, Typography } from "antd";
+import { useTranslation } from "react-i18next";
+
+import { dependenciesItems, devDependenciesItems } from "./constants";
+
+const { version } = getAppInfo().pkg;
+const { lastBuildTime } = getAppInfo();
+
+const { Text, Link } = Typography;
+
+export default function About() {
+	const { t } = useTranslation();
+	const {
+		token: { colorBgLayout },
+	} = theme.useToken();
+
+	const projectMessageItems = [
+		{
+			key: 1,
+			label: t("about:version"),
+			children: <Text code>{version}</Text>,
+		},
+		{
+			key: 2,
+			label: t("about:lastBuildTime"),
+			children: <Tag color="#55acee">{lastBuildTime}</Tag>,
+		},
+		{
+			key: 3,
+			label: t("about:license"),
+			children: <Tag color="green">{getAppInfo().pkg.license}</Tag>,
+		},
+		{
+			key: 4,
+			label: t("about:previewAddress"),
+			children: (
+				<Link
+					rel="noreferrer noopener"
+					copyable
+					target="_blank"
+					href="https://condorheroblog.github.io/react-antd-admin/"
+				>
+					{t("common.view")}
+				</Link>
+			),
+		},
+		{
+			key: 5,
+			label: t("about:documentAddress"),
+			children: (
+				<Link
+					rel="noreferrer noopener"
+					copyable
+					target="_blank"
+					href="https://condorheroblog.github.io/react-antd-admin/docs/"
+				>
+					{t("common.view")}
+				</Link>
+			),
+		},
+		{
+			key: 6,
+			label: "Github",
+			children: (
+				<Link
+					rel="noreferrer noopener"
+					copyable
+					target="_blank"
+					href="https://github.com/condorheroblog/react-antd-admin"
+				>
+					{import.meta.env.VITE_GLOB_APP_TITLE}
+				</Link>
+			),
+		},
+		{
+			key: 7,
+			label: t("about:author"),
+			children: (
+				<Link
+					rel="noreferrer noopener"
+					target="_blank"
+					href="https://github.com/condorheroblog/"
+				>
+					{getAppInfo().pkg.author}
+				</Link>
+			),
+		},
+	];
+
+	return (
+		<BasicContent>
+			<Row gutter={[0, 20]} style={{ backgroundColor: colorBgLayout }}>
+				<Col span={24}>
+					<Row>
+						<Col>
+							<Card title={t("about:aboutProject")}>
+								<Descriptions
+									items={[
+										{
+											key: 1,
+											children: t("about:descriptions"),
+										},
+									]}
+								/>
+							</Card>
+						</Col>
+					</Row>
+				</Col>
+				<Col span={24}>
+					<Card title={t("about:projectMessage")}>
+						<Descriptions bordered items={projectMessageItems} />
+					</Card>
+				</Col>
+				<Col span={24}>
+					<Badge.Ribbon text={dependenciesItems.length} color="green">
+						<Card title={t("about:dependencies")}>
+							<Descriptions bordered items={dependenciesItems} />
+						</Card>
+					</Badge.Ribbon>
+				</Col>
+				{devDependenciesItems.length > 0 && (
+					<Col span={24}>
+						<Badge.Ribbon text={devDependenciesItems.length} color="blue">
+							<Card title={t("about:devDependencies")}>
+								<Descriptions bordered items={devDependenciesItems} />
+							</Card>
+						</Badge.Ribbon>
+					</Col>
+				)}
+			</Row>
+		</BasicContent>
+	);
+}

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

@@ -0,0 +1,74 @@
+import type { AppRouteRecordRaw, ModuleDefinition } from "@oj-module/runtime";
+import { EyeOutlined, FileTextOutlined, LockOutlined, SafetyOutlined } from "@ant-design/icons";
+
+import { accessControlCodes } from "@oj-module/runtime";
+import { createElement, lazy } from "react";
+
+const PageControl = lazy(() => import("./pages/page-control"));
+const ButtonControl = lazy(() => import("./pages/button-control"));
+const AdminVisible = lazy(() => import("./pages/admin-visible"));
+const CommonVisible = lazy(() => import("./pages/common-visible"));
+
+const routes: AppRouteRecordRaw[] = [
+	{
+		path: "/access",
+		handle: {
+			layout: "container",
+			icon: createElement(SafetyOutlined),
+			title: "access:menu.access",
+			order: 10,
+		},
+		children: [
+			{
+				path: "/access/page-control",
+				Component: PageControl,
+				handle: {
+					icon: createElement(FileTextOutlined),
+					title: "access:menu.pageControl",
+					permissions: [
+						accessControlCodes.get,
+					],
+				},
+			},
+			{
+				path: "/access/button-control",
+				Component: ButtonControl,
+				handle: {
+					icon: createElement(LockOutlined),
+					title: "access:menu.buttonControl",
+				},
+			},
+			{
+				path: "/access/admin-visible",
+				Component: AdminVisible,
+				handle: {
+					icon: createElement(EyeOutlined),
+					title: "access:menu.adminVisible",
+					roles: ["admin"],
+				},
+			},
+			{
+				path: "/access/common-visible",
+				Component: CommonVisible,
+				handle: {
+					icon: createElement(EyeOutlined),
+					title: "access:menu.commonVisible",
+					roles: ["common"],
+				},
+			},
+		],
+	},
+];
+
+const mod: ModuleDefinition = {
+	name: "access",
+	description: "权限控制模块",
+	version: "1.0.0",
+	routes,
+	i18n: {
+		"zh-CN": () => import("./locales/zh-CN.json"),
+		"en-US": () => import("./locales/en-US.json"),
+	},
+};
+
+export default mod;

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

@@ -0,0 +1,46 @@
+{
+	"accessMode": {
+		"title": "Backend Access Permission Visibility",
+		"description": "The current page only supports obtaining route visibility through backend interfaces"
+	},
+	"adminVisible": {
+		"title": "Admin Visible",
+		"description": "The current page is only visible to Admin accounts"
+	},
+	"commonVisible": {
+		"title": "Common Visible",
+		"description": "The current page is only visible to Common accounts"
+	},
+	"pageControl": {
+		"alertMessage": "Demo of Frontend Page Access Permissions",
+		"alertDescription": "Switch to different accounts and observe the changes in the 'Permission Demonstration' submenu on the left.",
+		"cardTitle": "Permission Mode",
+		"frontendControl": "Frontend Permission Control",
+		"backendControl": "Backend Permission Control",
+		"switchToFrontend": "Switch to Frontend Permission Mode",
+		"switchToBackend": "Switch to Backend Permission Mode",
+		"switchAdmin": "Switch to Admin User",
+		"switchCommon": "Switch to Common User",
+		"currentPermissionMode": "Current permission mode:",
+		"accountSwitching": "Account Switching",
+		"warningMessage": "If enableFrontendAceess and enableBackendAceess are equal, switching routing mode is not allowed."
+	},
+	"buttonControl": {
+		"alertMessage": "Demo of Frontend Button Access Permissions",
+		"alertDescription": "Switch between different accounts to observe button changes.",
+		"currentRole": "Current Role",
+		"switchAdmin": "Switch to Admin User",
+		"switchCommon": "Switch to Common User",
+		"componentControlPermissionCodes": "Component-based Control - Permission Codes",
+		"componentControlRoles": "Component-based Control - Roles",
+		"functionControlPermissionCodes": "Function-based Control - Permission Codes",
+		"functionControlRoles": "Function-based Control - Roles"
+	},
+	"menu": {
+		"access": "Access Demo",
+		"pageControl": "Page Control",
+		"buttonControl": "Button Control",
+		"adminVisible": "Admin Visible",
+		"commonVisible": "Common Visible"
+	}
+}