@oj-module/cli 0.2.17 → 0.2.20

package/templates/web.config.ts

@@ -2,6 +2,13 @@
  * 模块工程配置：共享依赖一律不进 dependencies（宿主 importmap 提供），
  * 这里只登记模块清单（entry 相对本工程根）。
  *
+ * 布局：`src/<name>/{api,web}`——模块的前后端同处一个目录，`web/entry.ts` 是前端入口、
+ * `api/manifest.yaml` 是后端模块标记（两者其一即可成模块；纯共享库目录两边都没有）。
+ *
+ * 新布局下本清单退化为**可选覆盖**：`ojm build/dev` 以 `src/<name>/web/entry.ts` 扫描结果
+ * 为真源（字典序），这里登记的条目按声明顺序排前、其余按扫描顺序追加——忘登记不会漏构建。
+ * 登记了不存在的前端入口才报错。
+ *
  * 注意：这里的登记顺序只影响模块加载顺序，**不决定侧边栏导航顺序**——
  * 菜单顺序由各模块 entry 路由的 handle.order 决定（≥0 主菜单区升序；
  * <0 底部固定区，pin 在侧边栏底部；同 order 按根 path 字母序）。
@@ -9,30 +16,33 @@
  */
 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: "home", entry: "src/home/web/entry.ts" },
 	// /login 路由由模块提供：shell 宿主不挂 runtime 内置 baseRoutes
-	{ name: "login", entry: "web/src/login/entry.ts" },
+	{ name: "login", entry: "src/login/web/entry.ts" },
 	// 个人中心：runtime 用户菜单固定导航 /personal-center/my-profile，缺则点击落空
-	{ name: "personal-center", entry: "web/src/personal-center/entry.ts" },
+	{ name: "personal-center", entry: "src/personal-center/web/entry.ts" },
 	// 通知：onInit 注册 notificationsApi provider（四方法全必填），
 	// 通知铃的互动（单条已读/全部已读/清空）由此生效；未登记则永远回落内置只读兜底
-	{ name: "notification", entry: "web/src/notification/entry.ts" },
+	{ name: "notification", entry: "src/notification/web/entry.ts" },
 	// 系统管理：用户/成员资格/角色权限/操作日志/站点设置/登录方式（oj 后端 /api/system/*）
-	{ name: "system", entry: "web/src/system/entry.ts" },
+	{ name: "system", entry: "src/system/web/entry.ts" },
 	// 解决方案市场：第一方能力（消费 _platform 编排面 /api/_platform/market/*，
 	// R29：第三方方案不得仿照此调用面），默认随脚手架下发
-	{ name: "oj-market", entry: "web/src/oj-market/entry.ts" },
+	{ name: "oj-market", entry: "src/oj-market/web/entry.ts" },
 	// #region demo-only
-	// 以下为模板内置的演示模块（about/access/exception/outside/route-nest），
+	// 以下为模板内置的演示模块（demo/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" },
+	//
+	// 注意：新布局的清单是「扫描 + 覆盖」并集——注释掉不会让它们消失，
+	// 扫描仍会捡到 `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 },
+	{ name: "outside", entry: "src/outside/web/entry.ts", enabled: false },
+	{ name: "route-nest", entry: "src/route-nest/web/entry.ts", enabled: false },
 	// #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.17",
-		"@oj-module/runtime/contract": "0.2.17",
-		"@oj-module/runtime/contract/errors": "0.2.17",
+		"@oj-module/runtime": "0.2.20",
+		"@oj-module/runtime/contract": "0.2.20",
+		"@oj-module/runtime/contract/errors": "0.2.20",
 		"@plane/kit": "0.1.20",
 		"@plane/editor": "0.1.20",
 		"antd": "6.6.1",

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

@@ -1,5 +0,0 @@
-name: auth
-desc: JWT 鉴权端点（业务路由）：login/refresh/logout；Bearer 守卫由 oj-auth 提供
-version: 0.1.0
-deps: # login/refresh 读 _platform.users（ownership_guard: deny 下必须声明，§3）
-  _platform: ^0.1.0

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

@@ -1,5 +0,0 @@
-name: system
-desc: 框架管理域端点（/api/system/*）：角色/权限点管理（assertSystemAdmin 判权，H2）
-version: 0.1.0
-deps: # roles/bindings/permissions 读写 _platform 的 sys_* 表（ownership_guard: deny 下必须声明）
-  _platform: ^0.1.0

package/templates/api/tests/fixture.ts

@@ -1,58 +0,0 @@
-// 后端 BDD 夹具：node:sqlite 内存库 + **真实迁移文件**建表，装到 globalThis.db——
-// 与 oj 运行时注入的全局同名同面（query/exec/tx/dialect），service 代码不改一行即可被测。
-// 夹具直接读 api/src/<模块>/migrations/*.sql，与迁移不可能漂移（沿用 oj-wiki 先例）。
-//
-// **构造器边界（架构定论，勿在此夹具里补 table()）**：db.table()/listTables() 等构造器是
-// oj 二进制内的纯 Rust 实现，无 JS 模块可导出，Node 侧垫不出来——本夹具刻意只给
-// {query, exec, tx, dialect}。两层测试的分工因此定型：
-//   · L2（本目录 *.spec.ts）：构造器面用**记录型假 builder**（记 where/orderBy/limit 调用
-//     序列做编排断言）；真 SQL 执行断言走 db.query 直查。
-//   · L1（同目录 *.test.ts，`oj test` 收集）：真 v8 + 真构造器闭环，守 SQL 渲染/过滤/转义
-//     的真执行面（样板见 tests/l1-builder.test.ts；方法论见 devkit oj-test-guide.md）。
-import { createRequire } from "node:module";
-
-const req = createRequire(import.meta.url);
-const { DatabaseSync } = req("node:sqlite");
-const { readdirSync, readFileSync, existsSync } = req("node:fs");
-const { join, dirname } = req("node:path");
-const { fileURLToPath } = req("node:url");
-
-const SRC = join(dirname(fileURLToPath(import.meta.url)), "..", "src");
-
-export const ADMIN = 1;
-
-/** 建内存库 + 注入全局；返回 DatabaseSync 供用例直插数据/断言。 */
-export function installDb(): any {
-	const dbo = new DatabaseSync(":memory:");
-	// 重放 src 下全部模块的迁移（方言专属文件除外）
-	for (const mod of readdirSync(SRC)) {
-		const dir = join(SRC, mod, "migrations");
-		if (!existsSync(dir))
-			continue;
-		for (const f of readdirSync(dir).filter((f: string) => f.endsWith(".sql") && !/\.(?:mysql|pg)\.sql$/.test(f)).sort())
-			dbo.exec(readFileSync(join(dir, f), "utf8"));
-	}
-
-	dbo.prepare("INSERT INTO users (id, username, password_hash) VALUES (?, ?, 'x')").run(ADMIN, "admin");
-
-	const query = async (sql: string, params: unknown[] = []) => dbo.prepare(sql).all(...(params as never[]));
-	const exec = async (sql: string, params: unknown[] = []) => Number(dbo.prepare(sql).run(...(params as never[])).changes);
-	const txInstance = { query, exec, isTx: true };
-	// db.tx 镜像运行时面：BEGIN/COMMIT/ROLLBACK 包裹回调（versions.ts 注释同语义）
-	const tx = async (fn: (t: typeof txInstance) => unknown) => {
-		dbo.exec("BEGIN");
-		try {
-			const r = await fn(txInstance);
-			dbo.exec("COMMIT");
-			return r;
-		}
-		catch (e) {
-			dbo.exec("ROLLBACK");
-			throw e;
-		}
-	};
-
-	const g = globalThis as any;
-	g.db = { query, exec, tx, dialect: () => "sqlite" };
-	return dbo;
-}

package/templates/api/tsconfig.json

@@ -1,8 +0,0 @@
-{
-	"extends": "../tsconfig.json",
-	"include": [
-		"src",
-		"../global.d.ts",
-		"../env.d.ts"
-	]
-}

package/templates/api/vitest.config.ts

@@ -1,12 +0,0 @@
-import { fileURLToPath } from "node:url";
-import { defineConfig } from "vitest/config";
-
-// 后端模块测试（BDD）：node:sqlite 内存库 + 真实迁移建表（见 tests/fixture.ts）。
-// root 锚定本目录，保证从工程根跑 vitest 时 include 相对本目录解析。
-export default defineConfig({
-	root: fileURLToPath(new URL(".", import.meta.url)),
-	test: {
-		include: ["tests/**/*.spec.ts"],
-		environment: "node",
-	},
-});