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