@gadmin2n/schematics 0.0.94 → 0.0.95

package/dist/lib/application/files/gadmin2-game-angle-demo/server/scripts/lib/admin-code.ts

@@ -0,0 +1,14 @@
+/**
+ * gadmin2 顶级"系统管理"page 的 code，跨实例项目可配。
+ *
+ * 背景：
+ *   - gadmin2 模板默认惯例是 'admin'（其他实例项目走默认）
+ *   - ERP 是历史特例，DB 里早期初始化为 'administration'，所有环境都已存在
+ *
+ * 通过环境变量 `ADMIN_PAGE_CODE` 覆盖默认值，避免在 seed 代码里硬编码。
+ * ERP 在 server/.env.local 及各部署环境里设置 `ADMIN_PAGE_CODE=administration`。
+ *
+ * seed 脚本通过 `dotenv -e .env.local -e .env -- ts-node ...` 执行，
+ * 因此 process.env 已自动加载相应配置。
+ */
+export const ADMIN_PAGE_CODE = process.env.ADMIN_PAGE_CODE ?? 'admin';

package/dist/lib/application/files/gadmin2-game-angle-demo/server/scripts/lib/page-helpers.ts

@@ -13,17 +13,29 @@ export const FULL_ACTIONS = ['createAny', 'readAny', 'updateAny', 'deleteAny'];
 
 /**
  * Upsert a Resource row.
- * update: {} preserves any manual edits on re-run.
+ *
+ * 历史数据中部分 t_resource 行存在 code/name 不一致（如 code='businesstrip',
+ * name='businessTrip'）—— 这是早期 seed 用过 toLowerCase 留下的痕迹。`code` 和
+ * `name` 都是 @unique，简单按 `code` 做 upsert 会在 create 分支撞 name 唯一约束
+ * (P2002)。
+ *
+ * 因此先 findFirst by `code OR name`，命中即视为同一行返回；找不到才 create。
+ * 这样无论 fresh DB 还是带历史数据的 DB 都幂等。
+ *
+ * 不更新已存在行的 code/name/description 字段，避免改动正在生效的 RBAC 关键值
+ * （nest-access-control 通过 Resource.name 匹配 @UseRoles({ resource })）。
  */
 export async function upsertResource(
   prisma: PrismaClient,
   code: string,
   description = `${code} resource`,
 ) {
-  return prisma.resource.upsert({
-    where: { code },
-    update: {},
-    create: { code, name: code, description, isCommonResource: false },
+  const existing = await prisma.resource.findFirst({
+    where: { OR: [{ code }, { name: code }] },
+  });
+  if (existing) return existing;
+  return prisma.resource.create({
+    data: { code, name: code, description, isCommonResource: false },
   });
 }
 

package/dist/lib/application/files/gadmin2-game-angle-demo/server/scripts/lib/resync-sequences.ts

@@ -0,0 +1,89 @@
+/**
+ * resync-sequences.ts —— 把 PostgreSQL autoincrement 序列推到 MAX(id)
+ *
+ * 用途：seed 启动前调用一次，规避「序列落后于真实最大 id」造成的 P2002 on `id`。
+ *
+ * 触发场景：
+ *   - 用 pg_dump --data-only 导入数据但没带序列状态
+ *   - 灌库脚本用显式 id 做 INSERT（绕过 nextval）
+ *   - 早期 seed 用过显式 id，后来切回 autoincrement
+ *
+ * 工作方式：
+ *   1) 通过 pg_class / pg_attribute 元数据，找出 current_schema() 下所有
+ *      绑定了序列的列（pg_get_serial_sequence 非 NULL）。
+ *   2) 对每列执行一条 SQL：取 MAX(col) 与序列 last_value，落后才 setval。
+ *      正常状态下是纯读，零写。
+ *
+ * 安全性：
+ *   - 元数据来自 pg_catalog（DB 自身），不接受任何用户输入。
+ *   - 标识符通过 pg_get_serial_sequence + format('%I') 来源，已被 PG 自身
+ *     按需引号化，可直接拼接进 SQL。
+ *   - 不跨 schema：只处理 current_schema()（即连接串里 ?schema=xxx 指向的那个）。
+ */
+
+import { PrismaClient } from '@prisma/client';
+
+interface SeqRow {
+  table_name: string;
+  column_name: string;
+  seq_name: string; // 形如 "public"."t_page_id_seq"，已被 PG 引号化
+}
+
+interface BumpResult {
+  bumped: boolean;
+  from_v: bigint;
+  to_v: bigint;
+}
+
+export async function resyncSequences(prisma: PrismaClient): Promise<void> {
+  const seqs = await prisma.$queryRaw<SeqRow[]>`
+    SELECT
+      c.relname AS table_name,
+      a.attname AS column_name,
+      pg_get_serial_sequence(format('%I.%I', n.nspname, c.relname), a.attname) AS seq_name
+    FROM pg_class c
+    JOIN pg_namespace n ON n.oid = c.relnamespace
+    JOIN pg_attribute a ON a.attrelid = c.oid
+    WHERE c.relkind = 'r'
+      AND n.nspname = current_schema()
+      AND a.attnum > 0
+      AND NOT a.attisdropped
+      AND pg_get_serial_sequence(format('%I.%I', n.nspname, c.relname), a.attname) IS NOT NULL
+    ORDER BY c.relname, a.attname
+  `;
+
+  let bumped = 0;
+  for (const s of seqs) {
+    // 单条 SQL 完成「比较 + 落后才 setval」，对健康序列是纯读：
+    //   - cur: 序列当前 last_value
+    //   - m  : 表里 column 的 MAX 值
+    //   - 仅当 m > cur 时执行 setval(seq, m)，否则不写
+    const result = await prisma.$queryRawUnsafe<BumpResult[]>(`
+      WITH cur AS (SELECT last_value AS v FROM ${s.seq_name}),
+           m   AS (SELECT COALESCE(MAX("${
+             s.column_name
+           }"), 0)::bigint AS v FROM "${s.table_name}")
+      SELECT
+        (m.v > cur.v) AS bumped,
+        cur.v AS from_v,
+        CASE WHEN m.v > cur.v
+             THEN setval('${s.seq_name.replace(/'/g, "''")}', m.v)
+             ELSE cur.v
+        END AS to_v
+      FROM cur, m
+    `);
+    const r = result[0];
+    if (r?.bumped) {
+      bumped++;
+      console.log(
+        `[resync-seq] ${s.table_name}.${s.column_name}: ${r.from_v} → ${r.to_v}`,
+      );
+    }
+  }
+
+  console.log(
+    bumped > 0
+      ? `[resync-seq] Bumped ${bumped} stale sequence(s) (of ${seqs.length} checked).`
+      : `[resync-seq] All ${seqs.length} sequences healthy.`,
+  );
+}

package/dist/lib/application/files/gadmin2-game-angle-demo/server/seed/agenda.seed.ts

@@ -1,4 +1,5 @@
 import { PrismaClient } from '@prisma/client';
+import { ADMIN_PAGE_CODE } from '../scripts/lib/admin-code';
 import {
   bindResourceToPage,
   getPageResourceIds,
@@ -9,15 +10,15 @@ import {
 /**
  * Agenda 模块 seed
  *
- * 职责：agenda page (admin 子节点) + agenda resource + 自家 SYSTEM_ADMIN 授权。
- * 前置：seedBootstrap 已建好 admin 与 SYSTEM_ADMIN。
+ * 职责：agenda page (顶级 admin/administration 子节点) + agenda resource + 自家 SYSTEM_ADMIN 授权。
+ * 前置：seedBootstrap 已建好 顶级 page 与 SYSTEM_ADMIN。
  */
 export async function seedAgendaModule(prisma: PrismaClient): Promise<void> {
   const role = await prisma.role.findUniqueOrThrow({
     where: { name: 'SYSTEM_ADMIN' },
   });
   const admin = await prisma.page.findUniqueOrThrow({
-    where: { code: 'admin' },
+    where: { code: ADMIN_PAGE_CODE },
   });
 
   const page = await upsertPage(prisma, {

package/dist/lib/application/files/gadmin2-game-angle-demo/server/seed/audit.seed.ts

@@ -1,4 +1,5 @@
 import { PrismaClient } from '@prisma/client';
+import { ADMIN_PAGE_CODE } from '../scripts/lib/admin-code';
 import {
   bindResourceToPage,
   getPageResourceIds,
@@ -9,16 +10,16 @@ import {
 /**
  * Audit 模块 seed
  *
- * 职责：audits page (admin 子节点) + audit resource + 自家 SYSTEM_ADMIN 授权。
+ * 职责：audits page (顶级 admin/administration 子节点) + audit resource + 自家 SYSTEM_ADMIN 授权。
  * 注意：page.code 是 'audits'，但 resource.code 是 'audit'（与 backend module 一致）。
- * 前置：seedBootstrap 已建好 admin 与 SYSTEM_ADMIN。
+ * 前置：seedBootstrap 已建好 顶级 page 与 SYSTEM_ADMIN。
  */
 export async function seedAuditModule(prisma: PrismaClient): Promise<void> {
   const role = await prisma.role.findUniqueOrThrow({
     where: { name: 'SYSTEM_ADMIN' },
   });
   const admin = await prisma.page.findUniqueOrThrow({
-    where: { code: 'admin' },
+    where: { code: ADMIN_PAGE_CODE },
   });
 
   const page = await upsertPage(prisma, {

package/dist/lib/application/files/gadmin2-game-angle-demo/server/seed/bootstrap.ts

@@ -1,15 +1,17 @@
 import { PrismaClient } from '@prisma/client';
+import { ADMIN_PAGE_CODE } from '../scripts/lib/admin-code';
 import { grantRoleAccess, upsertPage } from '../scripts/lib/page-helpers';
 
 /**
  * Bootstrap seed — 全模块共享的最小公共集
  *
  * 任何模块 seed 都假设以下 3 个对象已存在：
- *   1. SYSTEM_ADMIN 角色   —— 各模块 grant SYSTEM_ADMIN 时通过 name 查找
- *   2. admin 顶级 page     —— 各业务模块 page 的 parentId
- *   3. dataMngt 分组 page  —— 自动生成 CRUD 页面（data-mngt.seed.ts）的 parentId
+ *   1. SYSTEM_ADMIN 角色        —— 各模块 grant SYSTEM_ADMIN 时通过 name 查找
+ *   2. ADMIN_PAGE_CODE 顶级 page —— 各业务模块 page 的 parentId
+ *      （默认 'admin'；ERP 通过环境变量 ADMIN_PAGE_CODE=administration 覆盖）
+ *   3. dataMngt 分组 page        —— 自动生成 CRUD 页面（data-mngt.seed.ts）的 parentId
  *
- * 同时把 SYSTEM_ADMIN 对 admin / dataMngt 这两个分组节点的 RolePages 也建好，
+ * 同时把 SYSTEM_ADMIN 对 顶级 / dataMngt 这两个分组节点的 RolePages 也建好，
  * 否则它们的子菜单父节点不会展开。
  *
  * 必须在所有模块 seed 之前运行（由 seed/index.ts 编排）。
@@ -27,14 +29,20 @@ export async function seedBootstrap(prisma: PrismaClient): Promise<void> {
   });
   console.log(`[bootstrap] Role: SYSTEM_ADMIN (id=${systemAdminRole.id})`);
 
-  // ── admin 顶级分组 page ────────────────────────────────────────────────────
-  const adminPage = await upsertPage(prisma, {
-    code: 'admin',
-    name: 'admin',
-    zhName: '系统管理',
-    enName: 'System Mgnt',
-    sortOrder: 1000,
-  });
+  // ── 顶级分组 page（admin 或 administration，由环境变量决定） ──────────────
+  // updateData 显式同步文案/排序，确保已存在的 administration 行（ERP 历史数据）
+  // 也能拿到正确的 zhName='系统管理'、enName='System Mgnt'、sortOrder=1000。
+  const adminPage = await upsertPage(
+    prisma,
+    {
+      code: ADMIN_PAGE_CODE,
+      name: ADMIN_PAGE_CODE,
+      zhName: '系统管理',
+      enName: 'System Mgnt',
+      sortOrder: 1000,
+    },
+    { zhName: '系统管理', enName: 'System Mgnt', sortOrder: 1000 },
+  );
   console.log(`[bootstrap] Page: ${adminPage.code} (id=${adminPage.id})`);
 
   // ── dataMngt 分组 page（自动 CRUD 菜单容器） ──────────────────────────────
@@ -52,5 +60,7 @@ export async function seedBootstrap(prisma: PrismaClient): Promise<void> {
   // 分组节点本身不绑定 resource，只为让侧边栏父节点对 SYSTEM_ADMIN 可见
   await grantRoleAccess(prisma, systemAdminRole.id, adminPage.id, []);
   await grantRoleAccess(prisma, systemAdminRole.id, dataMngtPage.id, []);
-  console.log(`[bootstrap] RolePages: SYSTEM_ADMIN → admin, dataMngt`);
+  console.log(
+    `[bootstrap] RolePages: SYSTEM_ADMIN → ${adminPage.code}, dataMngt`,
+  );
 }

package/dist/lib/application/files/gadmin2-game-angle-demo/server/seed/canvas.seed.ts

@@ -1,4 +1,5 @@
 import { PrismaClient } from '@prisma/client';
+import { ADMIN_PAGE_CODE } from '../scripts/lib/admin-code';
 import {
   bindResourceToPage,
   getPageResourceIds,
@@ -9,15 +10,15 @@ import {
 /**
  * Canvas 模块 seed
  *
- * 职责：canvas page (admin 子节点) + canvas resource + 自家 SYSTEM_ADMIN 授权。
- * 前置：seedBootstrap 已建好 admin 与 SYSTEM_ADMIN。
+ * 职责：canvas page (顶级 admin/administration 子节点) + canvas resource + 自家 SYSTEM_ADMIN 授权。
+ * 前置：seedBootstrap 已建好 顶级 page 与 SYSTEM_ADMIN。
  */
 export async function seedCanvasModule(prisma: PrismaClient): Promise<void> {
   const role = await prisma.role.findUniqueOrThrow({
     where: { name: 'SYSTEM_ADMIN' },
   });
   const admin = await prisma.page.findUniqueOrThrow({
-    where: { code: 'admin' },
+    where: { code: ADMIN_PAGE_CODE },
   });
 
   const page = await upsertPage(prisma, {

package/dist/lib/application/files/gadmin2-game-angle-demo/server/seed/game.seed.ts

@@ -1,4 +1,5 @@
 import { PrismaClient } from '@prisma/client';
+import { ADMIN_PAGE_CODE } from '../scripts/lib/admin-code';
 import {
   bindResourceToPage,
   getPageResourceIds,
@@ -9,15 +10,15 @@ import {
 /**
  * Game 模块 seed
  *
- * 职责：game page (admin 子节点) + game resource + 自家 SYSTEM_ADMIN 授权。
- * 前置：seedBootstrap 已建好 admin 与 SYSTEM_ADMIN。
+ * 职责：game page (顶级 admin/administration 子节点) + game resource + 自家 SYSTEM_ADMIN 授权。
+ * 前置：seedBootstrap 已建好 顶级 page 与 SYSTEM_ADMIN。
  */
 export async function seedGameModule(prisma: PrismaClient): Promise<void> {
   const role = await prisma.role.findUniqueOrThrow({
     where: { name: 'SYSTEM_ADMIN' },
   });
   const admin = await prisma.page.findUniqueOrThrow({
-    where: { code: 'admin' },
+    where: { code: ADMIN_PAGE_CODE },
   });
 
   const page = await upsertPage(prisma, {

package/dist/lib/application/files/gadmin2-game-angle-demo/server/seed/index.ts

@@ -1,4 +1,5 @@
 import { PrismaClient } from '@prisma/client';
+import { resyncSequences } from '../scripts/lib/resync-sequences';
 import { seedAgendaModule } from './agenda.seed';
 import { seedAuditModule } from './audit.seed';
 import { seedBootstrap } from './bootstrap';
@@ -15,6 +16,7 @@ const prisma = new PrismaClient();
  * Top-level seed orchestrator.
  *
  * 顺序：
+ *   ⓪ resync-sequences   —— 把 autoincrement 序列追到 MAX(id)，规避 dump/import 留下的 P2002
  *   ① bootstrap          —— admin/dataMngt 根 page + SYSTEM_ADMIN role（全模块前置）
  *   ② 各模块 seed         —— 每个模块自管自家 page / resource / 授权 / 业务数据
  *   ③ data-mngt 自动 CRUD —— 扫描 config/prisma/ 业务模型生成 page/resource/grants
@@ -23,6 +25,8 @@ const prisma = new PrismaClient();
  * 全部幂等，可重复运行。
  */
 export async function main() {
+  await resyncSequences(prisma);
+
   await prisma.user.createMany({ data: users, skipDuplicates: true });
 
   await seedBootstrap(prisma);

package/dist/lib/application/files/gadmin2-game-angle-demo/server/seed/permission.seed.ts

@@ -1,4 +1,5 @@
 import { PrismaClient } from '@prisma/client';
+import { ADMIN_PAGE_CODE } from '../scripts/lib/admin-code';
 import {
   bindResourceToPage,
   getPageResourceIds,
@@ -10,13 +11,13 @@ import {
  * Permission 模块 seed
  *
  * 职责（仅本模块自家）：
- *   1. permission 父分组 page (admin → permission)
+ *   1. permission 父分组 page (顶级 admin/administration → permission)
  *   2. 5 个 leaf page: permission_readme / user / role / page / resource
  *   3. 7 个 resource: user / role / rolePages / roleResource / page / pageResource / resource
  *   4. PageResource 绑定（page ↔ resource，多对多）
  *   5. SYSTEM_ADMIN 对上述全部 page + resource 的全量授权
  *
- * 前置：seedBootstrap 已建好 admin 顶级 page 和 SYSTEM_ADMIN role。
+ * 前置：seedBootstrap 已建好 顶级 page 和 SYSTEM_ADMIN role。
  *
  * 多 resource 共享同一 page 的情况（如 role page UI 同时调 role + rolePages + roleResource API）
  * 通过 resourceDefs[].pageCode 表达。
@@ -29,7 +30,7 @@ export async function seedPermissionModule(
     where: { name: 'SYSTEM_ADMIN' },
   });
   const adminPage = await prisma.page.findUniqueOrThrow({
-    where: { code: 'admin' },
+    where: { code: ADMIN_PAGE_CODE },
   });
 
   // ── permission 父分组 ──────────────────────────────────────────────────────

package/dist/lib/application/files/gadmin2-game-angle-demo/web/package.json

@@ -72,7 +72,7 @@
     "lint-staged": "^13.0.0",
     "postcss": "^8.5.6",
     "postcss-nesting": "^14.0.0",
-    "prettier": "^3.0.0",
+    "prettier": "^3.8.3",
     "typescript": "^5.4.2",
     "vite": "^6.2.0",
     "vite-tsconfig-paths": "^5.1.4"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gadmin2n/schematics",
-  "version": "0.0.94",
+  "version": "0.0.95",
   "description": "Gadmin - modern, fast, powerful node.js web framework (@schematics)",
   "main": "dist/index.js",
   "files": [