英德利 × 尚书 / 运行与部署说明
英德利 × 尚书｜运行与部署说明
本地运行
运行环境为 Python 3.9 或以上版本，以及支持 WebGL 的现代浏览器。三维页面建议开启浏览器硬件加速。
- 完整解压交付包，保持
demo/、scripts/与启动文件的相对位置。 - macOS 双击
启动体验.command；Windows 双击启动体验.bat。 - 启动程序优先使用 8765、8766、8767 三个端口；端口被占用时自动选择三个空闲端口，不停止或占用已有服务。
- 浏览器自动打开整合入口。以启动窗口显示的实际地址为准；默认地址为 https://yingdeli.dev.lingeringtek.cn/package/。
- 使用期间保持启动窗口打开；结束时在该窗口按 Ctrl+C 停止服务。
| 入口 | 默认地址 |
|---|---|
| 客户展厅 | https://yingdeli-showroom.dev.lingeringtek.cn/ |
| 生产工作台 | https://yingdeli.dev.lingeringtek.cn/ |
| 采购工作台 | https://yingdeli-procurement.dev.lingeringtek.cn/ |
默认端口变化时，通过整合入口进入各站点，或复制启动窗口列出的地址。双击 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、组件参数化与工程图自动生成按建设计划接入，并以批准样例验证结果。