geMoldInsight/docs/STATUS.md

geMoldInsight 项目状态（STATUS）

文档定位：唯一的「现在到哪了」。README / AGENTS / 各主文档只链接到这里，不复制状态内容。 维护规则：每完整完成一个需求，倒序在本文顶部加一条（日期 + 主题 + 关键事实）；其余主文档（架构 / 规划 / 技术债 / 部署）维护各自的"当前有效说法"，本文只记录"什么时候做到了哪一步"。维护规则出处见根目录 AGENTS.md。

2026-09-15（后端设计审查完成 → 治理计划入文档：完成 moldinsight 后端设计审查（部署 / 任务一致性 / API / 代码结构），产出治理批次计划入 ROADMAP.md §3.1（批次 0–4：安全→部署→一致性→结构→架构）；新识别技术债 D5–D14 入 TECH_DEBT.md §3——含确认安全缺口 /api/status/{task_id} 无鉴权、主处理链路依赖节点本地文件路径（API 与 Celery worker 容器无共享卷）等。下一步：按批次 0 + 批次 1 的 D6（RustFS 主链路）启动实施。）

最后更新：2026-09-15（项目规范体系对齐 ipc-chat-cortex——参考 ipc-chat-cortex 的 AGENTS.md + docs 规范重整本文档体系：① AGENTS.md 重写——硬约束速览（新增：接口变更三件套 Pydantic→openapi.json→gen:api、配置只走 .env 且关键项不兜底、单数据库刻意设计）+ 代码地图逐文件化 + 开发约定映射表（改什么→同步什么文档）；② 新增 OPERATIONS.md（配置来源与优先级 / 本地启动 / Compose / 运维硬性要求）与 API_CONTRACT.md（端点总览 / 统一约定 / OpenAPI 类型生成流程）；③ 本文件改为日志体，原静态内容分流到各归属文档（推荐部署模式→DEPLOYMENT §1，未完成项→ROADMAP/TECH_DEBT）。验证：openapi 导出命令实测可用（conda gemold 环境，unified app 76 paths）；待办：checked-in openapi.json（2026-07-27，70 paths）已落后当前代码，下次接口变更时按 API_CONTRACT.md §4 重导出并 npm run gen:api。）

上一条：2026-09-02（模块化收口 + 文档主骨架建立（基线条目）：代码侧完成 moldinsight 技术债治理——安全收口（debug/history 权限补齐、任务访问控制收紧）、静默失败修复（detect-undercuts 基于真实 shape 重建）、OCC 超时后 executor 重建防毒化全队列、后台任务统一分派、Redis 任务状态改 Hash 原子更新、完成态任务视图缓存、导出缓存与持久化收口、旧入口与死代码删除、Generator 公共接口提取 + 契约测试；详见 TECH_DEBT.md §2。结构侧完成 src/entrypoints/ 三入口拆分（moldinsight / inventory / unified）、shared 平台能力集中、前端独立 frontend/ 工程。文档侧建立 STATUS / ARCHITECTURE / ROADMAP / TECH_DEBT / DEPLOYMENT 主骨架，README 收敛为唯一导航入口，历史材料迁入 archive/。测试基线：本地 pip 环境 47 passed, 1 skipped（pythonocc 缺失自动 skip）；moldinsight conda + OCC 环境 88 passed。inventory 侧少量既有 deprecation warnings 不影响通过。）

此前：2026-09-01（文档体系专项整理启动：明确「README 只做导航、每类信息单一归属、历史材料进 archive」的文档治理原则；建立 deployment/ 主题目录与 archive/ 归档目录；部署文档收口为 DEPLOYMENT（入口）+ deployment/LINUX_SETUP（操作）+ deployment/DEPLOY_PORT / PORT_CONFIG（端口补充）三层。）