🔧 build(deploy): 端口默认值统一 10003/10004——前端入口固定 10003

约定"容器内部端口无所谓，重要的是宿主机端口；前端 = 10003"。

- .env.example 端口段重写：移除冗余 HOST/PORT（uvicorn 命令硬编码，
  无人读 env）+ 移除误导注释；FRONTEND_PORT/BACKEND_PORT/MOLDINSIGHT_PORT
  默认 10003，INVENTORY_PORT 默认 10004
- docker-compose.yml frontend 默认 80→10003、backend 8000→10003，删除
  backend service 内冗余 HOST/PORT env
- docker-compose.moldinsight.yml / docker-compose.inventory.yml 默认
  端口同步
- DEPLOY_PORT §3 / PORT_CONFIG §1 §2 端口映射示例同步
- STATUS 补录

验证：yaml 渲染端口映射 unified frontend 10003→80、backend 10003→8000，
moldinsight 10003→8000，inventory 10004→8001。

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

docs/deployment/DEPLOY_PORT.md

@@ -68,24 +68,24 @@
 - [docker-compose.moldinsight.yml](../../docker-compose.moldinsight.yml)
 - [docker-compose.inventory.yml](../../docker-compose.inventory.yml)
 
-关键端口映射：
+关键端口映射（默认 10003 / 10004，详见 [.env.example](../../.env.example)）：
 
-- `FRONTEND_PORT` → frontend Nginx 外部端口
-- `BACKEND_PORT` → unified backend 外部端口
+- `FRONTEND_PORT` → frontend Nginx 外部端口（浏览器入口，推荐直接访问）
+- `BACKEND_PORT` → unified backend 外部端口（一般不直接访问，经前端 /api 反代同域访问）
 - `MOLDINSIGHT_PORT` → moldinsight-only 独立部署端口
 - `INVENTORY_PORT` → inventory-only 独立部署端口
 
 示例：
 
 ```env
-MOLDINSIGHT_PORT=8000
-INVENTORY_PORT=8001
+MOLDINSIGHT_PORT=10003
+INVENTORY_PORT=10004
 ```
 
 对应 compose 行为：
 
-- moldinsight：`${MOLDINSIGHT_PORT:-8000}:8000`
-- inventory：`${INVENTORY_PORT:-8001}:8001`
+- moldinsight：`${MOLDINSIGHT_PORT:-10003}:8000`
+- inventory：`${INVENTORY_PORT:-10004}:8001`
 
 ---
 

docs/deployment/PORT_CONFIG.md

@@ -27,10 +27,10 @@
 核心环境变量：
 
 ```env
-FRONTEND_PORT=80
-BACKEND_PORT=8000
-MOLDINSIGHT_PORT=8000
-INVENTORY_PORT=8001
+FRONTEND_PORT=10003    # 浏览器入口（前端 Nginx 对外端口）
+BACKEND_PORT=10003     # unified backend 对外端口（一般不直接访问，经前端反代）
+MOLDINSIGHT_PORT=10003 # moldinsight-only 独立部署时使用
+INVENTORY_PORT=10004   # inventory-only 独立部署时使用
 ```
 
 其余基础设施通常为：
@@ -52,10 +52,10 @@ RUSTFS_ENDPOINT=http://localhost:9000
 
 | 变量 / 端口 | 用途 |
 |---|---|
-| `FRONTEND_PORT` | 前端 Nginx 宿主机暴露端口 |
-| `BACKEND_PORT` | unified backend 宿主机暴露端口 |
-| `MOLDINSIGHT_PORT` | moldinsight-only 独立部署端口 |
-| `INVENTORY_PORT` | inventory-only 独立部署端口 |
+| `FRONTEND_PORT`（默认 10003） | 前端 Nginx 宿主机暴露端口（浏览器入口） |
+| `BACKEND_PORT`（默认 10003） | unified backend 宿主机暴露端口（一般不直接访问，经前端 /api 反代） |
+| `MOLDINSIGHT_PORT`（默认 10003） | moldinsight-only 独立部署端口 |
+| `INVENTORY_PORT`（默认 10004） | inventory-only 独立部署端口 |
 | `DB_PORT` | PostgreSQL 端口 |
 | `REDIS_PORT` | Redis 端口 |
 | `9000` | MinIO/RustFS S3 兼容 API |