docs: 新增 PROGRESS.md 开发进度追踪文件

包含 Phase 1 P0/P1 任务清单、Phase 2/3 待办、
状态标签说明和已知重要决策记录。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
ila
2026-05-24 17:48:14 +08:00
co-authored by Claude Sonnet 4.6
parent a179d18632
commit 46d2a865f6
+109
View File
@@ -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 |