ShaoHua
d81aa06681
1. 更新 .env 配置文件，替换原有云同步变量为 API 目标配置 2. 调整 publish-linux.ps1 中的文档路径，使用研发工单目录 3. 重构项目文档目录：将原 v1.2.0-tasks 迁移为研发工单-v1.2.0 目录，统一术语为"研发工单"替代"任务" 4. 更新 README.md 与各 PRD 文档的术语对照表，明确业务实体与研发工作项的区分 5. 新增多个研发工单文档，覆盖搜索、云同步、Linux 打包等模块 6. 删除旧的任务拆分文档，统一使用新的研发工单体系
1.8 KiB
1.8 KiB
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
- Linux 上可启动并打开主界面
- WebView 能渲染 Vue 前端且路由可用（刷新不 404）
- 前端能成功请求本地
/api/*并加载 Todo 待办项列表 - 有至少一种自包含交付产物（AppImage/Flatpak 二选一）可运行（见 pack/linux/README.md）
Search
- 主界面有搜索框
- 输入关键字后列表实时过滤（层级策略符合
03-*定义） - 清空后恢复原列表
云同步（基础可用）
- 可手动配置服务端地址，并有基础校验与风险提示
- 登录后能拉取该用户的 Todo 数据并展示
- 服务端策略
allowPersist=false时客户端不落盘，退出后数据不保留 - 高风险操作触发二次认证（服务端支持时）