# 英德利 × 尚书｜运行与部署说明

## 本地运行

运行环境为 **Python 3.9 或以上版本**，以及支持 WebGL 的现代浏览器。三维页面建议开启浏览器硬件加速。

1. 完整解压交付包，保持 `demo/`、`scripts/` 与启动文件的相对位置。
2. macOS 双击 `启动体验.command`；Windows 双击 `启动体验.bat`。
3. 启动程序优先使用 8765、8766、8767 三个端口；端口被占用时自动选择三个空闲端口，不停止或占用已有服务。
4. 浏览器自动打开整合入口。以启动窗口显示的实际地址为准；默认地址为 **http://127.0.0.1:8766/package/**。
5. 使用期间保持启动窗口打开；结束时在该窗口按 **Ctrl+C** 停止服务。

| 入口 | 默认地址 |
|---|---|
| 客户展厅 | http://127.0.0.1:8765/ |
| 生产工作台 | http://127.0.0.1:8766/ |
| 采购工作台 | http://127.0.0.1:8767/ |

默认端口变化时，通过整合入口进入各站点，或复制启动窗口列出的地址。双击 `00_从这里开始.html` 可直接阅读文档，无须启动服务；交互业务页面须通过上述地址访问。

## 数据保存与常见问题

首次运行从干净的演示数据开始。已提交的客户需求、发布配置、工单、采购草稿和库存状态保存在 **`data/demo-state.json`**；正常停止再启动后继续保留。跨页面操作后刷新数据，查看最新结果。客户浏览器中的已保存方案与服务端业务记录分别保存。

- **提示找不到 Python：** 安装 Python 3.9 或以上版本，确认终端可运行 Python，再启动体验。
- **浏览器未自动打开：** 复制启动窗口中的整合入口地址。
- **三维区域未显示：** 使用支持 WebGL 的浏览器，检查硬件加速，刷新后重试。
- **无法保存记录：** 检查解压目录是否可写、磁盘是否有可用空间；不要在压缩包预览窗口中运行。
- **需要保留体验记录：** 停止服务后备份 `data/demo-state.json`；恢复前同样先停止服务。

本地体验使用三个回环地址入口和模拟数据，没有正式企业身份权限、真实大模型或 CAD 系统连接。端口划分不等于生产级隔离，本地启动程序不直接用于公网部署。

## 正式部署建议

正式平台采用三个独立入口，配合独立后端接口层、身份验证及服务端授权，通过尚书共享受控业务对象与版本。

| 规划入口 | 网络与职责 |
|---|---|
| `showroom.example.invalid` | 客户展厅；发布批准的产品资料、图片与轻量模型，接收需求 |
| `production.example.invalid` | 内网或 VPN；工程评审、版本发布、BOM、图纸、工单与质量 |
| `procurement.example.invalid` | 内网或 VPN；采购需求、缺料、采购审批、收货与库存 |

以上域名为规划示例。正式环境配置实际域名与 TLS，接入企业身份源，按岗位、项目和数据级别控制查看、下载、导出及执行动作。公开展示资产与工程原件分别存储，客户接口只返回批准公开的字段；成本、供应商及敏感工程信息留在内部系统。

尚书承担业务协同、受控动作、流程和权限基础；CAD/PDM 管理工程原件与工程版本；ERP 承担约定的采购、库存和财务主数据；MES/WMS 按现场执行范围接入。每类数据明确唯一权威来源，接口保留版本、幂等和对账机制，避免多个系统分别维护同一份 BOM。

正式上线依次完成接口与数据核验、权限测试、工程资料发布验证、备份恢复和故障回退演练，再开展试点业务验收。私有化 AI、组件参数化与工程图自动生成按建设计划接入，并以批准样例验证结果。