docs: align vision with reusable desktop template
This commit is contained in:
@@ -5,17 +5,20 @@
|
||||
| 领域 | 当前等级 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| 项目结构 | B | 已从模板整理为普通工程,目录职责基本清楚 |
|
||||
| 后端服务 | B | 服务边界清晰,但热键和 OCR 的错误路径仍可加强 |
|
||||
| 本地存储 | B | SQLite 初始化和基础测试已存在,后续可补更多迁移测试 |
|
||||
| 前端结构 | B | Vue 组件按功能拆分,主窗口布局策略仍需明确 |
|
||||
| 产品定位 | B | 已校准为 Windows-first 可复用桌面应用模板,后续需要代码落地 |
|
||||
| 后端服务 | B | 现有服务边界清晰,登录、日志、统计和业务样例服务尚未实现 |
|
||||
| 本地存储 | B | SQLite 初始化和基础测试已存在,目标新增表需要迁移和测试 |
|
||||
| 前端结构 | B- | Vue 组件按功能拆分,但尚未形成模板化主布局和目标路由 |
|
||||
| 构建验证 | B | Go 测试、前端构建、后端编译可运行 |
|
||||
| 文档 | B | Harness Coding 文档已接入,后续随代码继续维护 |
|
||||
| 文档 | B+ | Harness Coding 文档已接入,并同步了模板愿景 |
|
||||
|
||||
## 主要风险
|
||||
|
||||
- 模板范围膨胀:登录、设置、业务、日志、统计和组件示例都要做,但必须小步交付。
|
||||
- Wails v3 alpha 版本兼容性风险。
|
||||
- bindings 与 Go 服务签名不一致的运行时风险。
|
||||
- 热键和 OCR 跨平台行为不完全一致。
|
||||
- 登录 provider、AI provider、日志和统计如果没有边界,会导致后续替换困难。
|
||||
- 热键、托盘、OCR 等平台能力在 Windows 以外行为不完全一致。
|
||||
- 前端缺少专门单元测试,主要依赖构建和人工 smoke。
|
||||
|
||||
## 质量门槛
|
||||
@@ -27,10 +30,21 @@
|
||||
- 涉及前端时 `npm run build` 通过。
|
||||
- 涉及后端启动时 `go build -o bin/cmbone.exe .` 通过。
|
||||
- 涉及 UI 时完成对应窗口的人工检查。
|
||||
- 涉及登录、日志、统计或业务样例时,同步更新 `api.md`、`routes.md`、`current-state.md` 和任务验收。
|
||||
|
||||
## 模板模块质量要求
|
||||
|
||||
- 登录:本地 provider 和 remote provider 边界清楚,密码不写死在前端。
|
||||
- 设置:配置项有 key、类型、默认值、说明和迁移逻辑。
|
||||
- 主业务:商品图片 AI 优化可以先模拟,但任务状态、失败原因和结果结构要真实。
|
||||
- 审计日志:记录用户动作,字段可查询、可导出。
|
||||
- 运行日志:记录系统错误,能支持排错。
|
||||
- 数据统计:只做 P0 指标,不提前做复杂 BI。
|
||||
- 组件示例:复用 Ant Design Vue,不自研组件库。
|
||||
|
||||
## 改进方向
|
||||
|
||||
- 为存储迁移、配置服务、热键服务补充更细测试。
|
||||
- 为主窗口最大化和自适应布局建立明确规则。
|
||||
- 为 OCR 失败、热键注册失败补充用户可理解反馈。
|
||||
- 建立 Windows-first 主窗口最大化和自适应布局策略。
|
||||
- 为登录、日志、图片任务和统计新增服务、模型、迁移和测试。
|
||||
- 为商品图片 AI 优化样例补充真实页面闭环。
|
||||
- 为 Wails bindings 生成流程补充完整操作说明。
|
||||
|
||||
Reference in New Issue
Block a user