OnebotCatalog/开发计划书.md

OnebotCatalog 开发计划书

定位：在现有 OnebotCatalog 基础上继续优化，不推翻重做。 更新时间：2026-08-31 配套文档：项目总览.md（全貌）、docs\工作交接.md（快速上手）、docs\部署清单.md（迁移部署）、OnebotCatalog升级改制开发说明书.md（升级方向）

---

一、当前状态总览

软件侧主线已全部打通：

• ✅ M1/M2/M3 核心软件完成（目录/选型/3D/下载/维护/发布）
• ✅ 参数化选型引擎一期（KC 试点）
• ✅ NX 按需生成服务二期 A 版（两天卡点「批处理导出 0 solid」已解决）
• ✅ 后台 /admin 密码登录 + 三 tab（UG 配置 / 参数配置 / 模型管理）
• ✅ 一键启动 _start_all.bat + 网页状态圆球

唯一真正卡进度的外部依赖：真实母模（建模工程师）。

---

二、范围决策（已定，避免反复）

决策	结论	日期
去 NX 化（升级 2）	❌ 不做。OCCT 程序化建模出不了真实母模精确几何，且与已打通的 NX 主线冲突	2026-08-31
TC 集成（M4 / 升级3 / 升级4）	⏳ 暂缓。代码对 TC 零感知，按优先级排在真母模+轻量化+部署之后	2026-08-31
Parasolid / STL 格式	❌ 已砍，非标生成只留 STEP / IGES / PRT	2026-08-27
OCCT 转换服务	✅ 做，但只当 STEP→glTF 转换器，不碰参数化建模	2026-08-31

---

三、任务清单与开工顺序

第一批：可立即开工（零依赖，可并行）

#	任务	说明	状态
1	OCCT 转换服务搭建	把 d:\source_code\occt_demo\occt_demo.py 固化成常驻 8090 服务 + /convert（STEP→glTF）+ /health	待开工
2	生产部署收尾	netsh urlacl 授权、网页 config.js 填生产地址、桌面 catalog.json genApi + 重建发布	待开工

第二批：网页 3D 轻量化（依赖任务 1）

#	任务	说明	状态
3	升级 1：网页 3D 轻量化	构建期批量预生成 glTF（标准档位 2772 个）+ 前端 Three.js 加载 glTF 降级新迪查看器	待开工（依赖 1）

第三批：数据管理（P1/P2，按需）

#	任务	说明	状态
4	升级 3：TC 母模数据源	母模入 TC + 发布工作流	暂缓
5	升级 4：客户 TC 检入	有 TC 大客户才做	暂缓

第四批：可选增强（P3）

#	任务	说明	状态
6	升级 5：增强功能	3D 标注 / 2D 尺寸 SVG / 工程图导出	暂缓

外部等待（不占开工，标注阻塞点）

#	任务	阻塞点	谁
7	真实母模	建模工程师做真实气缸母模（表达式名 bore/stroke/magOn/mountIdx 一字不差）	用户侧，唯一卡交付
8	NX 2512 换机实测	换机 + 验证 journal API / step214ug.exe	用户侧

---

四、开工顺序图

现在就能做（并行）：
  1 OCCT 转换服务  ─┐
  2 生产部署收尾    ─┴→ 3 网页3D轻量化 → 4 TC母模 → 5 客户TC检入 → 6 增强

外部等待（并行推进）：
  7 真母模、8 NX 2512 实测

---

五、架构关键认知（跨机器部署）

OCCT 转换服务不依赖 NX，服务器没装 NX 也能跑。分工：

服务器（无 NX）：GenServer + OCCT转换 + serve-web
局域网 NX 机器：NX worker（非标参数化生成 STEP）
对接方式：jobs/output/masters 目录用网络共享（UNC 路径）

---

六、下一步建议

1. 开工 任务 1（OCCT 转换服务） —— 升级 1 的唯一前置、零风险、已验证
2. 并行推进 任务 2（生产部署收尾） —— 需用户提供服务器 IP/域名
3. 真母模就位后做全链路真实验证