ShaoHua
d81aa06681
1. 更新 .env 配置文件，替换原有云同步变量为 API 目标配置 2. 调整 publish-linux.ps1 中的文档路径，使用研发工单目录 3. 重构项目文档目录：将原 v1.2.0-tasks 迁移为研发工单-v1.2.0 目录，统一术语为"研发工单"替代"任务" 4. 更新 README.md 与各 PRD 文档的术语对照表，明确业务实体与研发工作项的区分 5. 新增多个研发工单文档，覆盖搜索、云同步、Linux 打包等模块 6. 删除旧的任务拆分文档，统一使用新的研发工单体系
53 lines
2.6 KiB
Markdown
53 lines
2.6 KiB
Markdown
# Hua.Todo 产品需求文档 (PRD)
|
|
|
|
> **术语对照（必读）**
|
|
>
|
|
> | 术语 | 含义 | 出现位置 |
|
|
> |---|---|---|
|
|
> | **Todo 待办项 / 任务 / 子任务（业务实体）** | 用户在 Hua.Todo 应用中创建的待办事项，对应代码 `Task` / `SubTask` 实体、`/api/task` 接口、UI 列表项 | 本文及 `docs/manual/`、业务代码 |
|
|
> | **研发工单（Dev Work Item）** | 智能体 / 开发者执行的编码工作项（需求拆分、并行开发） | `docs/project/研发工单-*/`、`.trae/rules/全局/05-研发工单规则.md` |
|
|
>
|
|
> 本文中"任务/子任务"统一指业务实体；如涉及编码侧拆分请使用"研发工单"。
|
|
|
|
## 1. 项目概述
|
|
本项目是一个基于 C# WPF (.NET 10) 开发的桌面代办管理应用 (Hua.Todo)。旨在提供轻量、高效的任务管理体验，特别是通过快捷键快速唤起记录功能，最大化用户的操作效率。
|
|
|
|
## 2. 技术架构
|
|
- **开发语言**: C#
|
|
- **UI 框架**: WPF (Windows Presentation Foundation)
|
|
- **目标框架**: .NET 10
|
|
- **操作系统**: Windows
|
|
|
|
## 3. 功能需求
|
|
|
|
### 3.1 核心功能：快速记录 (Quick Entry)
|
|
- **全局快捷键**:
|
|
- 允许用户注册/使用系统级全局快捷键（例如 `Ctrl + Alt + A` 或其他不冲突的组合）。
|
|
- 支持在应用后台运行时响应快捷键。
|
|
- **快速唤起**:
|
|
- 按下快捷键时，若应用最小化或隐藏，应立即弹出“新建任务”窗口或主界面。
|
|
- 窗口弹出后，输入框应自动获取焦点，用户可直接打字。
|
|
|
|
### 3.2 任务模型 (Task Model)
|
|
每个任务需包含以下核心字段：
|
|
1. **任务名称 (Title/Content)**: 任务的具体描述。
|
|
2. **紧急程度 (Priority/Urgency)**:
|
|
- 用于区分任务优先级（如：高、中、低）。
|
|
- 需在界面上有直观的视觉区分（如颜色标记）。
|
|
3. **完成状态 (IsCompleted)**:
|
|
- 标记任务是否已完成。
|
|
|
|
### 3.3 任务列表与视图 (Task List & View)
|
|
- **列表展示**: 展示当前所有未完成的任务。
|
|
- **默认过滤**:
|
|
- 应用启动或刷新时，**默认隐藏已完成的任务**。
|
|
- (可选) 提供“显示已完成任务”的切换开关以便查看历史记录。
|
|
|
|
### 3.4 离线与同步 (Offline & Sync)
|
|
- **离线记录**: 支持完全离线使用，数据优先保存于本地。
|
|
- **数据同步**: 在网络可用时（或特定时机），自动将本地数据同步到服务端（预留同步机制）。
|
|
|
|
## 4. 非功能需求
|
|
- **性能**: 启动速度快，快捷键响应低延迟。
|
|
- **持久化**: 任务数据需保存到本地（如 SQLite, JSON, 或 XML），保证关闭应用后数据不丢失。
|