@gadmin2n/schematics 0.0.135 → 0.0.137

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

@@ -46,7 +46,7 @@ COPY --from=builder --chown=node:node /app/server/package.json /app/server/yarn.
 
 # 注意：这里不能用 `yarn install --production`。
 # start-prod.sh 启动时需要：
-#   - prisma CLI（运行 `yarn push:db`）
+#   - prisma CLI（运行 `yarn migrate:deploy`）
 #   - ts-node + dotenv-cli（运行 `yarn seed`）
 # 这三者在 package.json 中位于 devDependencies，--production 会跳过它们。
 # 故安装全量依赖；产物体积增加约 80MB，换来启动脚本统一可用。
@@ -74,7 +74,7 @@ RUN chmod +x start-prod.sh
 # 复制环境变量配置（作为默认值，K8s 注入的同名变量优先级更高）
 COPY --from=builder --chown=node:node /app/server/.env ./.env
 
-# package.json 的 push:db / seed 都走 `dotenv -e .env.local -e .env -- ...`，
+# package.json 的 migrate:deploy / seed 都走 `dotenv -e .env.local -e .env -- ...`，
 # dotenv-cli v7 在指定文件不存在时会报错；镜像里没有 .env.local，touch 空文件兜底。
 RUN touch .env.local && chown node:node .env.local
 

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

@@ -190,7 +190,7 @@ print_post_up_guide() {
 
 提示:
   · 前端开发请用 cd web && yarn dev (本 compose 的 web 是 nginx 静态镜像，无热更新)
-  · server-init 是一次性容器，跑完 push:db + seed 后退出 (Exited 0) 是正常的
+  · server-init 是一次性容器，跑完 migrate:deploy + seed 后退出 (Exited 0) 是正常的
 EOF
 }
 

package/dist/lib/application/files/gadmin2-game-angle-demo/config/prisma/canvas.prisma

@@ -3,6 +3,7 @@
 /// @IgnoreAutoField
 model Canvas {
   id                String    @id @default(cuid())
+  code              String    @unique @default(nanoid()) @db.VarChar(21) @map("code")
   name              String    @db.VarChar(255)
   userId            String    @db.VarChar(255) @map("user_id")
   items             Json      @default("[]")

package/dist/lib/application/files/gadmin2-game-angle-demo/config/prisma/workflow.prisma

@@ -99,9 +99,9 @@ model WorkflowInstance {
 model WorkflowNodeExecution {
   id         BigInt                 @id @default(autoincrement())
   instanceId BigInt                 @map("instance_id")
-  nodeId     String                 @db.VarChar(64)   // DSL node.id
-  nodeType   String                 @db.VarChar(64)   // e.g. "http_request"
-  nodeLabel  String?                @db.VarChar(128)  // human-readable label
+  nodeId     String                 @db.VarChar(64) @map("node_id")  // DSL node.id
+  nodeType   String                 @db.VarChar(64) @map("node_type") // e.g. "http_request"
+  nodeLabel  String?                @db.VarChar(128) @map("node_label")  // human-readable label
   status     WorkflowInstanceStatus @default(PENDING)
   input      Json?
   output     Json?
@@ -177,3 +177,14 @@ model WorkflowEventOutbox {
   // （Prisma schema 不支持 WHERE 子句的 partial index）
   @@map("t_workflow_event_outbox")
 }
+
+/// @IgnoreReactCode
+model TemporalTenantConfig {
+  adminUrl    String @db.VarChar(256) @map("admin_url")    // shared temporal admin API URL，e.g. http://localhost:8081
+  adminToken  String @db.VarChar(128) @map("admin_token")  // X-Admin-Token
+  namespace   String @db.VarChar(64)  @map("namespace")    // 租户 namespace，需与 TEMPORAL_NAMESPACE 一致
+  dbUrl       String @db.Text         @map("db_url")       // shared worker 视角的本项目 DB URL
+  displayName String @db.VarChar(128) @map("display_name") // 租户展示名
+
+  @@map("t_temporal_tenant_config")
+}

package/dist/lib/application/files/gadmin2-game-angle-demo/config/ui/User.ts

@@ -18,7 +18,7 @@ export const User: ModelConfig = {
         {
           action: "EXPORT",
           desc: "export",
-          fields: ["*", "!createdAt"],
+          fields: ["*", "!createdAt", "!groupMemberships.*", "!groupMemberships"],
         },
         { action: "INSERT", desc: "Insert" },
       ],
@@ -27,7 +27,7 @@ export const User: ModelConfig = {
       filter: ["roles"],
       sorter: ["id", "roles"],
     },
-    fields: ["*", "!createdAt"],
+    fields: ["*", "!createdAt", "!groupMemberships.*", "!groupMemberships"],
     rowSelection: {
       actions: [
         { action: "DELETE", desc: "Delete" },
@@ -50,7 +50,7 @@ export const User: ModelConfig = {
     },
   },
   form: {
-    fields: ["*", "!creator", "!createdAt", "!updatedAt"],
+    fields: ["*", "!creator", "!createdAt", "!updatedAt", "!groupMemberships.*", "!groupMemberships"],
     reaction: {
       id: {
         toggle: [],
@@ -61,6 +61,6 @@ export const User: ModelConfig = {
     },
   },
   show: {
-    fields: ["*", "!createdAt"],
+    fields: ["*", "!createdAt", "!groupMemberships.*", "!groupMemberships"],
   },
 };

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

@@ -135,7 +135,7 @@ lsof -iTCP:8080 -sTCP:LISTEN
 docker compose logs server-init
 ```
 
-如果状态是 `Exited (1)` 或更高，说明 push:db 或 seed 失败了，server / worker 不会启动。看日志排错后用 `docker compose up -d server-init` 重跑（幂等）。
+如果状态是 `Exited (1)` 或更高，说明 migrate:deploy 或 seed 失败了，server / worker 不会启动。看日志排错后用 `docker compose up -d server-init` 重跑（幂等）。
 
 ### Temporal schema 初始化失败
 
@@ -154,7 +154,7 @@ server 镜像里 `TAIHU_*` 用的是 `server/.env` 默认值，对应太湖测
 ```bash
 ./compose-ctl.sh --reset
 # 等 temporal-server 重新做 schema setup（看日志 `temporal-server` 里出现 "Temporal server started"）
-# server-init 会自动重跑 push:db + seed，业务库回到种子数据状态
+# server-init 会自动重跑 migrate:deploy + seed，业务库回到种子数据状态
 ```
 
 ## 用到的镜像

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

@@ -16,10 +16,10 @@
 #
 # 端口分配（已避免冲突）：
 #   5432  -> PostgreSQL
-#   7233  -> Temporal gRPC（Server）
 #   8000  -> NestJS Server（API）
-#   8080  -> Temporal Web UI
 #   3000  -> Web 前端（nginx，容器内 80）
+# Phase 3 起 gadmin-test 不再内嵌 temporal — TEMPORAL_ADDRESS 指向共享 temporal-shared
+# 部署，见 docs/superpowers/specs/2026-07-14-shared-temporal-phase3-design.md
 #
 # 镜像构建依赖（与 Jenkinsfile 保持一致的方案 C）：
 #   server / web 通过 ARG CODEGEN_IMAGE + FROM ${CODEGEN_IMAGE} 引用本地 codegen 镜像，
@@ -28,12 +28,14 @@
 #
 # 首次启动顺序（depends_on + healthcheck 自动编排）：
 #   1. postgres 起来 → healthy（pg_isready）
-#   2. temporal-server auto-setup 跑 schema 初始化（约 30~60s）→ healthy
-#   3. server / temporal-worker / temporal-ui 起来
+#   2. server-init 跑 migrate:deploy + seed → 退出
+#   3. server 起来
 #   4. web 起来
 #
+# 前置：Phase 3 起 server 需要能连到共享 temporal（TEMPORAL_ADDRESS 必填）；
+# 首次使用先跑 `bash dev/register-tenant.sh` 注册本项目为租户。
+#
 # 提示：
-#   - 仅起 Temporal（不起 web/server/worker）请用 ./temporal/docker-compose.yml
 #   - web 是生产 nginx 镜像，不支持热更新；前端开发请直接 `cd web && yarn dev`
 # =============================================================================
 
@@ -81,68 +83,14 @@ services:
       retries: 10
 
   # ---------------------------------------------------------------------------
-  # Temporal Server (auto-setup)：自动建 schema、起 frontend/history/matching/worker
-  # 不开 ENABLE_ES，visibility 走 PG（与本地联调最小依赖一致）
-  # ---------------------------------------------------------------------------
-  temporal-server:
-    # 生产 Helm chart 1.2.0 捆绑的 Temporal Server 是 1.31.0（见 docs/temporal-server-argocd.md），
-    # 但 Docker Hub 上 temporalio/auto-setup 镜像目前最新只到 1.29.6.1（auto-setup tag 通常滞后于 server）。
-    # 本地联调用最接近的 1.29.6.1 即可，schema 与 1.31.0 兼容。
-    image: temporalio/auto-setup:1.29.6.1
-    container_name: temporal-server
-    restart: unless-stopped
-    depends_on:
-      postgres:
-        condition: service_healthy
-    environment:
-      DB: postgres12
-      DB_PORT: 5432
-      POSTGRES_SEEDS: postgres
-      POSTGRES_USER: ${POSTGRES_USER:-kavenma}
-      POSTGRES_PWD: ${POSTGRES_PASSWORD:-kavenma}
-      DBNAME: temporal
-      VISIBILITY_DBNAME: temporal_visibility
-      DYNAMIC_CONFIG_FILE_PATH: config/dynamicconfig/development-sql.yaml
-      # 显式绑 0.0.0.0：podman rootless CNI 下 server 默认只绑容器主网卡 IP（如 10.89.x.x），
-      # 容器内 127.0.0.1:7233 连不通 → healthcheck 永远 unhealthy → worker 不启动。
-      # 设成 0.0.0.0 后 docker / podman 都可达。
-      BIND_ON_IP: 0.0.0.0
-    volumes:
-      - ./temporal/config:/etc/temporal/config/dynamicconfig
-    ports:
-      - "7233:7233"
-    healthcheck:
-      # auto-setup 镜像自带 temporal CLI；healthcheck 在容器内执行，地址用 127.0.0.1
-      test: ["CMD-SHELL", "temporal operator cluster health --address 127.0.0.1:7233 || exit 1"]
-      interval: 10s
-      timeout: 5s
-      retries: 12
-      start_period: 30s
-
-  # ---------------------------------------------------------------------------
-  # Temporal Web UI
-  # ---------------------------------------------------------------------------
-  temporal-ui:
-    image: temporalio/ui:latest
-    container_name: temporal-ui
-    restart: unless-stopped
-    depends_on:
-      temporal-server:
-        condition: service_started
-    environment:
-      TEMPORAL_ADDRESS: temporal-server:7233
-    ports:
-      - "8080:8080"
-
-  # ---------------------------------------------------------------------------
-  # Server 一次性初始化：prisma db push + seed
+  # Server 一次性初始化：migrate:deploy + seed
   # ---------------------------------------------------------------------------
   # 直接复用 codegen 镜像（它已含 server 全量依赖：ts-node / prisma CLI / seed/ 源码）。
   # 业务 server 镜像走 `--production` 安装、且不复制 seed/，因此 seed 不能在 server
   # 容器里跑；这里独立成 init 容器，跑完即退出。
   #
   # 幂等：
-  #   - prisma db push 多次执行无害（只补 schema 差异）
+  #   - migrate:deploy 多次执行无害（只补 schema 差异）
   #   - seed 全部用 createMany skipDuplicates / upsert 风格，重复跑不会重复插
   #
   # 依赖：
@@ -167,8 +115,8 @@ services:
       - -c
       - |
         set -e
-        echo "[server-init] prisma db push ..."
-        yarn push:db
+        echo "[server-init] migrate deploy ..."
+        yarn migrate:deploy
         echo "[server-init] seed ..."
         yarn seed
         echo "[server-init] done."
@@ -193,42 +141,15 @@ services:
         condition: service_healthy
       server-init:
         condition: service_completed_successfully
-      # 不等 temporal-server healthy：server 启动不强依赖 Temporal
-      temporal-server:
-        condition: service_started
     environment:
       DATABASE_URL: postgresql://${POSTGRES_USER:-kavenma}:${POSTGRES_PASSWORD:-kavenma}@postgres:5432/gadmin_demo?schema=public
-      TEMPORAL_ADDRESS: temporal-server:7233
-      TEMPORAL_NAMESPACE: ${TEMPORAL_NAMESPACE:-default}
+      TEMPORAL_ADDRESS: ${TEMPORAL_ADDRESS:?TEMPORAL_ADDRESS not set — see server/.env}
+      TEMPORAL_NAMESPACE: ${TEMPORAL_NAMESPACE:-gadmin-test}
       TEMPORAL_TASK_QUEUE: ${TEMPORAL_TASK_QUEUE:-workflow-execution}
       NODE_ENV: ${NODE_ENV:-development}
     ports:
       - "8000:8000"
 
-  # ---------------------------------------------------------------------------
-  # Temporal Worker（Node.js 长驻进程）
-  # ---------------------------------------------------------------------------
-  temporal-worker:
-    image: ${COMPOSE_PROJECT_NAME}-temporal-worker:local
-    build:
-      context: ./temporal/worker
-      dockerfile: Dockerfile
-    container_name: gadmin2-temporal-worker
-    restart: on-failure
-    depends_on:
-      postgres:
-        condition: service_healthy
-      server-init:
-        condition: service_completed_successfully
-      temporal-server:
-        condition: service_healthy
-    environment:
-      TEMPORAL_ADDRESS: temporal-server:7233
-      TEMPORAL_NAMESPACE: ${TEMPORAL_NAMESPACE:-default}
-      TEMPORAL_TASK_QUEUE: ${TEMPORAL_TASK_QUEUE:-workflow-execution}
-      DATABASE_URL: postgresql://${POSTGRES_USER:-kavenma}:${POSTGRES_PASSWORD:-kavenma}@postgres:5432/gadmin_demo?schema=public
-    # 无对外端口、无 health endpoint
-
   # ---------------------------------------------------------------------------
   # Web 前端（生产 nginx 镜像；本地仅用于完整集成验证）
   # 镜像构建依赖 codegen：先 `docker compose --profile codegen build codegen`

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

@@ -27,7 +27,7 @@ $ vi config/ui/{ModelName}.ts
 
 ### Generate code after edit config/schema.prisma or config/ui.config.ts
 ```
-$ gadmin2 g prisma:dev  #Run prisma push db first. Command "gadmin2 g prisma" without run "prisma push db"
+$ gadmin2 g prisma:dev  # 生成 CRUD 代码 + 创建并应用迁移（内部调 migrate:dev）；gadmin2 g prisma 只生成代码、不碰数据库
 ```
 
 ### Start web DevServer
@@ -45,6 +45,104 @@ $ yarn 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)
 
+## 数据库迁移（Prisma Migrations）
+
+> Schema 的唯一手写真源是 `config/prisma/*.prisma`。`gadmin2 g prisma:dev` 会据此聚合出 `server/prisma/schema.prisma`、生成后端 CRUD 代码，并调用 `migrate:dev` 创建并应用迁移。
+
+### Git 追踪边界
+
+| 类别 | 路径 | 是否入库 | 谁生成 |
+|------|------|:---:|------|
+| Schema 真源（手改） | `config/prisma/*.prisma` | ✅ | 人 |
+| 迁移文件 | `server/prisma/migrations/` | ✅ | `prisma migrate` |
+| 前端页面 | `web/src/routes/` | ✅ | react 生成器 |
+| 聚合 schema | `server/prisma/schema.prisma` | ❌ | gadmin 聚合 |
+| 后端 CRUD | `server/src/generated/` | ❌ | nestjs 生成器 |
+
+因为 `schema.prisma` 与 `generated/` 不入库，**每次拉取到 schema/迁移变更后都要本地重新生成**（见下方 git hook）。
+
+### 环境规则（重要）
+
+`gadmin2 g prisma:dev` 在检测到漂移时会提示重置数据库，**只能在各自本地库运行**；共享库（测试/生产）一律用 `migrate deploy`（只回放迁移、从不删数据）。
+
+| 环境 | 允许的迁移命令 |
+|------|------|
+| 本地开发（各自本地库） | `gadmin2 g prisma:dev` |
+| 共享测试 / 生产库 | 仅 `yarn migrate:deploy` |
+
+### 命令详解：`gadmin2 g prisma:dev` vs `yarn migrate:deploy`
+
+**`gadmin2 g prisma:dev`（内部调 `migrate:dev` = `prisma migrate dev --name auto`）**
+
+一条命令做四件事，按顺序：
+
+1. 据 `config/prisma/*.prisma` 聚合出 `server/prisma/schema.prisma`，并生成后端 CRUD 代码
+2. 对比迁移目录与数据库 `_prisma_migrations` 表，**按顺序应用所有 pending 迁移**（含刚拉下来的别人的迁移）
+3. 再对比 `schema.prisma` 与迁移历史，**若本地还有未捕获的 schema 改动，则生成一个新迁移并应用**（`--name auto` 自动命名）
+4. 重新生成 Prisma Client
+
+要点：
+- **会生成迁移、会应用、会重新生成代码**——本地开发的主命令。
+- 检测到**漂移（drift）**（本地库和迁移历史对不上，如曾手动 `db push` 改过表）时，会**交互式提示重置数据库（drop 重建）**。纯拉取+应用别人迁移通常不触发；本地库被改脏才会。遇到时看清提示再决定，别盲目回车。
+- 因为会改本地库且交互，**绝不能对共享/生产库运行**。
+
+**`yarn migrate:deploy`（= `prisma migrate deploy`）**
+
+- **只回放 pending 迁移，从不生成迁移、从不删数据、无交互**，也不会因 drift 提示 reset。
+- **不重新生成后端 CRUD 代码**——若拉下来的变更带了新表/新字段需要 module 代码，还得再跑 `gadmin2 g prisma`（只生成代码、不碰库）。
+- 共享测试库、生产库、CI/部署链路（`start-prod.sh`）专用。
+
+**如何选（拉取到别人的新迁移后）**
+
+| 我的情况 | 用哪条 |
+|------|------|
+| 本地开发，且/或自己也改了 schema，要生成代码 | `gadmin2 g prisma:dev` |
+| 本地开发，确定自己没改 schema，只想安全应用别人迁移 | `yarn migrate:deploy`（如需代码再 `gadmin2 g prisma`） |
+| 共享测试 / 生产库 | 只能 `yarn migrate:deploy` |
+
+### 日常开发流
+
+```
+1. 改 config/prisma/{module}.prisma                       # 唯一手写处
+2. yarn 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/*
+```
+
+> 建议第 2、3 步分开：先 `--create-only` 生成、人工审 SQL，再应用，避免误改把线上表 DROP。急活也可跳过直接跑第 4 步（`migrate:dev` 会交互式要迁移名并一步生成+应用）。
+
+### 拉取他人改动后
+
+`.husky/post-merge` 与 `.husky/post-rewrite` 会在 `git pull`（merge）/ `git pull --rebase` 后，检测本次是否含 schema/迁移变更并提示：
+
+- 含 `config/prisma/*` 或新迁移 → 运行 `gadmin2 g prisma:dev`（应用新迁移 + 重新生成后端代码）
+- 仅含 `config/ui/*` → 运行 `gadmin2 g prisma`（只重新生成前端代码）
+
+hook 只提示、不自动执行（`migrate:dev` 会改本地库且交互，不宜静默跑）；需先在项目根跑过一次 `yarn`（触发 `husky install`）hook 才生效。
+
+### 首次接入迁移（baseline）
+
+如果现存库最初由 `db push` 建立、无迁移历史，切换到迁移前需 baseline。`0_init` 为全量基线，已入库。是否要标记「已应用」取决于**本库是否已有表**（这条记录写在数据库 `_prisma_migrations` 表，不随 git 同步，每个库独立）：
+
+| 场景 | 生成 0_init | `migrate resolve --applied 0_init` | 之后 |
+|------|:---:|:---:|------|
+| 已有本地库（db push 建的） | ❌ 文件已入库 | ✅ 必须一次 | 正常 `gadmin2 g prisma:dev` |
+| 新环境 / 空库 | ❌ | ❌ 不需要 | 直接 `gadmin2 g prisma:dev` 建全表 |
+| 共享测试/生产库（现存非空） | ❌ | ✅ 首次一次 | 之后 `yarn migrate:deploy` |
+
+resolve 命令（在 `server/` 下执行，注意用本地 `dotenv-cli` 以避免命中全局 python-dotenv）：
+
+```bash
+$ cd server
+$ ./node_modules/.bin/dotenv -e .env.local -e .env -- npx prisma migrate resolve --applied 0_init
+$ ./node_modules/.bin/dotenv -e .env.local -e .env -- npx prisma migrate status   # 验证：应显示 up to date、无 pending
+```
+
+### 迁移冲突约定
+
+两人各自基于同一父迁移生成迁移，合并后顺序会乱。约定：schema 改动**小步快合**；合并遇到迁移冲突时，**后合并者删掉自己的迁移文件、rebase 后重新 `yarn migrate:create`**，不要手改文件名时间戳。
+
 ## 构建与部署
 
 ### 模块划分
@@ -144,7 +242,7 @@ post.always: 清理本地 codegen 中间镜像
         │          • CREATE DATABASE temporal_visibility
         │
         ├── server-init（一次性容器，depends_on postgres healthy）
-        │    • yarn push:db    （prisma 把 schema 推到 gadmin_demo）
+        │    • yarn migrate:deploy    （prisma 把 schema 推到 gadmin_demo）
         │    • yarn seed       （播种 RBAC 等基础数据，跑完即退出 Exited 0）
         │
         └── server / web / temporal-* （正常服务）
@@ -157,7 +255,7 @@ post.always: 清理本地 codegen 中间镜像
 
 #### 2. 生产 / 临时环境（K8s + `server/start-prod.sh`）
 
-server 镜像的入口是 `start-prod.sh`，比本地 compose 多了「按需 push:db」「per-branch schema 隔离」逻辑：
+server 镜像的入口是 `start-prod.sh`，比本地 compose 多了「按需 migrate:deploy」「per-branch schema 隔离」逻辑：
 
 ```
 container start
@@ -173,13 +271,13 @@ container start
         │   │
         │   ├─ A. 临时环境（feature*/bugfix*/hotfix*）：每次启动都重建分支 schema
         │   │    • 改写 DATABASE_URL：schema=<DEPLOY_NAME>（- 与 / 替换为 _）
-        │   │    • yarn push:db
+        │   │    • yarn migrate:deploy
         │   │    • node migrate-between-pg-schemas.js   （从 public schema 拷数据到分支 schema）
         │   │    • yarn seed                            （幂等，每次启动都跑）
         │   │
         │   └─ B. 非临时环境（默认 / production）：按需初始化
         │        • DATABASE_URL 兜底 schema=public
-        │        • 探测 t_role：不存在或 count=0 → yarn push:db + yarn seed；否则跳过
+        │        • 探测 t_role：不存在或 count=0 → yarn migrate:deploy + yarn seed；否则跳过
         │        • 连接失败等异常 → 保守走初始化路径
         │
         └── exec node dist/src/main                  ← 启动 NestJS
@@ -188,7 +286,7 @@ container start
 要点：
 - `ensure-database.js` 与本地 compose 的 `init.sql` 是**互补关系**：compose 路径走 init.sql，K8s / 外部托管 PG 走 ensure-database.js。重复执行无副作用。
 - 临时环境「每次启动都 seed」依赖所有 seed 实现都是 upsert / skipDuplicates 风格，重复跑不插重。
-- 非临时环境用 `t_role` 行数判断是否需要初始化（首次部署或被清库），避免每次重启都跑 push:db + seed。
+- 非临时环境用 `t_role` 行数判断是否需要初始化（首次部署或被清库），避免每次重启都跑 migrate:deploy + seed。
 - 如果部署环境已通过 DBA / 运维流程保证库存在，可设 `SKIP_ENSURE_DATABASE=1` 跳过 ensure-database.js（预留开关，当前实现未消费该变量，按需扩展）。
 
 #### 3. 谁在何时建什么 — 总览
@@ -196,7 +294,7 @@ container start
 | 对象 | 本地 compose | 生产 / 临时环境 |
 |---|---|---|
 | 数据库（`gadmin_demo`） | `dev/postgres/init.sql`（pgdata 卷为空时） | `ensure-database.js`（每次启动幂等） |
-| Schema + 表结构 | `server-init` 里 `yarn push:db` | `start-prod.sh` 按分支策略 `yarn push:db` |
+| Schema + 表结构 | `server-init` 里 `yarn migrate:deploy` | `start-prod.sh` 按分支策略 `yarn migrate:deploy` |
 | 基础数据（seed） | `server-init` 里 `yarn seed` | `start-prod.sh` 按分支策略 `yarn seed` |
 | 临时环境 schema 隔离 | — | `start-prod.sh` 改写 DATABASE_URL + `migrate-between-pg-schemas.js` |
 

package/dist/lib/application/files/gadmin2-game-angle-demo/server/ensure-database.js

@@ -13,7 +13,7 @@
  *
  * 失败语义：
  *   - 任何步骤异常（连接失败 / 权限不足 / SQL 报错）都直接 exit 1，让 start-prod.sh 终止。
- *     下游 push:db / 应用启动反正都会失败，越早暴露越好。
+ *     下游 migrate:deploy / 应用启动反正都会失败，越早暴露越好。
  *
  * 关闭开关：
  *   - 若部署侧确认 DB 由外部流程保证存在、不希望本步执行，

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

@@ -22,22 +22,23 @@
     "test:cov": "jest --coverage",
     "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
     "test:e2e": "jest --config ./test/jest-e2e.json",
-    "migrate:dev": "npm run push:db && dotenv -e .env.local -e .env  -- prisma migrate",
-    "migrate:dev:create": "dotenv -e .env.local -e .env  -- prisma migrate dev --create-only",
+    "migrate:dev": "dotenv -e .env.local -e .env  -- prisma migrate dev --name auto",
+    "migrate:create": "dotenv -e .env.local -e .env  -- prisma migrate dev --create-only",
     "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 && dotenv -e .env.local -e .env  -- npx prisma generate",
+    "generate:dev": "npm run 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",
     "seed": "dotenv -e .env.local -e .env  -- ts-node seed/index.ts",
-    "prisma:studio": "dotenv -e .env.local -e .env  -- prisma studio"
+    "prisma:studio": "dotenv -e .env.local -e .env  -- prisma studio",
+    "gen:jwt": "dotenv -e .env.local -e .env  -- ts-node scripts/gen-jwt.ts"
   },
   "dependencies": {
     "@agendajs/postgres-backend": "^3.0.5",
     "@azure/identity": "^4.13.0",
-    "@gadmin2n/nest-common": "^0.0.51",
+    "@gadmin2n/nest-common": "^0.1.3",
     "@nestjs/cache-manager": "^3.0.1",
     "@nestjs/common": "^10.4.15",
     "@nestjs/config": "^3.2.0",
@@ -90,7 +91,7 @@
   "devDependencies": {
     "@faker-js/faker": "^10.4.0",
     "@gadmin2n/prisma-nest-generator": "^0.0.49",
-    "@gadmin2n/prisma-react-generator": "^0.0.65",
+    "@gadmin2n/prisma-react-generator": "^0.0.69",
     "@nestjs/cli": "^11.0.21",
     "@nestjs/testing": "^10.4.15",
     "@swc/cli": "^0.8.1",

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

@@ -6,6 +6,11 @@ import { defineConfig } from 'prisma/config';
 dotenv.config({ path: path.resolve(__dirname, '.env.local') });
 dotenv.config({ path: path.resolve(__dirname, '.env') });
 
+// 从连接串的 ?schema= 读取外部表所在 schema,缺省 public
+const schema =
+  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+  new URL(process.env.DATABASE_URL!).searchParams.get('schema') ?? 'public';
+
 export default defineConfig({
   engine: 'classic',
   datasource: {
@@ -18,6 +23,9 @@ export default defineConfig({
   tables: {
     // 将要被 Prisma 标记为“外部管理”的表名列表
     // 可以使用 "schema.table" 或仅 "table"（依你 DB/项目设置）
-    external: ['public.users'],
+    // agenda_jobs / agenda_logs 均由 @agendajs/postgres-backend 在服务启动时
+    // 通过 CREATE TABLE IF NOT EXISTS 自动创建并维护（含部分索引、唯一索引、触发器），
+    // Prisma schema 无法完整表达，故整体交给库管理，迁移不碰。
+    external: [`${schema}.agenda_jobs`, `${schema}.agenda_logs`],
   },
 });

package/dist/lib/application/files/gadmin2-game-angle-demo/server/scripts/gen-jwt.ts

@@ -0,0 +1,85 @@
+/**
+ * gen-jwt.ts — 使用 TaiHuId.sign() 为 seed 用户生成 JWT token
+ *
+ * Usage:
+ *   yarn gen:jwt --userid kavenma
+ *   yarn gen:jwt --userid kavenma --expiresIn 3600
+ *
+ * userid 必须在 seed/users.ts 中存在。
+ */
+
+import seedUsers from '../seed/users';
+import TaiHuId from '../src/lib/taihu';
+
+function parseArgs(): Record<string, string> {
+  const argv = process.argv.slice(2);
+  const flags: Record<string, string> = {};
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i].startsWith('--')) {
+      const key = argv[i].slice(2);
+      const next = argv[i + 1];
+      flags[key] = next && !next.startsWith('--') ? argv[++i] : 'true';
+    }
+  }
+  return flags;
+}
+
+async function main() {
+  const flags = parseArgs();
+  const { userid, expiresIn } = flags;
+
+  if (!userid) {
+    console.error('[gen-jwt] --userid is required.');
+    console.error(
+      `[gen-jwt] Available userids: ${seedUsers
+        .map((u) => u.userid)
+        .join(', ')}`,
+    );
+    process.exit(1);
+  }
+
+  const user = seedUsers.find((u) => u.userid === userid);
+  if (!user) {
+    console.error(`[gen-jwt] userid "${userid}" not found in seed/users.ts.`);
+    console.error(
+      `[gen-jwt] Available userids: ${seedUsers
+        .map((u) => u.userid)
+        .join(', ')}`,
+    );
+    process.exit(1);
+  }
+
+  const ttl = expiresIn ? parseInt(expiresIn, 10) : 7 * 24 * 60 * 60; // 默认 7 天
+
+  const token = await TaiHuId.sign(
+    {
+      user_id: user.userid,
+      sub: user.userid,
+      name: user.username,
+      email: `${user.userid}@tencent.com`,
+    },
+    ttl,
+  );
+
+  console.log(
+    `[gen-jwt] ✅ Generated JWT for userid=${user.userid} (expiresIn=${ttl}s):\n`,
+  );
+  console.log(token);
+
+  console.log('\n[gen-jwt] 🍪 如何在浏览器中种入 cookie：');
+  console.log('  1) 打开目标站点（例如 http://localhost:3000），进入 DevTools');
+  console.log('  2) Application → Cookies → 选择当前域名');
+  console.log(
+    '     新增一条 cookie：Name=gadmin-token  Value=<上面的 token>  Path=/',
+  );
+  console.log('  3) 刷新页面即可以该 userid 身份登录\n');
+  console.log('  或在 DevTools Console 中执行（同域下即时生效）：');
+  console.log(
+    `    document.cookie = "gadmin-token=${token}; path=/; max-age=${ttl}"`,
+  );
+}
+
+main().catch((e) => {
+  console.error('[gen-jwt] Fatal error:', e);
+  process.exit(1);
+});

package/dist/lib/application/files/gadmin2-game-angle-demo/server/scripts/notify-dev-servers.js

@@ -44,7 +44,7 @@ const HEALTH_URL = `http://127.0.0.1:${NEST_PORT}/api/health/live`;
 const WEB_SENTINEL = path.resolve(process.cwd(), '..', 'web', '.vite-restart');
 
 function log(msg) {
-  process.stdout.write(`[postgadminGenerate] ${msg}\n`);
+  process.stdout.write(`\x1b[90m[postgadminGenerate] ${msg}\x1b[0m\n`);
 }
 
 function pingOnce(url) {
@@ -81,18 +81,19 @@ function touchViteSentinel() {
 }
 
 (async () => {
+  const rawOpts = {
+    pollMs: envInt('POSTGEN_POLL_MS'),
+    initialStableMs: envInt('POSTGEN_INITIAL_STABLE_MS'),
+    maxStableMs: envInt('POSTGEN_MAX_STABLE_MS'),
+    observeDownTimeoutMs: envInt('POSTGEN_OBSERVE_DOWN_TIMEOUT_MS'),
+    totalTimeoutMs: envInt('POSTGEN_TOTAL_TIMEOUT_MS'),
+  };
   await waitForNestReady({
     ping: () => pingOnce(HEALTH_URL),
     sleep,
     now: () => Date.now(),
     log,
-    opts: {
-      pollMs: envInt('POSTGEN_POLL_MS'),
-      initialStableMs: envInt('POSTGEN_INITIAL_STABLE_MS'),
-      maxStableMs: envInt('POSTGEN_MAX_STABLE_MS'),
-      observeDownTimeoutMs: envInt('POSTGEN_OBSERVE_DOWN_TIMEOUT_MS'),
-      totalTimeoutMs: envInt('POSTGEN_TOTAL_TIMEOUT_MS'),
-    },
+    opts: Object.fromEntries(Object.entries(rawOpts).filter(([, v]) => v !== undefined)),
   });
   touchViteSentinel();
 })().catch((e) => {