diff --git a/README.md b/README.md index 0f0c278..71177c1 100644 --- a/README.md +++ b/README.md @@ -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` --- diff --git a/deploy/build.bat b/deploy/build.bat index 7a64ed1..016a149 100644 --- a/deploy/build.bat +++ b/deploy/build.bat @@ -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 diff --git a/deploy/build.sh b/deploy/build.sh index 77109f7..8fa432a 100644 --- a/deploy/build.sh +++ b/deploy/build.sh @@ -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" diff --git a/docker-compose.inventory.yml b/docker-compose.inventory.yml new file mode 100644 index 0000000..81fbb8e --- /dev/null +++ b/docker-compose.inventory.yml @@ -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 \ No newline at end of file diff --git a/docker-compose.moldinsight.yml b/docker-compose.moldinsight.yml new file mode 100644 index 0000000..c022c9a --- /dev/null +++ b/docker-compose.moldinsight.yml @@ -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 \ No newline at end of file diff --git a/docker-compose.yml b/docker-compose.yml index 9f2b870..3034566 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -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 \ No newline at end of file diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md index 2907c98..3e973f0 100644 --- a/docs/DEPLOYMENT.md +++ b/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 ` 直接按文件名选择。两种写法等价。 + +### 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)。 --- diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.md index 3aed0dc..2e278c2 100644 --- a/docs/OPERATIONS.md +++ b/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. 运行时硬性要求 diff --git a/docs/STATUS.md b/docs/STATUS.md index 66e6a72..246430d 100644 --- a/docs/STATUS.md +++ b/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 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` 两个方法 + 经验角标）。） diff --git a/docs/deployment/DEPLOY_PORT.md b/docs/deployment/DEPLOY_PORT.md index 20d0382..dc4e27b 100644 --- a/docs/deployment/DEPLOY_PORT.md +++ b/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) 关键端口映射： diff --git a/docs/deployment/LINUX_SETUP.md b/docs/deployment/LINUX_SETUP.md index 5663700..f93e367 100644 --- a/docs/deployment/LINUX_SETUP.md +++ b/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 ``` --- diff --git a/docs/deployment/PORT_CONFIG.md b/docs/deployment/PORT_CONFIG.md index 44b1bf7..363ef5a 100644 --- a/docs/deployment/PORT_CONFIG.md +++ b/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`） --- diff --git a/docs/topics/storage/STORAGE_SETUP.md b/docs/topics/storage/STORAGE_SETUP.md index effd29a..13c7da6 100644 --- a/docs/topics/storage/STORAGE_SETUP.md +++ b/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` 作为默认方式。 diff --git a/frontend/README.md b/frontend/README.md index 1b0eb3a..9380ffa 100644 --- a/frontend/README.md +++ b/frontend/README.md @@ -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 ```