diff --git a/docs/PROGRESS.md b/docs/PROGRESS.md new file mode 100644 index 0000000..1b83466 --- /dev/null +++ b/docs/PROGRESS.md @@ -0,0 +1,109 @@ +# 明析平台 开发进度 + +> 最后更新:2026-05-24 +> 当前阶段:**Phase 1 · Demo版**(目标:2026年6月中旬决赛前完成) + +--- + +## 当前焦点 + +> 每次会话更新此处,说明正在做什么、下一步是什么。 + +- **正在做**:项目骨架初始化完成,准备开始第一个子项目的业务代码 +- **下一步**:从 `mingxi-vision` 开始,实现 `/api/detect` 推理接口 + +--- + +## Phase 1 · Demo版 任务状态 + +### P0(路演必须完成) + +| 子项目 | 任务 | 状态 | +|--------|------|------| +| mingxi-vision | 图片推理 API(`POST /api/detect`) | 🔲 未开始 | +| mingxi-vision | asyncio.Lock 推理串行化 | 🔲 未开始 | +| mingxi-vision | 启动时模型加载 + warmup | 🔲 未开始 | +| mingxi-vision | 健康检查接口(`GET /api/health`) | 🔲 未开始 | +| mingxi-capture | PyQt5 主窗口(触发按钮 + 图像展示 + 缺陷列表) | 🔲 未开始 | +| mingxi-capture | MockCamera 模拟模式(读本地图片文件夹) | 🔲 未开始 | +| mingxi-capture | 调用 vision 接口并展示结果 | 🔲 未开始 | +| mingxi-capture | 异步上报队列(调用 backend 存档) | 🔲 未开始 | +| mingxi-backend | Django 项目初始化(settings / urls / wsgi) | 🔲 未开始 | +| mingxi-backend | 用户模型 + JWT 认证(复用现有代码) | 🔲 未开始 | +| mingxi-backend | 三级权限(operator / leader / admin) | 🔲 未开始 | +| mingxi-backend | 接收 capture 推送(`POST /api/detect/result/`) | 🔲 未开始 | +| mingxi-backend | 检测历史查询接口(按角色过滤) | 🔲 未开始 | +| mingxi-frontend | 项目脚手架初始化(Vue3 + Vite + TS) | 🔲 未开始 | +| mingxi-frontend | 登录页 | 🔲 未开始 | +| mingxi-frontend | 检测历史列表页 | 🔲 未开始 | +| mingxi-frontend | 检测详情页(标注图 + 缺陷明细) | 🔲 未开始 | + +### P1(有时间做,路演加分项) + +| 子项目 | 任务 | 状态 | +|--------|------|------| +| mingxi-capture | 系统托盘图标 + 最小化到托盘 | 🔲 未开始 | +| mingxi-capture | 配置弹窗(服务器地址、模拟模式设置) | 🔲 未开始 | +| mingxi-backend | 模型管理(上传 / 备份 / 切换 / 触发热重载) | 🔲 未开始 | +| mingxi-vision | 模型热重载接口(`POST /api/model/reload`) | 🔲 未开始 | +| mingxi-frontend | 实时监控看板(短轮询,1秒刷新) | 🔲 未开始 | +| mingxi-frontend | 统计报表页(缺陷分布、合格率趋势) | 🔲 未开始 | + +--- + +## Phase 2 · POC版(2026年Q3) + +> 决赛后启动,接入真实相机。 + +| 任务 | 状态 | +|------|------| +| mingxi-capture:接入海康MVS SDK(MV-CS060-10GM) | 🔲 未开始 | +| mingxi-capture:PLC触发接口(串口/数字IO) | 🔲 未开始 | +| mingxi-vision:ONNX Runtime 部署(export_onnx.py) | 🔲 未开始 | +| mingxi-backend:告警规则引擎 | 🔲 未开始 | +| POC试用:完成1家PCB厂对接 | 🔲 未开始 | + +--- + +## Phase 3 · 产线版(2026年Q4) + +> 首单签约目标。 + +| 任务 | 状态 | +|------|------| +| 多相机并发支持 | 🔲 未开始 | +| 告警推送(企业微信/短信) | 🔲 未开始 | +| MES/ERP 对接接口 | 🔲 未开始 | +| 软件著作权申请 | 🔲 未开始 | + +--- + +## 状态说明 + +| 标签 | 含义 | +|------|------| +| 🔲 未开始 | 尚未动工 | +| 🔄 进行中 | 当前正在开发 | +| ✅ 已完成 | 功能可用,已提交 | +| ⚠️ 有问题 | 完成但存在已知缺陷 | +| ❌ 暂缓 | 本阶段不做,延后 | + +--- + +## 已知问题 / 阻塞项 + +> 记录当前妨碍开发的问题。 + +- 暂无 + +--- + +## 重要决策记录 + +| 决策 | 文件 | +|------|------| +| 采用 monorepo 单仓库管理四个子项目 | — | +| capture 作为编排方:同步调 vision,异步推 backend | `docs/明析平台-软件重构设计文档.md` §8 | +| 推理串行化用 asyncio.Lock,不用多进程 | `docs/mingxi-vision-架构设计.md` | +| 浏览器端用短轮询,不引入 WebSocket | `docs/明析平台-软件重构设计文档.md` §7 | +| 数据库用 SQLite,不用 MySQL | `docs/明析平台-软件重构设计文档.md` §6 |