geMoldInsight/docs/STATUS.md

geMoldInsight 项目状态（STATUS）

文档定位：唯一的“当前实现状态 / 当前推荐方案”文档。 README 只做导航，不重复维护状态；架构细节见 ARCHITECTURE.md，演进路线见 ROADMAP.md，技术债见 TECH_DEBT.md，部署入口见 DEPLOYMENT.md。 最后更新：2026-09-01。

---

1. 当前项目状态总览

geMoldInsight 当前已从早期单体演进为：

• moldinsight：模具分析、STEP/STP 处理、批量分析、导出、成本估算
• inventory：成品/物料/BOM/库存/采购/销售/财务
• frontend：Vue 3 独立前端工程
• shared：配置、数据库、认证、日志、应用工厂等共享平台层

当前架构形态可概括为：

单仓库 + 单数据库 + 多模块 + 可独立部署

详细结构与边界见 ARCHITECTURE.md。

---

2. 当前推荐方案

2.1 推荐部署模式

当前推荐部署模式为：

• unified：frontend + unified backend + moldinsight celery

适用场景：

• 本地开发
• 集成环境
• 小团队统一部署
• 前端同域反代到单一 backend

详细部署说明见 DEPLOYMENT.md 与 deployment/LINUX_SETUP.md。

2.2 当前代码入口

当前后端已存在独立部署入口：

• src/entrypoints/moldinsight.py
• src/entrypoints/inventory.py

当前 Compose 入口：

• docker-compose.yml

---

3. 当前模块化进展

3.1 已经成型的部分

• src/moldinsight/ 与 src/inventory/ 已具备相对清晰的业务目录边界
• 前端已独立为 frontend/ 工程，不再是后端静态目录的附属
• 部署入口已按模块拆分到 src/entrypoints/
• 基础认证、配置、数据库、日志等能力已集中到 shared

3.2 当前主要耦合点

当前最大的剩余耦合点主要是：

• shared 仍承担较多平台与组合职责
• 共享 ORM 模型仍集中在 shared.models.database
• 部分历史文档与当前模块化事实尚未完全收口

这些内容的结构化说明见 ARCHITECTURE.md。

---

4. 最近已完成的重要整理

4.1 moldinsight 技术债治理（本轮已完成）

已完成的重点治理包括：

• 安全收口：debug/history 权限补齐、任务访问控制收紧
• 静默失败修复：detect-undercuts 基于真实 shape 重建分析
• OCC 超时后 executor 重建，避免单个任务毒化全队列
• 后台任务统一分派，避免 fire-and-forget 丢失
• Redis 任务状态改为 Hash 原子更新，并兼容旧 string 格式
• 完成态任务视图增加缓存，减少 RustFS 高频回读
• 导出缓存与持久化链路收口，支持重启后再导出
• 删除旧入口与死代码，修正部署陷阱
• Generator 公共接口提取完成，并补充契约测试

详细治理记录见 TECH_DEBT.md。

4.2 测试状态

当前已验证：

• 本地 pip 环境：47 passed, 1 skipped
• gemold conda + OCC 环境：88 passed

说明：

• 无 OCC 环境下，依赖 pythonocc 的契约测试会自动 skip
• inventory 侧仍有少量既有 deprecation warnings，但不影响本轮通过状态

---

5. 当前仍在推进 / 尚未完成的重点

5.1 文档体系整理

本轮正在进行：

• 将 README 收敛为唯一文档导航入口
• 建立 STATUS / ARCHITECTURE / ROADMAP / TECH_DEBT / DEPLOYMENT 主骨架
• 收口部署文档与历史文档

5.2 仍未完成的功能/结构项

当前仍明确未完成或待下一步推进的重点：

• advanced_router 拆分 + Pydantic 请求模型
• 铝价模拟数据增加 source: "simulated" 标注，并同步前端展示
• 进一步收敛 shared/platform 边界
• 继续清理当前文档中“现状 / 规划 / 历史”混放问题

更长周期的演进方向见 ROADMAP.md。

---

6. 报告、模板与归档文档说明

以下文档仍可能被保留用于专题说明、验收、模板复用或历史追溯，但不再承担当前状态入口职责：

• 业务/专题报告：
  • archive/MOLD_ERP_ANALYSIS_REPORT.md
  • archive/ZERO_FINISHED_INVENTORY_CERTIFICATE.md
• 验收/模板文档：
  • templates/UAT_CHECKLIST.md
  • templates/INTERFACE_INTEGRATION_CATALOG_TEMPLATE.md
• 历史材料归档：
  • archive/README.md

---

7. 文档维护规则

• 当前实现状态只在本文维护
• README 只做导航与最短入门，不重复状态细节
• 架构边界改动更新 ARCHITECTURE.md
• 规划变更更新 ROADMAP.md
• 技术债状态变更更新 TECH_DEBT.md
• 部署方式变化更新 DEPLOYMENT.md 与 deployment/LINUX_SETUP.md