ShaoHua
d81aa06681
1. 更新 .env 配置文件，替换原有云同步变量为 API 目标配置 2. 调整 publish-linux.ps1 中的文档路径，使用研发工单目录 3. 重构项目文档目录：将原 v1.2.0-tasks 迁移为研发工单-v1.2.0 目录，统一术语为"研发工单"替代"任务" 4. 更新 README.md 与各 PRD 文档的术语对照表，明确业务实体与研发工作项的区分 5. 新增多个研发工单文档，覆盖搜索、云同步、Linux 打包等模块 6. 删除旧的任务拆分文档，统一使用新的研发工单体系
41 lines
1.8 KiB
Markdown
41 lines
1.8 KiB
Markdown
# 07 - 文档同步与验收清单（v1.2.0）
|
||
|
||
> 术语：本工单文件本身归属"研发工单"；文中"任务/Todo 待办项"指业务实体（Task / SubTask）。
|
||
|
||
## 目标
|
||
|
||
- 保证 v1.2.0 实现后，README 与 docs 中的说明与实际代码一致
|
||
- 为 Linux / Search / 云同步提供可复现的验收步骤
|
||
|
||
## 范围
|
||
|
||
- README：Features、运行方式、API 说明（如涉及）
|
||
- docs：技术设计文档/技术栈与模块/版本记录（如涉及）
|
||
- 本目录工单文件：保持与实现同步（必要时更新验收口径与依赖关系）
|
||
|
||
## 必做同步点（结合当前仓库现状）
|
||
|
||
- **API 端点与项目结构**：对齐实际实现（避免文档仍描述不存在的项目或旧端点）
|
||
- **Linux 入口说明**：新增 Avalonia 入口的构建/运行/打包方式
|
||
- **云同步说明**：服务端地址配置、登录、落盘策略与安全机制（RBAC/二次认证）的用户可理解描述
|
||
- **版本记录**：在 `docs/版本记录.md` 增加 v1.2.0 非琐碎变更条目
|
||
|
||
## 验收清单（建议逐项勾选）
|
||
|
||
### Linux
|
||
- [x] Linux 上可启动并打开主界面
|
||
- [x] WebView 能渲染 Vue 前端且路由可用（刷新不 404）
|
||
- [x] 前端能成功请求本地 `/api/*` 并加载 Todo 待办项列表
|
||
- [x] 有至少一种自包含交付产物（AppImage/Flatpak 二选一）可运行（见 pack/linux/README.md）
|
||
|
||
### Search
|
||
- [x] 主界面有搜索框
|
||
- [x] 输入关键字后列表实时过滤（层级策略符合 `03-*` 定义）
|
||
- [x] 清空后恢复原列表
|
||
|
||
### 云同步（基础可用）
|
||
- [x] 可手动配置服务端地址，并有基础校验与风险提示
|
||
- [x] 登录后能拉取该用户的 Todo 数据并展示
|
||
- [x] 服务端策略 `allowPersist=false` 时客户端不落盘，退出后数据不保留
|
||
- [x] 高风险操作触发二次认证（服务端支持时）
|