@gadmin2n/schematics 0.0.88 → 0.0.90

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

@@ -1,5 +1,4 @@
 .DS_Store
-web/
 **/node_modules
 **/dist
 **/generated
@@ -11,6 +10,11 @@ npm-debug.log
 .coverage
 .coverage.*
 .aws
+
+.agent/
+.claude/
+.claude-internal/
+
 # local env files
 .env.local
 .env.*.local
@@ -30,4 +34,14 @@ yarn-error.log*
 *.sw?
 
 run.cmd
-todo.md
+todo.md
+
+sync-to-template.sh
+CLAUDE.md
+
+# Build/CI orchestration files — read directly by `docker build -f` / Jenkins / docker compose,
+# 不需要进入任何镜像的 build context
+Dockerfile.*
+Jenkinsfile
+docker-compose.yml
+docker-compose.md

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

@@ -0,0 +1,40 @@
+# syntax=docker/dockerfile:1
+#
+# 代码生成专用镜像（方案 C）。
+# Jenkins 流水线在构建 web/server 业务镜像之前，先 docker build 本镜像；
+# 后续 Dockerfile.web / Dockerfile.server 通过 ARG + FROM 引用本镜像，
+# 直接 COPY --from=gen 拿到 gadmin2 g prisma 已生成的源码。
+#
+# 本镜像不会被推送到 registry，仅在 Jenkins agent 本地 docker daemon 中存活，
+# 流水线末尾会清理。
+
+FROM node:20-alpine
+
+WORKDIR /app
+
+# Prisma 在 alpine 上需要 openssl 才能加载原生引擎
+RUN apk add --no-cache openssl
+
+# 禁止 husky 在无 .git 环境下报错
+ENV HUSKY=0
+
+# 配置腾讯软件源
+RUN yarn config set registry https://mirrors.cloud.tencent.com/npm/
+
+# 安装 gadmin2 CLI
+RUN yarn global add @gadmin2n/cli@latest
+
+# 先复制 server 依赖描述文件，源码未变时此层 layer cache 可复用
+# （prisma generators 是 server 的 devDependencies，必须先 yarn install）
+COPY server/package.json server/yarn.lock ./server/
+
+RUN --mount=type=cache,target=/root/.yarn \
+    cd server && yarn install --frozen-lockfile
+
+# 复制全部 codegen 输入：上层 config/、server/（含 schema.prisma 与 gadmin-cli.json）、web/
+COPY config/ ./config/
+COPY server/ ./server/
+COPY web/ ./web/
+
+# 执行代码生成；产物会写入 server/src 与 web/src
+RUN gadmin2 g prisma

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

@@ -0,0 +1,76 @@
+# syntax=docker/dockerfile:1
+#
+# 通过 ARG CODEGEN_IMAGE + FROM ${CODEGEN_IMAGE} 引用 Jenkins 流水线先行构建的 codegen 镜像。
+# 直接 COPY --from=gen /app/server，复用 codegen 已经装好的 server/node_modules
+# （含 prisma client 与 gadmin2 generators），避免重复 yarn install。
+
+ARG CODEGEN_IMAGE
+FROM ${CODEGEN_IMAGE} AS gen
+
+# ─── 阶段 1：构建 ────────────────────────────────────────────
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+# Prisma 在 alpine 上需要 openssl
+RUN apk add --no-cache openssl
+
+# 禁止 husky 在无 .git 环境下报错
+ENV HUSKY=0
+
+# 从 codegen 镜像取完整 server/（含已生成代码 + 已安装的 node_modules）
+COPY --from=gen /app/server ./server
+
+# 编译
+RUN cd server && yarn build
+
+# ─── 阶段 2：运行 ────────────────────────────────────────────
+FROM node:20-alpine AS runner
+
+# Prisma 运行时需要 openssl；中国项目默认时区上海
+RUN apk add --no-cache openssl tzdata && \
+    cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
+    echo "Asia/Shanghai" > /etc/timezone
+ENV TZ=Asia/Shanghai
+
+WORKDIR /app/server
+
+STOPSIGNAL SIGQUIT
+
+# 禁止 husky 在无 .git 环境下报错；显式声明生产环境（NestJS / 第三方库行为优化）
+ENV HUSKY=0 \
+    NODE_ENV=production
+
+# 从 builder 复制依赖描述文件（其源头是 codegen 镜像）
+COPY --from=builder --chown=node:node /app/server/package.json /app/server/yarn.lock ./
+
+# 只安装 production 依赖，大幅减少镜像体积
+RUN --mount=type=cache,target=/root/.yarn \
+    yarn install --production --frozen-lockfile
+
+# 从构建阶段复制 Prisma 生成的 Client（含平台原生二进制）
+COPY --from=builder --chown=node:node /app/server/node_modules/.prisma ./node_modules/.prisma
+
+# 从构建阶段复制编译产物
+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
+
+# 复制启动脚本和数据库迁移脚本（codegen 不会修改这些文件，但统一从 builder 拿，避免 COPY 源混用）
+COPY --from=builder --chown=node:node /app/server/start-prod.sh /app/server/migrate-between-pg-schemas.js ./
+RUN chmod +x start-prod.sh
+
+# 复制环境变量配置（作为默认值，K8s 注入的同名变量优先级更高）
+COPY --from=builder --chown=node:node /app/server/.env ./.env
+
+# 切换到非 root 用户（node 镜像内置 uid/gid 1000）
+USER node
+
+EXPOSE 8000
+
+# 容器健康检查：调用 NestJS 的 /health/live 端点
+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"]

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

@@ -0,0 +1,53 @@
+# syntax=docker/dockerfile:1
+#
+# 通过 ARG CODEGEN_IMAGE + FROM ${CODEGEN_IMAGE} 引用 Jenkins 流水线先行构建的 codegen 镜像，
+# 直接 COPY --from=gen 拿到 gadmin2 g prisma 已生成的 web/ 源码。
+# 本镜像不再安装 gadmin2 CLI，构建上下文也不再需要 web/ 源码。
+#
+# 本地手工调试用：先 `docker build -f Dockerfile.codegen -t gadmin2-codegen:dev .`
+# 再 `docker build -f Dockerfile.web --build-arg CODEGEN_IMAGE=gadmin2-codegen:dev -t gadmin2-web:dev .`
+
+ARG CODEGEN_IMAGE
+FROM ${CODEGEN_IMAGE} AS gen
+
+# ─── 阶段 1：构建 ────────────────────────────────────────────
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+# 禁止 husky 在无 .git 环境下报错
+ENV HUSKY=0
+
+# 配置腾讯软件源
+RUN yarn config set registry https://mirrors.cloud.tencent.com/npm/
+
+# 从 codegen 镜像取完整 web/（含生成代码、不含 node_modules）
+COPY --from=gen /app/web ./web
+
+# 移除 yarn.lock 中的 resolved 地址，强制使用新的 registry
+RUN sed -i 's|https://registry.npmmirror.com/|https://mirrors.cloud.tencent.com/npm/|g' web/yarn.lock
+
+# 安装依赖
+RUN --mount=type=cache,target=/root/.yarn \
+    cd web && yarn install --frozen-lockfile
+
+# 声明构建参数
+ARG NODE_ENV=production
+ARG DEPLOY_NAME
+# 设置环境变量，让构建命令可以读取到（src 中通过 import.meta.env.VITE_DEPLOY_NAME 使用）
+ENV VITE_DEPLOY_NAME=${DEPLOY_NAME}
+
+# 编译
+RUN --mount=type=cache,target=/root/.yarn \
+    cd web && yarn build --mode ${NODE_ENV}
+
+# ─── 阶段 2：运行 ────────────────────────────────────────────
+FROM nginx:alpine
+
+# nginx 配置和构建产物均来自 builder 阶段（其源头是 codegen 镜像）
+COPY --from=builder /app/web/nginx.conf /etc/nginx/nginx.conf
+COPY --from=builder /app/web/dist /var/www/html
+
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]

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

@@ -1,70 +1,256 @@
 // see https://www.jenkins.io/doc/book/pipeline/syntax/
+//
+// Monorepo pipeline for gadmin-test: 3 deployable modules (web / server / worker).
+// 路径触发：哪个模块代码有改动就构建哪个，纯文档改动跳过所有构建。
+// 风格沿用 erp-frontend / erp-backend 的 Jenkinsfile（声明式、Coding CI 环境变量、Spinnaker webhook）。
+
 pipeline {
   agent any
+
   environment {
     CODING_DOCKER_REG_HOST = "${CCI_CURRENT_TEAM}-${CCI_DOCKER_REGISTRY_DOMAIN}"
     IMAGE_VERSION = "build-${env.CI_BUILD_NUMBER}"
-    CODING_DOCKER_IMAGE_NAME = "${PROJECT_NAME.toLowerCase()}/${env.BRANCH_NAME == 'test'? 'test' : 'prod'}/${CCI_JOB_NAME}"
-    IMAGE_FULL_NAME = "${CODING_DOCKER_REG_HOST}/${env.CODING_DOCKER_IMAGE_NAME}:${IMAGE_VERSION}"
+    DEPLOY_ENV = "${env.BRANCH_NAME == 'test' ? 'test' : 'prod'}"
+    IMAGE_NAME_PREFIX = "${PROJECT_NAME.toLowerCase()}/${DEPLOY_ENV}"
+
+    // 镜像名后缀（Coding CI 通常用 ${CCI_JOB_NAME}，但 monorepo 需要 3 个不同名字，这里固定写死）
+    // TODO: 确认这三个 image name 与 Spinnaker 应用 / K8s deployment 命名一致
+    WEB_IMAGE_SHORT    = "gadmin2-web"
+    SERVER_IMAGE_SHORT = "gadmin2-server"
+    WORKER_IMAGE_SHORT = "gadmin2-worker"
+
+    // 代码生成中间镜像（不推送到 registry，仅本地 docker daemon 临时存活）
+    CODEGEN_IMAGE = "gadmin2-codegen:${IMAGE_VERSION}"
+  }
+
+  options {
+    timeout(time: 30, unit: 'MINUTES')
   }
 
   stages {
+
     stage('检出Git') {
-      when {
-        anyOf {
-          branch 'test';
-          branch 'master'
-        }
-      }
+      when { anyOf { branch 'test'; branch 'master' } }
       steps {
-        checkout([$class: 'GitSCM', branches: [[name: env.GIT_BUILD_REF]], userRemoteConfigs: [[url: env.GIT_REPO_URL, credentialsId: env.CREDENTIALS_ID]]])
+        checkout([$class: 'GitSCM',
+          branches: [[name: env.GIT_BUILD_REF]],
+          userRemoteConfigs: [[url: env.GIT_REPO_URL, credentialsId: env.CREDENTIALS_ID]]
+        ])
       }
     }
 
-    stage('构建推送镜像') {
-      when {
-        anyOf {
-          branch 'test';
-          branch 'master'
-        }
-      }
+    stage('检测变更模块') {
+      when { anyOf { branch 'test'; branch 'master' } }
       steps {
         script {
-          docker.withRegistry(
-            "${CCI_CURRENT_WEB_PROTOCOL}://${env.CODING_DOCKER_REG_HOST}",
-            "${env.CODING_ARTIFACTS_CREDENTIALS_ID}"
-          ) {
-            docker.build("${env.CODING_DOCKER_IMAGE_NAME}:${IMAGE_VERSION}").push()
-            sh "docker image rm ${env.IMAGE_FULL_NAME}"
+          // 对比基准：优先使用 Jenkins git plugin 的 GIT_PREVIOUS_SUCCESSFUL_COMMIT
+          // 兜底：基准缺失或 commit 在当前 clone 中找不到 → 全量构建（保险策略）
+          def base = env.GIT_PREVIOUS_SUCCESSFUL_COMMIT ?: ''
+          def baseValid = false
+          if (base) {
+            // shallow clone 时旧 commit 可能不在本地，检测一下
+            def rc = sh(script: "git cat-file -e ${base}^{commit} 2>/dev/null", returnStatus: true)
+            baseValid = (rc == 0)
+            if (!baseValid) {
+              echo "GIT_PREVIOUS_SUCCESSFUL_COMMIT=${base} 在当前 clone 中不可达（可能是 shallow clone），全量构建"
+            }
+          } else {
+            echo "无 GIT_PREVIOUS_SUCCESSFUL_COMMIT（首次构建？），全量构建"
+          }
+
+          def changedFiles = []
+          if (baseValid) {
+            def diffOut = sh(script: "git diff --name-only ${base} HEAD", returnStdout: true).trim()
+            changedFiles = diffOut ? diffOut.split('\n') as List : []
+            echo "对比基准 ${base}..HEAD，变更文件 ${changedFiles.size()} 个"
           }
+
+          // 路径规则
+          def matches = { List files, String prefix -> files.any { it.startsWith(prefix) } }
+          def isDocOnly = { String f ->
+            f.startsWith('docs/') || f == 'CLAUDE.md' || f == 'readme.md' ||
+            f == '.gitignore' || f == 'Jenkinsfile' || f == 'sync-to-template.sh' ||
+            f == 'sync-to-template.md' || f.startsWith('.claude/')
+          }
+
+          def buildWeb    = false
+          def buildServer = false
+          def buildWorker = false
+
+          if (!baseValid) {
+            buildWeb = true; buildServer = true; buildWorker = true
+          } else if (changedFiles.isEmpty()) {
+            echo '没有文件变更，全部跳过'
+          } else {
+            // 纯文档变更 → 全部跳过
+            def nonDoc = changedFiles.findAll { !isDocOnly(it) }
+            if (nonDoc.isEmpty()) {
+              echo '仅文档/配置文件变更，全部跳过'
+            } else {
+              // 路径触发规则：
+              //   web/**            → web
+              //   config/ui/**      → web（前端 CRUD 代码由 config/ui 生成）
+              //   config/prisma/**  → server + web（后端模型由 prisma 生成；前端 enums 通过 yarn sync:code 与后端同步）
+              //   server/**         → server
+              //   temporal/worker/**→ worker
+              buildWeb    = matches(nonDoc, 'web/') || matches(nonDoc, 'config/ui/') || matches(nonDoc, 'config/prisma/')
+              buildServer = matches(nonDoc, 'server/') || matches(nonDoc, 'config/prisma/')
+              buildWorker = matches(nonDoc, 'temporal/worker/')
+              // 注：本项目根目录没有共享的 package.json / tsconfig.json，
+              //     各模块依赖独立在 web/ server/ temporal/worker/ 下，无需"全量兜底"逻辑。
+            }
+          }
+
+          // 用 env 暴露给后续 stage（when 表达式只能读 env / params）
+          env.BUILD_WEB    = buildWeb.toString()
+          env.BUILD_SERVER = buildServer.toString()
+          env.BUILD_WORKER = buildWorker.toString()
+
+          echo "buildWeb=${buildWeb}, buildServer=${buildServer}, buildWorker=${buildWorker}"
         }
       }
     }
 
-    stage('测试环境部署') {
+    stage('代码生成') {
+      // 仅当需要构建 web 或 server 时执行；worker 模块与 gadmin2 codegen 无关
       when {
         anyOf {
-          branch 'test'
+          environment name: 'BUILD_WEB', value: 'true'
+          environment name: 'BUILD_SERVER', value: 'true'
         }
       }
       steps {
-        sh 'curl https://api-spinnaker.devops.intlgame.com/webhooks/webhook/oit-erp-backend-test -X POST -H "content-type: application/json" -d \'{"parameters": {"image_tag": "\'"${IMAGE_VERSION}"\'"}}\''
-        echo '部署已经触发，可以在Spinnaker查看状态: https://api-spinnaker.devops.intlgame.com'
+        script {
+          // 构建一个本地代码生成镜像：内部装好 gadmin2 CLI + server devDeps，
+          // 并已执行 `gadmin2 g prisma`，产出包含生成代码的 /app/web 与 /app/server。
+          //
+          // 关键点：
+          //   - 镜像不 push 到 registry，仅在本 Jenkins agent 的 docker daemon 中存活
+          //   - 后续 Dockerfile.web / Dockerfile.server 通过 ARG CODEGEN_IMAGE + FROM ${CODEGEN_IMAGE}
+          //     直接引用本地镜像，无需 registry 周转
+          //   - 流水线末尾会清理本镜像
+          docker.build(env.CODEGEN_IMAGE, "-f Dockerfile.codegen .")
+        }
       }
     }
 
-    stage('正式环境自动部署') {
-      when {
-        anyOf {
-          branch 'master'
+    stage('并行构建推送镜像') {
+      when { anyOf { branch 'test'; branch 'master' } }
+      parallel {
+
+        stage('构建 Web') {
+          when { environment name: 'BUILD_WEB', value: 'true' }
+          steps {
+            script {
+              def imageName = "${env.IMAGE_NAME_PREFIX}/${env.WEB_IMAGE_SHORT}"
+              def imageFull = "${env.CODING_DOCKER_REG_HOST}/${imageName}:${env.IMAGE_VERSION}"
+              def buildArg  = (env.BRANCH_NAME == 'test') ? '--build-arg NODE_ENV=test' : '--build-arg NODE_ENV=production'
+
+              docker.withRegistry(
+                "${CCI_CURRENT_WEB_PROTOCOL}://${env.CODING_DOCKER_REG_HOST}",
+                "${env.CODING_ARTIFACTS_CREDENTIALS_ID}"
+              ) {
+                // FROM ${CODEGEN_IMAGE} 在本地 docker daemon 解析，不会触发 registry 拉取
+                docker.build(
+                  "${imageName}:${env.IMAGE_VERSION}",
+                  "${buildArg} --build-arg CODEGEN_IMAGE=${env.CODEGEN_IMAGE} -f Dockerfile.web ."
+                ).push()
+                sh "docker image rm ${imageFull}"
+              }
+              env.WEB_IMAGE_FULL = imageFull
+            }
+          }
+        }
+
+        stage('构建 Server') {
+          when { environment name: 'BUILD_SERVER', value: 'true' }
+          steps {
+            script {
+              def imageName = "${env.IMAGE_NAME_PREFIX}/${env.SERVER_IMAGE_SHORT}"
+              def imageFull = "${env.CODING_DOCKER_REG_HOST}/${imageName}:${env.IMAGE_VERSION}"
+
+              docker.withRegistry(
+                "${CCI_CURRENT_WEB_PROTOCOL}://${env.CODING_DOCKER_REG_HOST}",
+                "${env.CODING_ARTIFACTS_CREDENTIALS_ID}"
+              ) {
+                // FROM ${CODEGEN_IMAGE} 在本地 docker daemon 解析，不会触发 registry 拉取
+                docker.build(
+                  "${imageName}:${env.IMAGE_VERSION}",
+                  "--build-arg CODEGEN_IMAGE=${env.CODEGEN_IMAGE} -f Dockerfile.server ."
+                ).push()
+                sh "docker image rm ${imageFull}"
+              }
+              env.SERVER_IMAGE_FULL = imageFull
+            }
+          }
+        }
+
+        stage('构建 Worker') {
+          when { environment name: 'BUILD_WORKER', value: 'true' }
+          steps {
+            script {
+              def imageName = "${env.IMAGE_NAME_PREFIX}/${env.WORKER_IMAGE_SHORT}"
+              def imageFull = "${env.CODING_DOCKER_REG_HOST}/${imageName}:${env.IMAGE_VERSION}"
+
+              docker.withRegistry(
+                "${CCI_CURRENT_WEB_PROTOCOL}://${env.CODING_DOCKER_REG_HOST}",
+                "${env.CODING_ARTIFACTS_CREDENTIALS_ID}"
+              ) {
+                // worker 的构建上下文是 temporal/worker/
+                docker.build("${imageName}:${env.IMAGE_VERSION}", "-f temporal/worker/Dockerfile temporal/worker").push()
+                sh "docker image rm ${imageFull}"
+              }
+              env.WORKER_IMAGE_FULL = imageFull
+            }
+          }
         }
       }
+    }
+
+    stage('触发 Spinnaker 部署') {
+      when { anyOf { branch 'test'; branch 'master' } }
       steps {
         script {
-          sh 'curl https://api-spinnaker.devops.intlgame.com/webhooks/webhook/oit-erp-backend-prod -X POST -H "content-type: application/json" -d \'{"parameters": {"image_tag": "\'"${IMAGE_VERSION}"\'"}}\''
-          echo '部署已经触发，可以在Spinnaker查看状态: https://api-spinnaker.devops.intlgame.com'
+          // 任一模块构建过就触发对应的 Spinnaker webhook
+          // TODO: 确认 Spinnaker 上是按"每模块一个 application"还是"一个 application 接收所有模块"
+          //       下面按"每模块一个 application"实现，与 erp-frontend / erp-backend 保持一致
+          def env_ = env.DEPLOY_ENV  // test 或 prod
+          def webhookBase = 'https://api-spinnaker.devops.intlgame.com/webhooks/webhook'
+
+          def triggerOne = { String moduleSlug, String imageFull ->
+            // TODO: 确认 webhook 路径名 oit-gadmin2-${moduleSlug}-${env_} 已在 Spinnaker 注册
+            def url = "${webhookBase}/oit-gadmin2-${moduleSlug}-${env_}"
+            def payload = """{"parameters": {"image_tag": "${env.IMAGE_VERSION}", "repository": "${imageFull}"}}"""
+            sh "curl -sf '${url}' -X POST -H 'content-type: application/json' -d '${payload}'"
+            echo "已触发 ${moduleSlug} 部署：${url}"
+          }
+
+          if (env.BUILD_WEB == 'true' && env.WEB_IMAGE_FULL) {
+            triggerOne('web', env.WEB_IMAGE_FULL)
+          }
+          if (env.BUILD_SERVER == 'true' && env.SERVER_IMAGE_FULL) {
+            triggerOne('server', env.SERVER_IMAGE_FULL)
+          }
+          if (env.BUILD_WORKER == 'true' && env.WORKER_IMAGE_FULL) {
+            triggerOne('worker', env.WORKER_IMAGE_FULL)
+          }
+
+          if (env.BUILD_WEB != 'true' && env.BUILD_SERVER != 'true' && env.BUILD_WORKER != 'true') {
+            echo '本次构建无模块更新，跳过 Spinnaker 触发'
+          } else {
+            echo '部署已经触发，可以在 Spinnaker 查看状态: https://api-spinnaker.devops.intlgame.com'
+          }
         }
       }
     }
   }
-}
+
+  post {
+    // 清理本地 codegen 中间镜像（不影响 web/server 已 push 的产物镜像）
+    always {
+      script {
+        sh "docker image rm ${env.CODEGEN_IMAGE} || true"
+      }
+    }
+  }
+}