📦 build(deploy): Compose 按部署模式拆分三文件——换文件名即换模式一键部署

- docker-compose.yml（unified 默认入口）/ docker-compose.moldinsight.yml / docker-compose.inventory.yml 三文件一一对应三种部署模式，profiles 字段保留（--profile 旧命令双保险可用）
- 修复两个既有部署隐患：moldinsight-only 场景 celery depends_on 悬空；moldinsight service image 统一为 gemold-backend:latest 与 Dockerfile.celery FROM 对齐（废弃 gemold-moldinsight tag）
- gemold_network / uploads_data / html_data 固定 name 命名；inventory-only 不声明卷避免空卷；每文件内 x-base-env anchor 收敛重复 environment（SECRET_KEY/ADMIN_PASSWORD fail-fast 保留）
- 文档同步 11 处：DEPLOYMENT §1.1 一键部署总表 + §2 三模式命令、LINUX_SETUP §6/§11、README、OPERATIONS §4、build.sh/.bat 提示、PORT_CONFIG / DEPLOY_PORT / STORAGE_SETUP / frontend/README
- STATUS.md 补 2026-09-24 批次日志

验证：三文件 YAML 结构静态校验通过；5 个 service environment 键与拆分前逐一比对零丢失（39/39、34/34、39/39、34/34、20/20）

Co-Authored-By: Claude Code <noreply@anthropic.com>

docs/DEPLOYMENT.md

@@ -16,8 +16,25 @@
 - 前端同域反代可以面对单一 backend
 - 比按路径把前端网关分流到两套后端更易维护
 
-当前 Compose 入口：
-- [docker-compose.yml](../docker-compose.yml)
+### 1.1 一键 Compose 部署（按文件名切换模式）
+
+项目按"模式 ↔ Compose 文件"一一对应的方式支持一键部署。换文件名即可换模式：
+
+| 模式 | Compose 文件 | 一键命令 | 等价 `--profile` 命令 |
+|---|---|---|---|
+| **unified**（默认） | [docker-compose.yml](../docker-compose.yml) | `docker compose up -d` | `docker compose --profile full up -d` |
+| moldinsight-only | [docker-compose.moldinsight.yml](../docker-compose.moldinsight.yml) | `docker compose -f docker-compose.moldinsight.yml up -d` | `docker compose --profile moldinsight up -d` |
+| inventory-only | [docker-compose.inventory.yml](../docker-compose.inventory.yml) | `docker compose -f docker-compose.inventory.yml up -d` | `docker compose --profile inventory up -d` |
+
+> **双保险设计**：每个 service 的 `profiles:` 字段保留，因此 `--profile` 写法继续可用（兼容现有脚本与 CI）；同时支持 `-f <file>` 直接按文件名选择。两种写法等价。
+
+### 1.2 镜像构建
+
+首次部署或更新代码后先构建，再 `up`：
+
+```bash
+bash deploy/build.sh        # 显式构建 base / backend / celery / frontend 4 个镜像
+```
 
 详细 Linux 部署步骤：
 - [deployment/LINUX_SETUP.md](deployment/LINUX_SETUP.md)
@@ -35,6 +52,18 @@
 - 测试/集成环境
 - 小团队统一部署
 
+**Compose 文件**：[docker-compose.yml](../docker-compose.yml)（**默认入口**）
+
+**一键命令**：
+
+```bash
+docker compose up -d
+# 或等价写法（保留 profile 双保险）
+docker compose --profile full up -d
+```
+
+包含服务：`frontend` + `backend`（unified 入口）+ `moldinsight-celery`。
+
 ### 2.2 moldinsight-only
 
 只部署模具分析后端。
@@ -43,6 +72,18 @@
 - 独立开放分析能力
 - 异步任务与文件处理独立扩容
 
+**Compose 文件**：[docker-compose.moldinsight.yml](../docker-compose.moldinsight.yml)
+
+**一键命令**：
+
+```bash
+docker compose -f docker-compose.moldinsight.yml up -d
+# 或等价写法
+docker compose --profile moldinsight up -d
+```
+
+包含服务：`moldinsight`（独立 API）+ `moldinsight-celery`（异步 worker）。
+
 ### 2.3 inventory-only
 
 只部署进销存后端。
@@ -51,6 +92,18 @@
 - 独立部署 ERP / 库存能力
 - 与 moldinsight 分开发布节奏
 
+**Compose 文件**：[docker-compose.inventory.yml](../docker-compose.inventory.yml)
+
+**一键命令**：
+
+```bash
+docker compose -f docker-compose.inventory.yml up -d
+# 或等价写法
+docker compose --profile inventory up -d
+```
+
+包含服务：仅 `inventory`。不挂任何命名卷（inventory 无文件分析链路），不依赖 RustFS / MinIO。
+
 部署模式的结构含义见 [ARCHITECTURE.md](ARCHITECTURE.md)。
 
 ---

docs/OPERATIONS.md

@@ -9,7 +9,7 @@
 
 - 配置统一走**环境变量**，代码侧由 [src/shared/config/settings.py](../src/shared/config/settings.py) 的 `Settings` 单例经 `dotenv` + `os.getenv` 读取。
 - **本地运行**：仓库根 `.env`（`load_dotenv()` 自动加载；不在仓库内，参照 [.env.example](../.env.example) 复制编辑）。
-- **Compose 运行**：compose 文件用 `${VAR}` 从同目录 `.env` 注入容器环境变量（见 [docker-compose.yml](../docker-compose.yml)）。
+- **Compose 运行**：compose 文件用 `${VAR}` 从同目录 `.env` 注入容器环境变量；按模式对应不同文件名（见 [DEPLOYMENT.md §1.1](DEPLOYMENT.md)）。
 - **键值约定**：
   - `DB_HOST / DB_PORT / DB_NAME / DB_USER / DB_PASSWORD`：**惰性校验、无代码默认**——缺失时 import 不报错（便于测试/静态分析），真正连库时才失败。生产必须显式配置。
   - `AUTO_MIGRATE`：应用启动时是否自动执行 alembic 迁移，默认 `true`（单机开发语义）；**多副本 / 容器编排部署应设 `false`**，改由部署流程单点执行 `alembic upgrade head` 或 `python -m shared.database.init_db`（迁移脚本已随镜像分发于 `/app/migrations/`）。
@@ -78,13 +78,26 @@ npm run gen:api    # 从根目录 openapi.json 重新生成 src/types/api.ts（
 
 ## 4. Docker Compose
 
+按"模式 ↔ 文件名"一一对应：
+
 ```bash
-docker compose --profile full up -d     # frontend + unified backend + moldinsight-celery（推荐）
-docker compose --profile moldinsight up -d   # moldinsight 单模块栈
-docker compose --profile inventory up -d     # inventory 单模块栈
+# unified（默认；frontend + backend + moldinsight-celery）
+docker compose up -d
+# 或（profile 双保险）
+docker compose --profile full up -d
+
+# moldinsight-only（moldinsight + moldinsight-celery）
+docker compose -f docker-compose.moldinsight.yml up -d
+# 或
+docker compose --profile moldinsight up -d
+
+# inventory-only（仅 inventory）
+docker compose -f docker-compose.inventory.yml up -d
+# 或
+docker compose --profile inventory up -d
 ```
 
-- 镜像构建：`deploy/build.bat` / `deploy/build.sh`（base → 各服务镜像，见 `deploy/Dockerfile.*`）。
+- 镜像构建：`bash deploy/build.sh`（base → backend → celery → frontend 4 个 tag）；首次部署或更新代码后必须先 build 再 `up`。
 - PostgreSQL / Redis / RustFS 通常**复用服务器已有服务**，不由项目 compose 自带；容器只注入连接配置。
 
 ## 5. 运行时硬性要求

docs/STATUS.md

@@ -4,6 +4,8 @@
 > 维护规则：每完整完成一个需求，**倒序在本文顶部加一条**（日期 + 主题 + 关键事实）；其余主文档（架构 / 规划 / 技术债 / 部署）维护各自的"当前有效说法"，本文只记录"什么时候做到了哪一步"。维护规则出处见根目录 [AGENTS.md](../AGENTS.md)。
 > 早期条目（2026-09-17 之前）已精简为锚点，完整流水见 [archive/2026-09_governance_batches.md](archive/2026-09_governance_batches.md) 与 [archive/2026-09_status_history.md](archive/2026-09_status_history.md)。
 
+> 2026-09-24（**Compose 按部署模式拆分为三个一键文件 + 文档全量同步**：① 单文件 profile 编排拆为"模式 ↔ 文件名"一一对应的三文件——[docker-compose.yml](../docker-compose.yml)（unified 默认入口：frontend + backend + moldinsight-celery，`docker compose up -d` 即起）+ [docker-compose.moldinsight.yml](../docker-compose.moldinsight.yml)（moldinsight-only：独立 API + celery）+ [docker-compose.inventory.yml](../docker-compose.inventory.yml)（inventory-only：仅 inventory，不声明任何命名卷避免空卷）；② **所有 service 的 `profiles:` 字段保留（双保险）**，`--profile full/moldinsight/inventory` 旧命令继续可用；③ **顺手修复两个既有部署隐患**——moldinsight-only 场景 celery 的 `depends_on` 悬空（原指向被 profile 过滤掉的 `backend`，现各文件内分别指向 `backend` / `moldinsight`），以及 `gemold-moldinsight:latest` 与 `gemold-backend:latest` 双 tag 漂移（moldinsight service 的 image 统一为 `gemold-backend:latest`，与 [Dockerfile.celery](../deploy/Dockerfile.celery) 的 FROM 对齐，干净环境单跑 moldinsight-only 不再构建失败）；④ `gemold_network` / `uploads_data` / `html_data` 加 `name:` 固定命名，跨文件 / 跨模式可复用；每文件内部以 YAML anchor（`x-base-env`）收敛 35+ 行重复 environment，`SECRET_KEY` / `ADMIN_PASSWORD` 的 `${VAR:?}` fail-fast 校验保留；⑤ 文档同步 11 文件：[DEPLOYMENT.md](DEPLOYMENT.md) §1.1 新增一键部署总表 + §2 三模式各附文件名与等价命令，[deployment/LINUX_SETUP.md](deployment/LINUX_SETUP.md) §6/§11 重写，[README.md](../README.md) 快速开始与 Compose 入口、[OPERATIONS.md](OPERATIONS.md) §4、[deploy/build.sh](../deploy/build.sh) / [.bat](../deploy/build.bat) 末尾提示、PORT_CONFIG / DEPLOY_PORT / STORAGE_SETUP / frontend/README 链接全部对齐（`AGENTS.md` §4.1 部署方式→DEPLOYMENT 同步规则满足）。**验证**：三文件 YAML 解析 + 结构静态校验通过（services / profiles / depends_on / 卷声明 / anchor 合并 / 网络命名）；5 个 service 的 environment 键与拆分前逐一比对（YAML 展开合并键后 39/39、34/34、39/39、34/34、20/20）零丢失。**遗留**：本机无 docker，`docker compose -f <file> config` 干跑与真实 up 待部署机执行。）
+>
 > 2026-09-24（**D17 Human-in-Loop 老师傅经验反馈批 3 上线（前端按钮 + Dialog + 经验角标）——闭环可视**：① [ResultView.vue:35-47](frontend/src/modules/moldinsight/ResultView.vue#L35-L47) 方案卡片 summary-header 加 `t-tag theme="success" variant="light"` 经验角标（"📚 历史经验 N 条"），从 `hintsByAxis[currentAxisHint]` 读取，按 scheme_axis 索引，无 hints 时不渲染；② [ResultView.vue:131-138](frontend/src/modules/moldinsight/ResultView.vue#L131-L138) `export-buttons-bar` 加 `👍 老师傅反馈` 按钮（`v-if="canGiveFeedback"` 角色门控：admin 或 process_engineer）；③ 新建 [components/HumanFeedbackDialog.vue](frontend/src/modules/moldinsight/components/HumanFeedbackDialog.vue)：t-dialog + t-form + t-radio-group 三选一（采纳 / 建议调整 / 拒绝）+ t-textarea 原因 + 调整建议（仅 adjust 模式显隐）；提交走 `moldinsightApi.submitExperienceFeedback`，成功后 emit `submitted` 让父组件重拉 hints 刷新角标；④ [shared/api-client.ts:407-444](frontend/src/shared/api-client.ts#L407-L444) `moldinsightApi` 新增 `getExperienceHints` / `submitExperienceFeedback` 两个方法（生成类型由 openapi-typescript 自动产出）；⑤ [ResultView.vue](frontend/src/modules/moldinsight/ResultView.vue) `onMounted` 调 `loadExperienceHints` 拉一次 + 反馈提交后 `onFeedbackSubmitted` 再拉一次（写入即消费前端可见）；`canGiveFeedback` 走 `is_superuser || roles 含 process_engineer` 表达式（项目硬规则"前端不要破坏 ResultView.vue 视觉一致性"：按钮与既有 6 个 t-button 同一 `export-buttons-bar`，theme/size 一致；角标 theme="success" variant="light" 与既有 t-tag theme="primary" / "warning" 同款）。**接口变更三件套随批完成**：openapi.json 重导出（2 个新 path，含 ExperienceFeedbackCreate / ExperienceHintItem / ExperienceHintsResponse 三个新 schema）→ `npm run gen:api` 再生 types/api.ts → `npm run build` 通过。**后端基线**：**192 passed, 13 skipped**（批 3 不改后端）；**前端构建**：vue-tsc + vite 通过，ResultView 包大小 37.18 kB / 11.91 kB gzip。**D17 闭环端到端可用**：admin / process_engineer 在 ResultView 点"👍 老师傅反馈" → Dialog 选"采纳"+ 写原因 → 提交 → 角标即时刷新（重拉 hints）；下次同指纹 STP 分析，`PartingCandidateGenerator` 候选方向加成 + `PartingSchemeScorer` total_score 加成 + method 标签升级 `human_experience_primary`。**下一步**：批 4（衰减机制完善 + DFM 规则库独立模块化 + 经验冲突仲裁 UI）按需排期。）
 
 > 2026-09-23（**D17 Human-in-Loop 老师傅经验反馈批 2 上线（算法接缝 + OCC payload 通道）——闭环通**：① 算法层 4 个核心文件加 `hints` 形参透传链：[parting_candidate_generator.py:13-66](src/moldinsight/core/parting_candidate_generator.py#L13-L66) `_build_axis_metrics` 末尾按 hints 加成（`weight × 20` 上限，`sample_count ≥ 2 + weight ≥ 0.5` → method 标签升级 `human_experience_primary`）；[parting_scheme_scorer.py:8-46](src/moldinsight/core/parting_scheme_scorer.py#L8-L46) `_score_scheme` 新增 `human_hint_bonus` 字段（weight × 12 上限，sample_count < 2 时 ×0.5 折半），纳入 total_score；[multi_scheme_planner.py:26-86](src/moldinsight/core/multi_scheme_planner.py#L26-L86) `generate_plan` 透传 hints 到下两层，`global_summary.applied_hints` 注入返回；② [processing_service.py:531-595](src/moldinsight/services/processing_service.py#L531-L595) `_step_generate_cavity` 调 `experience_feedback_service.resolve_for_process_params` 拿同指纹 hints，装进 run_occ payload 顶层 `experience_hints` 字段（普通 dict 透传，pickle 安全，满足 [occ_worker.py:7-8](src/moldinsight/core/occ_worker.py#L7-L8) 硬规则）；③ [occ_worker.py:117-140](src/moldinsight/core/occ_worker.py#L117-L140) `_op_generate_cavity` 读 `payload.get("experience_hints") or {}` 透传给 `planner.generate_plan(..., hints=...)`；④ D17 闭环验证：老师傅写一条同指纹 `adopted` → 同 X 通道下次分析 `priority_score` +18，`score_breakdown.human_hint_bonus` +12（sample_count=3），method 标签升级 `human_experience_primary`。**接口面零变化**（路径 / schema 不动；仅 OCC 子进程内部响应含 `global_summary.applied_hints`，由前端 ResultView 渲染角标——批 3 实现）。**测试基线**：**192 passed, 13 skipped**（批 2 净增 7 通过 + 4 OCC-gated skip：candidate_generator 3 例 / scheme_scorer 4 例在无 OCC 环境跑通，multi_scheme_planner + processing_service 4 例 OCC-gated 待 conda `gemold` 镜像验证）。**接口变更三件套执行节点**：openapi.json 重导出与前端 `gen:api` 待批 3 完成后一并执行（前端调用两 path + ResultView 渲染一并改）。**下一步**：批 3 前端（ResultView 按钮组 + `HumanFeedbackDialog.vue` + `moldinsightApi` 两个方法 + 经验角标）。）

docs/deployment/DEPLOY_PORT.md

@@ -64,7 +64,9 @@
 ## 3. Docker Compose 端口来源
 
 当前主部署文件：
-- [docker-compose.yml](../../docker-compose.yml)
+- [docker-compose.yml](../../docker-compose.yml)（unified，默认入口）
+- [docker-compose.moldinsight.yml](../../docker-compose.moldinsight.yml)
+- [docker-compose.inventory.yml](../../docker-compose.inventory.yml)
 
 关键端口映射：
 

docs/deployment/LINUX_SETUP.md

@@ -151,7 +151,7 @@ RUSTFS_SECRET_KEY=minioadmin
 - `/health` → unified backend
 - `/html` → unified backend（内部再提供 moldinsight 分析产物）
 
-如果使用根目录 [docker-compose.yml](../../docker-compose.yml) 的 `frontend` 服务，则该入口已经内置在前端 Nginx 镜像中。
+如果使用 [docker-compose.yml](../../docker-compose.yml)（unified 模式）的 `frontend` 服务，则该入口已经内置在前端 Nginx 镜像中。
 
 ---
 
@@ -199,7 +199,9 @@ celery -A src.celery_app.celery_app worker --loglevel=info
 如需按模块独立部署，则使用 `moldinsight-only` 或 `inventory-only` 入口；它们仍共享同一个仓库、同一个数据库与同一套基础设施。
 
 当前入口与部署编排见：
-- [../../docker-compose.yml](../../docker-compose.yml)
+- [../../docker-compose.yml](../../docker-compose.yml)（默认 unified）
+- [../../docker-compose.moldinsight.yml](../../docker-compose.moldinsight.yml)
+- [../../docker-compose.inventory.yml](../../docker-compose.inventory.yml)
 - [../../src/entrypoints/unified.py](../../src/entrypoints/unified.py)
 
 ---
@@ -398,25 +400,40 @@ curl http://127.0.0.1:8000/health
 
 ## 11. Docker Compose 说明
 
-当前 [docker-compose.yml](../../docker-compose.yml) 会启动：
+仓库根目录维护 3 个独立 compose 文件，按文件名映射部署模式：
 
-- `frontend`
-- `backend`
-- `moldinsight-celery`
-- 可选：`moldinsight` / `inventory`（独立模块模式）
+| 模式 | Compose 文件 | 一键命令 |
+|---|---|---|
+| unified（默认） | [docker-compose.yml](../../docker-compose.yml) | `docker compose up -d` |
+| moldinsight-only | [docker-compose.moldinsight.yml](../../docker-compose.moldinsight.yml) | `docker compose -f docker-compose.moldinsight.yml up -d` |
+| inventory-only | [docker-compose.inventory.yml](../../docker-compose.inventory.yml) | `docker compose -f docker-compose.inventory.yml up -d` |
 
-它**不会**再拉起：
+每个 service 的 `profiles:` 字段仍在老 `--profile` 命令下生效（双保险）：
+
+| 文件 | 等价 `--profile` 命令 |
+|---|---|
+| [docker-compose.yml](../../docker-compose.yml) | `docker compose --profile full up -d` |
+| [docker-compose.moldinsight.yml](../../docker-compose.moldinsight.yml) | `docker compose --profile moldinsight up -d` |
+| [docker-compose.inventory.yml](../../docker-compose.inventory.yml) | `docker compose --profile inventory up -d` |
+
+不同模式分别包含的服务：
+
+- **unified**：`frontend` + `backend`（unified 入口）+ `moldinsight-celery`
+- **moldinsight-only**：`moldinsight`（独立 API）+ `moldinsight-celery`
+- **inventory-only**：仅 `inventory`
+
+任一 compose 文件**都不会**再拉起：
 
 - PostgreSQL
 - Redis
-- MinIO
+- MinIO / RustFS
 
-这些基础设施应由服务器现有服务提供，并通过 `.env` 传入连接信息；前端则由 `frontend` 容器独立提供，并通过同域反代转发到后端。
+这些基础设施应由服务器现有服务提供，并通过 `.env` 传入连接信息；前端则由 `frontend` 容器独立提供（仅 unified 模式包含），通过同域反代转发到后端。
 
-示例：
+镜像构建：
 
 ```bash
-docker compose --profile full up -d
+bash deploy/build.sh        # base → backend → celery → frontend
 ```
 
 ---

docs/deployment/PORT_CONFIG.md

@@ -17,10 +17,12 @@
 
 对于 Docker Compose 部署，当前主要端口配置来源于：
 
-- [docker-compose.yml](../../docker-compose.yml)
+- [docker-compose.yml](../../docker-compose.yml)（unified，默认入口）
+- [docker-compose.moldinsight.yml](../../docker-compose.moldinsight.yml)
+- [docker-compose.inventory.yml](../../docker-compose.inventory.yml)
 - `.env` / `deploy/.env.example`
 
-注意：该 compose 文件仅负责项目应用容器，不负责 PostgreSQL / Redis / 对象存储容器。
+注意：这些 compose 文件仅负责项目应用容器，不负责 PostgreSQL / Redis / 对象存储容器。
 
 核心环境变量：
 
@@ -116,7 +118,8 @@ Compose 通过端口映射暴露服务：
 - inventory → `${INVENTORY_PORT}:8001`
 
 当前实际定义见：
-- [docker-compose.yml](../../docker-compose.yml)
+- [docker-compose.yml](../../docker-compose.yml)（unified / moldinsight-only）
+- [docker-compose.inventory.yml](../../docker-compose.inventory.yml)（inventory-only 的 `INVENTORY_PORT`）
 
 ---
 

docs/topics/storage/STORAGE_SETUP.md

@@ -116,9 +116,11 @@ RUSTFS_SECRET_KEY=change-me
 
 ### 3. 启动项目服务
 
-当前推荐通过：
-- [docker-compose.yml](../../../docker-compose.yml)
-- 或 [src/entrypoints/](../../../src/entrypoints/)
+当前推荐通过（按模式对应不同 compose 文件）：
+- `docker compose up -d`（[docker-compose.yml](../../../docker-compose.yml)，默认 unified）
+- `docker compose -f docker-compose.moldinsight.yml up -d`
+- `docker compose -f docker-compose.inventory.yml up -d`
+- 或直接 [src/entrypoints/](../../../src/entrypoints/) 入口
 
 而不是继续使用历史单体 `python src/main.py` 作为默认方式。