diff --git a/.gitea/workflows/build.yml b/.gitea/workflows/build.yml
new file mode 100644
index 0000000..45ce9dc
--- /dev/null
+++ b/.gitea/workflows/build.yml
@@ -0,0 +1,86 @@
+name: build
+
+# 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:
+    runs-on: ubuntu-latest
+    container:
+      image: docker:24
+      options: --network infra-infra-net
+    steps:
+      - 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 }}
+        run: |
+          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"
+
+      # 可选：清空 m2 缓存（仅手动勾选 cache_bust 时）
+      - name: 可选清空 m2 缓存
+        if: ${{ inputs.cache_bust == 'true' }}
+        run: |
+          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
+          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}/." 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 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 "${{ secrets.NEXUS_PASSWORD }}" | docker login nexus:8083 -u "${{ secrets.NEXUS_USER }}" --password-stdin
+          docker build -t "nexus:8083/docker-hosted/userclass-service:${TAG}" -f docker/Dockerfile .
+          docker push "nexus:8083/docker-hosted/userclass-service:${TAG}"
+          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\":\"userclass\",\"tag\":\"${TAG}\",\"sha\":\"${GITHUB_SHA}\",\"message\":\"${COMMIT_MSG}\"}"
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..76d4fbc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+# UserclassService
+
+> 本仓库由 projman 自动创建并注入 CI（`.gitea/workflows/build.yml`）与 Dockerfile（`docker/Dockerfile`）。
+> 推送代码到 main 分支即自动构建镜像并推送到 Nexus，projman 收到通知后建档待部署，由运维在 projman「后端发布」手动点部署。
+
+## 首次推送本地代码到本仓库
+
+> 目标：把本地已有代码推上去，同时**保留** projman 注入的文件（`build.yml`、`Dockerfile`）。
+
+```bash
+# 1. 进入本地代码目录
+cd /your/local/code/dir
+
+# 2. 初始化 git（目录已有 .git 也安全，git init 幂等无副作用）
+git init
+git branch -M main
+
+# 3. 先把本地代码提交成一个 commit（关键！不提交直接 merge 会丢失本地代码）
+git add -A
+git commit -m "init local code"
+
+# 4. 关联远程仓库（幂等：已存在 origin 则改地址，不报错）
+git remote add origin http://gitea.yunhaixingtong.com/userclass/UserclassService.git 2>/dev/null \
+  || git remote set-url origin http://gitea.yunhaixingtong.com/userclass/UserclassService.git
+
+# 5. 拉取远程信息（只下载，不合并）
+git fetch origin
+
+# 6. 合并远程 main（关键步骤）
+#    本地与远程是两条独立历史，需允许合并不相关历史。
+#    此步会把 projman 注入的 build.yml 与 Dockerfile 合并进你的本地工作区。
+git merge origin/main --allow-unrelated-histories -m "merge projman injected files"
+
+# 7. 查看状态（确认 .gitea/workflows/build.yml、docker/Dockerfile 已在本地）
+git status
+
+# 8. 提交并推送
+git add -A
+git commit -m "sync local code" 2>/dev/null || true
+git push origin main
+```
+
+## 推送后验证
+
+push 触发 CI 构建，前往 Gitea 仓库 → **Actions** 查看日志；构建成功后镜像推送到 Nexus，projman 建档待部署，在 projman 应用详情「后端发布」手动点部署。
+
+## 禁止写法（会导致注入文件被删）
+
+`git reset origin/main` + `git add -A` 会把远程已注入、但你本地没有的文件（`build.yml`、`Dockerfile`）当作"删除"提交并推送，导致这些文件被删、CI 失败。务必用 `git merge` 而非 `git reset`，且 merge 前先提交本地代码。
+
+## 关于 Dockerfile
+
+projman 注入的 Dockerfile 仅在仓库不存在时写入；你自备的 Dockerfile 优先，不会被覆盖。
diff --git a/docker/Dockerfile b/docker/Dockerfile
index 8aa6674..92ab9b7 100644
--- a/docker/Dockerfile
+++ b/docker/Dockerfile
@@ -1,5 +1,9 @@
-# BschClass 后端镜像（基于已构建好的 target/BschClass-0.1.jar）
-# 构建上下文 = 仓库根目录： docker build -f docker/Dockerfile -t <img> .
+# 由 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 退出参数 + MaxRAMPercentage=75（设内存上限时）
+# + 用户自定义参数），未注入时容器内兜底 -Xms512m -Xmx1024m
 FROM eclipse-temurin:8-jre
 
 RUN apt-get update \
@@ -9,12 +13,7 @@ RUN apt-get update \
  && rm -rf /var/lib/apt/lists/*
 
 WORKDIR /app
-COPY target/BschClass-0.1.jar /app/BschClass-0.1.jar
-# 镜像内 application-prod.yml 仅作独立运行时的兜底默认；
-# projman 部署时平台配置档案会以 bind mount 覆盖同路径文件，环境变量再压过文件。
-COPY docker/application-prod.yml /app/config/application-prod.yml
-COPY docker/run-app.sh /app/run-app.sh
-RUN chmod +x /app/run-app.sh && mkdir -p /data/upload
+COPY target/app.jar /app/app.jar
 
-EXPOSE 8087
-ENTRYPOINT ["/app/run-app.sh"]
+EXPOSE 10004
+ENTRYPOINT ["sh", "-c", "java ${JAVA_OPTS:--Xms512m -Xmx1024m} -Dfile.encoding=UTF-8 -jar /app/app.jar"]