docs: align vision with reusable desktop template
This commit is contained in:
@@ -4,7 +4,9 @@
|
||||
|
||||
## 项目定位
|
||||
|
||||
`cmbone` 是从 `SuiDemo` 迁移而来的 Wails v3 本地桌面项目。当前目标不是继续堆功能,而是保持一个简单、清晰、初级程序员可维护的 Wails + Vue + SQLite 应用骨架。
|
||||
`cmbone` 是从 `SuiDemo` 迁移而来的 Wails v3 本地桌面项目。当前目标是打造一个 Windows-first、可扩展到其他平台的可复用桌面应用模板,而不是某个单一业务产品。
|
||||
|
||||
模板要内置常见桌面应用能力:应用壳、设置、登录、主业务模块、操作日志、数据统计和常用业务组件。第一批业务样例使用“电商商品图片 AI 优化”,用来验证模板能否承载真实业务闭环。
|
||||
|
||||
项目当前已具备:
|
||||
|
||||
@@ -13,6 +15,15 @@
|
||||
- 本地 SQLite 配置和热键表。
|
||||
- 托盘菜单、快捷键、OCR 示例窗口。
|
||||
|
||||
目标模块包括:
|
||||
|
||||
- 登录:本地固定账号 provider 和真实后端 provider 两种路径。
|
||||
- 设置:主题、语言、窗口行为、快捷键、数据目录、日志策略。
|
||||
- 主业务:商品图片 AI 优化样例,包括任务、结果、失败反馈。
|
||||
- 操作日志:审计日志和运行日志分开设计。
|
||||
- 数据统计:图片处理量、成功率、耗时、失败数、日志数和 7 天趋势。
|
||||
- 常用组件:输入框、多选框、下拉框、多行文本、表格、筛选和分页示例。
|
||||
|
||||
## 必读顺序
|
||||
|
||||
每次开始工作前,按顺序读取:
|
||||
@@ -27,11 +38,13 @@
|
||||
|
||||
## 工作规则
|
||||
|
||||
- 只做当前任务要求的改动,不夹带重构、依赖升级或产品扩展。
|
||||
- 只做当前任务要求的改动,不夹带重构、依赖升级或无验收标准的产品扩展。
|
||||
- 保持 Go `1.23.0`、Wails `v3.0.0-alpha.9`、`@wailsio/runtime 3.0.0-alpha.66` 的兼容关系;不要直接升级到 latest。
|
||||
- 不提交 `bin/`、`frontend/dist/`、`frontend/node_modules/` 等构建产物或依赖目录。
|
||||
- 后端服务方法变更后,优先使用 `wails3 generate bindings` 重新生成 `frontend/bindings`;如果本机没有 CLI,只允许小范围手动修正并在 `progress.md` 记录原因。
|
||||
- 涉及存储结构时,同步更新 `docs/04-architecture.md`、`docs/api.md`、`docs/current-state.md` 和相关任务验收。
|
||||
- 登录、日志、统计和业务样例必须通过 provider / service 边界接入,不把演示逻辑写死在前端页面里。
|
||||
- 自研组件库不是目标;优先复用 Ant Design Vue,并沉淀项目级组合组件和使用示例。
|
||||
- 提交前至少运行 `go test ./...`、`cd frontend && npm run build`、`go build -o bin/cmbone.exe .`。
|
||||
|
||||
## 风格
|
||||
|
||||
Reference in New Issue
Block a user