diff --git a/.gitea/workflows/build.yml b/.gitea/workflows/build.yml
index e9f23e8..9763908 100644
--- a/.gitea/workflows/build.yml
+++ b/.gitea/workflows/build.yml
@@ -38,10 +38,16 @@ jobs:
       - name: 构建前端（node 容器）
         run: |
           set -e
-          docker rm -f frontbuild 2>/dev/null || true
-          docker run -d --name frontbuild -w /build node:20 sleep 3600
-          docker cp "${PWD}/." frontbuild:/build/
-          docker exec frontbuild sh -c '
+          # 构建容器名必须全局唯一：runner 挂的是宿主 docker.sock，容器名在整个 daemon 上是共享
+          # 命名空间。旧写法固定名 frontbuild 会在多仓/多条 workflow 并发时互相 docker rm -f 掉
+          # 对方正在构建的容器，表现为无编译报错的 exit 137（SIGKILL，2026-09-10 三仓同推即撞）。
+          # GITHUB_RUN_ID 实例级唯一，再拼时间戳兜底（手动重跑/未注入时也不撞名）。
+          BUILD_CONTAINER="frontbuild-${GITHUB_RUN_ID:-0}-$(date +%s)"
+          echo "BUILD_CONTAINER=${BUILD_CONTAINER}"
+          docker rm -f "$BUILD_CONTAINER" 2>/dev/null || true
+          docker run -d --name "$BUILD_CONTAINER" -w /build node:20 sleep 3600
+          docker cp "${PWD}/." "$BUILD_CONTAINER":/build/
+          docker exec "$BUILD_CONTAINER" sh -c '
             set -e
             cd /build
             if [ -f .npmrc ]; then sed -i "/SASS_BINARY_PATH/d" .npmrc; fi
@@ -49,17 +55,19 @@ jobs:
             npm run build
           '
           echo "=== dist 产物 ==="
-          docker exec frontbuild sh -c 'ls -la /build/dist/ | head -20'
+          docker exec "$BUILD_CONTAINER" sh -c 'ls -la /build/dist/ | head -20'
           # 从容器 cp dist 到宿主工作目录
-          docker cp frontbuild:/build/dist ./dist
-          docker rm -f frontbuild
+          docker cp "$BUILD_CONTAINER":/build/dist ./dist
+          docker rm -f "$BUILD_CONTAINER"
           echo "BUILD CHECK OK"
 
-      # 打包 dist → zip（进入 dist 目录打包，zip 根目录直接是 html/css/js 文件）
+      # 打包 dist → zip（vite outDir 已简化为直出 dist/，无中间层；进入 dist 打包，
+      # zip 根目录直接是 index.html/css/js。此前 outDir=dist/base 时曾误打 dist/ 整层，
+      # zip 根只有 base/ 目录，projman 前端发布校验报「zip 根目录缺少 html 文件」）
       - name: 打包产物
         run: |
           TAG=$(echo "$GITHUB_SHA" | cut -c1-8)
-          ZIP_FILE="svc-hall-front-${TAG}.zip"
+          ZIP_FILE="notice-front-${TAG}.zip"
           cd dist && zip -r "../${ZIP_FILE}" . && cd ..
           echo "ZIP_FILE=${ZIP_FILE}" >> "$GITHUB_ENV"
           echo "TAG=${TAG}" >> "$GITHUB_ENV"
@@ -71,9 +79,7 @@ jobs:
           NEXUS_USER: ${{ secrets.NEXUS_USER }}
           NEXUS_PASSWORD: ${{ secrets.NEXUS_PASSWORD }}
         run: |
-          set -e
           NEXUS_URL="http://nexus.yunhaixingtong.com:8081/repository/front-hosted/${ZIP_FILE}"
-          # -f：HTTP >=400 时 curl 以非零退出，仓库不存在/认证失败必须让 job 变红，否则建档的是不存在的 URL
           curl -sSf -X PUT \
             -u "${NEXUS_USER}:${NEXUS_PASSWORD}" \
             --upload-file "${ZIP_FILE}" \
@@ -84,8 +90,7 @@ jobs:
       # 通知 projman：webhook 收到后建档（type=front, status=pending），部署由用户在「前端发布」Tab 手动触发
       - name: 通知 projman 建档
         run: |
-          set -e
           curl -sSf -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\":\"svc-hall\",\"front\":\"front\",\"tag\":\"${TAG}\",\"sha\":\"${GITHUB_SHA}\",\"message\":\"${COMMIT_MSG}\",\"nexusUrl\":\"${NEXUS_URL}\"}"
+            -d "{\"app\":\"notice\",\"front\":\"front\",\"tag\":\"${TAG}\",\"sha\":\"${GITHUB_SHA}\",\"message\":\"${COMMIT_MSG}\",\"nexusUrl\":\"${NEXUS_URL}\"}"
diff --git a/README.md b/README.md
index f2fb997..396701c 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,56 @@
-# svc-hall-front
+# 通知公告前端（Vue3 + Vite + view-ui-plus）
 
-managed by projman
\ No newline at end of file
+## 本地启动
+
+```bash
+npm install
+```
+
+### 1）纯前端调试（推荐，后端不可用时）
+
+本地连不上 `sso.yunhaixingtong.com` / `base.yunhaixingtong.com` 时，后端 CAS 过滤器会拦截
+`/api/*` 请求导致所有接口失败。此时使用内置 mock 调试前端页面：
+
+```bash
+npm run dev:mock
+```
+
+- 启用 `src/assets/mock/noticeapi.ts` 中的内存 mock（vite-plugin-mock），覆盖全部页面接口：
+  用户/菜单、发文部门字典、通知增删改查、阅读情况、联系组、选择用户树、附件上传等。
+- mock 数据为内存态，刷新页面即还原；修改 mock 文件后需重启 dev server 才生效。
+- mock 模式下请求走 vite 同源（`host.config.ts` 中 `serviceHost` 为空串）。
+
+### 2）连接后端调试
+
+```bash
+npm run dev
+```
+
+- `.env.dev`：`VITE_SERVICE_HOST=http://localhost:8070/notice`（Java 后端，见 `../service`）。
+- 后端需要能访问 CAS（`yh.sso.server-url-prefix`）与用户中心（`yh.open.*`），否则接口 302/失败。
+
+## 主要页面
+
+| 路由 | 页面 |
+| --- | --- |
+| `/notice/newnotice` | 通知发送（新建/编辑 `?serid=`/转发 `?fid=`，wangeditor 富文本） |
+| `/notice/notice_list` | 已发通知 |
+| `/notice/notice_accept` | 已收通知（左列表 + 右详情，打印/转发/附件） |
+| `/notice/manage` | 通知列表（管理端） |
+| `/notice/setting` | 应用设置（发文部门卡片 + 自定义组） |
+| `/notice/notice_details` | 通知详情（`type=0` 管理视角含阅读进度/编辑/打印，`type=1` 查看） |
+
+## 关键组件
+
+- `components/UserCheckModal.vue`：选择用户弹窗（组织树勾选 + 已选列表，移植自旧前端
+  `oldfront/src/components/userCheck.vue`）。
+- `components/UserCheckInput.vue`：通知对象选择（全部用户/指定用户，移植自旧
+  `user_check_input.vue`）。
+- `components/NoticeUpload.vue`：通知附件上传（选择文件 + 200MB 限制，移植自旧
+  `uploadFile.vue`）。
+- 发文部门卡片：见 `views/notice/NoticeSetting.vue`，样式与交互对齐 UserBase「应用类型」
+  （`UserBase/front/src/views/app/AppCategory.vue`），额外支持停用/启用。
+
+## 统计说明
+
+统计相关前端已按需求移除（`Notice_statis` 接口封装、菜单、图标等），后期统计不在本应用内做。