@oj-module/cli 0.2.64 → 0.2.67

package/templates/src/app/api/publish/manifest.yaml

@@ -0,0 +1,8 @@
+name: publish
+desc: 发布凭证与发布身份（业务路由）：申请 / 列表 / 撤销 / 一次性兑换。凭证兑换即作废，Ed25519 密钥长期有效；身份只由服务端推导，CLI 不重复实现编码规则。
+version: 0.1.0
+tables:
+  # 共享表（B 组）：兑换发生在 CLI，无业务租户语义；租户归属走 owner_tenant 列
+  - publish_credential
+deps: # 判权（currentAccess）、统一信封（respond）、分页与限速都来自平台内核
+  _platform: ^0.1.0

package/templates/src/app/api/publish/migrations/0001__publish_credential.mysql.sql

@@ -0,0 +1,23 @@
+-- 0001__publish_credential（mysql 方言）：列语义同 0001__publish_credential.sql 头注释。
+-- 差异（沿用 _platform 基线的既有惯例）：键列/短文本收窄为 VARCHAR；秒级 epoch 取 BIGINT；
+-- 索引写在 CREATE TABLE 内（mysql 无 CREATE INDEX IF NOT EXISTS）。
+CREATE TABLE IF NOT EXISTS publish_credential (
+  id BIGINT AUTO_INCREMENT PRIMARY KEY,
+  token_hash VARCHAR(255) NOT NULL,
+  token_hint VARCHAR(64) NOT NULL,
+  uid BIGINT NOT NULL,
+  username VARCHAR(255) NOT NULL,
+  display_name TEXT,
+  product VARCHAR(255) NOT NULL,
+  key_id VARCHAR(255) NOT NULL,
+  owner_tenant VARCHAR(255) NOT NULL,
+  expires_at BIGINT NOT NULL,
+  used BIGINT NOT NULL DEFAULT 0,
+  used_at BIGINT,
+  revoked BIGINT NOT NULL DEFAULT 0,
+  created_at BIGINT NOT NULL,
+  created_ip VARCHAR(64),
+  UNIQUE KEY uk_publish_credential_token (token_hash),
+  KEY idx_publish_credential_owner (owner_tenant, uid, created_at),
+  KEY idx_publish_credential_key (key_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

package/templates/src/app/api/publish/migrations/0001__publish_credential.pg.sql

@@ -0,0 +1,23 @@
+-- 0001__publish_credential（postgres 方言）：列语义同 0001__publish_credential.sql 头注释。
+-- 差异（沿用 _platform 基线的既有惯例）：TEXT 全保留，秒级 epoch 取 BIGINT。
+CREATE TABLE IF NOT EXISTS publish_credential (
+  id BIGSERIAL PRIMARY KEY,
+  token_hash TEXT NOT NULL,
+  token_hint TEXT NOT NULL,
+  uid BIGINT NOT NULL,
+  username TEXT NOT NULL,
+  display_name TEXT,
+  product TEXT NOT NULL,
+  key_id TEXT NOT NULL,
+  owner_tenant TEXT NOT NULL,
+  expires_at BIGINT NOT NULL,
+  used INTEGER NOT NULL DEFAULT 0,
+  used_at BIGINT,
+  revoked INTEGER NOT NULL DEFAULT 0,
+  created_at BIGINT NOT NULL,
+  created_ip TEXT
+);
+CREATE UNIQUE INDEX IF NOT EXISTS uk_publish_credential_token ON publish_credential (token_hash);
+CREATE INDEX IF NOT EXISTS idx_publish_credential_owner
+  ON publish_credential (owner_tenant, uid, created_at);
+CREATE INDEX IF NOT EXISTS idx_publish_credential_key ON publish_credential (key_id);

package/templates/src/app/api/publish/migrations/0001__publish_credential.sql

@@ -0,0 +1,39 @@
+-- 0001__publish_credential（sqlite 方言）：发布凭证表。
+--
+-- 定性：**共享表**（schema.yaml `tenant: false` + config.yaml `tenant.shared_allow` 双声明）。
+-- 理由：兑换是 CLI 发起的，那一刻没有业务租户上下文；建成租户表会让 sql_guard: deny 给
+-- 按 token_hash 的查询强加 tenant_id 过滤，换个租户头就查不到。租户归属由 owner_tenant
+-- 显式承载（命名同 wecom_login_ticket：共享表出现 tenant_id 会被定性红线判为自相矛盾）。
+--
+-- 语义：
+--   · 一次性兑换令牌：兑换成功后 used=1，再兑即拒；未兑换前可用 revoked 手动作废
+--   · key_id 在**申请时**就算好落库，兑换只回读——CLI 不实现任何编码规则（单一真源）
+--   · 只存 token_hash（sha256），明文只在申请响应里出现一次
+--
+-- 主键用自增 id 而非 token_hash：列表分页与撤销都按行 id 操作（pagedFactory 也按 id 排序），
+-- 用 hash 做主键会让这两件事都得先算 hash 再反查。token_hash 仍唯一。
+CREATE TABLE IF NOT EXISTS publish_credential (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  token_hash TEXT NOT NULL,
+  token_hint TEXT NOT NULL,
+  uid INTEGER NOT NULL,
+  username TEXT NOT NULL,
+  display_name TEXT,
+  product TEXT NOT NULL,
+  key_id TEXT NOT NULL,
+  owner_tenant TEXT NOT NULL,
+  expires_at INTEGER NOT NULL,
+  used INTEGER NOT NULL DEFAULT 0,
+  used_at INTEGER,
+  revoked INTEGER NOT NULL DEFAULT 0,
+  created_at INTEGER NOT NULL,
+  created_ip TEXT
+);
+CREATE UNIQUE INDEX IF NOT EXISTS uk_publish_credential_token ON publish_credential (token_hash);
+
+-- 「发布管理」页的主查询：按租户 + 本人 + 时间倒序
+CREATE INDEX IF NOT EXISTS idx_publish_credential_owner
+  ON publish_credential (owner_tenant, uid, created_at);
+
+-- 撞号检查（同 key_id 是否已属于别人）
+CREATE INDEX IF NOT EXISTS idx_publish_credential_key ON publish_credential (key_id);

package/templates/src/app/api/publish/schema.yaml

@@ -0,0 +1,33 @@
+# 声明式表结构（S006 纪律：结构真源是 migrations/0001__publish_credential*，本文件只负责
+# 「列集/主键/租户定性」的运行时元数据，与迁移逐列对齐；templates-migration-schema-parity 双双守着）。
+#
+# 定性（三处一致：这里 / config.yaml `tenant.shared_allow` / 迁移文件头注释）：
+# **共享表**（tenant: false）。凭证在 CLI 兑换那一跳被执行，此刻没有业务租户语义——
+# 若建成租户表，sql_guard: deny 会给按 token_hash 的查询强加 tenant_id 过滤，换个租户头即查不到。
+# 租户归属由 `owner_tenant` 列显式承载（语义同 wecom_login_ticket：共享表出现 tenant_id
+# 会被定性红线判为自相矛盾）。
+tables:
+  publish_credential:
+    tenant: false
+    pk: id
+    columns:
+      id: {type: integer, null: false, autoincrement: true}
+      # 只存 sha256(明文)：明文只在申请响应里出现一次
+      token_hash: {type: text, null: false}
+      # 明文前 8 位，仅供「发布管理」页识别是哪一张，不参与任何校验
+      token_hint: {type: text, null: false}
+      uid: {type: integer, null: false}
+      # 申请时快照：改名不影响已签发的凭证与已推导的 key_id
+      username: {type: text, null: false}
+      display_name: {type: text}
+      # 申请时填写的产品名（NAME_RE 校验，落库即定）
+      product: {type: text, null: false}
+      # 服务端推导并落库的发布身份；兑换时原样下发，CLI 零推导
+      key_id: {type: text, null: false}
+      owner_tenant: {type: text, null: false}
+      expires_at: {type: integer, null: false}
+      used: {type: integer, null: false}
+      used_at: {type: integer}
+      revoked: {type: integer, null: false}
+      created_at: {type: integer, null: false}
+      created_ip: {type: text}

package/templates/src/app/api/system/login-methods/api.ts

@@ -10,9 +10,10 @@ async function get() {
 }
 get.response = {
 	type: "object",
-	required: ["methods"],
+	required: ["methods", "site_title"],
 	properties: {
 		methods: { type: "array", items: { type: "string" } },
+		site_title: { type: "string" },
 	},
 };
 

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

@@ -124,6 +124,21 @@ export const schemas = {
 		data: z.array(z.object({
 
 }).catchall(z.unknown())),
+	},
+	"platformMarketReleasesGet": {
+		query: z.object({
+	"page": z.number().min(1).optional(),
+	"limit": z.number().min(1).max(200).optional()
+}),
+		data: z.object({
+	"list": z.array(z.object({
+
+}).catchall(z.unknown())),
+	"total": z.number(),
+	"page": z.number(),
+	"size": z.number(),
+	"syncError": z.string().nullable().optional()
+}),
 	},
 	"platformOrgDepartmentsGet": {
 		query: z.object({

package/templates/src/app/web/_platform/__client/index.ts

@@ -36,7 +36,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, platformOrgDepartmentsGet, platformOrgIsMemberGet, platformOrgMembersGet, platformOrgPickerGet, platformOrgResolvePost, platformOrgTreeGet, platformOrgUserGet, platformSolutionsRoutesGet, platformSolutionsVerifyPost, platformSolutionsVerifyLastGet };
+	return { platformContactsGet, platformContactsDetailGet, platformMarketInstallPost, platformMarketInstallCancelPost, platformMarketTaskGet, platformMarketEnablePost, platformMarketMetaGet, platformMarketTrustGet, platformMarketTrustPost, platformMarketTrustKeyPost, platformMarketTrustKeyDelete, platformMarketIndexGet, platformMarketUninstallImpactGet, platformMarketUninstallPost, platformMarketHistoryGet, platformMarketReleasesGet, platformOrgDepartmentsGet, platformOrgIsMemberGet, platformOrgMembersGet, platformOrgPickerGet, platformOrgResolvePost, platformOrgTreeGet, platformOrgUserGet, platformSolutionsRoutesGet, platformSolutionsVerifyPost, platformSolutionsVerifyLastGet };
 }
 
 /**
@@ -423,6 +423,30 @@ export async function platformMarketHistoryGet(): Promise<PlatformMarketHistoryG
 	}
 }
 
+export type PlatformMarketReleasesGetQuery = z.input<(typeof schemas)["platformMarketReleasesGet"]["query"]>;
+export type PlatformMarketReleasesGetData = z.infer<(typeof schemas)["platformMarketReleasesGet"]["data"]>;
+
+export async function platformMarketReleasesGet(query: PlatformMarketReleasesGetQuery): Promise<PlatformMarketReleasesGetData> {
+	const client = ensureReq();
+	try {
+		const env = await client.get(`_platform/market/releases`, { searchParams: query as Record<string, string | number | boolean> }).json<OjEnvelope<PlatformMarketReleasesGetData>>();
+		// 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 PlatformMarketReleasesGetData;
+		if (import.meta.env.DEV) {
+			const { schemas } = await import("./api.schemas");
+			const r = schemas["platformMarketReleasesGet"].data.safeParse(data);
+			if (!r.success)
+				throw new ContractApiError(-1, `[契约违例] platformMarketReleasesGet 响应与契约不符：${r.error.issues.map(i => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ")}`);
+		}
+		return data;
+	}
+	catch (e) {
+		throw await toApiError(e);
+	}
+}
+
 export type PlatformOrgDepartmentsGetQuery = z.input<(typeof schemas)["platformOrgDepartmentsGet"]["query"]>;
 export type PlatformOrgDepartmentsGetData = z.infer<(typeof schemas)["platformOrgDepartmentsGet"]["data"]>;
 

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

@@ -8,13 +8,16 @@ import { onInit as personalCenterOnInit, routes as personalCenterRoutes } from "
 import { onInit as systemOnInit, routes as systemRoutes } from "./system/routes";
 
 /**
- * 应用模块（多根聚合）：一个 entry 承载六个业务根，各根独立成一级菜单。
+ * 应用模块（多根聚合）：一个 entry 承载五个业务根，各根独立成一级菜单。
  *
- * 为什么聚合：这六个根（首页/登录/个人中心/通知/系统管理）是脚手架的框架内置页面，
- * 同版本发布、同生命周期、缺一不可，拆成六个模块只会把工程目录、web.config 登记、
- * modules.json 与首屏模块入口请求都放大六倍。聚合后仍是「一目录一模块」，但模块内
+ * 为什么聚合：这五个根（首页/登录/个人中心/通知/系统管理）是脚手架的框架内置页面，
+ * 同版本发布、同生命周期、缺一不可，拆成五个模块只会把工程目录、web.config 登记、
+ * modules.json 与首屏模块入口请求都放大五倍。聚合后仍是「一目录一模块」，但模块内
  * 按根分目录（`<root>/routes.ts` + `pages/` + `__client/`），页面相对导入不变。
  *
+ * 发布管理不在这里：它属于方案市场，随 `src/oj-market/web/publish` 走市场模块
+ * （`/publish` 仍是独立一级菜单，URL 与菜单 key 不变）。
+ *
  * 结构约定（多根模块）：
  *   - 顶层路由首段去重 > 1 → runtime 判为多根（`isMultiRoot`），各根按 entry 里的
  *     **绝对路径**原样注册，不被 `routePrefix` 改写——URL 与菜单 key 都不变；
@@ -24,7 +27,8 @@ import { onInit as systemOnInit, routes as systemRoutes } from "./system/routes"
  *
  * i18n 用 `i18nNamespaces` 沿用各根**原命名空间**（home / login / personal-center /
  * notification / system），因此 `t("system:menu.users")`、`useTranslation("system")`
- * 与菜单标题 `<ns>:menu.<key>` 全部零改动。
+ * 与菜单标题 `<ns>:menu.<key>` 全部零改动。发布管理的 `publish` 命名空间随页面
+ * 在 oj-market 侧登记。
  */
 const i18nNamespaces: Record<string, ModuleI18n> = {
 	"home": {

package/templates/src/app/web/home/pages/components/bar-chart.tsx

@@ -1,9 +1,11 @@
 import type { EChartsOption } from "echarts";
 import { Card } from "antd";
-import ReactECharts from "echarts-for-react";
+import ReactEChartsCore from "echarts-for-react/esm/core";
 import { useTranslation } from "react-i18next";
 
-/** 柱状图：演示 `echarts` + `echarts-for-react`（共享依赖，宿主 importmap 提供）。 */
+import { echarts } from "./echarts-setup";
+
+/** 柱状图：按需注册的 `echarts` + `echarts-for-react/esm/core`（见 echarts-setup.ts）。 */
 export default function BarChart() {
 	const { t } = useTranslation();
 	const categories = [
@@ -25,7 +27,7 @@ export default function BarChart() {
 	};
 	return (
 		<Card title={t("home:views")}>
-			<ReactECharts opts={{ height: 320, width: "auto" }} option={option} />
+			<ReactEChartsCore echarts={echarts} opts={{ height: 320, width: "auto" }} option={option} />
 		</Card>
 	);
 }

package/templates/src/app/web/home/pages/components/echarts-setup.ts

@@ -0,0 +1,30 @@
+/**
+ * 按需注册的 echarts 实例（体积治理）。
+ *
+ * 为什么不用 `import ReactECharts from "echarts-for-react"`：
+ * 那条路径会 `import * as echarts from "echarts"`（整包 index），把 **全部图表类型 +
+ * 全部组件 + 全部渲染器** 打进模块产物。实测 `app` 模块 entry.js 1,697,666 B 中
+ * echarts 918 KB + zrender 221 KB，占 **87%**；而首页只用到折线/柱状/饼图三种。
+ *
+ * 这里改用 `echarts/core` 按需注册：只留 3 种图表 + 3 个组件 + Canvas 渲染器，
+ * 同一份代码实测 1,125 KB → 572 KB（−49%）。
+ *
+ * 新图表类型/组件时，务必在这里 `use()` 补上——否则运行期渲染为空且**不报错**，
+ * 是最常见的 echarts 按需踩坑。
+ */
+import { BarChart, LineChart, PieChart } from "echarts/charts";
+import { GridComponent, LegendComponent, TooltipComponent } from "echarts/components";
+import * as echarts from "echarts/core";
+import { CanvasRenderer } from "echarts/renderers";
+
+echarts.use([
+	BarChart,
+	LineChart,
+	PieChart,
+	GridComponent,
+	LegendComponent,
+	TooltipComponent,
+	CanvasRenderer,
+]);
+
+export { echarts };

package/templates/src/app/web/home/pages/components/line-chart.tsx

@@ -1,12 +1,14 @@
 import type { EChartsOption } from "echarts";
 import { Card, Radio } from "antd";
 import dayjs from "dayjs";
-import ReactECharts from "echarts-for-react";
+import ReactEChartsCore from "echarts-for-react/esm/core";
 import { useMemo, useState } from "react";
 import { useTranslation } from "react-i18next";
 
+import { echarts } from "./echarts-setup";
+
 /**
- * 折线图：演示 `echarts` + `echarts-for-react` + `dayjs`（共享依赖）。
+ * 折线图：按需注册的 `echarts` + `echarts-for-react/esm/core`（见 echarts-setup.ts）。
  * 数据为静态演示值——真实业务请走模块契约 + `ojm api` 生成的 client
  * （参考 `demo` 模块的裸 fetch 与教程里 books 模块的契约式接法）。
  */
@@ -69,7 +71,7 @@ export default function LineChart() {
 				</Radio.Group>
 			)}
 		>
-			<ReactECharts opts={{ height: 320, width: "auto" }} option={option} />
+			<ReactEChartsCore echarts={echarts} opts={{ height: 320, width: "auto" }} option={option} />
 		</Card>
 	);
 }

package/templates/src/app/web/home/pages/components/pie-chart.tsx

@@ -1,11 +1,14 @@
 import type { EChartsOption } from "echarts";
 import { Card, Segmented } from "antd";
-import ReactECharts from "echarts-for-react";
+import ReactEChartsCore from "echarts-for-react/esm/core";
 import { useMemo, useState } from "react";
 import { useTranslation } from "react-i18next";
 
+import { echarts } from "./echarts-setup";
+
 /**
- * 饼图：演示 `echarts` + `echarts-for-react` + antd `Segmented` 联动。
+ * 饼图：按需注册的 `echarts` + `echarts-for-react/esm/core` + antd `Segmented` 联动
+ * （注册清单见 echarts-setup.ts）。
  * 数据为静态演示值（各渠道 × 品类）。
  */
 const VALUES: Record<string, number[]> = {
@@ -59,7 +62,7 @@ export default function PieChart() {
 				/>
 			)}
 		>
-			<ReactECharts opts={{ height: 320, width: "auto" }} option={option} />
+			<ReactEChartsCore echarts={echarts} opts={{ height: 320, width: "auto" }} option={option} />
 		</Card>
 	);
 }

package/templates/src/app/web/home/pages/index.tsx

@@ -19,8 +19,9 @@ const wrapperCol: ColProps = {
 
 /**
  * 首页：结构对齐 playground home，用自带的统计卡片与三类图表
- * 演示宿主共享依赖矩阵（echarts / echarts-for-react / react-countup / dayjs /
- * antd / @ant-design/icons / react-i18next 均由宿主 importmap 单例提供）。
+ * 演示依赖矩阵（react-countup / dayjs / antd / @ant-design/icons / react-i18next
+ * 由宿主 importmap 单例提供；echarts 由模块自打包并按需注册，
+ * 见 `./components/echarts-setup.ts`）。
  */
 export default function HomePage() {
 	return (

package/templates/src/app/web/home/routes.ts

@@ -14,8 +14,9 @@ const Home = lazy(() => import("./pages/index"));
  * 工程缺 `/home` 路由时这些跳转会落到错误边界。
  *
  * 结构对齐 playground-oj/web/src/home；页面用统计卡片 + 折线/柱/饼图
- * 演示宿主共享依赖矩阵（echarts / echarts-for-react / react-countup / dayjs /
- * antd / @ant-design/icons / react-i18next，均由宿主 importmap 提供单例）。
+ * 演示依赖矩阵（react-countup / dayjs / antd / @ant-design/icons / react-i18next
+ * 由宿主 importmap 提供单例；echarts 属模块自打包的重型依赖，走按需注册，
+ * 见 `pages/components/echarts-setup.ts`）。
  * 图表数据为静态演示值——真实业务走模块契约 + `ojm api` 生成的 client。
  */
 export const routes: AppRouteRecordRaw[] = [
@@ -34,6 +35,11 @@ export const routes: AppRouteRecordRaw[] = [
 				handle: {
 					title: "home:menu.home",
 					icon: createElement(HomeOutlined),
+					// 首页是 /home 根的 index 子路由，运行时匹配到的叶子路由 id 为 `/home/`（带尾斜杠），
+					// 而菜单项 key 是父级 `/home`，selectedKeys 取叶子 id 导致高亮对不上——
+					// 复刻 react-antd-admin 时「首页」菜单项不亮。用 currentActiveMenu 显式声明高亮 /home
+					// （框架既定机制：页面指定高亮哪个菜单），对齐 playground / react-antd-admin 的选中态。
+					currentActiveMenu: "/home",
 				},
 			},
 		],

package/templates/src/app/web/login/locales/en-US.json

@@ -30,9 +30,15 @@
 		"sso.action": "Sign in with SSO",
 		"wecom": "WeCom",
 		"wecom.action": "Sign in with WeCom",
+		"wecomPending": "WeCom login will be available in a later stage",
 		"wecom.hint": "Enter the enterprise code (corp_id, visible in the WeCom console), or use the dedicated sign-in link from your admin",
 		"wecom.agent": "App ID (agentid)",
 		"wecom.agentHint": "Leave empty if the corp has a single app; otherwise use the agentid provided by your admin",
-		"wecom.exchanging": "Completing WeCom sign-in…"
+		"wecom.exchanging": "Completing WeCom sign-in…",
+		"wecom.scan.hint": "Open the WeCom app, scan with 「Scan」 and confirm — no username or password needed",
+		"wecom.scan.action": "One-tap sign in with WeCom",
+		"wecom.otherCorp": "Another enterprise? Sign in with an enterprise code",
+		"wecom.otherCorpHide": "Hide enterprise code"
+
 	}
 }

package/templates/src/app/web/login/locales/zh-CN.json

@@ -30,9 +30,15 @@
 		"sso.action": "使用 SSO 登录",
 		"wecom": "企业微信",
 		"wecom.action": "使用企业微信登录",
+		"wecomPending": "企业微信登录将在后续阶段提供",
 		"wecom.hint": "填写企业代码（企微后台可见的 corp_id），或直接使用管理员收到的专属登录链接",
 		"wecom.agent": "应用 ID（agentid）",
 		"wecom.agentHint": "留空使用该企业下唯一应用；多应用部署请填管理员提供的 agentid",
-		"wecom.exchanging": "正在完成企业微信登录…"
+		"wecom.exchanging": "正在完成企业微信登录…",
+		"wecom.scan.hint": "打开企业微信 App，用「扫一扫」扫码确认后自动进入，无需输入账号密码",
+		"wecom.scan.action": "使用企业微信一键登录",
+		"wecom.otherCorp": "其他企业？使用企业代码登录",
+		"wecom.otherCorpHide": "收起企业代码"
+
 	}
 }