📦 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>
2026-09-24 15:28:13 +08:00
parent 6baa6b0d0a
commit a548623ea5
14 changed files with 398 additions and 216 deletions
@@ -63,12 +63,21 @@ npm install
 推荐先查看部署入口：
 - [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md)

-本地常见方式：
+本地常见方式（按模式对应不同 compose 文件）：

 ```bash
-docker compose --profile full up -d
+# 默认：unified（前端 + 后端 + Celery）
+docker compose up -d
+
+# 仅模具分析
+docker compose -f docker-compose.moldinsight.yml up -d
+
+# 仅进销存
+docker compose -f docker-compose.inventory.yml up -d
 ```

+> 镜像首次构建：`bash deploy/build.sh`（build base → backend → celery → frontend 4 个 tag）。
+
 如需直接运行：

 ```bash
@@ -170,9 +179,15 @@ geMoldInsight/

 ## 当前代码入口

+- unified： [src/entrypoints/unified.py](src/entrypoints/unified.py)
 - moldinsight-only： [src/entrypoints/moldinsight.py](src/entrypoints/moldinsight.py)
 - inventory-only： [src/entrypoints/inventory.py](src/entrypoints/inventory.py)
- 当前 Compose 入口： [docker-compose.yml](docker-compose.yml)
+
+当前 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`

 ---

@@ -23,17 +23,16 @@ docker build -t gemold-frontend:latest -f deploy\Dockerfile.frontend .
 echo.
 echo === 全部构建完成 ===
 echo.
-echo 启动完整系统（前端 + unified backend + celery）:
-echo   docker compose --profile full up -d
+echo 启动 unified 默认栈（前端 + backend + celery）:
+echo   docker compose up -d
+echo   # 或：docker compose --profile full up -d
 echo.
-echo 仅启动 unified backend:
-echo   docker compose --profile unified up -d
+echo 按文件名切换模式:
+echo   docker compose -f docker-compose.moldinsight.yml up -d
+echo   docker compose -f docker-compose.inventory.yml up -d
 echo.
-echo 仅启动前端入口:
-echo   docker compose --profile frontend up -d
-echo.
-echo 仅启动进销存:
-echo   docker compose --profile inventory up -d
-echo.
-echo 仅启动模具分析:
-echo   docker compose --profile moldinsight up -d
+echo profile 写法（兼容旧脚本）:
+echo   docker compose --profile unified up -d        # backend + celery
+echo   docker compose --profile frontend up -d       # 仅前端
+echo   docker compose --profile moldinsight up -d    # moldinsight + celery
+echo   docker compose --profile inventory up -d      # 仅 inventory
@@ -25,17 +25,16 @@ docker build -t gemold-frontend:latest -f deploy/Dockerfile.frontend .
 echo ""
 echo "=== 全部构建完成 ==="
 echo ""
-echo "启动完整系统（前端 + unified backend + celery）:"
-echo "  docker compose --profile full up -d"
+echo "启动 unified 默认栈（前端 + backend + celery）:"
+echo "  docker compose up -d"
+echo "  # 或等价：docker compose --profile full up -d"
 echo ""
-echo "仅启动 unified backend:"
-echo "  docker compose --profile unified up -d"
+echo "按文件名切换模式:"
+echo "  docker compose -f docker-compose.moldinsight.yml up -d"
+echo "  docker compose -f docker-compose.inventory.yml up -d"
 echo ""
-echo "仅启动前端入口:"
-echo "  docker compose --profile frontend up -d"
-echo ""
-echo "仅启动进销存:"
-echo "  docker compose --profile inventory up -d"
-echo ""
-echo "仅启动模具分析:"
-echo "  docker compose --profile moldinsight up -d"
+echo "profile 写法（兼容旧脚本）:"
+echo "  docker compose --profile unified up -d        # backend + celery"
+echo "  docker compose --profile frontend up -d       # 仅前端"
+echo "  docker compose --profile moldinsight up -d    # moldinsight + celery"
+echo "  docker compose --profile inventory up -d      # 仅 inventory"
@@ -0,0 +1,60 @@
+# geMoldInsight — inventory-only 模式
+#
+# 一键启动：
+#   docker compose -f docker-compose.inventory.yml up -d
+# 等价命令（profile 双保险）：
+#   docker compose --profile inventory up -d
+#
+# 服务清单：仅 inventory 后端
+# 不含前端、不含 moldinsight、不含 Celery worker。
+#
+# 基础设施：仅依赖 PostgreSQL + Redis；不依赖 RustFS / MinIO 对象存储，
+# 不挂 uploads/html 命名卷（inventory 无文件分析链路）。
+
+# ---------------------------------------------------------------
+# 公共环境变量（inventory 子集：DB / Redis / 认证 / 启动参数）
+# ---------------------------------------------------------------
+x-inventory-env: &inventory_env
+  DB_HOST: ${DB_HOST}
+  DB_PORT: ${DB_PORT:-5432}
+  DB_NAME: ${DB_NAME:-moldinsight}
+  DB_USER: ${DB_USER}
+  DB_PASSWORD: ${DB_PASSWORD}
+  REDIS_HOST: ${REDIS_HOST}
+  REDIS_PORT: ${REDIS_PORT:-6379}
+  REDIS_PASSWORD: ${REDIS_PASSWORD:-}
+  SECRET_KEY: ${SECRET_KEY:?SECRET_KEY 未配置：请在 .env 中设置}
+  ALGORITHM: ${ALGORITHM:-HS256}
+  ACCESS_TOKEN_EXPIRE_MINUTES: ${ACCESS_TOKEN_EXPIRE_MINUTES:-1440}
+  DEBUG: ${DEBUG:-false}
+  SERVE_FRONTEND_STATIC: ${SERVE_FRONTEND_STATIC:-false}
+
+services:
+  inventory:
+    build:
+      context: .
+      dockerfile: deploy/Dockerfile.inventory
+    image: gemold-inventory:latest
+    container_name: gemold_inventory
+    command: ["python", "-m", "uvicorn", "entrypoints.inventory:app", "--host", "0.0.0.0", "--port", "8001"]
+    ports:
+      - "${INVENTORY_PORT:-8001}:8001"
+    environment:
+      <<: *inventory_env
+      HOST: 0.0.0.0
+      PORT: "8001"
+      ADMIN_USERNAME: ${ADMIN_USERNAME:-admin}
+      ADMIN_PASSWORD: ${ADMIN_PASSWORD:?ADMIN_PASSWORD 未配置：请在 .env 中设置}
+      ADMIN_EMAIL: ${ADMIN_EMAIL:-admin@gemold.com}
+      ADMIN_FULL_NAME: ${ADMIN_FULL_NAME:-系统管理员}
+      AUTO_MIGRATE: ${AUTO_MIGRATE:-true}
+    restart: unless-stopped
+    profiles:
+      - inventory
+    networks:
+      - gemold_network
+
+networks:
+  gemold_network:
+    name: gemold_network
+    driver: bridge
@@ -0,0 +1,114 @@
+# geMoldInsight — moldinsight-only 模式
+#
+# 一键启动：
+#   docker compose -f docker-compose.moldinsight.yml up -d
+# 等价命令（profile 双保险）：
+#   docker compose --profile moldinsight up -d
+#
+# 服务清单：moldinsight（独立 API）+ moldinsight-celery（异步分析 worker）
+# 不含前端、不含 inventory。
+#
+# 镜像说明：本文件里 moldinsight service 的 image 固定为 gemold-backend:latest，
+# 与 deploy/Dockerfile.celery 的 FROM gemold-backend:latest 对齐；只要 build.sh
+# 执行过（或已存在该 tag），celery 镜像就能正常构建，不再依赖 gemold-moldinsight tag。
+
+# ---------------------------------------------------------------
+# 公共环境变量（moldinsight 家族共用）
+# ---------------------------------------------------------------
+x-base-env: &base_env
+  DB_HOST: ${DB_HOST}
+  DB_PORT: ${DB_PORT:-5432}
+  DB_NAME: ${DB_NAME:-moldinsight}
+  DB_USER: ${DB_USER}
+  DB_PASSWORD: ${DB_PASSWORD}
+  REDIS_HOST: ${REDIS_HOST}
+  REDIS_PORT: ${REDIS_PORT:-6379}
+  REDIS_PASSWORD: ${REDIS_PASSWORD:-}
+  RUSTFS_ENDPOINT: ${RUSTFS_ENDPOINT}
+  RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY}
+  RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY}
+  RUSTFS_TIMEOUT: ${RUSTFS_TIMEOUT:-30}
+  SECRET_KEY: ${SECRET_KEY:?SECRET_KEY 未配置：请在 .env 中设置}
+  ALGORITHM: ${ALGORITHM:-HS256}
+  ACCESS_TOKEN_EXPIRE_MINUTES: ${ACCESS_TOKEN_EXPIRE_MINUTES:-1440}
+  DEBUG: ${DEBUG:-false}
+  SERVE_FRONTEND_STATIC: ${SERVE_FRONTEND_STATIC:-false}
+  UPLOAD_DIR: ${UPLOAD_DIR:-./uploads}
+  MAX_FILE_SIZE: ${MAX_FILE_SIZE:-104857600}
+  ALLOWED_EXTENSIONS: ${ALLOWED_EXTENSIONS:-.stp,.step,.stp.gz}
+  POINTCLOUD_SAMPLE_COUNT: ${POINTCLOUD_SAMPLE_COUNT:-10000}
+  MESH_QUALITY: ${MESH_QUALITY:-high}
+  PARALLEL_PROCESSING: ${PARALLEL_PROCESSING:-true}
+  RUSTFS_PRESIGNED_URL_EXPIRES: ${RUSTFS_PRESIGNED_URL_EXPIRES:-3600}
+  ENABLE_FREECAD_VERIFICATION: ${ENABLE_FREECAD_VERIFICATION:-false}
+  FREECAD_VERIFICATION_TIMEOUT: ${FREECAD_VERIFICATION_TIMEOUT:-120}
+  LLM_ENABLED: ${LLM_ENABLED:-false}
+  LLM_API_URL: ${LLM_API_URL:-https://api.openai.com/v1}
+  LLM_API_KEY: ${LLM_API_KEY:-}
+  LLM_MODEL: ${LLM_MODEL:-gpt-4o-mini}
+  LLM_TIMEOUT: ${LLM_TIMEOUT:-60}
+  LLM_MAX_TOKENS: ${LLM_MAX_TOKENS:-2000}
+
+services:
+  moldinsight:
+    build:
+      context: .
+      dockerfile: deploy/Dockerfile.moldinsight
+    # 与 Dockerfile.celery 的 FROM 对齐；统一用 gemold-backend tag，避免历史
+    # gemold-moldinsight:latest / gemold-backend:latest 双 tag 漂移
+    image: gemold-backend:latest
+    container_name: gemold_moldinsight
+    command: ["python", "-m", "uvicorn", "entrypoints.moldinsight:app", "--host", "0.0.0.0", "--port", "8000"]
+    ports:
+      - "${MOLDINSIGHT_PORT:-8000}:8000"
+    environment:
+      <<: *base_env
+      HOST: 0.0.0.0
+      PORT: "8000"
+      ADMIN_USERNAME: ${ADMIN_USERNAME:-admin}
+      ADMIN_PASSWORD: ${ADMIN_PASSWORD:?ADMIN_PASSWORD 未配置：请在 .env 中设置}
+      ADMIN_EMAIL: ${ADMIN_EMAIL:-admin@gemold.com}
+      ADMIN_FULL_NAME: ${ADMIN_FULL_NAME:-系统管理员}
+      AUTO_MIGRATE: ${AUTO_MIGRATE:-true}
+    # uploads_data：D6 过渡兜底，RustFS 异常时本地路径回退
+    # html_data：D11 后仅作 /html 报告代理的存量兜底读（新产物不落本地）
+    volumes:
+      - uploads_data:/app/uploads
+      - html_data:/app/html_output
+    restart: unless-stopped
+    profiles:
+      - moldinsight
+    networks:
+      - gemold_network
+
+  moldinsight-celery:
+    build:
+      context: .
+      dockerfile: deploy/Dockerfile.celery
+    container_name: gemold_celery
+    environment:
+      <<: *base_env
+      # Celery/OCC 吞吐调优（OCC_THROUGHPUT 方案 A，默认值在 Dockerfile.celery）
+      CELERY_CONCURRENCY: ${CELERY_CONCURRENCY:-2}
+      CELERY_MAX_TASKS_PER_CHILD: ${CELERY_MAX_TASKS_PER_CHILD:-50}
+    volumes:
+      - uploads_data:/app/uploads
+    # 注：本文件无 backend service，celery 必须等 moldinsight API 就绪后再启动
+    depends_on:
+      - moldinsight
+    restart: unless-stopped
+    profiles:
+      - moldinsight
+    networks:
+      - gemold_network
+
+networks:
+  gemold_network:
+    name: gemold_network
+    driver: bridge
+
+volumes:
+  uploads_data:
+    name: gemold_uploads_data
+  html_data:
+    name: gemold_html_data
@@ -1,3 +1,58 @@
+# geMoldInsight — unified 模式（默认入口）
+#
+# 一键启动：
+#   docker compose up -d                          # 推荐（默认走本文件）
+# 等价命令（保留 profile 双保险，AGENTS.md 兼容性需要）：
+#   docker compose --profile full up -d           # frontend + backend + celery
+#   docker compose --profile unified up -d        # backend + celery（不带前端）
+#   docker compose --profile frontend up -d       # 只起前端
+#
+# 其他模式（换文件名）：
+#   docker compose -f docker-compose.moldinsight.yml up -d
+#   docker compose -f docker-compose.inventory.yml up -d
+#
+# 服务清单：frontend + backend(unified 入口) + moldinsight-celery
+# 镜像构建顺序由 deploy/build.sh 保证（base → backend → frontend，celery 复用 backend）
+
+# ---------------------------------------------------------------
+# 公共环境变量（moldinsight 家族 backend/celery/moldinsight 共用）
+# 通过 anchor 在本文件内复用，避免 environment 块重复
+# ---------------------------------------------------------------
+x-base-env: &base_env
+  DB_HOST: ${DB_HOST}
+  DB_PORT: ${DB_PORT:-5432}
+  DB_NAME: ${DB_NAME:-moldinsight}
+  DB_USER: ${DB_USER}
+  DB_PASSWORD: ${DB_PASSWORD}
+  REDIS_HOST: ${REDIS_HOST}
+  REDIS_PORT: ${REDIS_PORT:-6379}
+  REDIS_PASSWORD: ${REDIS_PASSWORD:-}
+  RUSTFS_ENDPOINT: ${RUSTFS_ENDPOINT}
+  RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY}
+  RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY}
+  RUSTFS_TIMEOUT: ${RUSTFS_TIMEOUT:-30}
+  # SECRET_KEY 必须在 .env 中显式配置，否则 compose 直接失败
+  SECRET_KEY: ${SECRET_KEY:?SECRET_KEY 未配置：请在 .env 中设置}
+  ALGORITHM: ${ALGORITHM:-HS256}
+  ACCESS_TOKEN_EXPIRE_MINUTES: ${ACCESS_TOKEN_EXPIRE_MINUTES:-1440}
+  DEBUG: ${DEBUG:-false}
+  SERVE_FRONTEND_STATIC: ${SERVE_FRONTEND_STATIC:-false}
+  UPLOAD_DIR: ${UPLOAD_DIR:-./uploads}
+  MAX_FILE_SIZE: ${MAX_FILE_SIZE:-104857600}
+  ALLOWED_EXTENSIONS: ${ALLOWED_EXTENSIONS:-.stp,.step,.stp.gz}
+  POINTCLOUD_SAMPLE_COUNT: ${POINTCLOUD_SAMPLE_COUNT:-10000}
+  MESH_QUALITY: ${MESH_QUALITY:-high}
+  PARALLEL_PROCESSING: ${PARALLEL_PROCESSING:-true}
+  RUSTFS_PRESIGNED_URL_EXPIRES: ${RUSTFS_PRESIGNED_URL_EXPIRES:-3600}
+  ENABLE_FREECAD_VERIFICATION: ${ENABLE_FREECAD_VERIFICATION:-false}
+  FREECAD_VERIFICATION_TIMEOUT: ${FREECAD_VERIFICATION_TIMEOUT:-120}
+  LLM_ENABLED: ${LLM_ENABLED:-false}
+  LLM_API_URL: ${LLM_API_URL:-https://api.openai.com/v1}
+  LLM_API_KEY: ${LLM_API_KEY:-}
+  LLM_MODEL: ${LLM_MODEL:-gpt-4o-mini}
+  LLM_TIMEOUT: ${LLM_TIMEOUT:-60}
+  LLM_MAX_TOKENS: ${LLM_MAX_TOKENS:-2000}
+
 services:
  frontend:
    build:
@@ -26,44 +81,13 @@ services:
    ports:
      - "${BACKEND_PORT:-8000}:8000"
    environment:
+      <<: *base_env
      HOST: 0.0.0.0
      PORT: "8000"
-      DB_HOST: ${DB_HOST}
-      DB_PORT: ${DB_PORT:-5432}
-      DB_NAME: ${DB_NAME:-moldinsight}
-      DB_USER: ${DB_USER}
-      DB_PASSWORD: ${DB_PASSWORD}
-      REDIS_HOST: ${REDIS_HOST}
-      REDIS_PORT: ${REDIS_PORT:-6379}
-      REDIS_PASSWORD: ${REDIS_PASSWORD:-}
-      RUSTFS_ENDPOINT: ${RUSTFS_ENDPOINT}
-      RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY}
-      RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY}
-      RUSTFS_TIMEOUT: ${RUSTFS_TIMEOUT:-30}
-      SECRET_KEY: ${SECRET_KEY:?SECRET_KEY 未配置：请在 .env 中设置}
      ADMIN_USERNAME: ${ADMIN_USERNAME:-admin}
      ADMIN_PASSWORD: ${ADMIN_PASSWORD:?ADMIN_PASSWORD 未配置：请在 .env 中设置}
      ADMIN_EMAIL: ${ADMIN_EMAIL:-admin@gemold.com}
      ADMIN_FULL_NAME: ${ADMIN_FULL_NAME:-系统管理员}
-      ALGORITHM: ${ALGORITHM:-HS256}
-      ACCESS_TOKEN_EXPIRE_MINUTES: ${ACCESS_TOKEN_EXPIRE_MINUTES:-1440}
-      DEBUG: ${DEBUG:-false}
-      SERVE_FRONTEND_STATIC: ${SERVE_FRONTEND_STATIC:-false}
-      UPLOAD_DIR: ${UPLOAD_DIR:-./uploads}
-      MAX_FILE_SIZE: ${MAX_FILE_SIZE:-104857600}
-      ALLOWED_EXTENSIONS: ${ALLOWED_EXTENSIONS:-.stp,.step,.stp.gz}
-      POINTCLOUD_SAMPLE_COUNT: ${POINTCLOUD_SAMPLE_COUNT:-10000}
-      MESH_QUALITY: ${MESH_QUALITY:-high}
-      PARALLEL_PROCESSING: ${PARALLEL_PROCESSING:-true}
-      RUSTFS_PRESIGNED_URL_EXPIRES: ${RUSTFS_PRESIGNED_URL_EXPIRES:-3600}
-      ENABLE_FREECAD_VERIFICATION: ${ENABLE_FREECAD_VERIFICATION:-false}
-      FREECAD_VERIFICATION_TIMEOUT: ${FREECAD_VERIFICATION_TIMEOUT:-120}
-      LLM_ENABLED: ${LLM_ENABLED:-false}
-      LLM_API_URL: ${LLM_API_URL:-https://api.openai.com/v1}
-      LLM_API_KEY: ${LLM_API_KEY:-}
-      LLM_MODEL: ${LLM_MODEL:-gpt-4o-mini}
-      LLM_TIMEOUT: ${LLM_TIMEOUT:-60}
-      LLM_MAX_TOKENS: ${LLM_MAX_TOKENS:-2000}
      AUTO_MIGRATE: ${AUTO_MIGRATE:-true}
    # 共享卷过渡兜底（D6/D11）：主链路已改走 RustFS。uploads 供 RustFS 异常时
    # 本地路径回退；html_output 仅作 /html 报告代理的存量兜底读（新产物不落本地）
@@ -83,38 +107,7 @@ services:
      dockerfile: deploy/Dockerfile.celery
    container_name: gemold_celery
    environment:
-      DB_HOST: ${DB_HOST}
-      DB_PORT: ${DB_PORT:-5432}
-      DB_NAME: ${DB_NAME:-moldinsight}
-      DB_USER: ${DB_USER}
-      DB_PASSWORD: ${DB_PASSWORD}
-      REDIS_HOST: ${REDIS_HOST}
-      REDIS_PORT: ${REDIS_PORT:-6379}
-      REDIS_PASSWORD: ${REDIS_PASSWORD:-}
-      RUSTFS_ENDPOINT: ${RUSTFS_ENDPOINT}
-      RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY}
-      RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY}
-      RUSTFS_TIMEOUT: ${RUSTFS_TIMEOUT:-30}
-      SECRET_KEY: ${SECRET_KEY:?SECRET_KEY 未配置：请在 .env 中设置}
-      ALGORITHM: ${ALGORITHM:-HS256}
-      ACCESS_TOKEN_EXPIRE_MINUTES: ${ACCESS_TOKEN_EXPIRE_MINUTES:-1440}
-      DEBUG: ${DEBUG:-false}
-      SERVE_FRONTEND_STATIC: ${SERVE_FRONTEND_STATIC:-false}
-      UPLOAD_DIR: ${UPLOAD_DIR:-./uploads}
-      MAX_FILE_SIZE: ${MAX_FILE_SIZE:-104857600}
-      ALLOWED_EXTENSIONS: ${ALLOWED_EXTENSIONS:-.stp,.step,.stp.gz}
-      POINTCLOUD_SAMPLE_COUNT: ${POINTCLOUD_SAMPLE_COUNT:-10000}
-      MESH_QUALITY: ${MESH_QUALITY:-high}
-      PARALLEL_PROCESSING: ${PARALLEL_PROCESSING:-true}
-      RUSTFS_PRESIGNED_URL_EXPIRES: ${RUSTFS_PRESIGNED_URL_EXPIRES:-3600}
-      ENABLE_FREECAD_VERIFICATION: ${ENABLE_FREECAD_VERIFICATION:-false}
-      FREECAD_VERIFICATION_TIMEOUT: ${FREECAD_VERIFICATION_TIMEOUT:-120}
-      LLM_ENABLED: ${LLM_ENABLED:-false}
-      LLM_API_URL: ${LLM_API_URL:-https://api.openai.com/v1}
-      LLM_API_KEY: ${LLM_API_KEY:-}
-      LLM_MODEL: ${LLM_MODEL:-gpt-4o-mini}
-      LLM_TIMEOUT: ${LLM_TIMEOUT:-60}
-      LLM_MAX_TOKENS: ${LLM_MAX_TOKENS:-2000}
+      <<: *base_env
      # Celery/OCC 吞吐调优（OCC_THROUGHPUT 方案 A，默认值在 Dockerfile.celery）
      CELERY_CONCURRENCY: ${CELERY_CONCURRENCY:-2}
      CELERY_MAX_TASKS_PER_CHILD: ${CELERY_MAX_TASKS_PER_CHILD:-50}
@@ -128,107 +121,17 @@ services:
    profiles:
      - full
      - unified
-      - moldinsight
-    networks:
-      - gemold_network
-
-  moldinsight:
-    build:
-      context: .
-      dockerfile: deploy/Dockerfile.moldinsight
-    image: gemold-moldinsight:latest
-    container_name: gemold_moldinsight
-    ports:
-      - "${MOLDINSIGHT_PORT:-8000}:8000"
-    environment:
-      HOST: 0.0.0.0
-      PORT: "8000"
-      DB_HOST: ${DB_HOST}
-      DB_PORT: ${DB_PORT:-5432}
-      DB_NAME: ${DB_NAME:-moldinsight}
-      DB_USER: ${DB_USER}
-      DB_PASSWORD: ${DB_PASSWORD}
-      REDIS_HOST: ${REDIS_HOST}
-      REDIS_PORT: ${REDIS_PORT:-6379}
-      REDIS_PASSWORD: ${REDIS_PASSWORD:-}
-      RUSTFS_ENDPOINT: ${RUSTFS_ENDPOINT}
-      RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY}
-      RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY}
-      RUSTFS_TIMEOUT: ${RUSTFS_TIMEOUT:-30}
-      SECRET_KEY: ${SECRET_KEY:?SECRET_KEY 未配置：请在 .env 中设置}
-      ADMIN_USERNAME: ${ADMIN_USERNAME:-admin}
-      ADMIN_PASSWORD: ${ADMIN_PASSWORD:?ADMIN_PASSWORD 未配置：请在 .env 中设置}
-      ADMIN_EMAIL: ${ADMIN_EMAIL:-admin@gemold.com}
-      ADMIN_FULL_NAME: ${ADMIN_FULL_NAME:-系统管理员}
-      ALGORITHM: ${ALGORITHM:-HS256}
-      ACCESS_TOKEN_EXPIRE_MINUTES: ${ACCESS_TOKEN_EXPIRE_MINUTES:-1440}
-      DEBUG: ${DEBUG:-false}
-      SERVE_FRONTEND_STATIC: ${SERVE_FRONTEND_STATIC:-false}
-      UPLOAD_DIR: ${UPLOAD_DIR:-./uploads}
-      MAX_FILE_SIZE: ${MAX_FILE_SIZE:-104857600}
-      ALLOWED_EXTENSIONS: ${ALLOWED_EXTENSIONS:-.stp,.step,.stp.gz}
-      POINTCLOUD_SAMPLE_COUNT: ${POINTCLOUD_SAMPLE_COUNT:-10000}
-      MESH_QUALITY: ${MESH_QUALITY:-high}
-      PARALLEL_PROCESSING: ${PARALLEL_PROCESSING:-true}
-      RUSTFS_PRESIGNED_URL_EXPIRES: ${RUSTFS_PRESIGNED_URL_EXPIRES:-3600}
-      ENABLE_FREECAD_VERIFICATION: ${ENABLE_FREECAD_VERIFICATION:-false}
-      FREECAD_VERIFICATION_TIMEOUT: ${FREECAD_VERIFICATION_TIMEOUT:-120}
-      LLM_ENABLED: ${LLM_ENABLED:-false}
-      LLM_API_URL: ${LLM_API_URL:-https://api.openai.com/v1}
-      LLM_API_KEY: ${LLM_API_KEY:-}
-      LLM_MODEL: ${LLM_MODEL:-gpt-4o-mini}
-      LLM_TIMEOUT: ${LLM_TIMEOUT:-60}
-      LLM_MAX_TOKENS: ${LLM_MAX_TOKENS:-2000}
-      AUTO_MIGRATE: ${AUTO_MIGRATE:-true}
-    # html_output 仅作 /html 报告代理的存量兜底读（D11，新产物不落本地）
-    volumes:
-      - uploads_data:/app/uploads
-      - html_data:/app/html_output
-    restart: unless-stopped
-    profiles:
-      - moldinsight
-    networks:
-      - gemold_network
-
-  inventory:
-    build:
-      context: .
-      dockerfile: deploy/Dockerfile.inventory
-    image: gemold-inventory:latest
-    container_name: gemold_inventory
-    ports:
-      - "${INVENTORY_PORT:-8001}:8001"
-    environment:
-      HOST: 0.0.0.0
-      PORT: "8001"
-      DB_HOST: ${DB_HOST}
-      DB_PORT: ${DB_PORT:-5432}
-      DB_NAME: ${DB_NAME:-moldinsight}
-      DB_USER: ${DB_USER}
-      DB_PASSWORD: ${DB_PASSWORD}
-      REDIS_HOST: ${REDIS_HOST}
-      REDIS_PORT: ${REDIS_PORT:-6379}
-      REDIS_PASSWORD: ${REDIS_PASSWORD:-}
-      SECRET_KEY: ${SECRET_KEY:?SECRET_KEY 未配置：请在 .env 中设置}
-      ADMIN_USERNAME: ${ADMIN_USERNAME:-admin}
-      ADMIN_PASSWORD: ${ADMIN_PASSWORD:?ADMIN_PASSWORD 未配置：请在 .env 中设置}
-      ADMIN_EMAIL: ${ADMIN_EMAIL:-admin@gemold.com}
-      ADMIN_FULL_NAME: ${ADMIN_FULL_NAME:-系统管理员}
-      ALGORITHM: ${ALGORITHM:-HS256}
-      ACCESS_TOKEN_EXPIRE_MINUTES: ${ACCESS_TOKEN_EXPIRE_MINUTES:-1440}
-      DEBUG: ${DEBUG:-false}
-      SERVE_FRONTEND_STATIC: ${SERVE_FRONTEND_STATIC:-false}
-      AUTO_MIGRATE: ${AUTO_MIGRATE:-true}
-    restart: unless-stopped
-    profiles:
-      - inventory
    networks:
      - gemold_network

 networks:
  gemold_network:
+    # 固定 name，便于跨 compose 文件调试时容器互通（如 inventory-only 与 unified 临时联调）
+    name: gemold_network
    driver: bridge

 volumes:
  uploads_data:
+    name: gemold_uploads_data
  html_data:
+    name: gemold_html_data
@@ -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)。

 ---
@@ -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. 运行时硬性要求
@@ -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` 两个方法 + 经验角标）。）
@@ -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)

 关键端口映射：

@@ -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
 ```

 ---
@@ -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`）

 ---

@@ -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` 作为默认方式。

@@ -51,15 +51,15 @@ npm run build
 - [deploy/Dockerfile.frontend](../deploy/Dockerfile.frontend)
 - [deploy/nginx/frontend.conf](../deploy/nginx/frontend.conf)

-以及根目录 Compose 中的 `frontend` 服务：
+以及根目录 [docker-compose.yml](../docker-compose.yml)（unified 模式）中的 `frontend` 服务：

 ```bash
+# 仅起前端（假设后端已在 unified / moldinsight 模式下独立运行）
 docker compose --profile frontend up -d
-```

-完整系统：
-
-```bash
+# 完整系统（默认 unified）
+docker compose up -d
+# 或
 docker compose --profile full up -d
 ```