@gadmin2n/schematics 0.0.153 → 0.0.154

package/dist/lib/application/files/gadmin2-game-angle-demo/.git-blame-ignore-revs

@@ -0,0 +1,5 @@
+# git blame 忽略的批量格式化 commit（用法：git config blame.ignoreRevsFile .git-blame-ignore-revs）
+#
+# 提交后把对应 commit hash 填到下面（本文件需与 commit 同库才有意义）：
+#
+# TODO: oxfmt 全量 reformat 的 commit hash（Prettier → Oxfmt 迁移时的纯格式化提交）

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

@@ -0,0 +1 @@
+22

package/dist/lib/application/files/gadmin2-game-angle-demo/CODEBUDDY.md

@@ -7,9 +7,9 @@
 ## 常用命令
 
 ```bash
-cd server && yarn start:dev   # 后端，端口 8000（优先读 server/.env.local）
-cd web && yarn dev            # 前端，端口 3000（优先读 web/.env.local）
-cd server && yarn seed        # 执行 seed（页面/资源/权限声明）
+cd server && pnpm start:dev   # 后端，端口 8000（优先读 server/.env.local）
+cd web && pnpm dev            # 前端，端口 3000（优先读 web/.env.local）
+cd server && pnpm seed        # 执行 seed（页面/资源/权限声明）
 ```
 
 ## 架构概览
@@ -69,7 +69,7 @@ server/src/
   - 只改 ui 配置文件 → 执行 `gadmin2 g prisma`
 - 修改 `config/prisma/` 后必须同步检查 `server/seed/`：
   - raw SQL 引用的列/表、seed 数据的必填字段与字段名要与新 schema 一致
-  - 改完需要提醒开发者 `yarn seed` 验证
+  - 改完需要提醒开发者 `pnpm seed` 验证
 - **优先使用 skill 解决问题**，具体走哪条路径见下方「项目改动路径决策」
 
 ### 代码修改范围

package/dist/lib/application/files/gadmin2-game-angle-demo/Dockerfile.codegen

@@ -8,7 +8,8 @@
 # 本镜像不会被推送到 registry，仅在 Jenkins agent 本地 docker daemon 中存活，
 # 流水线末尾会清理。
 
-FROM node:20-alpine
+# pin 到 22：pnpm 11 要求 node >= 22.13（见 server/package.json engines）
+FROM node:22-alpine
 
 WORKDIR /app
 
@@ -18,18 +19,24 @@ RUN apk add --no-cache openssl
 # 禁止 husky 在无 .git 环境下报错
 ENV HUSKY=0
 
-# 配置腾讯软件源
-RUN yarn config set registry https://mirrors.cloud.tencent.com/npm/
+# 腾讯软件源：npm_config_registry 对 npm 与 pnpm 均生效（server/.npmrc 亦含 registry，
+# 但全局安装 gadmin2 CLI 发生在 COPY .npmrc 之前，需要环境变量兜底）
+ENV npm_config_registry=https://mirrors.cloud.tencent.com/npm/
 
-# 安装 gadmin2 CLI
-RUN yarn global add @gadmin2n/cli@latest
+# 启用 corepack 并激活 server/package.json packageManager 字段指定的 pnpm 版本
+RUN corepack enable && corepack install --global pnpm@11.23.0
+
+# 安装 gadmin2 CLI（全局工具，用镜像自带 npm 即可，避免配置 pnpm global bin 路径）
+RUN npm i -g @gadmin2n/cli@latest
 
 # 先复制 server 依赖描述文件，源码未变时此层 layer cache 可复用
-# （prisma generators 是 server 的 devDependencies，必须先 yarn install）
-COPY server/package.json server/yarn.lock ./server/
+# （prisma generators 是 server 的 devDependencies，必须先 pnpm install）
+COPY server/package.json server/pnpm-lock.yaml server/pnpm-workspace.yaml server/.npmrc ./server/
 
-RUN --mount=type=cache,target=/root/.yarn \
-    cd server && yarn install --frozen-lockfile
+# 显式指定 store 路径：默认路径随 HOME 变化，写死才能让下方 cache mount 生效
+ENV PNPM_STORE_DIR=/pnpm/store
+RUN --mount=type=cache,target=/pnpm/store \
+    cd server && pnpm install --frozen-lockfile
 
 # 复制全部 codegen 输入：上层 config/、server/（含 schema.prisma 与 gadmin-cli.json）、web/
 COPY config/ ./config/

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

@@ -2,13 +2,14 @@
 #
 # 通过 ARG CODEGEN_IMAGE + FROM ${CODEGEN_IMAGE} 引用 Jenkins 流水线先行构建的 codegen 镜像。
 # 直接 COPY --from=gen /app/server，复用 codegen 已经装好的 server/node_modules
-# （含 prisma client 与 gadmin2 generators），避免重复 yarn install。
+# （含 prisma client 与 gadmin2 generators），避免重复 pnpm install。
 
 ARG CODEGEN_IMAGE
 FROM ${CODEGEN_IMAGE} AS gen
 
 # ─── 阶段 1：构建 ────────────────────────────────────────────
-FROM node:20-alpine AS builder
+# pin 到 22：pnpm 11 要求 node >= 22.13（见 server/package.json engines）
+FROM node:22-alpine AS builder
 
 WORKDIR /app
 
@@ -18,14 +19,17 @@ RUN apk add --no-cache openssl
 # 禁止 husky 在无 .git 环境下报错
 ENV HUSKY=0
 
+# 启用 corepack 并激活 server/package.json packageManager 字段指定的 pnpm 版本
+RUN corepack enable && corepack install --global pnpm@11.23.0
+
 # 从 codegen 镜像取完整 server/（含已生成代码 + 已安装的 node_modules）
 COPY --from=gen /app/server ./server
 
 # 编译
-RUN cd server && yarn build
+RUN cd server && pnpm build
 
 # ─── 阶段 2：运行 ────────────────────────────────────────────
-FROM node:20-alpine AS runner
+FROM node:22-alpine AS runner
 
 # Prisma 运行时需要 openssl；中国项目默认时区上海
 RUN apk add --no-cache openssl tzdata && \
@@ -41,17 +45,21 @@ STOPSIGNAL SIGQUIT
 ENV HUSKY=0 \
     NODE_ENV=production
 
+# 启用 corepack 并激活 server/package.json packageManager 字段指定的 pnpm 版本
+RUN corepack enable && corepack install --global pnpm@11.23.0
+
 # 从 builder 复制依赖描述文件（其源头是 codegen 镜像）
-COPY --from=builder --chown=node:node /app/server/package.json /app/server/yarn.lock ./
+COPY --from=builder --chown=node:node /app/server/package.json /app/server/pnpm-lock.yaml /app/server/pnpm-workspace.yaml /app/server/.npmrc ./
 
-# 注意：这里不能用 `yarn install --production`。
+# 注意：这里不能用 `pnpm install --prod`。
 # start-prod.sh 启动时需要：
-#   - prisma CLI（运行 `yarn migrate:deploy`）
-#   - ts-node + dotenv-cli（运行 `yarn seed`）
-# 这三者在 package.json 中位于 devDependencies，--production 会跳过它们。
+#   - prisma CLI（运行 `pnpm migrate:deploy`）
+#   - ts-node + dotenv-cli（运行 `pnpm seed`）
+# 这三者在 package.json 中位于 devDependencies，--prod 会跳过它们。
 # 故安装全量依赖；产物体积增加约 80MB，换来启动脚本统一可用。
-RUN --mount=type=cache,target=/root/.yarn \
-    yarn install --frozen-lockfile
+ENV PNPM_STORE_DIR=/pnpm/store
+RUN --mount=type=cache,target=/pnpm/store \
+    pnpm install --frozen-lockfile
 
 # 从构建阶段复制 Prisma 生成的 Client（含平台原生二进制）
 COPY --from=builder --chown=node:node /app/server/node_modules/.prisma ./node_modules/.prisma
@@ -62,7 +70,7 @@ COPY --from=builder --chown=node:node /app/server/dist ./dist
 # 复制 Prisma schema（feature 分支部署时 prisma db push 需要）
 COPY --from=builder --chown=node:node /app/server/prisma ./prisma
 
-# 复制 seed 源码与其依赖的 scripts/lib（启动时 `yarn seed` 走 ts-node 直接执行 .ts）
+# 复制 seed 源码与其依赖的 scripts/lib（启动时 `pnpm seed` 走 ts-node 直接执行 .ts）
 COPY --from=builder --chown=node:node /app/server/seed ./seed
 COPY --from=builder --chown=node:node /app/server/scripts ./scripts
 COPY --from=builder --chown=node:node /app/server/tsconfig.json ./tsconfig.json
@@ -87,4 +95,4 @@ EXPOSE 8000
 HEALTHCHECK --interval=30s --timeout=5s --start-period=30s --retries=3 \
     CMD wget -qO- http://127.0.0.1:8000/health/live || exit 1
 
-CMD ["yarn", "start:prod"]
+CMD ["pnpm", "start:prod"]

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

@@ -11,25 +11,26 @@ ARG CODEGEN_IMAGE
 FROM ${CODEGEN_IMAGE} AS gen
 
 # ─── 阶段 1：构建 ────────────────────────────────────────────
-FROM node:20-alpine AS builder
+# pin 到 22：pnpm 11 要求 node >= 22.13（见 web/package.json engines）
+FROM node:22-alpine AS builder
 
 WORKDIR /app
 
 # 禁止 husky 在无 .git 环境下报错
 ENV HUSKY=0
 
-# 配置腾讯软件源
-RUN yarn config set registry https://mirrors.cloud.tencent.com/npm/
+# 启用 corepack 并激活 web/package.json packageManager 字段指定的 pnpm 版本
+RUN corepack enable && corepack install --global pnpm@11.23.0
 
-# 从 codegen 镜像取完整 web/（含生成代码、不含 node_modules）
-COPY --from=gen /app/web ./web
+# 显式指定 store 路径：默认路径随 HOME 变化，写死才能让下方 cache mount 生效
+ENV PNPM_STORE_DIR=/pnpm/store
 
-# 移除 yarn.lock 中的 resolved 地址，强制使用新的 registry
-RUN sed -i 's|https://registry.npmmirror.com/|https://mirrors.cloud.tencent.com/npm/|g' web/yarn.lock
+# 从 codegen 镜像取完整 web/（含生成代码、不含 node_modules；registry 由 web/.npmrc 提供）
+COPY --from=gen /app/web ./web
 
 # 安装依赖
-RUN --mount=type=cache,target=/root/.yarn \
-    cd web && yarn install --frozen-lockfile
+RUN --mount=type=cache,target=/pnpm/store \
+    cd web && pnpm install --frozen-lockfile
 
 # 声明构建参数
 ARG NODE_ENV=production
@@ -38,8 +39,7 @@ ARG DEPLOY_NAME
 ENV VITE_DEPLOY_NAME=${DEPLOY_NAME}
 
 # 编译
-RUN --mount=type=cache,target=/root/.yarn \
-    cd web && yarn build --mode ${NODE_ENV}
+RUN cd web && pnpm build --mode ${NODE_ENV}
 
 # ─── 阶段 2：运行 ────────────────────────────────────────────
 FROM nginx:alpine

package/dist/lib/application/files/gadmin2-game-angle-demo/Jenkinsfile

@@ -88,7 +88,7 @@ pipeline {
               // 路径触发规则：
               //   web/**            → web
               //   config/ui/**      → web（前端 CRUD 代码由 config/ui 生成）
-              //   config/prisma/**  → server + web（后端模型由 prisma 生成；前端 enums 通过 yarn sync:code 与后端同步）
+              //   config/prisma/**  → server + web（后端模型由 prisma 生成；前端 enums 通过 pnpm sync:code 与后端同步）
               //   server/**         → server
               buildWeb    = matches(nonDoc, 'web/') || matches(nonDoc, 'config/ui/') || matches(nonDoc, 'config/prisma/')
               buildServer = matches(nonDoc, 'server/') || matches(nonDoc, 'config/prisma/')

package/dist/lib/application/files/gadmin2-game-angle-demo/PRODUCT.md

@@ -61,7 +61,7 @@ gadmin2 是一个低代码生成工具：给它一份 Prisma schema + 一份 UI
 1. **数据优先于装饰** — 任何屏幕，先问「数据看清楚了吗」，再问「漂亮吗」。删掉一个分隔线、一个图标、一段说明文字而页面没有变难用，就该删。
 2. **冷静的信息密度** — 同屏可以塞很多东西，但不能让人焦虑。靠间距节奏、字重对比和层级排布承载密度，不靠颜色或边框。Cards 是惰性答案，能用一条横分隔线解决就别套卡片。
 3. **靠清晰建立信任** — 标签、错误信息、空状态、操作确认都用直白可执行的句子。不写「Oops!」「出了点小问题」之类粉饰；写「保存失败：第 3 行的 `email` 格式不合法」。
-4. **配置即设计** — 因为页面由 prisma + ui 配置生成，所有视觉规范必须沉淀到 token、组件和默认值里，让一个新模型 `yarn generate` 出来就已经是合格的页面，工程师不需要写任何 CSS。
+4. **配置即设计** — 因为页面由 prisma + ui 配置生成，所有视觉规范必须沉淀到 token、组件和默认值里，让一个新模型 `pnpm generate` 出来就已经是合格的页面，工程师不需要写任何 CSS。
 5. **保留专家流速** — 内部用户每天要重复几百次同样的操作。键盘快捷键、批量选择、复制 ID、可分享链接的过滤状态、自动聚焦的输入框，都比「视觉打磨」优先级更高。任何「为新人友好」的改动都不能减慢老用户。
 
 ## Accessibility & Inclusion

package/dist/lib/application/files/gadmin2-game-angle-demo/compose-ctl.sh

@@ -189,7 +189,7 @@ print_post_up_guide() {
   清空数据回到种子状态     ./compose-ctl.sh --reset
 
 提示:
-  · 前端开发请用 cd web && yarn dev (本 compose 的 web 是 nginx 静态镜像，无热更新)
+  · 前端开发请用 cd web && pnpm dev (本 compose 的 web 是 nginx 静态镜像，无热更新)
   · server-init 是一次性容器，跑完 migrate:deploy + seed 后退出 (Exited 0) 是正常的
 EOF
 }

package/dist/lib/application/files/gadmin2-game-angle-demo/docker-compose.yml

@@ -36,7 +36,7 @@
 # 首次使用先跑 `bash dev/register-tenant.sh` 注册本项目为租户。
 #
 # 提示：
-#   - web 是生产 nginx 镜像，不支持热更新；前端开发请直接 `cd web && yarn dev`
+#   - web 是生产 nginx 镜像，不支持热更新；前端开发请直接 `cd web && pnpm dev`
 # =============================================================================
 
 services:
@@ -116,9 +116,9 @@ services:
       - |
         set -e
         echo "[server-init] migrate deploy ..."
-        yarn migrate:deploy
+        pnpm migrate:deploy
         echo "[server-init] seed ..."
-        yarn seed
+        pnpm seed
         echo "[server-init] done."
 
   # ---------------------------------------------------------------------------
@@ -153,7 +153,7 @@ services:
   # ---------------------------------------------------------------------------
   # Web 前端（生产 nginx 镜像；本地仅用于完整集成验证）
   # 镜像构建依赖 codegen：先 `docker compose --profile codegen build codegen`
-  # 开发态请用 `cd web && yarn dev`，热更新更顺手
+  # 开发态请用 `cd web && pnpm dev`，热更新更顺手
   # ---------------------------------------------------------------------------
   web:
     image: ${COMPOSE_PROJECT_NAME}-web:local

package/dist/lib/application/files/gadmin2-game-angle-demo/readme.md

@@ -6,7 +6,7 @@ The gadmin2 CLI is a command-line interface tool that helps you to initialize, d
 
 ## Installation
 ```
-$ yarn global add @gadmin2n/cli@latest
+$ npm i -g @gadmin2n/cli@latest
 ```
 Check CLI version
 ```
@@ -33,15 +33,15 @@ $ gadmin2 g prisma:dev  # 生成 CRUD 代码 + 创建并应用迁移（内部调
 ### Start web DevServer
 ```
 $ cd web
-$ yarn #run once if dependancies installed failed
-$ yarn dev
+$ pnpm install #run once if dependancies installed failed
+$ pnpm dev
 ```
 
 ### Start server(nestjs) DevServer
 ```
 $ cd server
-$ yarn #run once if dependancies installed failed
-$ yarn start:dev
+$ pnpm install #run once if dependancies installed failed
+$ pnpm start:dev
 ```
 About nestjs server [read more](https://ptc.coding.intlgame.com/p/gadmin2/d/schematics/git/tree/master/src/lib/application/files/server/nest/README.md)
 
@@ -68,9 +68,9 @@ About nestjs server [read more](https://ptc.coding.intlgame.com/p/gadmin2/d/sche
 | 环境 | 允许的迁移命令 |
 |------|------|
 | 本地开发（各自本地库） | `gadmin2 g prisma:dev` |
-| 共享测试 / 生产库 | 仅 `yarn migrate:deploy` |
+| 共享测试 / 生产库 | 仅 `pnpm migrate:deploy` |
 
-### 命令详解：`gadmin2 g prisma:dev` vs `yarn migrate:deploy`
+### 命令详解：`gadmin2 g prisma:dev` vs `pnpm migrate:deploy`
 
 **`gadmin2 g prisma:dev`（内部调 `migrate:dev` = `prisma migrate dev --name auto`）**
 
@@ -86,7 +86,7 @@ About nestjs server [read more](https://ptc.coding.intlgame.com/p/gadmin2/d/sche
 - 检测到**漂移（drift）**（本地库和迁移历史对不上，如曾手动 `db push` 改过表）时，会**交互式提示重置数据库（drop 重建）**。纯拉取+应用别人迁移通常不触发；本地库被改脏才会。遇到时看清提示再决定，别盲目回车。
 - 因为会改本地库且交互，**绝不能对共享/生产库运行**。
 
-**`yarn migrate:deploy`（= `prisma migrate deploy`）**
+**`pnpm migrate:deploy`（= `prisma migrate deploy`）**
 
 - **只回放 pending 迁移，从不生成迁移、从不删数据、无交互**，也不会因 drift 提示 reset。
 - **不重新生成后端 CRUD 代码**——若拉下来的变更带了新表/新字段需要 module 代码，还得再跑 `gadmin2 g prisma`（只生成代码、不碰库）。
@@ -97,14 +97,14 @@ About nestjs server [read more](https://ptc.coding.intlgame.com/p/gadmin2/d/sche
 | 我的情况 | 用哪条 |
 |------|------|
 | 本地开发，且/或自己也改了 schema，要生成代码 | `gadmin2 g prisma:dev` |
-| 本地开发，确定自己没改 schema，只想安全应用别人迁移 | `yarn migrate:deploy`（如需代码再 `gadmin2 g prisma`） |
-| 共享测试 / 生产库 | 只能 `yarn migrate:deploy` |
+| 本地开发，确定自己没改 schema，只想安全应用别人迁移 | `pnpm migrate:deploy`（如需代码再 `gadmin2 g prisma`） |
+| 共享测试 / 生产库 | 只能 `pnpm migrate:deploy` |
 
 ### 日常开发流
 
 ```
 1. 改 config/prisma/{module}.prisma                       # 唯一手写处
-2. yarn migrate:create                                # 只生成迁移文件，不应用
+2. pnpm migrate:create                                # 只生成迁移文件，不应用
 3. 审查 server/prisma/migrations/xxx/migration.sql        # 重点看 DROP / 改列类型 / NOT NULL
 4. gadmin2 g prisma:dev                                    # 生成 CRUD 代码 + 应用迁移到本地库
 5. 提交 config/prisma/* + server/prisma/migrations/* + web/src/routes/*
@@ -119,7 +119,7 @@ About nestjs server [read more](https://ptc.coding.intlgame.com/p/gadmin2/d/sche
 - 含 `config/prisma/*` 或新迁移 → 运行 `gadmin2 g prisma:dev`（应用新迁移 + 重新生成后端代码）
 - 仅含 `config/ui/*` → 运行 `gadmin2 g prisma`（只重新生成前端代码）
 
-hook 只提示、不自动执行（`migrate:dev` 会改本地库且交互，不宜静默跑）；需先在项目根跑过一次 `yarn`（触发 `husky install`）hook 才生效。
+hook 只提示、不自动执行（`migrate:dev` 会改本地库且交互，不宜静默跑）；需先在项目根在 web 或 server 跑过一次 `pnpm install`（触发 `husky install`）hook 才生效。
 
 ### 首次接入迁移（baseline）
 
@@ -129,7 +129,7 @@ hook 只提示、不自动执行（`migrate:dev` 会改本地库且交互，不
 |------|:---:|:---:|------|
 | 已有本地库（db push 建的） | ❌ 文件已入库 | ✅ 必须一次 | 正常 `gadmin2 g prisma:dev` |
 | 新环境 / 空库 | ❌ | ❌ 不需要 | 直接 `gadmin2 g prisma:dev` 建全表 |
-| 共享测试/生产库（现存非空） | ❌ | ✅ 首次一次 | 之后 `yarn migrate:deploy` |
+| 共享测试/生产库（现存非空） | ❌ | ✅ 首次一次 | 之后 `pnpm migrate:deploy` |
 
 resolve 命令（在 `server/` 下执行，注意用本地 `dotenv-cli` 以避免命中全局 python-dotenv）：
 
@@ -149,7 +149,7 @@ npx dotenv -e .env.local -e .env -- bash -c 'psql "${DATABASE_URL%%\?*}" -c "DEL
 
 ### 迁移冲突约定
 
-两人各自基于同一父迁移生成迁移，合并后顺序会乱。约定：schema 改动**小步快合**；合并遇到迁移冲突时，**后合并者删掉自己的迁移文件、rebase 后重新 `yarn migrate:create`**，不要手改文件名时间戳。
+两人各自基于同一父迁移生成迁移，合并后顺序会乱。约定：schema 改动**小步快合**；合并遇到迁移冲突时，**后合并者删掉自己的迁移文件、rebase 后重新 `pnpm migrate:create`**，不要手改文件名时间戳。
 
 ## 构建与部署
 
@@ -191,7 +191,7 @@ docker compose up -d --build
 
 详细使用与端口分配见 `docker-compose.md`。
 
-> 注：开发态 web/server 推荐直接 `yarn dev` / `yarn start:dev`（见 Usage 章节），`docker compose` 是用于完整集成验证。
+> 注：开发态 web/server 推荐直接 `pnpm dev` / `pnpm start:dev`（见 Usage 章节），`docker compose` 是用于完整集成验证。
 
 ### CI/CD 流水线
 
@@ -249,8 +249,8 @@ post.always: 清理本地 codegen 中间镜像
         │          • CREATE DATABASE temporal_visibility
         │
         ├── server-init（一次性容器，depends_on postgres healthy）
-        │    • yarn migrate:deploy    （prisma 把 schema 推到 gadmin_demo）
-        │    • yarn seed       （播种 RBAC 等基础数据，跑完即退出 Exited 0）
+        │    • pnpm migrate:deploy    （prisma 把 schema 推到 gadmin_demo）
+        │    • pnpm seed       （播种 RBAC 等基础数据，跑完即退出 Exited 0）
         │
         └── server / web / temporal-* （正常服务）
 ```
@@ -278,13 +278,13 @@ container start
         │   │
         │   ├─ A. 临时环境（feature*/bugfix*/hotfix*）：每次启动都重建分支 schema
         │   │    • 改写 DATABASE_URL：schema=<DEPLOY_NAME>（- 与 / 替换为 _）
-        │   │    • yarn migrate:deploy
+        │   │    • pnpm migrate:deploy
         │   │    • node migrate-between-pg-schemas.js   （从 public schema 拷数据到分支 schema）
-        │   │    • yarn seed                            （幂等，每次启动都跑）
+        │   │    • pnpm seed                            （幂等，每次启动都跑）
         │   │
         │   └─ B. 非临时环境（默认 / production）：按需初始化
         │        • DATABASE_URL 兜底 schema=public
-        │        • 探测 t_role：不存在或 count=0 → yarn migrate:deploy + yarn seed；否则跳过
+        │        • 探测 t_role：不存在或 count=0 → pnpm migrate:deploy + pnpm seed；否则跳过
         │        • 连接失败等异常 → 保守走初始化路径
         │
         └── exec node dist/src/main                  ← 启动 NestJS
@@ -301,8 +301,8 @@ container start
 | 对象 | 本地 compose | 生产 / 临时环境 |
 |---|---|---|
 | 数据库（`gadmin_demo`） | `dev/postgres/init.sql`（pgdata 卷为空时） | `ensure-database.js`（每次启动幂等） |
-| Schema + 表结构 | `server-init` 里 `yarn migrate:deploy` | `start-prod.sh` 按分支策略 `yarn migrate:deploy` |
-| 基础数据（seed） | `server-init` 里 `yarn seed` | `start-prod.sh` 按分支策略 `yarn seed` |
+| Schema + 表结构 | `server-init` 里 `pnpm migrate:deploy` | `start-prod.sh` 按分支策略 `pnpm migrate:deploy` |
+| 基础数据（seed） | `server-init` 里 `pnpm seed` | `start-prod.sh` 按分支策略 `pnpm seed` |
 | 临时环境 schema 隔离 | — | `start-prod.sh` 改写 DATABASE_URL + `migrate-between-pg-schemas.js` |
 
 ## Template Sync

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

@@ -0,0 +1,13 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 80,
+  "sortPackageJson": false,
+  "ignorePatterns": [
+    "src/**/*.enum.ts",
+    "src/generated/**",
+    "dist/**",
+    "node_modules/**"
+  ]
+}

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

@@ -0,0 +1,17 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["typescript"],
+  "categories": {
+    "correctness": "warn"
+  },
+  "rules": {
+    "typescript/no-explicit-any": "off",
+    "no-empty-function": "warn"
+  },
+  "ignorePatterns": [
+    "dist/**",
+    "node_modules/**",
+    "src/generated/**",
+    "src/**/*.enum.ts"
+  ]
+}

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

@@ -8,7 +8,8 @@
   "scripts": {
     "prebuild": "rimraf dist",
     "build": "nest build -c gadmin-cli.json",
-    "format": "prettier --write \"../config/*.ts\" \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format": "oxfmt src test",
+    "format:check": "oxfmt src test --check",
     "prepare": "cd .. && husky install || true",
     "start": "dotenv -e .env.local -e .env  -- nest start -c gadmin-cli.json",
     "start:dev": "dotenv -e .env.local -e .env  -- nest start -c gadmin-cli.json --watch",
@@ -17,7 +18,8 @@
     "start:debug": "dotenv -e .env.local -e .env  -- nest start -c gadmin-cli.json --debug --watch",
     "start:prod": "/bin/sh start-prod.sh",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "lint": "oxlint src test",
+    "lint:fix": "oxlint src test --fix",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:cov": "jest --coverage",
@@ -28,7 +30,7 @@
     "migrate:deploy": "dotenv -e .env.local -e .env  -- prisma migrate deploy",
     "migrate:status": "dotenv -e .env.local -e .env  -- prisma migrate status",
     "generate": "dotenv -e .env.local -e .env  -- npx prisma generate",
-    "generate:dev": "npm run migrate:dev",
+    "generate:dev": "pnpm migrate:dev",
     "postgenerate:dev": "dotenv -e .env.local -e .env  -- ts-node seed/data-mngt.seed.ts",
     "postgadminGenerate": "node scripts/notify-dev-servers.js",
     "push:db": "dotenv -e .env.local -e .env  -- prisma db push --skip-generate",
@@ -69,8 +71,8 @@
     "cache-manager": "^6.4.3",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.13.2",
-    "cron-parser": "^5.0.0",
     "cookie-parser": "^1.4.6",
+    "cron-parser": "^5.0.0",
     "crypto-js": "^4.2.0",
     "csvtojson": "^2.0.10",
     "dayjs": "^1.10.7",
@@ -108,18 +110,13 @@
     "@types/multer": "^1.4.7",
     "@types/node": "^16.0.0",
     "@types/supertest": "^2.0.11",
-    "@typescript-eslint/eslint-plugin": "^5.0.0",
-    "@typescript-eslint/parser": "^5.0.0",
     "concurrently": "^9.1.0",
-    "eslint": "^8.0.1",
-    "eslint-config-prettier": "^8.3.0",
-    "eslint-plugin-prettier": "^4.0.0",
     "husky": "^8.0.0",
     "jest": "^29.0.0",
     "lint-staged": "^13.0.0",
     "nodemon": "^3.1.7",
-    "prettier": "^2.3.2",
-    "prettier-plugin-organize-imports": "^3.0.3",
+    "oxfmt": "^0.68.0",
+    "oxlint": "^1.83.0",
     "prisma-dbml-generator": "^0.9.1",
     "source-map-support": "^0.5.20",
     "supertest": "^6.1.3",
@@ -149,10 +146,14 @@
   "_moduleAliases": {
     "@": "src"
   },
+  "packageManager": "pnpm@11.23.0",
+  "engines": {
+    "node": ">=22.13"
+  },
   "prisma": {
-    "seed": "yarn seed"
+    "seed": "pnpm seed"
   },
   "lint-staged": {
-    "**/*.{ts,tsx}": "prettier --write"
+    "**/*.{ts,tsx}": "oxfmt"
   }
 }

package/dist/lib/application/files/gadmin2-game-angle-demo/server/pnpm-workspace.yaml

@@ -0,0 +1,23 @@
+# pnpm 11 起，原先放在 package.json "pnpm" 字段的设置迁移至此文件。
+# 本项目非 monorepo，此文件仅用于承载 pnpm 设置。
+
+# gadmin2 CLI 与 nestjs-prisma 等工具按 yarn 扁平布局硬编码路径
+# （如 server/node_modules/.prisma/client/index.d.ts），
+# pnpm 默认的 isolated 布局会破坏它们，故使用 hoisted 模式（等价 yarn 扁平 node_modules）。
+nodeLinker: hoisted
+
+# 依赖的构建脚本默认被禁止执行（供应链安全考虑），需在此逐个放行。
+allowBuilds:
+  # 必须放行：postinstall 负责下载/生成 Prisma 引擎与 Client，缺失则无法启动
+  prisma: true
+  '@prisma/client': true
+  '@prisma/engines': true
+  # nest build 使用的 SWC 原生二进制
+  '@swc/core': true
+  # esbuild（nest cli / ts-node 链路）原生二进制下载
+  esbuild: true
+  # temporal 链路依赖，postinstall 做 cli codegen 自检
+  protobufjs: true
+  # 以下脚本仅打印捐赠/统计信息，与产物无关，保持禁止
+  '@nestjs/core': false
+  '@scarf/scarf': false

package/dist/lib/application/files/gadmin2-game-angle-demo/server/src/lib/auth.guard.ts

@@ -97,7 +97,10 @@ async function issueGAdminTokenCookie(res, user: UserType) {
 
 @Injectable()
 export default class AuthGuard implements CanActivate {
-  constructor(private reflector: Reflector, private userService: UserService) {}
+  constructor(
+    private reflector: Reflector,
+    private userService: UserService,
+  ) {}
 
   private async getApikeyIdentity(req): Promise<UserType> {
     const apiKey = req.headers['x-api-key'] ?? req.query.api_key;

package/dist/lib/application/files/gadmin2-game-angle-demo/server/src/lib/structured-all-exceptions.filter.ts

@@ -56,8 +56,8 @@ export class StructuredAllExceptionsFilter implements ExceptionFilter {
         typeof payload === 'string'
           ? payload
           : statusCode === HttpStatus.INTERNAL_SERVER_ERROR
-          ? 'Internal server error.'
-          : controlled?.message ?? error,
+            ? 'Internal server error.'
+            : (controlled?.message ?? error),
       error,
       path,
     });

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

@@ -58,12 +58,10 @@ class PrismaDbSpanProcessor implements SpanProcessor {
       mutableSpan.attributes['db.name'] = dbInfo.name;
       mutableSpan.attributes['db.instance'] = dbInfo.name;
       mutableSpan.attributes['db.ip'] = dbInfo.host;
-      mutableSpan.attributes[
-        'peer.service'
-      ] = `${dbInfo.name}@${dbInfo.host}:${dbInfo.port}`;
-      mutableSpan.attributes[
-        'peer.filled'
-      ] = `${dbInfo.name}@${dbInfo.host}:${dbInfo.port}`;
+      mutableSpan.attributes['peer.service'] =
+        `${dbInfo.name}@${dbInfo.host}:${dbInfo.port}`;
+      mutableSpan.attributes['peer.filled'] =
+        `${dbInfo.name}@${dbInfo.host}:${dbInfo.port}`;
     }
     this.inner.onEnd(span);
   }

package/dist/lib/application/files/gadmin2-game-angle-demo/server/src/modules/agenda/agenda.service.ts

@@ -440,8 +440,8 @@ export class AgendaService
       ? toggle === 'active'
         ? stateFiltered.filter((j) => !j.disabled)
         : toggle === 'paused'
-        ? stateFiltered.filter((j) => j.disabled)
-        : stateFiltered
+          ? stateFiltered.filter((j) => j.disabled)
+          : stateFiltered
       : stateFiltered;
 
     const total = toggleFiltered.length;

package/dist/lib/application/files/gadmin2-game-angle-demo/server/src/modules/audit/audit.controller.ts

@@ -130,7 +130,7 @@ export class AuditController {
     @Body() body: UpdateAuditDto,
     @ACAttrFilter() acAttrFilter,
   ) {
-    /* 
+    /*
     const origin = (await this.auditService.findUnique(id, {
       id: true,
       // 这里需要根据实际情况填写

package/dist/lib/application/files/gadmin2-game-angle-demo/server/src/modules/codeRuntime/code-runtime.controller.ts

@@ -61,12 +61,12 @@ export class CodeRuntimeController {
       node?.runtimeKey === 'code' && !input.configKey
         ? node.config
         : node?.runtimeKey === 'human_approval' &&
-          input.configKey === 'creationResult'
-        ? node.config.external?.creationResult
-        : node?.runtimeKey === 'human_approval' &&
-          input.configKey === 'approverLookupResult'
-        ? dynamicSubject?.lookup?.result
-        : undefined;
+            input.configKey === 'creationResult'
+          ? node.config.external?.creationResult
+          : node?.runtimeKey === 'human_approval' &&
+              input.configKey === 'approverLookupResult'
+            ? dynamicSubject?.lookup?.result
+            : undefined;
     if (
       !version ||
       version.workflowId !== instance.workflowId ||

package/dist/lib/application/files/gadmin2-game-angle-demo/server/src/modules/game/game.controller.ts

@@ -128,7 +128,7 @@ export class GameController {
     @Body() body: UpdateGameDto,
     @ACAttrFilter() acAttrFilter,
   ) {
-    /* 
+    /*
     const origin = (await this.gameService.findUnique(id, {
       id: true,
       // 这里需要根据实际情况填写