首次提交: OnebotCatalog 项目代码与文档（含 NX 按需生成服务二期、后台、一键启动）

开发计划书.md

@@ -0,0 +1,100 @@
+# 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. 真母模就位后做**全链路真实验证**