51 lines
2.5 KiB
Markdown
51 lines
2.5 KiB
Markdown
# 质量文档
|
|
|
|
## 当前质量概览
|
|
|
|
| 领域 | 当前等级 | 说明 |
|
|
| --- | --- | --- |
|
|
| 项目结构 | B | 已从模板整理为普通工程，目录职责基本清楚 |
|
|
| 产品定位 | B | 已校准为 Windows-first 可复用桌面应用模板，后续需要代码落地 |
|
|
| 后端服务 | B | 现有服务边界清晰，登录、日志、统计和业务样例服务尚未实现 |
|
|
| 本地存储 | B | SQLite 初始化和基础测试已存在，目标新增表需要迁移和测试 |
|
|
| 前端结构 | B- | Vue 组件按功能拆分，窗口和布局策略已明确，但尚未代码落地为模板化主布局和目标路由 |
|
|
| 构建验证 | B | Go 测试、前端构建、后端编译可运行 |
|
|
| 文档 | B+ | Harness Coding 文档已接入，并同步了模板愿景 |
|
|
|
|
## 主要风险
|
|
|
|
- 模板范围膨胀：登录、设置、业务、日志、统计和组件示例都要做，但必须小步交付。
|
|
- Wails v3 alpha 版本兼容性风险。
|
|
- bindings 与 Go 服务签名不一致的运行时风险。
|
|
- 登录 provider、AI provider、日志和统计如果没有边界，会导致后续替换困难。
|
|
- 热键、托盘、OCR 等平台能力在 Windows 以外行为不完全一致。
|
|
- 前端缺少专门单元测试，主要依赖构建和人工 smoke。
|
|
|
|
## 质量门槛
|
|
|
|
每个代码任务至少达到：
|
|
|
|
- Go 代码 `gofmt`。
|
|
- `go test ./...` 通过。
|
|
- 涉及前端时 `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，不自研组件库。
|
|
|
|
## 改进方向
|
|
|
|
- 按已确定的 Windows-first 窗口和布局策略实现主窗口启动参数、根容器和主布局。
|
|
- 为登录、日志、图片任务和统计新增服务、模型、迁移和测试。
|
|
- 为商品图片 AI 优化样例补充真实页面闭环。
|
|
- 为 Wails bindings 生成流程补充完整操作说明。
|