# 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)