150 lines
5.0 KiB
Markdown
150 lines
5.0 KiB
Markdown
# geMoldInsight 项目状态（STATUS）
|
||
|
||
> 文档定位：**唯一的“当前实现状态 / 当前推荐方案”文档**。
|
||
> README 只做导航，不重复维护状态；架构细节见 [ARCHITECTURE.md](ARCHITECTURE.md)，演进路线见 [ROADMAP.md](ROADMAP.md)，技术债见 [TECH_DEBT.md](TECH_DEBT.md)，部署入口见 [DEPLOYMENT.md](DEPLOYMENT.md)。
|
||
> 最后更新：2026-09-01。
|
||
|
||
---
|
||
|
||
## 1. 当前项目状态总览
|
||
|
||
geMoldInsight 当前已从早期单体演进为：
|
||
|
||
- `moldinsight`：模具分析、STEP/STP 处理、批量分析、导出、成本估算
|
||
- `inventory`：成品/物料/BOM/库存/采购/销售/财务
|
||
- `frontend`：Vue 3 独立前端工程
|
||
- `shared`：配置、数据库、认证、日志、应用工厂等共享平台层
|
||
|
||
当前架构形态可概括为：
|
||
|
||
> **单仓库 + 单数据库 + 多模块 + 可独立部署**
|
||
|
||
详细结构与边界见 [ARCHITECTURE.md](ARCHITECTURE.md)。
|
||
|
||
---
|
||
|
||
## 2. 当前推荐方案
|
||
|
||
### 2.1 推荐部署模式
|
||
|
||
当前推荐部署模式为：
|
||
|
||
- **unified**：frontend + unified backend + moldinsight celery
|
||
|
||
适用场景：
|
||
- 本地开发
|
||
- 集成环境
|
||
- 小团队统一部署
|
||
- 前端同域反代到单一 backend
|
||
|
||
详细部署说明见 [DEPLOYMENT.md](DEPLOYMENT.md) 与 [deployment/LINUX_SETUP.md](deployment/LINUX_SETUP.md)。
|
||
|
||
### 2.2 当前代码入口
|
||
|
||
当前后端已存在独立部署入口：
|
||
- [src/entrypoints/moldinsight.py](../src/entrypoints/moldinsight.py)
|
||
- [src/entrypoints/inventory.py](../src/entrypoints/inventory.py)
|
||
|
||
当前 Compose 入口：
|
||
- [docker-compose.yml](../docker-compose.yml)
|
||
|
||
---
|
||
|
||
## 3. 当前模块化进展
|
||
|
||
### 3.1 已经成型的部分
|
||
|
||
- `src/moldinsight/` 与 `src/inventory/` 已具备相对清晰的业务目录边界
|
||
- 前端已独立为 `frontend/` 工程，不再是后端静态目录的附属
|
||
- 部署入口已按模块拆分到 `src/entrypoints/`
|
||
- 基础认证、配置、数据库、日志等能力已集中到 `shared`
|
||
|
||
### 3.2 当前主要耦合点
|
||
|
||
当前最大的剩余耦合点主要是：
|
||
|
||
- `shared` 仍承担较多平台与组合职责
|
||
- 共享 ORM 模型仍集中在 `shared.models.database`
|
||
- 部分历史文档与当前模块化事实尚未完全收口
|
||
|
||
这些内容的结构化说明见 [ARCHITECTURE.md](ARCHITECTURE.md)。
|
||
|
||
---
|
||
|
||
## 4. 最近已完成的重要整理
|
||
|
||
### 4.1 moldinsight 技术债治理（本轮已完成）
|
||
|
||
已完成的重点治理包括：
|
||
|
||
- 安全收口：debug/history 权限补齐、任务访问控制收紧
|
||
- 静默失败修复：`detect-undercuts` 基于真实 shape 重建分析
|
||
- OCC 超时后 executor 重建，避免单个任务毒化全队列
|
||
- 后台任务统一分派，避免 fire-and-forget 丢失
|
||
- Redis 任务状态改为 Hash 原子更新，并兼容旧 string 格式
|
||
- 完成态任务视图增加缓存，减少 RustFS 高频回读
|
||
- 导出缓存与持久化链路收口，支持重启后再导出
|
||
- 删除旧入口与死代码，修正部署陷阱
|
||
- Generator 公共接口提取完成，并补充契约测试
|
||
|
||
详细治理记录见 [TECH_DEBT.md](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](ROADMAP.md)。
|
||
|
||
---
|
||
|
||
## 6. 报告、模板与归档文档说明
|
||
|
||
以下文档仍可能被保留用于专题说明、验收、模板复用或历史追溯，但不再承担当前状态入口职责：
|
||
|
||
- 业务/专题报告：
|
||
- [archive/MOLD_ERP_ANALYSIS_REPORT.md](archive/MOLD_ERP_ANALYSIS_REPORT.md)
|
||
- [archive/ZERO_FINISHED_INVENTORY_CERTIFICATE.md](archive/ZERO_FINISHED_INVENTORY_CERTIFICATE.md)
|
||
- 验收/模板文档：
|
||
- [templates/UAT_CHECKLIST.md](templates/UAT_CHECKLIST.md)
|
||
- [templates/INTERFACE_INTEGRATION_CATALOG_TEMPLATE.md](templates/INTERFACE_INTEGRATION_CATALOG_TEMPLATE.md)
|
||
- 历史材料归档：
|
||
- [archive/README.md](archive/README.md)
|
||
|
||
---
|
||
|
||
## 7. 文档维护规则
|
||
|
||
- 当前实现状态只在本文维护
|
||
- README 只做导航与最短入门，不重复状态细节
|
||
- 架构边界改动更新 [ARCHITECTURE.md](ARCHITECTURE.md)
|
||
- 规划变更更新 [ROADMAP.md](ROADMAP.md)
|
||
- 技术债状态变更更新 [TECH_DEBT.md](TECH_DEBT.md)
|
||
- 部署方式变化更新 [DEPLOYMENT.md](DEPLOYMENT.md) 与 [deployment/LINUX_SETUP.md](deployment/LINUX_SETUP.md)
|