diff --git a/.gitea/workflows/build.yml b/.gitea/workflows/build.yml
index 067e2c9..e6238c5 100644
--- a/.gitea/workflows/build.yml
+++ b/.gitea/workflows/build.yml
@@ -1,16 +1,21 @@
 name: build
 
-# open-gateway 开放接口网关 CI（仿 usermsg/service build.yml 平台链，不含部署）
-# 触发：push 到 main
-# 链路：clone 源码 -> maven 容器构建 jar（复用宿主 m2 缓存）-> cp 固定名 app.jar
-#       -> docker build -f docker/Dockerfile -> push Nexus docker-hosted
-# Nexus 凭据从宿主 prod.env 读入 job env（同机内网 CI，安全边界等同，勿回显）
-# 部署：projman 注册应用（open-gateway，空 ctx，端口 10010）后走发布链 Apply 拉起
+# Spring Boot 应用 CI（仿 UserBase ci.yml build 阶段 + projman webhook 建档，不含部署）
+# 触发：push 到 main / 手动 Run workflow（可勾选缓存重建）
+# 链路：clone 源码 -> maven 容器构建 jar（复用宿主 m2 缓存）-> docker build -f docker/Dockerfile -> push Nexus -> 通知 projman 建档（部署由运维在 DeployTab 手动触发）
+# 依赖仓库 Secrets：NEXUS_USER / NEXUS_PASSWORD（docker-hosted 推送）/ DEPLOY_TOKEN（webhook 鉴权）
+# 依赖 docker/Dockerfile（由 projman 注入，开发者也可自备——已写则尊重不覆盖）
+# maven 依赖走 http://nexus:8081/repository/maven-public/（infra-infra-net 内容器名直连，匿名可拉公司 yh-* starter）
 
 on:
   push:
     branches: [ main ]
   workflow_dispatch:
+    inputs:
+      cache_bust:
+        description: '构建前清空 maven m2 缓存'
+        required: false
+        default: 'false'
 
 jobs:
   build-push:
@@ -22,6 +27,7 @@ jobs:
       - name: 安装 git / curl（alpine）
         run: apk add --no-cache git curl
 
+      # 内网 Gitea 无法访问 GitHub 拉 actions/checkout，手动 clone 本仓库
       - name: 拉取源码（内网无 GitHub，手动 clone 本仓库）
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -29,39 +35,52 @@ jobs:
           git clone --depth 1 --branch main "http://x-access-token:${GITHUB_TOKEN}@gitea.yunhaixingtong.com/${{ github.repository }}.git" /tmp/src
           cp -a /tmp/src/. .
           rm -rf /tmp/src
+          # 取提交备注首行，脱去换行/双引号/反斜杠（避免破坏 webhook JSON），截断到 200 字符
+          COMMIT_MSG=$(git log -1 --pretty=%s | tr '\n' ' ' | sed 's/["\\]/ /g' | cut -c1-200)
+          echo "COMMIT_MSG=${COMMIT_MSG}" >> "$GITHUB_ENV"
 
-      - name: 读取 Nexus 凭据（同机 prod.env，不回显）
+      # 可选：清空 m2 缓存（仅手动勾选 cache_bust 时）
+      - name: 可选清空 m2 缓存
+        if: ${{ inputs.cache_bust == 'true' }}
         run: |
-          set -e
-          docker run --rm -v /opt/docker/projman-deploy:/pe:ro alpine sh -c \
-            'grep -E "^PROJMAN_NEXUS_USER=|^PROJMAN_NEXUS_PASSWORD=" /pe/prod.env' > /tmp/nx.env
-          # prod.env 无 NEXUS_USER 时默认 admin
-          grep -q '^PROJMAN_NEXUS_USER=' /tmp/nx.env || echo 'PROJMAN_NEXUS_USER=admin' >> /tmp/nx.env
-          echo "NX_USER=$(grep '^PROJMAN_NEXUS_USER=' /tmp/nx.env | head -1 | cut -d= -f2-)" >> "$GITHUB_ENV"
-          echo "NX_PASS=$(grep '^PROJMAN_NEXUS_PASSWORD=' /tmp/nx.env | head -1 | cut -d= -f2-)" >> "$GITHUB_ENV"
-          rm -f /tmp/nx.env
+          docker run --rm -v /opt/docker/projman-m2:/root/.m2 alpine sh -c 'rm -rf /root/.m2/*'
+          echo "m2 cache busted"
 
+      # maven 构建：起独立 maven 容器（入 infra-infra-net 用容器名 nexus 直连 maven-public）
+      # 通过 docker.sock 调宿主 dockerd，故 -v 路径按宿主解析；用 docker cp 进出源码/产物
+      # m2 缓存挂宿主固定目录 /opt/docker/projman-m2，跨构建复用依赖
+      # settings.xml 用 profile 方式追加 nexus maven-public 仓库（匿名可拉，不带凭据）
+      # maven 实际产物名 = artifactId-version.jar（随 pom 变，-DfinalName 命令行 property 不可靠覆盖不了），
+      # 故 mvn package 后在容器内 cp 成固定名 app.jar，使 docker cp 与 docker/Dockerfile 的 COPY target/app.jar 绑定
       - name: 构建 jar（maven 容器，复用宿主 m2 缓存）
         run: |
           set -e
-          CTR="mavenbuild-open-gateway-$(date +%s)"
-          trap 'docker rm -f "$CTR" >/dev/null 2>&1 || true' EXIT
-          docker run -d --name "$CTR" \
+          docker rm -f mavenbuild 2>/dev/null || true
+          docker run -d --name mavenbuild \
             --network infra-infra-net \
             -v /opt/docker/projman-m2:/root/.m2 \
             -w /build maven:3.6.3-jdk-8 sleep 3600
-          docker cp "${PWD}/." "$CTR":/build/
-          docker exec "$CTR" sh -c "printf '%s' '<settings><profiles><profile><id>nexus-repo</id><repositories><repository><id>nexus-internal</id><url>http://nexus:8081/repository/maven-public/</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled><updatePolicy>always</updatePolicy></snapshots></repository></repositories></profile></profiles><activeProfiles><activeProfile>nexus-repo</activeProfile></activeProfiles></settings>' > /root/.m2/settings.xml"
-          docker exec "$CTR" sh -c 'cd /build && mvn -B -DskipTests clean package'
-          docker exec "$CTR" sh -c 'cd /build/target && cp *.jar app.jar'
+          docker cp "${PWD}/." mavenbuild:/build/
+          docker exec mavenbuild sh -c "printf '%s' '<settings><profiles><profile><id>nexus-repo</id><repositories><repository><id>nexus-internal</id><url>http://nexus:8081/repository/maven-public/</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled><updatePolicy>always</updatePolicy></snapshots></repository></repositories></profile></profiles><activeProfiles><activeProfile>nexus-repo</activeProfile></activeProfiles></settings>' > /root/.m2/settings.xml"
+          docker exec mavenbuild sh -c 'cd /build && mvn -B -DskipTests clean package'
+          docker exec mavenbuild sh -c 'cd /build/target && cp *.jar app.jar'
           mkdir -p "${PWD}/target"
-          docker cp "$CTR":/build/target/app.jar "${PWD}/target/app.jar"
+          docker cp mavenbuild:/build/target/app.jar "${PWD}/target/app.jar"
+          docker rm -f mavenbuild
 
       - name: 构建并推送镜像
         run: |
           set -e
           TAG=$(echo "$GITHUB_SHA" | cut -c1-8)
-          echo "${NX_PASS}" | docker login nexus:8083 -u "${NX_USER}" --password-stdin
+          echo "${{ secrets.NEXUS_PASSWORD }}" | docker login nexus:8083 -u "${{ secrets.NEXUS_USER }}" --password-stdin
           docker build -t "nexus:8083/docker-hosted/open-gateway-service:${TAG}" -f docker/Dockerfile .
           docker push "nexus:8083/docker-hosted/open-gateway-service:${TAG}"
-          echo "open-gateway-service:${TAG} pushed"
+          echo "TAG=${TAG}" >> "$GITHUB_ENV"
+
+      # 通知 projman：webhook 收到后只建档 Release(status=pending)，部署由运维在 DeployTab 手动触发（App.deployMode=manual）
+      - name: 通知 projman 建档（部署由运维手动触发）
+        run: |
+          curl -sS -X POST "http://192.168.10.160:8090/projman/api/deploy/webhook" \
+            -H "Content-Type: application/json" \
+            -H "X-Deploy-Token: ${{ secrets.DEPLOY_TOKEN }}" \
+            -d "{\"app\":\"open-gateway\",\"tag\":\"${TAG}\",\"sha\":\"${GITHUB_SHA}\",\"message\":\"${COMMIT_MSG}\"}"
diff --git a/docker/Dockerfile b/docker/Dockerfile
index 8d7f78c..ea4b07b 100644
--- a/docker/Dockerfile
+++ b/docker/Dockerfile
@@ -1,6 +1,9 @@
-# 平台标准运行镜像（对齐 projman 注入模板）：SPRING_PROFILES_ACTIVE 由容器 env 注入
-# （platform,{bucket}，命令行不写死——写死会以更高优先级压掉平台公共配置层）
-# CI 已先 mvn package 并 cp 成固定名 target/app.jar；构建上下文 = 仓库根
+# 由 projman 注入的 Spring Boot 运行镜像（单阶段，jar 预构建）
+# CI 已先 mvn package，并在容器内把产物 cp 成固定名 target/app.jar
+# 构建上下文 = 仓库根：docker build -f docker/Dockerfile .
+# 健康检查依赖 curl（projman 部署用 curl 探 /actuator/health）——应用需含 spring-boot-starter-actuator
+# 时区 Asia/Shanghai；JAVA_OPTS 由 projman 渲染器注入（OOM 退出参数 + -Xmx=内存上限×75%（设上限时渲染期算死，JDK8 兼容）
+# + 用户自定义参数），未注入时容器内兜底 -Xms512m -Xmx1024m
 FROM eclipse-temurin:8-jre
 
 RUN apt-get update \
@@ -12,5 +15,5 @@ RUN apt-get update \
 WORKDIR /app
 COPY target/app.jar /app/app.jar
 
-EXPOSE 10010
+EXPOSE 10013
 ENTRYPOINT ["sh", "-c", "java ${JAVA_OPTS:--Xms512m -Xmx1024m} -Dfile.encoding=UTF-8 -jar /app/app.jar"]