diff --git a/.gitignore b/.gitignore index 12d6f65..4470b42 100644 --- a/.gitignore +++ b/.gitignore @@ -366,3 +366,5 @@ FodyWeavers.xsd /Hua.Todo/Output /src/Hua.Todo.Maui/Output /src/Hua.Todo.Host/Hua.Todo.db +/src/Hua.Todo.Host/Hua.Todo.db-shm +/src/Hua.Todo.Host/Hua.Todo.db-wal diff --git a/.trae/coordination/README.md b/.trae/coordination/README.md new file mode 100644 index 0000000..a8d0ad4 --- /dev/null +++ b/.trae/coordination/README.md @@ -0,0 +1,18 @@ +# 协调目录（并行 solo 专用） + +该目录用于解决两类问题： + +- 文件冲突：多窗口并行时明确“谁是 Writer”，其他人不直接改同一文件 +- 编译中途状态：确保阶段性交付保持可编译（绿线），必要时通过隔离策略推进 + +## 目录约定 + +- `ownership.md`：文件/目录所有权登记（Writer 表） +- `shared-files.md`：本阶段共享文件清单（由 Integrator 维护） +- `handoff/`：非 Writer 提交的差异建议/交接说明（Integrator 负责落盘） +- `wip/`：编译中途状态说明（为什么隔离、隔离方式、收敛条件） + +## 使用规则 + +- 所有权与共享文件清单优先使用“仓库相对路径” +- 禁止记录或提交构建产物目录中的文件路径（如 `bin/`、`obj/`、`node_modules/`、`dist/` 等） diff --git a/.trae/coordination/ownership.md b/.trae/coordination/ownership.md new file mode 100644 index 0000000..278c564 --- /dev/null +++ b/.trae/coordination/ownership.md @@ -0,0 +1,13 @@ +# 文件/目录所有权（Writer）登记 + +规则： + +- 同一时段内，同一个文件只能有一个 Writer +- 非 Writer 不编辑该文件；需要修改时，提交到 `.trae\coordination\handoff\` 由 Writer/Integrator 落盘 +- 路径建议使用仓库相对路径；每次扩大修改范围，先更新登记再改代码 + +## 当前所有权 + +| Path（仓库相对路径） | Writer | 任务/窗口标识 | 备注 | +|---|---|---|---| +| `src\\` | `` | `` | `共享：是/否` | diff --git a/.trae/coordination/shared-files.md b/.trae/coordination/shared-files.md new file mode 100644 index 0000000..9f38fb7 --- /dev/null +++ b/.trae/coordination/shared-files.md @@ -0,0 +1,11 @@ +# 本阶段共享文件清单（Integrator 维护） + +规则： + +- 本文件只由 Integrator 修改，避免反复冲突 +- 清单内每条必须是“仓库相对路径”，并说明为什么共享（入口/协议/配置/依赖锁等） +- 所有共享文件必须同时出现在各自任务的 Touch List 中，并标注 Writer 为 Integrator + +## 共享文件 + +- `src\\`：`` diff --git a/.trae/rules/parallel_solo_conflict_avoidance.md b/.trae/rules/parallel_solo_conflict_avoidance.md new file mode 100644 index 0000000..ad64aac --- /dev/null +++ b/.trae/rules/parallel_solo_conflict_avoidance.md @@ -0,0 +1,99 @@ +--- +alwaysApply: false +description: +--- +# 并行 solo 窗口冲突规约（必须遵守） + +## 适用范围 + +- 当同一个版本/需求被拆分为多个并行任务，并由多个 solo 窗口同时推进时适用。 +- 目标是同时降低两类风险： + - **文件冲突**：多人同时改同一文件/相邻行导致冲突。 + - **编译区间冲突**：A 窗口引入的未完成变更破坏编译，阻塞 B 窗口集成与验证。 + +## 核心原则 + +- **先声明后修改**：任何代码改动前，先在任务文档中声明“触碰文件清单（Touch List）”与“共享文件策略”。 +- **文件所有权唯一**：同一时段内，一个文件只能被一个窗口作为“写入者（Writer）”修改。 +- **共享文件单点修改**：涉及高耦合/共享入口的改动，集中到一个“集成窗口（Integrator）”完成，其他窗口只做准备工作（新文件/独立模块/文档/测试）。 +- **绿线优先（可编译）**：任何可落盘、可合入的变更必须保持可编译；临时状态必须通过“隔离手段”而不是破坏编译来实现。 + +## Touch List（触碰文件清单） + +- 每个并行任务 md 必须在开头包含一个明确的 Touch List，至少包含： + - 新增/修改/删除的文件路径（精确到文件，必须写“准确目录”） + - 预期修改类型（新增/小改/重构/接口变更/配置变更） + - 是否为共享文件（是/否） +- Touch List 必须保持可检索与可更新：变更范围扩大时，必须先更新 Touch List 再改代码。 + +### 目录书写要求（必须遵守） + +- Touch List 内每一条必须使用以下两种格式之一： + - **仓库相对路径（推荐）**：`src\\` + - **绝对路径（可选）**：`\src\\`（`` 为本机仓库根目录） +- Touch List 禁止包含构建产物与临时目录中的文件（这些文件不应被手工修改，且极易产生冲突），包括但不限于： + - `**\bin\**`、`**\obj\**` + - `**\node_modules\**` + - `**\.vite\**`、`**\dist\**` + +### Touch List 模板（复制即可用） + +- Touch List: + - `src\\`（共享：否｜Writer：本窗口） + - `src\\`（共享：是｜Writer：<窗口名>） + - `docs\`（共享：是/否｜Writer：<窗口名>） + - `.trae\`（共享：是｜Writer：<窗口名>） + +## 文件所有权与共享文件策略 + +- **默认规则**：Touch List 中标记为“共享文件”的条目，必须指定唯一 Writer。 +- **Writer 约束**： + - 非 Writer 窗口不得编辑该共享文件（包括格式化、重排 import、无关重构）。 + - 需要对共享文件提出修改时，非 Writer 只能提供“差异建议”（文字说明/伪代码/小片段）交给 Writer 落盘。 +- **共享文件判定（满足其一即为共享）**： + - 项目入口/启动逻辑、依赖注入注册、全局路由/导航、公共配置、公共协议与 DTO、公共组件/样式、跨模块公共工具 + - 解决方案/项目文件（如 `.sln`、`.csproj`）、锁文件、全局配置文件（如 `appsettings*`、构建脚本） + +## 协调目录（必须遵守） + +- 为了让“文件冲突”和“编译中途状态”可操作、可对齐，仓库内必须固定保留一个专用协调目录： + - `.trae\coordination\` +- 该目录只用于协作对齐，不承载业务实现代码；多人可在不同文件中写入，避免互相踩踏。 +- 并行推进时必须使用该目录中的文件记录“谁在改什么”和“中途状态怎么保证不破坏编译”： + - `.trae\coordination\ownership.md`：文件/目录所有权（Writer）登记表 + - `.trae\coordination\shared-files.md`：本阶段共享文件清单（只有 Integrator 维护） + - `.trae\coordination\handoff\`：非 Writer 提交的差异建议/交接说明（Integrator 落盘） + - `.trae\coordination\wip\`：编译中途状态说明（为什么需要隔离、如何保证绿线、何时收敛） + +## 目录分区与低冲突写法 + +- 优先通过“新增文件”完成并行开发，减少在同一文件内的交错修改。 +- 需要扩展既有逻辑时，优先选择低冲突策略： + - C#：新增类/partial 文件、扩展方法、接口实现分文件、平台目录分离 + - TypeScript/Vue：新增模块/组件文件，避免在同一大文件内做多处改动 +- 禁止在非必要情况下对共享文件做纯格式化、纯重排或无收益重构（这些改动高度易冲突且难以 review）。 + +## 编译绿线（避免编译区间冲突） + +- **不得提交/合入破坏编译的变更**：包括缺失类型、未实现接口、引用不存在、配置缺项导致启动失败等。 +- **允许的临时隔离手段（按优先级）**： + 1. 新功能先放在新文件/新类中，不在入口路径上启用 + 2. 通过显式开关控制启用（配置/运行时开关），默认关闭 + 3. 通过依赖注入分支注册或特性开关隔离，默认不触发 +- 当必须进行接口演进时，采用“双写/兼容期”策略： + - 先新增（保持旧接口可用）→ 再迁移调用方 → 最后清理旧接口 + +## 合入顺序与集成职责 + +- 每个并行阶段必须明确一个集成窗口（Integrator），负责： + - 处理共享文件的实际落盘与冲突消解 + - 保持主干/集成分支持续可编译、可运行 +- 其他窗口提交的成果应尽量以“新增文件 + 最小修改点”的方式交付，降低集成成本。 + +## 最小检查清单 + +1. [ ] 每个任务 md 是否已写 Touch List（精确到文件）？ +2. [ ] Touch List 中的共享文件是否指定了唯一 Writer？ +3. [ ] 是否避免了对共享文件的无意义格式化/重排？ +4. [ ] 当前改动是否保持可编译（绿线）？ +5. [ ] 若涉及接口演进，是否采用兼容期策略而非一次性破坏式变更？ diff --git a/.trae/rules/task_breakdown.md b/.trae/rules/task_breakdown.md index f5540a6..38d701e 100644 --- a/.trae/rules/task_breakdown.md +++ b/.trae/rules/task_breakdown.md @@ -1,8 +1,6 @@ --- alwaysApply: false -description: 强制任务拆分输出规范：阅读完所有文档后，先产出拆分后的任务 Markdown，并按可并行执行拆分为多个带序号的 md 文件，统一放入 docs/project 下的新建文件夹。 --- - # 任务拆分输出规范（必须遵守） ## 适用时机 @@ -23,6 +21,13 @@ description: 强制任务拆分输出规范：阅读完所有文档后，先产 - 前置条件（依赖哪些结论/接口/文档） - 验收标准（怎么判断完成，包含可执行的验证点） - 风险与回滚（如有） +- **子任务完成后的标记要求**： + - 当任一子任务（例如 `01-*`/`02-*`/`03-*`）完成实现后，必须在对应版本的 `00-任务总览.md` 中同步标注“已完成”。 + - 同时必须维护一张“待验证表”（可用 Markdown 表格），对每个子任务给出“待验证/已验证”状态，避免实现完成但验收未闭环。 +- **并行冲突规避要求**：当任务会被分发到多个 solo 窗口并行推进时，每个任务文件必须额外包含： + - 触碰文件清单（Touch List，精确到文件） + - 共享文件策略（哪些是共享文件、唯一 Writer 是谁、如何与集成窗口对接） + - 编译绿线策略（如何确保阶段性交付不破坏编译） ## 推荐结构（模板） @@ -41,3 +46,5 @@ description: 强制任务拆分输出规范：阅读完所有文档后，先产 3. [ ] 是否产出 `00-总览.md`（或等价总览文件）？ 4. [ ] 是否将可并行任务拆分为不同 md 文件？ 5. [ ] 是否所有 md 文件都带有连续序号？ +6. [ ] 并行任务是否为每个任务文件补充了 Touch List/共享文件策略/编译绿线策略？ +7. [ ] 子任务完成后，是否在对应版本的 `00-任务总览.md` 标注“已完成”，并在“待验证表”里更新状态？ diff --git a/Directory.Build.targets b/Directory.Build.targets new file mode 100644 index 0000000..705c3e5 --- /dev/null +++ b/Directory.Build.targets @@ -0,0 +1,8 @@ + + + + false + true + false + + diff --git a/Hua.Todo.slnx b/Hua.Todo.slnx index c1f8009..b3eb81d 100644 --- a/Hua.Todo.slnx +++ b/Hua.Todo.slnx @@ -6,9 +6,8 @@ - - - + + diff --git a/README.md b/README.md index 278081f..0cc4fae 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,17 @@ # Hua.Todo 跨平台代办管理应用 -一个基于 MAUI + WebView 架构开发的跨平台代办管理应用，支持 Windows、macOS、Android、iOS 和 Linux（预览）平台。通过 HTTP API 实现前后端通信，提供轻量、高效的任务管理体验。 +一个基于 WebView 容器（MAUI / Avalonia）+ 嵌入式 ASP.NET Core WebServer 架构开发的跨平台代办管理应用，支持 Windows、macOS、Android、iOS 和 Linux（预览）平台。通过 HTTP API 实现前后端通信，提供轻量、高效的任务管理体验。 ## 🚀 功能特点 ### 核心功能 -- **跨平台支持**：基于 MAUI + WebView 架构，支持 Windows、macOS、Android、iOS 和 Linux（预览） +- **跨平台支持**：基于 MAUI / Avalonia + WebView 架构，支持 Windows、macOS、Android、iOS 和 Linux（预览） - **任务管理**：支持创建、编辑、删除、完成状态切换 - **优先级管理**：支持高、中、低三种优先级设置，通过颜色直观区分 - **任务状态跟踪**：清晰标记任务完成状态，支持过滤查看（全部/进行中/已完成） - **本地数据持久化**：使用 SQLite 数据库保存数据，支持完全离线使用 - **HTTP API 通信**：前后端通过 RESTful API 进行数据交互 +- **云同步（基础）**：支持手动配置服务端地址并登录后拉取云端任务（v1.2.0 为只读展示） ## 📦 安装与使用 @@ -46,6 +47,19 @@ npm run dev ``` 前端将在 `http://localhost:5174` 启动，并自动代理 `/api` 请求到 `http://localhost:5173` +### Windows 交付产物（安装包） + +- 运行 `publish-windows.ps1` 生成 Inno Setup 安装包：`src/Hua.Todo.Maui/Output/Hua.Todo_Setup_vX.Y.Z.exe`（版本号来自 `Hua.Todo.Maui.csproj` 的 ``；根目录 `Directory.Build.targets` 会对 `Hua.Todo.Maui` 按 TargetFramework 条件配置 `UseMonoRuntime`：仅 Android 启用，其它目标关闭；同时会复制到 `artifacts/windows//installer/`） +- 运行 `publish.ps1` 默认会同时发布 Windows + Linux（仅发布 Windows：`publish.ps1 -Windows`） +- 安装后主程序为：`Hua.Todo.Maui.exe`（快捷方式/安装后启动均指向该文件） +- 发布产物默认使用静态资源：`src/Hua.Todo.Maui/appsettings.json` 中 `WebServer.IsUsingStatic=true` +- 前端构建产物会输出到 `src/Hua.Todo.Maui/wwwroot`，并随 Windows 发布复制到发布目录（嵌入式服务器从 `AppContext.BaseDirectory/wwwroot` 提供静态文件） + +### Linux 交付产物（v1.2.0） + +- `.tar.gz` 发布脚本：`publish-linux.ps1`（或使用 `publish.ps1 -Linux`） +- Flatpak 基础结构（manifest/desktop entry/AppStream）：`pack/linux/` + ### 使用说明 - **添加任务**：在前端界面中输入任务内容，设置优先级，点击添加按钮 - **管理任务**：查看任务列表，支持按状态过滤（全部/进行中/已完成） @@ -57,6 +71,7 @@ npm run dev ### 项目结构 ``` Hua.Todo/ +├── pack/ # 打包与交付产物（Linux/安装包等） ├── docs/ # 文档目录 │ ├── manual/ # 用户/开发者手册 │ └── project/ # 项目进度/需求文档 @@ -66,6 +81,7 @@ Hua.Todo/ │ ├── Hua.Todo.Host/ # 后端 API 宿主项目 (Kestrel) │ ├── Hua.Todo.Web/ # 前端 Web 项目 (Vue.js 3 + Vite) │ ├── Hua.Todo.Maui/ # 跨平台客户端项目 (Windows/Android/iOS/macOS) +│ ├── Hua.Todo.Avalonia/ # 桌面客户端项目 (Windows/macOS/Linux) │ └── Hua.Todo.slnx # 解决方案文件 ├── .gitignore # Git 忽略文件 └── README.md # 项目说明文档 diff --git a/docs/manual/技术栈与模块.md b/docs/manual/技术栈与模块.md index e6561f2..3e6ee57 100644 --- a/docs/manual/技术栈与模块.md +++ b/docs/manual/技术栈与模块.md @@ -5,7 +5,7 @@ ### 后端技术栈 - **开发语言**：C# 10 - **框架**：.NET 10 -- **UI 框架**：MAUI (Multi-platform App UI) +- **UI 框架**：MAUI（移动端/部分桌面） + Avalonia（桌面端） - **Web 服务器**：Kestrel (ASP.NET Core 内置) - **API 框架**：ASP.NET Core Web API - **数据访问**：Entity Framework Core @@ -37,3 +37,6 @@ ### Hua.Todo.Maui 跨平台客户端项目，将 Web 内容嵌入到原生容器中，支持 Windows、Android、iOS 和 macOS。 + +### Hua.Todo.Avalonia +桌面客户端项目（Avalonia + WebView），用于提供 Linux/Windows/macOS 桌面形态；同样通过嵌入式 WebServer + WebView 承载前端 UI。 diff --git a/docs/manual/版本记录.md b/docs/manual/版本记录.md index 7f2b355..88a9ac0 100644 --- a/docs/manual/版本记录.md +++ b/docs/manual/版本记录.md @@ -9,6 +9,14 @@ - v1.1.0：MAUI + WebView 跨平台版本 - v1.2.0 (规划中)：Linux 支持与增强功能 +### v1.2.0（开发中，2026-04-07） + +- **关键词检索**：主界面增加搜索框，按任务标题实时过滤；采用“命中即显示（含上下文）”策略；支持 Esc 清空；英文大小写不敏感。 +- **云同步（基础可用）**：新增“云同步设置”弹窗，支持手动配置服务端地址（格式校验 + 保存时可达性/风险提示）；登录成功后拉取云端任务并刷新主界面（v1.2.0 为只读展示）。 +- **发布脚本整理**：拆分/对齐各平台发布入口，新增 `publish.ps1` 作为统一入口（默认发布 Windows + Linux），Windows 发布脚本支持开关打包与版本自增，发布产物会落盘到 `artifacts/`。 +- **Windows 发布打包修复**：Inno Setup 安装包文件名带版本号（Hua.Todo_Setup_vX.Y.Z.exe）；安装后快捷方式/启动项指向 Hua.Todo.Maui.exe；发布产物强制 IsUsingStatic=true。 +- **Avalonia 桌面交互对齐 MAUI**：增加托盘菜单（显示/退出）、关闭隐藏到托盘、Windows 全局热键唤起主窗口、热键配置本地持久化；并对齐 Avalonia 的 appsettings 默认值。 + ### v1.1.1 (2026-04-06) - **文档规范增强**：新增文档同步规则，强制代码变更与文档更新保持同步。 @@ -29,8 +37,8 @@ ### v1.2.0 规划内容 (即将推出) - **Linux 官方支持**：正式适配 Linux 平台。 +- **Linux 打包与交付**：新增 `.tar.gz` 发布脚本与 Flatpak（manifest/desktop entry/AppStream）基础结构。 - **关键词检索**：支持按任务标题关键词搜索。 - **标签系统**：引入多标签支持，提升任务组织效率。 - **暗色模式**：全平台适配暗色/深色主题。 - **数据导出导入（后续）**：支持 JSON 格式数据备份与迁移（延期到后续版本）。 - diff --git a/docs/project/v1.2.0-tasks/00-任务总览.md b/docs/project/v1.2.0-tasks/00-任务总览.md index 2cce752..6dda33e 100644 --- a/docs/project/v1.2.0-tasks/00-任务总览.md +++ b/docs/project/v1.2.0-tasks/00-任务总览.md @@ -19,9 +19,10 @@ - **Linux 入口线**：`01-*` + `02-*` - 01：新增 Avalonia 入口、选择 Linux 可用的 WebView 控件、复用现有前后端协议 - - 02：Linux 打包/交付产物（优先自包含：AppImage/Flatpak 之一；补充 .deb/.tar.gz） + - 02：Linux 打包/交付产物（已落地：`.tar.gz` 发布脚本 + Flatpak 基础结构；详见 `publish-linux.ps1` 与 `pack/linux/`） - **Search 线**：`03-*` - 主要在前端完成；与云同步/平台入口基本无耦合，可并行 + - 03：已完成：主界面搜索框（按标题包含匹配；命中即显示含上下文；Esc 清空；英文大小写不敏感） - **云同步线**：`04-*` + `05-*` + `06-*` - 04：服务端基础能力（登录、任务同步/读取、配置下发、用户隔离） - 05：客户端配置与同步工作流（手动指定服务端地址、登录后拉取任务） @@ -29,9 +30,20 @@ - **文档与验收线**：`07-*` - 对齐文档与现实现状/接口；补齐验收步骤与自测清单 +## 待验证表 + +| 子任务 | 实现状态 | 验证状态 | 备注 | +|---|---|---|---| +| 01 - Linux 入口 | 已完成 | 待验证 | 基于 Avalonia + WebView.Avalonia 实现 | +| 02 - Linux 打包/交付 | 已落地 | 待验证 | `.tar.gz` 发布脚本 + Flatpak 基础结构 | +| 03 - Search 关键词检索 | 已完成 | 待验证 | 搜索框 + 树状任务标题包含匹配 | +| 04 - 云同步 服务端基础能力 | 已完成 | 已验证 | API 契约与错误码已固化到 04 文档 | +| 05 - 云同步 客户端配置与同步 | 已完成 | 待验证 | 新增“云同步设置”弹窗：地址校验+保存探测、登录/登出、登录后拉取云端任务并在主界面只读展示 | +| 06 - 安全与落盘策略 | 未标注 | 待验证 | | +| 07 - 文档与验收 | 未标注 | 待验证 | | + ## 交付判定（v1.2.0 Done Definition） - Linux：在基线发行版（建议 Ubuntu LTS）上可启动、可渲染前端、可调用本地 API；且有可安装/可运行的交付产物 - Search：可在主界面按标题实时过滤任务（含层级任务的展示策略清晰） - 云同步（基础可用）：可配置服务端地址；登录后可拉取该用户任务；服务端可下发“是否允许落盘”；客户端在禁止落盘时不产生本地持久化 - diff --git a/docs/project/v1.2.0-tasks/01-Linux-Avalonia入口与WebView.md b/docs/project/v1.2.0-tasks/01-Linux-Avalonia入口与WebView.md index 15da2ca..9124b1b 100644 --- a/docs/project/v1.2.0-tasks/01-Linux-Avalonia入口与WebView.md +++ b/docs/project/v1.2.0-tasks/01-Linux-Avalonia入口与WebView.md @@ -39,6 +39,36 @@ - 开发态：Avalonia WebView 指向前端 dev server（例如 `http://localhost:5173`）或指向本地 WebServer - 生产态：加载随应用交付的静态资源（`wwwroot`）并确保 SPA fallback 生效（访问非 `/assets/*` 的路由能回到 `index.html`） +## 实现落地（已完成） + +### 1) 项目结构 + +- 新增 Linux 桌面端入口项目：`src/Hua.Todo.Avalonia` +- 入口类型：Avalonia Desktop App（ClassicDesktopLifetime） + +### 2) WebView 方案选型（已落定） + +- 采用：`WebView.Avalonia` + `WebView.Avalonia.Desktop` + - Windows：依赖 WebView2 Runtime + - Linux：依赖 GTK + WebKitGTK（运行环境缺失时 WebView 会初始化失败） + +### 3) 资源加载策略（与 MAUI 对齐） + +- 生产态（默认）：内嵌 WebServer 托管 `wwwroot` 静态资源，WebView 指向 `HostUrl` +- 开发态：将 `IsUsingStatic=false`，WebView 指向 `ForEndUrl`（例如 Vite dev server） + +### 4) 前端契约对齐（与 MAUI 一致） + +- 在 WebView 导航完成后注入： + - `window.__API_BASE_URL__ = "${HostUrl}/api"` + - `window.mauiInterop`（事件名/字段名与现有前端保持一致） + +### 5) 本地 API 与数据库初始化 + +- 内嵌 WebServer 使用 Kestrel 启动并注册动态 API 与 Controllers +- 启动时执行数据库迁移（Migrate），并设置 SQLite WAL 模式以降低锁冲突风险 +- 默认 SQLite 路径使用用户目录（`LocalApplicationData/Hua.Todo/Hua.Todo.db`），避免安装目录无写权限导致启动失败 + ## 实施步骤（建议） 1. 新建 Avalonia 宿主项目 @@ -61,4 +91,3 @@ - 前端能通过 `window.__API_BASE_URL__` 正确请求本地 `/api/*`（至少任务列表接口可用） - 页面路由/刷新不会出现 404（SPA fallback 生效） - 开发态可调试（至少能看到控制台/网络错误，或能通过日志定位） - diff --git a/docs/project/v1.2.0-tasks/04-CloudSync-服务端基础能力.md b/docs/project/v1.2.0-tasks/04-CloudSync-服务端基础能力.md index c442cd6..2d3e23d 100644 --- a/docs/project/v1.2.0-tasks/04-CloudSync-服务端基础能力.md +++ b/docs/project/v1.2.0-tasks/04-CloudSync-服务端基础能力.md @@ -21,13 +21,102 @@ ## 接口契约（需要在实现前先写清楚） -建议输出一份“云同步 API 契约”并固化到 docs（便于客户端对接）。至少包含： -- 登录：`POST /auth/login`（或等效） -- 获取用户任务：`GET /tasks`（或等效，支持增量/版本号是加分项，但 v1.2.0 可先全量） -- 上传/同步：`POST /sync`（或按任务粒度的增删改接口） -- 获取安全配置：`GET /security/policy` - - 返回字段至少包含：`allowPersist`（是否允许落盘） - - 可扩展：`deviceTrust`、`sessionTtl`、`requireSecondFactorFor` 等 +v1.2.0 已实现一套最小可用契约（用于 05/06 客户端对接时冻结字段名/错误码）。 + +### 通用约定 + +- Base URL：由客户端配置（例如 `https://{host}:{port}`） +- 认证：`Authorization: Bearer {accessToken}` +- 错误响应（统一结构）： + +```json +{ "code": "ERROR_CODE", "message": "Human readable message." } +``` + +### 错误码 + +- `UNAUTHORIZED`：未登录或会话失效 +- `FORBIDDEN`：权限不足（RBAC / 策略拒绝） +- `SECOND_FACTOR_REQUIRED`：需要二次认证（step-up） +- `BAD_REQUEST`：请求参数不合法 +- `NOT_FOUND`：资源不存在 + +### Auth + +- 初始化管理员（仅当系统尚无云用户时允许一次）： + - `POST /auth/bootstrap` + - Body：`{ "userName": "admin", "password": "..." }` + - 200：成功；403：已初始化或不允许 + +- 登录： + - `POST /auth/login` + - Body：`{ "userName": "admin", "password": "..." }` + - 200：`{ accessToken, expiresAtUtc, userId, role, permissions[] }` + +- 二次认证（step-up，v1.2.0 最小实现为“复用登录口令进行再认证”）： + - `POST /auth/step-up` + - Header：`Authorization: Bearer ...` + - Body：`{ "password": "..." }` + - 200：`{ stepUpExpiresAtUtc }` + +### Tasks + +- 获取当前用户任务全量： + - `GET /tasks` + - Header：`Authorization: Bearer ...` + - 权限：`tasks:read` + - 200：`CloudTaskItem[]` + +### Sync + +- 上传/同步（增删改后返回最新全量）： + - `POST /sync` + - Header：`Authorization: Bearer ...` + - 权限：`sync:write` + - 二次认证：必需（否则返回 `SECOND_FACTOR_REQUIRED`） + - Body： + +```json +{ + "upserts": [ + { "id": 1, "title": "A", "priority": 1, "isCompleted": false, "parentTaskId": null }, + { "id": null, "title": "New", "priority": 1, "isCompleted": false, "parentTaskId": null } + ], + "deletes": [2, 3] +} +``` + + - 200： + +```json +{ + "serverTimeUtc": "2026-04-06T17:39:30.0281279Z", + "tasks": [ /* CloudTaskItem[] */ ] +} +``` + +### Security Policy + +- 获取安全策略（服务端下发）： + - `GET /security/policy` + - Header：`Authorization: Bearer ...` + - 权限：`policy:read` + - 200： + +```json +{ + "allowPersist": true, + "allowSync": true, + "requireSecondFactorFor": ["sync:write", "policy:write"] +} +``` + +- 更新安全策略（高风险操作）： + - `PUT /security/policy` + - Header：`Authorization: Bearer ...` + - 权限：`policy:write` + - 二次认证：必需（否则返回 `SECOND_FACTOR_REQUIRED`） + - Body：`{ "allowPersist": false, "allowSync": false }` ## 关键实现点（建议） @@ -49,3 +138,8 @@ - 未授权角色/权限访问受限接口会被拒绝（错误响应可被客户端识别） - 能返回安全策略配置（至少包含 `allowPersist`），并可通过配置切换行为 +## 当前实现说明（v1.2.0） + +- 数据隔离：`Tasks` 表新增 `UserId` 外键，云端 API 的所有读写按当前会话用户隔离；本地模式使用固定的 `local` 用户 ID（不影响既有 Dynamic API）。 +- RBAC：内置 `admin / user / readonly / nosync` 角色与权限映射；并叠加 `SecurityPolicies.AllowSync` 作为“是否允许同步写入”的策略开关。 +- 二次认证：通过 `POST /auth/step-up` 将会话提升到 step-up 状态；`POST /sync` 与 `PUT /security/policy` 会强制要求 step-up。 diff --git a/publish-linux.ps1 b/publish-linux.ps1 new file mode 100644 index 0000000..f538bf0 --- /dev/null +++ b/publish-linux.ps1 @@ -0,0 +1,115 @@ +<# + Hua.Todo Linux 发布脚本（产出 .tar.gz） + + 目标： + - 为 Linux 提供可分发的目录产物（dotnet publish 输出） + - 在 Windows 开发机上也能交叉发布 linux-x64（便于 CI 前的本地验证） + + 约束： + - Avalonia Linux 入口项目需先落地（参见 docs/project/v1.2.0-tasks/01-*） + - 仅打包为 tar.gz；Flatpak/AppImage 需要在 Linux 环境执行相关工具链 +#> + +param( + [ValidateSet("linux-x64", "linux-arm64")] + [string]$RuntimeIdentifier = "linux-x64", + + [switch]$SelfContained, + + [string]$Configuration = "Release" +) + +$ErrorActionPreference = "Stop" + +$ScriptPath = $PSScriptRoot + +function Get-FirstExistingFilePath { + param( + [Parameter(Mandatory = $true)] + [string[]]$Candidates + ) + + foreach ($candidate in $Candidates) { + if (Test-Path $candidate) { + return $candidate + } + } + + return $null +} + +function Read-ProjectVersion { + param( + [Parameter(Mandatory = $true)] + [string]$ProjectFile + ) + + $currentVersion = "0.0.0" + [xml]$csproj = Get-Content $ProjectFile -Raw + + $versionNode = $csproj.SelectSingleNode("//Version") + if ($null -ne $versionNode -and -not [string]::IsNullOrWhiteSpace($versionNode.InnerText)) { + return $versionNode.InnerText.Trim() + } + + $versionNode = $csproj.SelectSingleNode("//ApplicationDisplayVersion") + if ($null -ne $versionNode -and -not [string]::IsNullOrWhiteSpace($versionNode.InnerText)) { + return $versionNode.InnerText.Trim() + } + + return $currentVersion +} + +$candidateProjects = @( + (Join-Path $ScriptPath "src\Hua.Todo.Avalonia\Hua.Todo.Avalonia.csproj"), + (Join-Path $ScriptPath "src\Hua.Todo.Desktop.Avalonia\Hua.Todo.Desktop.Avalonia.csproj") +) + +$ProjectFile = Get-FirstExistingFilePath -Candidates $candidateProjects +if ($null -eq $ProjectFile) { + $candidatesText = ($candidateProjects | ForEach-Object { " - $_" }) -join "`n" + Write-Error @" +未找到 Avalonia Linux 入口项目（无法生成 Linux 交付产物）。 + +请先完成 docs/project/v1.2.0-tasks/01-Linux-Avalonia入口与WebView.md 对应实现，并确保下列路径之一存在： +$candidatesText +"@ + exit 1 +} + +$version = Read-ProjectVersion -ProjectFile $ProjectFile +$artifactRoot = Join-Path $ScriptPath "artifacts\linux\$RuntimeIdentifier" +$publishDir = Join-Path $artifactRoot "publish" + +if (Test-Path $artifactRoot) { + Remove-Item -Recurse -Force $artifactRoot +} +New-Item -ItemType Directory -Path $publishDir | Out-Null + +$selfContainedValue = if ($SelfContained.IsPresent) { "true" } else { "false" } + +Write-Host "Publishing (RID=$RuntimeIdentifier, SelfContained=$selfContainedValue)..." -ForegroundColor Cyan + +dotnet publish $ProjectFile ` + -c $Configuration ` + -r $RuntimeIdentifier ` + --self-contained $selfContainedValue ` + -o $publishDir + +if ($LASTEXITCODE -ne 0) { + Write-Error "dotnet publish failed" + exit 1 +} + +$packageName = "hua.todo-$version-$RuntimeIdentifier.tar.gz" +$packagePath = Join-Path $artifactRoot $packageName + +Write-Host "Creating tar.gz: $packageName" -ForegroundColor Cyan +tar -C $publishDir -czf $packagePath . + +if ($LASTEXITCODE -ne 0) { + Write-Error "tar.gz packaging failed" + exit 1 +} + +Write-Host "Linux artifact created: $packagePath" -ForegroundColor Green diff --git a/publish-windows.ps1 b/publish-windows.ps1 new file mode 100644 index 0000000..c9c17d2 --- /dev/null +++ b/publish-windows.ps1 @@ -0,0 +1,325 @@ +param( + [string]$TargetFramework = "net10.0-windows10.0.19041.0", + + [string]$RuntimeIdentifier = "win-x64", + + [string]$Configuration = "Release", + + [switch]$SkipInnoSetup, + + [switch]$SkipVersionBump, + + [string]$ArtifactsRoot = (Join-Path $PSScriptRoot ("artifacts\windows\{0}" -f $RuntimeIdentifier)) +) + +$ErrorActionPreference = "Stop" + +$ScriptPath = $PSScriptRoot +$ProjectDir = Join-Path $ScriptPath "src\Hua.Todo.Maui" +$ProjectFile = Join-Path $ProjectDir "Hua.Todo.Maui.csproj" +$SetupScript = Join-Path $ProjectDir "setup.iss" +$ProjectBaseName = [System.IO.Path]::GetFileNameWithoutExtension($ProjectFile) + +function Read-ProjectVersion { + param( + [Parameter(Mandatory = $true)] + [string]$ProjectFile + ) + + $currentVersion = "0.0.0" + [xml]$csproj = Get-Content $ProjectFile -Raw + + $versionNode = $csproj.SelectSingleNode("//Version") + if ($null -ne $versionNode -and -not [string]::IsNullOrWhiteSpace($versionNode.InnerText)) { + return $versionNode.InnerText.Trim() + } + + $versionNode = $csproj.SelectSingleNode("//ApplicationDisplayVersion") + if ($null -ne $versionNode -and -not [string]::IsNullOrWhiteSpace($versionNode.InnerText)) { + return $versionNode.InnerText.Trim() + } + + return $currentVersion +} + +function Read-InnoSetupAppName { + param( + [Parameter(Mandatory = $true)] + [string]$SetupScript + ) + + if (!(Test-Path $SetupScript)) { + return $null + } + + $content = Get-Content $SetupScript -Raw + $match = [regex]::Match($content, '#define\s+MyAppName\s+"([^"]+)"') + if ($match.Success) { + return $match.Groups[1].Value.Trim() + } + + return $null +} + +# Read OutputBaseFilename from setup.iss so we can determine the exact installer file path after ISCC runs. +# The value may contain Inno preprocessor macros like {#MyAppName}/{#MyAppVersion}. +function Read-InnoSetupOutputBaseFilename { + param( + [Parameter(Mandatory = $true)] + [string]$SetupScript + ) + + if (!(Test-Path $SetupScript)) { + return $null + } + + $content = Get-Content $SetupScript -Raw + $match = [regex]::Match($content, '^\s*OutputBaseFilename\s*=\s*(.+?)\s*$', [System.Text.RegularExpressions.RegexOptions]::Multiline) + if ($match.Success) { + return $match.Groups[1].Value.Trim().Trim('"') + } + + return $null +} + +# Resolve the subset of Inno preprocessor macros used by this repo to a concrete file base name. +function Resolve-InnoSetupOutputBaseFilename { + param( + [Parameter(Mandatory = $true)] + [string]$Template, + + [string]$AppName, + + [string]$Version + ) + + if ([string]::IsNullOrWhiteSpace($Template)) { + return $null + } + + $resolved = $Template + if (![string]::IsNullOrWhiteSpace($AppName)) { + $resolved = $resolved.Replace("{#MyAppName}", $AppName) + } + if (![string]::IsNullOrWhiteSpace($Version)) { + $resolved = $resolved.Replace("{#MyAppVersion}", $Version) + } + + return $resolved.Trim() +} + +function Update-InnoSetupVersion { + param( + [Parameter(Mandatory = $true)] + [string]$SetupScript, + + [Parameter(Mandatory = $true)] + [string]$Version + ) + + if (!(Test-Path $SetupScript)) { + return + } + + $issContent = Get-Content $SetupScript + $versionFound = $false + for ($i = 0; $i -lt $issContent.Count; $i++) { + if ($issContent[$i] -like '#define MyAppVersion *') { + $issContent[$i] = '#define MyAppVersion "' + $Version + '"' + $versionFound = $true + break + } + } + + if ($versionFound) { + Set-Content $SetupScript -Value $issContent -Encoding UTF8 + } +} + +function Copy-Directory { + param( + [Parameter(Mandatory = $true)] + [string]$Source, + + [Parameter(Mandatory = $true)] + [string]$Destination + ) + + if (Test-Path $Destination) { + Remove-Item -Recurse -Force $Destination + } + + New-Item -ItemType Directory -Path $Destination | Out-Null + Copy-Item -Path (Join-Path $Source "*") -Destination $Destination -Recurse -Force +} + +$currentVersion = Read-ProjectVersion -ProjectFile $ProjectFile +Update-InnoSetupVersion -SetupScript $SetupScript -Version $currentVersion + +Write-Host "Publishing Hua.Todo.Maui (TFM=$TargetFramework, RID=$RuntimeIdentifier, Config=$Configuration)..." -ForegroundColor Cyan +# UseMonoRuntime 在 csproj 内按 TargetFramework 做了条件配置：仅 Android 启用，其它目标关闭。 +dotnet publish $ProjectFile -f $TargetFramework -c $Configuration -r $RuntimeIdentifier --self-contained false +if ($LASTEXITCODE -ne 0) { + Write-Error "MAUI build failed" + exit 1 +} + +$publishDir = Join-Path $ProjectDir ("bin\{0}\{1}\{2}\publish" -f $Configuration, $TargetFramework, $RuntimeIdentifier) +if (!(Test-Path $publishDir)) { + $publishDir = (Get-ChildItem -Path (Join-Path $ProjectDir "bin\$Configuration") -Recurse -Directory -Filter publish -ErrorAction SilentlyContinue | Select-Object -First 1 -ExpandProperty FullName) +} +if (!(Test-Path $publishDir)) { + Write-Error "Publish directory not found" + exit 1 +} + +$publishAppSettings = Join-Path $publishDir "appsettings.json" +if (Test-Path $publishAppSettings) { + $appSettingsObj = Get-Content $publishAppSettings -Raw | ConvertFrom-Json + if ($null -eq $appSettingsObj.WebServer) { + $appSettingsObj | Add-Member -MemberType NoteProperty -Name "WebServer" -Value ([pscustomobject]@{}) + } + $appSettingsObj.WebServer.IsUsingStatic = $true + $appSettingsObj | ConvertTo-Json -Depth 32 | Set-Content -Path $publishAppSettings -Encoding UTF8 +} else { + Write-Error "Publish appsettings.json not found: $publishAppSettings" + exit 1 +} + +$desiredExeName = "$ProjectBaseName.exe" +$desiredExePath = Join-Path $publishDir $desiredExeName +if (!(Test-Path $desiredExePath)) { + $candidateExe = $null + $preferredCandidateNames = @( + "Hua.Todo.Maui.exe", + "Hua.Todo.exe" + ) + foreach ($name in $preferredCandidateNames) { + $candidatePath = Join-Path $publishDir $name + if (Test-Path $candidatePath) { + $candidateExe = Get-Item -Path $candidatePath + break + } + } + if ($null -eq $candidateExe) { + $exeFiles = Get-ChildItem -Path $publishDir -Filter "*.exe" -File -ErrorAction SilentlyContinue | Where-Object { $_.Name -notlike "*Setup*" } + $candidateExe = $exeFiles | Where-Object { Test-Path (Join-Path $publishDir ($_.BaseName + ".dll")) } | Select-Object -First 1 + if ($null -eq $candidateExe) { + $candidateExe = $exeFiles | Sort-Object Length -Descending | Select-Object -First 1 + } + } + if ($null -ne $candidateExe) { + Rename-Item -Path $candidateExe.FullName -NewName $desiredExeName -Force + } +} +if (!(Test-Path $desiredExePath)) { + Write-Error "Publish main executable not found: $desiredExeName" + exit 1 +} + +$mauiWwwrootDir = Join-Path $ProjectDir "wwwroot" +$mauiIndexPath = Join-Path $mauiWwwrootDir "index.html" +if (!(Test-Path $mauiIndexPath)) { + Write-Error "MAUI wwwroot not found: $mauiIndexPath" + exit 1 +} + +$publishWwwroot = Join-Path $publishDir "wwwroot" +if (Test-Path $publishWwwroot) { + Remove-Item -Recurse -Force $publishWwwroot +} +New-Item -ItemType Directory -Path $publishWwwroot | Out-Null +Copy-Item -Path (Join-Path $mauiWwwrootDir "*") -Destination $publishWwwroot -Recurse -Force + +$installerPath = $null +if (!$SkipInnoSetup.IsPresent) { + $ISCC = "${env:ProgramFiles(x86)}\Inno Setup 6\ISCC.exe" + if (Test-Path $ISCC) { + $innoAppName = Read-InnoSetupAppName -SetupScript $SetupScript + $outputDir = Join-Path $ProjectDir "Output" + $outputBaseTemplate = Read-InnoSetupOutputBaseFilename -SetupScript $SetupScript + $resolvedOutputBase = Resolve-InnoSetupOutputBaseFilename -Template $outputBaseTemplate -AppName $innoAppName -Version $currentVersion + $expectedInstallerPath = $null + if (![string]::IsNullOrWhiteSpace($resolvedOutputBase)) { + $expectedInstallerPath = Join-Path $outputDir ("{0}.exe" -f $resolvedOutputBase) + } + + if (![string]::IsNullOrWhiteSpace($innoAppName)) { + # Prevent stale unversioned installer (Output\Hua.Todo.exe) from confusing local release artifacts. + $oldInstallerPath = Join-Path $outputDir ("{0}.exe" -f $innoAppName) + if (Test-Path $oldInstallerPath) { + Remove-Item -Path $oldInstallerPath -Force + } + } + + # ISCC sometimes fails with a transient file sharing violation (e.g. antivirus/indexer holding the script/output briefly). + $maxAttempts = 3 + for ($attempt = 1; $attempt -le $maxAttempts; $attempt++) { + $isccOutput = (& $ISCC $SetupScript 2>&1 | Out-String) + $exitCode = $LASTEXITCODE + if ($exitCode -eq 0) { + break + } + + Write-Host $isccOutput + if ($attempt -lt $maxAttempts -and ($isccOutput -match 'Compile aborted|being used by another process|Sharing violation|process cannot access')) { + Start-Sleep -Seconds 2 + continue + } + + Write-Error "Packaging failed" + exit 1 + } + + if ($null -ne $expectedInstallerPath -and (Test-Path $expectedInstallerPath)) { + $installerPath = $expectedInstallerPath + } + + if ($null -eq $installerPath) { + if (Test-Path $outputDir) { + $installerPath = (Get-ChildItem -Path $outputDir -Filter "*.exe" -File -ErrorAction SilentlyContinue | Sort-Object LastWriteTime -Descending | Select-Object -First 1 -ExpandProperty FullName) + } + } + + Write-Host "Setup package created successfully!" -ForegroundColor Green + if ($null -ne $installerPath -and (Test-Path $installerPath)) { + Write-Host ("Output: {0}" -f $installerPath) -ForegroundColor Green + } + } else { + Write-Error "Inno Setup compiler not found" + exit 1 + } +} + +if (![string]::IsNullOrWhiteSpace($ArtifactsRoot)) { + $publishArtifactDir = Join-Path $ArtifactsRoot "publish" + $installerArtifactDir = Join-Path $ArtifactsRoot "installer" + Copy-Directory -Source $publishDir -Destination $publishArtifactDir + + if ($null -ne $installerPath -and (Test-Path $installerPath)) { + if (Test-Path $installerArtifactDir) { + Remove-Item -Recurse -Force $installerArtifactDir + } + New-Item -ItemType Directory -Path $installerArtifactDir | Out-Null + + $installerName = "hua.todo-$currentVersion-$RuntimeIdentifier-setup.exe" + Copy-Item -Path $installerPath -Destination (Join-Path $installerArtifactDir $installerName) -Force + } +} + +if (!$SkipVersionBump.IsPresent) { + $versionMatch = [regex]::Match($currentVersion, '^(?\d+)\.(?\d+)\.(?\d+)$') + if ($versionMatch.Success) { + $newVersion = "{0}.{1}.{2}" -f $versionMatch.Groups["major"].Value, $versionMatch.Groups["minor"].Value, ([int]$versionMatch.Groups["patch"].Value + 1) + + $content = Get-Content $ProjectFile -Raw + if ($content -match "[^<]*") { + $content = $content -replace "[^<]*", "$newVersion" + Set-Content $ProjectFile -Value $content -Encoding UTF8 + } else { + Write-Host "Skip version bump: node not found in csproj." -ForegroundColor Yellow + } + } else { + Write-Host "Skip version bump: version is not MAJOR.MINOR.PATCH -> $currentVersion" -ForegroundColor Yellow + } +} diff --git a/publish.ps1 b/publish.ps1 index d6d85bd..9bc0148 100644 --- a/publish.ps1 +++ b/publish.ps1 @@ -1,62 +1,63 @@ +param( + [switch]$Windows, + + [switch]$Linux, + + [string[]]$LinuxRuntimes = @("linux-x64", "linux-arm64"), + + [switch]$LinuxSelfContained, + + [string]$Configuration = "Release", + + [switch]$SkipWindowsInnoSetup, + + [switch]$SkipWindowsVersionBump +) + $ErrorActionPreference = "Stop" $ScriptPath = $PSScriptRoot -$ProjectDir = Join-Path $ScriptPath "src\Hua.Todo.Maui" -$ProjectFile = Join-Path $ProjectDir "Hua.Todo.Maui.csproj" -$SetupScript = Join-Path $ProjectDir "setup.iss" -# Read version from project file -$currentVersion = "1.0.0" -[xml]$csproj = Get-Content $ProjectFile -Raw -$versionNode = $csproj.SelectSingleNode("//Version") -if ($null -ne $versionNode) { - $currentVersion = $versionNode.InnerText -} else { - $versionNode = $csproj.SelectSingleNode("//ApplicationDisplayVersion") - if ($null -ne $versionNode) { - $currentVersion = $versionNode.InnerText +$publishWindowsScript = Join-Path $ScriptPath "publish-windows.ps1" +$publishLinuxScript = Join-Path $ScriptPath "publish-linux.ps1" + +$shouldPublishWindows = $Windows.IsPresent +$shouldPublishLinux = $Linux.IsPresent +if (!$shouldPublishWindows -and !$shouldPublishLinux) { + $shouldPublishWindows = $true + $shouldPublishLinux = $true +} + +if ($shouldPublishWindows) { + if (!(Test-Path $publishWindowsScript)) { + Write-Error "publish-windows.ps1 not found: $publishWindowsScript" + exit 1 + } + + & $publishWindowsScript ` + -Configuration $Configuration ` + -SkipInnoSetup:$SkipWindowsInnoSetup ` + -SkipVersionBump:$SkipWindowsVersionBump + + if ($LASTEXITCODE -ne 0) { + exit $LASTEXITCODE } } -# Update setup script version with current version before build -if (Test-Path $SetupScript) { - $issContent = Get-Content $SetupScript - $versionFound = $false - for ($i = 0; $i -lt $issContent.Count; $i++) { - if ($issContent[$i] -like '#define MyAppVersion *') { - $issContent[$i] = '#define MyAppVersion "' + $currentVersion + '"' - $versionFound = $true - break +if ($shouldPublishLinux) { + if (!(Test-Path $publishLinuxScript)) { + Write-Error "publish-linux.ps1 not found: $publishLinuxScript" + exit 1 + } + + foreach ($rid in $LinuxRuntimes) { + & $publishLinuxScript ` + -RuntimeIdentifier $rid ` + -SelfContained:$LinuxSelfContained ` + -Configuration $Configuration + + if ($LASTEXITCODE -ne 0) { + exit $LASTEXITCODE } } - if ($versionFound) { - Set-Content $SetupScript -Value $issContent - } } - -Write-Host "Building Hua.Todo.Maui (Release)..." -ForegroundColor Cyan -dotnet publish $ProjectFile -f net10.0-windows10.0.19041.0 -c Release --self-contained false -if ($LASTEXITCODE -ne 0) { - Write-Error "MAUI build failed" - exit 1 -} - -$ISCC = "${env:ProgramFiles(x86)}\Inno Setup 6\ISCC.exe" -if (Test-Path $ISCC) { - & $ISCC $SetupScript - if ($LASTEXITCODE -eq 0) { - Write-Host "Setup package created successfully!" -ForegroundColor Green - } else { - Write-Error "Packaging failed" - } -} else { - Write-Error "Inno Setup compiler not found" -} - -$versionParts = $currentVersion.Split(".") -$patch = [int]$versionParts[2] + 1 -$newVersion = $versionParts[0] + "." + $versionParts[1] + "." + $patch - -$content = Get-Content $ProjectFile -Raw -$content = $content -replace ".*", "$newVersion" -Set-Content $ProjectFile -Value $content diff --git a/src/Hua.Todo.Application/CloudSync/Auth/ClaimsPrincipalExtensions.cs b/src/Hua.Todo.Application/CloudSync/Auth/ClaimsPrincipalExtensions.cs new file mode 100644 index 0000000..4c89fc8 --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Auth/ClaimsPrincipalExtensions.cs @@ -0,0 +1,53 @@ +using System.Security.Claims; + +namespace Hua.Todo.Application.CloudSync.Auth; + +/// +/// 云同步鉴权相关的 扩展方法。 +/// +public static class ClaimsPrincipalExtensions +{ + /// + /// 获取当前用户 ID（若未登录则返回 null）。 + /// + /// 当前用户主体。 + /// 用户 ID。 + public static Guid? GetUserId(this ClaimsPrincipal user) + { + var value = user.FindFirstValue(ClaimTypes.NameIdentifier); + return Guid.TryParse(value, out var id) ? id : null; + } + + /// + /// 获取当前会话 ID（若不可用则返回 null）。 + /// + /// 当前用户主体。 + /// 会话 ID。 + public static Guid? GetSessionId(this ClaimsPrincipal user) + { + var value = user.FindFirstValue(ClaimTypes.Sid); + return Guid.TryParse(value, out var id) ? id : null; + } + + /// + /// 判断是否具备指定权限。 + /// + /// 当前用户主体。 + /// 权限点。 + /// 是否具备权限。 + public static bool HasPermission(this ClaimsPrincipal user, string permission) + { + return user.Claims.Any(c => c.Type == CloudClaims.Permission && string.Equals(c.Value, permission, StringComparison.OrdinalIgnoreCase)); + } + + /// + /// 判断是否已完成二次认证（step-up）。 + /// + /// 当前用户主体。 + /// 是否已完成二次认证。 + public static bool HasStepUp(this ClaimsPrincipal user) + { + return user.Claims.Any(c => c.Type == CloudClaims.StepUp && string.Equals(c.Value, "true", StringComparison.OrdinalIgnoreCase)); + } +} + diff --git a/src/Hua.Todo.Application/CloudSync/Auth/CloudClaims.cs b/src/Hua.Todo.Application/CloudSync/Auth/CloudClaims.cs new file mode 100644 index 0000000..0e7770e --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Auth/CloudClaims.cs @@ -0,0 +1,18 @@ +namespace Hua.Todo.Application.CloudSync.Auth; + +/// +/// 云同步鉴权使用的 Claim 名称约定。 +/// +public static class CloudClaims +{ + /// + /// 权限 Claim（可重复出现）。 + /// + public const string Permission = "perm"; + + /// + /// 二次认证状态 Claim。 + /// + public const string StepUp = "step_up"; +} + diff --git a/src/Hua.Todo.Application/CloudSync/Auth/CloudPermissions.cs b/src/Hua.Todo.Application/CloudSync/Auth/CloudPermissions.cs new file mode 100644 index 0000000..7702fd9 --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Auth/CloudPermissions.cs @@ -0,0 +1,38 @@ +namespace Hua.Todo.Application.CloudSync.Auth; + +/// +/// 云同步权限点常量。 +/// +public static class CloudPermissions +{ + /// + /// 读取任务数据。 + /// + public const string TasksRead = "tasks:read"; + + /// + /// 写入任务数据。 + /// + public const string TasksWrite = "tasks:write"; + + /// + /// 允许执行同步写入（用于区分“允许同步/禁止同步”）。 + /// + public const string SyncWrite = "sync:write"; + + /// + /// 读取安全策略。 + /// + public const string PolicyRead = "policy:read"; + + /// + /// 修改安全策略（高风险）。 + /// + public const string PolicyWrite = "policy:write"; + + /// + /// 管理用户（创建/修改角色）。 + /// + public const string UsersManage = "users:manage"; +} + diff --git a/src/Hua.Todo.Application/CloudSync/Auth/DefaultRolePermissionMapper.cs b/src/Hua.Todo.Application/CloudSync/Auth/DefaultRolePermissionMapper.cs new file mode 100644 index 0000000..1166c8a --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Auth/DefaultRolePermissionMapper.cs @@ -0,0 +1,43 @@ +namespace Hua.Todo.Application.CloudSync.Auth; + +/// +/// 默认的角色-权限映射（内置最小集合）。 +/// +public class DefaultRolePermissionMapper : IRolePermissionMapper +{ + /// + public IReadOnlyList GetPermissions(string role) + { + return role switch + { + "admin" => new[] + { + CloudPermissions.TasksRead, + CloudPermissions.TasksWrite, + CloudPermissions.SyncWrite, + CloudPermissions.PolicyRead, + CloudPermissions.PolicyWrite, + CloudPermissions.UsersManage + }, + "readonly" => new[] + { + CloudPermissions.TasksRead, + CloudPermissions.PolicyRead + }, + "nosync" => new[] + { + CloudPermissions.TasksRead, + CloudPermissions.TasksWrite, + CloudPermissions.PolicyRead + }, + _ => new[] + { + CloudPermissions.TasksRead, + CloudPermissions.TasksWrite, + CloudPermissions.SyncWrite, + CloudPermissions.PolicyRead + } + }; + } +} + diff --git a/src/Hua.Todo.Application/CloudSync/Auth/IRolePermissionMapper.cs b/src/Hua.Todo.Application/CloudSync/Auth/IRolePermissionMapper.cs new file mode 100644 index 0000000..03779c2 --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Auth/IRolePermissionMapper.cs @@ -0,0 +1,15 @@ +namespace Hua.Todo.Application.CloudSync.Auth; + +/// +/// 角色到权限集合的映射器（RBAC 最小落地）。 +/// +public interface IRolePermissionMapper +{ + /// + /// 获取指定角色对应的权限集合。 + /// + /// 角色名称。 + /// 权限列表。 + IReadOnlyList GetPermissions(string role); +} + diff --git a/src/Hua.Todo.Application/CloudSync/Auth/SessionAuthenticationDefaults.cs b/src/Hua.Todo.Application/CloudSync/Auth/SessionAuthenticationDefaults.cs new file mode 100644 index 0000000..1f57c2e --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Auth/SessionAuthenticationDefaults.cs @@ -0,0 +1,13 @@ +namespace Hua.Todo.Application.CloudSync.Auth; + +/// +/// 云同步会话鉴权默认配置。 +/// +public static class SessionAuthenticationDefaults +{ + /// + /// 会话鉴权 Scheme 名称。 + /// + public const string Scheme = "CloudSession"; +} + diff --git a/src/Hua.Todo.Application/CloudSync/Auth/SessionAuthenticationHandler.cs b/src/Hua.Todo.Application/CloudSync/Auth/SessionAuthenticationHandler.cs new file mode 100644 index 0000000..4d8074b --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Auth/SessionAuthenticationHandler.cs @@ -0,0 +1,114 @@ +using System.Security.Claims; +using System.Text.Encodings.Web; +using Microsoft.AspNetCore.Authentication; +using Microsoft.EntityFrameworkCore; +using Microsoft.Extensions.Logging; +using Microsoft.Extensions.Options; +using Hua.Todo.Application.Data; + +namespace Hua.Todo.Application.CloudSync.Auth; + +/// +/// 基于服务端会话表的 Bearer Token 鉴权处理器。 +/// +public class SessionAuthenticationHandler : AuthenticationHandler +{ + private readonly TodoDbContext _dbContext; + private readonly IRolePermissionMapper _rolePermissionMapper; + + /// + /// 创建 。 + /// + /// 鉴权 scheme 选项。 + /// 日志。 + /// 编码器。 + /// 数据库上下文。 + /// 角色权限映射器。 + public SessionAuthenticationHandler( + IOptionsMonitor options, + ILoggerFactory logger, + UrlEncoder encoder, + TodoDbContext dbContext, + IRolePermissionMapper rolePermissionMapper) + : base(options, logger, encoder) + { + _dbContext = dbContext; + _rolePermissionMapper = rolePermissionMapper; + } + + /// + protected override async Task HandleAuthenticateAsync() + { + var authorization = Request.Headers.Authorization.ToString(); + if (string.IsNullOrWhiteSpace(authorization)) + { + return AuthenticateResult.NoResult(); + } + + if (!authorization.StartsWith("Bearer ", StringComparison.OrdinalIgnoreCase)) + { + return AuthenticateResult.NoResult(); + } + + var token = authorization["Bearer ".Length..].Trim(); + if (!Guid.TryParse(token, out var sessionId)) + { + return AuthenticateResult.Fail("Invalid bearer token format."); + } + + var now = DateTime.UtcNow; + + var session = await _dbContext.UserSessions + .AsNoTracking() + .Include(s => s.User) + .FirstOrDefaultAsync(s => s.Id == sessionId, Context.RequestAborted); + + if (session == null || session.User == null) + { + return AuthenticateResult.Fail("Session not found."); + } + + if (session.ExpiresAtUtc <= now) + { + return AuthenticateResult.Fail("Session expired."); + } + + var user = session.User; + var permissions = _rolePermissionMapper.GetPermissions(user.Role).ToList(); + + var allowSync = await _dbContext.SecurityPolicies + .AsNoTracking() + .Where(p => p.UserId == user.Id) + .Select(p => (bool?)p.AllowSync) + .FirstOrDefaultAsync(Context.RequestAborted); + + if (allowSync.HasValue && !allowSync.Value) + { + permissions.RemoveAll(p => string.Equals(p, CloudPermissions.SyncWrite, StringComparison.OrdinalIgnoreCase)); + } + + var claims = new List + { + new(ClaimTypes.Sid, session.Id.ToString()), + new(ClaimTypes.NameIdentifier, user.Id.ToString()), + new(ClaimTypes.Name, user.UserName), + new(ClaimTypes.Role, user.Role) + }; + + foreach (var p in permissions) + { + claims.Add(new Claim(CloudClaims.Permission, p)); + } + + if (session.StepUpExpiresAtUtc.HasValue && session.StepUpExpiresAtUtc.Value > now) + { + claims.Add(new Claim(CloudClaims.StepUp, "true")); + } + + var identity = new ClaimsIdentity(claims, Scheme.Name); + var principal = new ClaimsPrincipal(identity); + var ticket = new AuthenticationTicket(principal, Scheme.Name); + + return AuthenticateResult.Success(ticket); + } +} diff --git a/src/Hua.Todo.Application/CloudSync/CloudSyncEndpointExtensions.cs b/src/Hua.Todo.Application/CloudSync/CloudSyncEndpointExtensions.cs new file mode 100644 index 0000000..bf1fcca --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/CloudSyncEndpointExtensions.cs @@ -0,0 +1,194 @@ +using Microsoft.AspNetCore.Builder; +using Microsoft.AspNetCore.Http; +using Hua.Todo.Application.CloudSync.Auth; +using Hua.Todo.Application.CloudSync.Models; +using Hua.Todo.Application.CloudSync.Services; + +namespace Hua.Todo.Application.CloudSync; + +/// +/// 云同步服务端 API 路由注册扩展。 +/// +public static class CloudSyncEndpointExtensions +{ + /// + /// 映射云同步相关 API 端点。 + /// + /// Web 应用。 + /// Web 应用。 + public static WebApplication MapCloudSyncEndpoints(this WebApplication app) + { + var auth = app.MapGroup("/auth").WithTags("CloudSync - Auth"); + auth.MapPost("/bootstrap", BootstrapAdminAsync).AllowAnonymous(); + auth.MapPost("/login", LoginAsync).AllowAnonymous(); + auth.MapPost("/step-up", StepUpAsync).AllowAnonymous(); + + var tasks = app.MapGroup("/tasks").WithTags("CloudSync - Tasks"); + tasks.MapGet("/", GetTasksAsync).AllowAnonymous(); + + var sync = app.MapGroup("/sync").WithTags("CloudSync - Sync"); + sync.MapPost("/", SyncAsync).AllowAnonymous(); + + var security = app.MapGroup("/security").WithTags("CloudSync - Security"); + security.MapGet("/policy", GetPolicyAsync).AllowAnonymous(); + security.MapPut("/policy", UpdatePolicyAsync).AllowAnonymous(); + + return app; + } + + private static async Task BootstrapAdminAsync( + BootstrapAdminRequest request, + CloudAuthService authService, + CancellationToken cancellationToken) + { + if (request == null || string.IsNullOrWhiteSpace(request.UserName) || string.IsNullOrWhiteSpace(request.Password)) + { + return CloudApiErrors.BadRequest("UserName and Password are required."); + } + + var ok = await authService.BootstrapAdminAsync(request.UserName, request.Password, cancellationToken); + if (!ok) + { + return CloudApiErrors.Forbidden("Bootstrap is not allowed (already initialized or invalid input)."); + } + + return Results.Ok(); + } + + private static async Task LoginAsync( + LoginRequest request, + CloudAuthService authService, + CancellationToken cancellationToken) + { + if (request == null || string.IsNullOrWhiteSpace(request.UserName) || string.IsNullOrWhiteSpace(request.Password)) + { + return CloudApiErrors.BadRequest("UserName and Password are required."); + } + + var response = await authService.LoginAsync(request.UserName, request.Password, TimeSpan.FromDays(7), cancellationToken); + if (response == null) + { + return CloudApiErrors.Unauthorized("Invalid credentials."); + } + + return Results.Json(response); + } + + private static async Task StepUpAsync( + StepUpRequest request, + CloudAuthService authService, + HttpContext httpContext, + CancellationToken cancellationToken) + { + var sessionId = httpContext.User.GetSessionId(); + if (sessionId == null) + { + return CloudApiErrors.Unauthorized(); + } + + if (request == null || string.IsNullOrWhiteSpace(request.Password)) + { + return CloudApiErrors.BadRequest("Password is required."); + } + + var expiresAt = await authService.StepUpAsync(sessionId.Value, request.Password, TimeSpan.FromMinutes(5), cancellationToken); + if (!expiresAt.HasValue) + { + return CloudApiErrors.Unauthorized("Invalid credentials or session expired."); + } + + return Results.Json(new StepUpResponse { StepUpExpiresAtUtc = expiresAt.Value }); + } + + private static async Task GetTasksAsync( + CloudTaskSyncService taskService, + HttpContext httpContext, + CancellationToken cancellationToken) + { + var userId = httpContext.User.GetUserId(); + if (userId == null) + { + return CloudApiErrors.Unauthorized(); + } + + if (!httpContext.User.HasPermission(CloudPermissions.TasksRead)) + { + return CloudApiErrors.Forbidden(); + } + + var tasks = await taskService.GetTasksAsync(userId.Value, cancellationToken); + return Results.Json(tasks); + } + + private static async Task SyncAsync( + SyncRequest request, + CloudTaskSyncService taskService, + HttpContext httpContext, + CancellationToken cancellationToken) + { + var userId = httpContext.User.GetUserId(); + if (userId == null) + { + return CloudApiErrors.Unauthorized(); + } + + if (!httpContext.User.HasPermission(CloudPermissions.SyncWrite)) + { + return CloudApiErrors.Forbidden(); + } + + if (!httpContext.User.HasStepUp()) + { + return CloudApiErrors.SecondFactorRequired(); + } + + var response = await taskService.SyncAsync(userId.Value, request, cancellationToken); + return Results.Json(response); + } + + private static async Task GetPolicyAsync( + SecurityPolicyService policyService, + HttpContext httpContext, + CancellationToken cancellationToken) + { + var userId = httpContext.User.GetUserId(); + if (userId == null) + { + return CloudApiErrors.Unauthorized(); + } + + if (!httpContext.User.HasPermission(CloudPermissions.PolicyRead)) + { + return CloudApiErrors.Forbidden(); + } + + var policy = await policyService.GetPolicyAsync(userId.Value, cancellationToken); + return Results.Json(policy); + } + + private static async Task UpdatePolicyAsync( + UpdateSecurityPolicyRequest request, + SecurityPolicyService policyService, + HttpContext httpContext, + CancellationToken cancellationToken) + { + var userId = httpContext.User.GetUserId(); + if (userId == null) + { + return CloudApiErrors.Unauthorized(); + } + + if (!httpContext.User.HasPermission(CloudPermissions.PolicyWrite)) + { + return CloudApiErrors.Forbidden(); + } + + if (!httpContext.User.HasStepUp()) + { + return CloudApiErrors.SecondFactorRequired(); + } + + var policy = await policyService.UpdatePolicyAsync(userId.Value, request.AllowPersist, request.AllowSync, cancellationToken); + return Results.Json(policy); + } +} diff --git a/src/Hua.Todo.Application/CloudSync/CloudSyncServiceCollectionExtensions.cs b/src/Hua.Todo.Application/CloudSync/CloudSyncServiceCollectionExtensions.cs new file mode 100644 index 0000000..5890846 --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/CloudSyncServiceCollectionExtensions.cs @@ -0,0 +1,47 @@ +using Microsoft.AspNetCore.Authentication; +using Microsoft.AspNetCore.Identity; +using Microsoft.Extensions.DependencyInjection; +using Hua.Todo.Application.CloudSync.Auth; +using Hua.Todo.Application.CloudSync.Services; +using Hua.Todo.Core.Entities; + +namespace Hua.Todo.Application.CloudSync; + +/// +/// 云同步服务端能力的依赖注入扩展。 +/// +public static class CloudSyncServiceCollectionExtensions +{ + /// + /// 注册云同步相关的认证、授权与业务服务。 + /// + /// 服务集合。 + /// 服务集合。 + public static IServiceCollection AddCloudSyncServer(this IServiceCollection services) + { + services.AddHttpContextAccessor(); + + services.AddSingleton(); + services.AddScoped, PasswordHasher>(); + + services.AddScoped(); + services.AddScoped(); + services.AddScoped(); + + services.AddAuthentication(SessionAuthenticationDefaults.Scheme) + .AddScheme(SessionAuthenticationDefaults.Scheme, _ => { }); + + services.AddAuthorization(options => + { + options.AddPolicy("tasks:read", p => p.RequireClaim(CloudClaims.Permission, CloudPermissions.TasksRead)); + options.AddPolicy("tasks:write", p => p.RequireClaim(CloudClaims.Permission, CloudPermissions.TasksWrite)); + options.AddPolicy("sync:write", p => p.RequireClaim(CloudClaims.Permission, CloudPermissions.SyncWrite)); + options.AddPolicy("policy:read", p => p.RequireClaim(CloudClaims.Permission, CloudPermissions.PolicyRead)); + options.AddPolicy("policy:write", p => p.RequireClaim(CloudClaims.Permission, CloudPermissions.PolicyWrite)); + options.AddPolicy("users:manage", p => p.RequireClaim(CloudClaims.Permission, CloudPermissions.UsersManage)); + }); + + return services; + } +} + diff --git a/src/Hua.Todo.Application/CloudSync/Models/ApiErrorResponse.cs b/src/Hua.Todo.Application/CloudSync/Models/ApiErrorResponse.cs new file mode 100644 index 0000000..c294067 --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Models/ApiErrorResponse.cs @@ -0,0 +1,18 @@ +namespace Hua.Todo.Application.CloudSync.Models; + +/// +/// 云同步 API 统一错误响应结构。 +/// +public class ApiErrorResponse +{ + /// + /// 错误码（用于客户端识别与提示）。 + /// + public string Code { get; set; } = string.Empty; + + /// + /// 错误消息（用于调试或直接展示）。 + /// + public string Message { get; set; } = string.Empty; +} + diff --git a/src/Hua.Todo.Application/CloudSync/Models/AuthDtos.cs b/src/Hua.Todo.Application/CloudSync/Models/AuthDtos.cs new file mode 100644 index 0000000..182be80 --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Models/AuthDtos.cs @@ -0,0 +1,87 @@ +namespace Hua.Todo.Application.CloudSync.Models; + +/// +/// 登录请求。 +/// +public class LoginRequest +{ + /// + /// 用户名。 + /// + public string UserName { get; set; } = string.Empty; + + /// + /// 密码。 + /// + public string Password { get; set; } = string.Empty; +} + +/// +/// 登录响应。 +/// +public class LoginResponse +{ + /// + /// Bearer Token（会话 ID）。 + /// + public string AccessToken { get; set; } = string.Empty; + + /// + /// 会话过期时间（UTC）。 + /// + public DateTime ExpiresAtUtc { get; set; } + + /// + /// 用户 ID。 + /// + public Guid UserId { get; set; } + + /// + /// 用户角色。 + /// + public string Role { get; set; } = string.Empty; + + /// + /// 用户权限列表。 + /// + public List Permissions { get; set; } = new(); +} + +/// +/// 初始化管理员账号请求（仅在系统尚无云用户时可用）。 +/// +public class BootstrapAdminRequest +{ + /// + /// 用户名。 + /// + public string UserName { get; set; } = string.Empty; + + /// + /// 密码。 + /// + public string Password { get; set; } = string.Empty; +} + +/// +/// 二次认证（step-up）请求。 +/// +public class StepUpRequest +{ + /// + /// 二次口令（v1.2.0 最小实现：复用登录密码进行再认证）。 + /// + public string Password { get; set; } = string.Empty; +} + +/// +/// 二次认证（step-up）响应。 +/// +public class StepUpResponse +{ + /// + /// 二次认证有效期截止（UTC）。 + /// + public DateTime StepUpExpiresAtUtc { get; set; } +} + diff --git a/src/Hua.Todo.Application/CloudSync/Models/CloudApiErrors.cs b/src/Hua.Todo.Application/CloudSync/Models/CloudApiErrors.cs new file mode 100644 index 0000000..5a43dba --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Models/CloudApiErrors.cs @@ -0,0 +1,54 @@ +using Microsoft.AspNetCore.Http; + +namespace Hua.Todo.Application.CloudSync.Models; + +/// +/// 云同步 API 错误响应生成器。 +/// +public static class CloudApiErrors +{ + /// + /// 生成标准错误响应。 + /// + /// HTTP 状态码。 + /// 业务错误码。 + /// 错误消息。 + /// 最小 API 结果。 + public static IResult Error(int statusCode, string code, string message) + { + return Results.Json( + new ApiErrorResponse { Code = code, Message = message }, + statusCode: statusCode); + } + + /// + /// 未认证。 + /// + public static IResult Unauthorized(string message = "Unauthorized.") + => Error(StatusCodes.Status401Unauthorized, "UNAUTHORIZED", message); + + /// + /// 权限不足。 + /// + public static IResult Forbidden(string message = "Forbidden.") + => Error(StatusCodes.Status403Forbidden, "FORBIDDEN", message); + + /// + /// 需要二次认证（step-up）。 + /// + public static IResult SecondFactorRequired(string message = "Second factor required.") + => Error(StatusCodes.Status403Forbidden, "SECOND_FACTOR_REQUIRED", message); + + /// + /// 请求非法。 + /// + public static IResult BadRequest(string message = "Bad request.") + => Error(StatusCodes.Status400BadRequest, "BAD_REQUEST", message); + + /// + /// 资源不存在。 + /// + public static IResult NotFound(string message = "Not found.") + => Error(StatusCodes.Status404NotFound, "NOT_FOUND", message); +} + diff --git a/src/Hua.Todo.Application/CloudSync/Models/SecurityPolicyDtos.cs b/src/Hua.Todo.Application/CloudSync/Models/SecurityPolicyDtos.cs new file mode 100644 index 0000000..2e58e60 --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Models/SecurityPolicyDtos.cs @@ -0,0 +1,38 @@ +namespace Hua.Todo.Application.CloudSync.Models; + +/// +/// 安全策略下发 DTO。 +/// +public class SecurityPolicyDto +{ + /// + /// 是否允许落盘。 + /// + public bool AllowPersist { get; set; } + + /// + /// 是否允许同步写入。 + /// + public bool AllowSync { get; set; } + + /// + /// 需要二次认证的操作列表（操作码）。 + /// + public List RequireSecondFactorFor { get; set; } = new(); +} + +/// +/// 更新安全策略请求 DTO。 +/// +public class UpdateSecurityPolicyRequest +{ + /// + /// 是否允许落盘。 + /// + public bool AllowPersist { get; set; } + + /// + /// 是否允许同步写入。 + /// + public bool AllowSync { get; set; } +} diff --git a/src/Hua.Todo.Application/CloudSync/Models/TaskSyncDtos.cs b/src/Hua.Todo.Application/CloudSync/Models/TaskSyncDtos.cs new file mode 100644 index 0000000..373be01 --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Models/TaskSyncDtos.cs @@ -0,0 +1,108 @@ +using Hua.Todo.Core.Entities; + +namespace Hua.Todo.Application.CloudSync.Models; + +/// +/// 云同步任务条目。 +/// +public class CloudTaskItem +{ + /// + /// 任务 ID（服务端分配）。 + /// + public int Id { get; set; } + + /// + /// 标题。 + /// + public string Title { get; set; } = string.Empty; + + /// + /// 优先级。 + /// + public TaskPriority Priority { get; set; } + + /// + /// 是否完成。 + /// + public bool IsCompleted { get; set; } + + /// + /// 创建时间（UTC）。 + /// + public DateTime CreatedAtUtc { get; set; } + + /// + /// 更新时间（UTC）。 + /// + public DateTime UpdatedAtUtc { get; set; } + + /// + /// 父任务 ID（v1.2.0 同步可先不使用）。 + /// + public int? ParentTaskId { get; set; } +} + +/// +/// 同步请求（增改删）。 +/// +public class SyncRequest +{ + /// + /// 新增或更新的任务列表。 + /// + public List Upserts { get; set; } = new(); + + /// + /// 需要删除的任务 ID 列表。 + /// + public List Deletes { get; set; } = new(); +} + +/// +/// 任务 Upsert DTO。 +/// +public class CloudTaskUpsert +{ + /// + /// 任务 ID；为空表示新建。 + /// + public int? Id { get; set; } + + /// + /// 标题。 + /// + public string Title { get; set; } = string.Empty; + + /// + /// 优先级。 + /// + public TaskPriority Priority { get; set; } = TaskPriority.Medium; + + /// + /// 是否完成。 + /// + public bool IsCompleted { get; set; } + + /// + /// 父任务 ID（可选）。 + /// + public int? ParentTaskId { get; set; } +} + +/// +/// 同步响应。 +/// +public class SyncResponse +{ + /// + /// 服务端时间（UTC）。 + /// + public DateTime ServerTimeUtc { get; set; } + + /// + /// 当前用户的任务全量。 + /// + public List Tasks { get; set; } = new(); +} + diff --git a/src/Hua.Todo.Application/CloudSync/Services/CloudAuthService.cs b/src/Hua.Todo.Application/CloudSync/Services/CloudAuthService.cs new file mode 100644 index 0000000..ae15e93 --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Services/CloudAuthService.cs @@ -0,0 +1,188 @@ +using Microsoft.AspNetCore.Identity; +using Microsoft.EntityFrameworkCore; +using Hua.Todo.Application.CloudSync.Auth; +using Hua.Todo.Application.CloudSync.Models; +using Hua.Todo.Application.Data; +using Hua.Todo.Core.Entities; + +namespace Hua.Todo.Application.CloudSync.Services; + +/// +/// 云同步认证服务（登录、初始化管理员、二次认证）。 +/// +public class CloudAuthService +{ + private readonly TodoDbContext _dbContext; + private readonly IPasswordHasher _passwordHasher; + private readonly IRolePermissionMapper _rolePermissionMapper; + + /// + /// 创建 。 + /// + /// 数据库上下文。 + /// 密码哈希器。 + /// 角色权限映射器。 + public CloudAuthService( + TodoDbContext dbContext, + IPasswordHasher passwordHasher, + IRolePermissionMapper rolePermissionMapper) + { + _dbContext = dbContext; + _passwordHasher = passwordHasher; + _rolePermissionMapper = rolePermissionMapper; + } + + /// + /// 初始化系统管理员账号（仅在系统尚无云用户时可用）。 + /// + /// 用户名。 + /// 密码。 + /// 取消令牌。 + /// 是否初始化成功。 + public async Task BootstrapAdminAsync(string userName, string password, CancellationToken cancellationToken) + { + var normalizedUserName = (userName ?? string.Empty).Trim(); + if (string.IsNullOrWhiteSpace(normalizedUserName) || string.IsNullOrWhiteSpace(password)) + { + return false; + } + + var hasAnyCloudUser = await _dbContext.Users + .AsNoTracking() + .AnyAsync(u => u.Role != "local", cancellationToken); + + if (hasAnyCloudUser) + { + return false; + } + + var exists = await _dbContext.Users + .AsNoTracking() + .AnyAsync(u => u.UserName == normalizedUserName, cancellationToken); + + if (exists) + { + return false; + } + + var user = new UserEntity + { + Id = Guid.NewGuid(), + UserName = normalizedUserName, + Role = "admin" + }; + + user.PasswordHash = _passwordHasher.HashPassword(user, password); + + _dbContext.Users.Add(user); + _dbContext.SecurityPolicies.Add(new SecurityPolicyEntity { Id = Guid.NewGuid(), UserId = user.Id, AllowPersist = true }); + await _dbContext.SaveChangesAsync(cancellationToken); + + return true; + } + + /// + /// 用户名密码登录并创建会话。 + /// + /// 用户名。 + /// 密码。 + /// 会话有效期。 + /// 取消令牌。 + /// 登录响应；失败则返回 null。 + public async Task LoginAsync(string userName, string password, TimeSpan sessionTtl, CancellationToken cancellationToken) + { + var normalizedUserName = (userName ?? string.Empty).Trim(); + if (string.IsNullOrWhiteSpace(normalizedUserName) || string.IsNullOrWhiteSpace(password)) + { + return null; + } + + var user = await _dbContext.Users.FirstOrDefaultAsync(u => u.UserName == normalizedUserName, cancellationToken); + if (user == null || user.Role == "local") + { + return null; + } + + var verify = _passwordHasher.VerifyHashedPassword(user, user.PasswordHash, password); + if (verify == PasswordVerificationResult.Failed) + { + return null; + } + + var now = DateTime.UtcNow; + var expiresAt = now.Add(sessionTtl); + + var session = new UserSessionEntity + { + Id = Guid.NewGuid(), + UserId = user.Id, + CreatedAtUtc = now, + ExpiresAtUtc = expiresAt + }; + + _dbContext.UserSessions.Add(session); + + var hasPolicy = await _dbContext.SecurityPolicies + .AsNoTracking() + .AnyAsync(p => p.UserId == user.Id, cancellationToken); + + if (!hasPolicy) + { + _dbContext.SecurityPolicies.Add(new SecurityPolicyEntity { Id = Guid.NewGuid(), UserId = user.Id, AllowPersist = true }); + } + + await _dbContext.SaveChangesAsync(cancellationToken); + + return new LoginResponse + { + AccessToken = session.Id.ToString(), + ExpiresAtUtc = expiresAt, + UserId = user.Id, + Role = user.Role, + Permissions = _rolePermissionMapper.GetPermissions(user.Role).ToList() + }; + } + + /// + /// 通过再输入口令提升会话权限（step-up）。 + /// + /// 会话 ID。 + /// 口令。 + /// 二次认证有效期。 + /// 取消令牌。 + /// 有效期截止时间；失败返回 null。 + public async Task StepUpAsync(Guid sessionId, string password, TimeSpan stepUpTtl, CancellationToken cancellationToken) + { + if (string.IsNullOrWhiteSpace(password)) + { + return null; + } + + var now = DateTime.UtcNow; + + var session = await _dbContext.UserSessions.FirstOrDefaultAsync(s => s.Id == sessionId, cancellationToken); + if (session == null || session.ExpiresAtUtc <= now) + { + return null; + } + + var user = await _dbContext.Users.FirstOrDefaultAsync(u => u.Id == session.UserId, cancellationToken); + if (user == null) + { + return null; + } + + var verify = _passwordHasher.VerifyHashedPassword(user, user.PasswordHash, password); + if (verify == PasswordVerificationResult.Failed) + { + return null; + } + + var stepUpExpiresAt = now.Add(stepUpTtl); + session.StepUpExpiresAtUtc = stepUpExpiresAt; + await _dbContext.SaveChangesAsync(cancellationToken); + + return stepUpExpiresAt; + } +} + diff --git a/src/Hua.Todo.Application/CloudSync/Services/CloudTaskSyncService.cs b/src/Hua.Todo.Application/CloudSync/Services/CloudTaskSyncService.cs new file mode 100644 index 0000000..9a0bf29 --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Services/CloudTaskSyncService.cs @@ -0,0 +1,128 @@ +using Microsoft.EntityFrameworkCore; +using Hua.Todo.Application.CloudSync.Models; +using Hua.Todo.Application.Data; +using Hua.Todo.Core.Entities; + +namespace Hua.Todo.Application.CloudSync.Services; + +/// +/// 云同步任务服务（按用户隔离）。 +/// +public class CloudTaskSyncService +{ + private readonly TodoDbContext _dbContext; + + /// + /// 创建 。 + /// + /// 数据库上下文。 + public CloudTaskSyncService(TodoDbContext dbContext) + { + _dbContext = dbContext; + } + + /// + /// 获取指定用户的任务全量。 + /// + /// 用户 ID。 + /// 取消令牌。 + /// 任务列表。 + public async Task> GetTasksAsync(Guid userId, CancellationToken cancellationToken) + { + var tasks = await _dbContext.Tasks + .AsNoTracking() + .Where(t => t.UserId == userId) + .OrderByDescending(t => t.CreatedAt) + .ToListAsync(cancellationToken); + + return tasks.Select(MapToItem).ToList(); + } + + /// + /// 执行同步（增改删），并返回最新全量。 + /// + /// 用户 ID。 + /// 同步请求。 + /// 取消令牌。 + /// 同步响应。 + public async Task SyncAsync(Guid userId, SyncRequest request, CancellationToken cancellationToken) + { + request ??= new SyncRequest(); + + if (request.Deletes.Count > 0) + { + var deleteIds = request.Deletes.Distinct().ToList(); + var toDelete = await _dbContext.Tasks + .Where(t => t.UserId == userId && deleteIds.Contains(t.Id)) + .ToListAsync(cancellationToken); + + if (toDelete.Count > 0) + { + _dbContext.Tasks.RemoveRange(toDelete); + } + } + + if (request.Upserts.Count > 0) + { + foreach (var upsert in request.Upserts) + { + if (string.IsNullOrWhiteSpace(upsert.Title)) + { + continue; + } + + if (upsert.Id.HasValue) + { + var existing = await _dbContext.Tasks + .FirstOrDefaultAsync(t => t.UserId == userId && t.Id == upsert.Id.Value, cancellationToken); + + if (existing != null) + { + existing.Title = upsert.Title.Trim(); + existing.Priority = upsert.Priority; + existing.IsCompleted = upsert.IsCompleted; + existing.ParentTaskId = upsert.ParentTaskId; + existing.UpdatedAt = DateTime.UtcNow; + continue; + } + } + + var entity = new TaskEntity + { + UserId = userId, + Title = upsert.Title.Trim(), + Priority = upsert.Priority, + IsCompleted = upsert.IsCompleted, + CreatedAt = DateTime.UtcNow, + UpdatedAt = DateTime.UtcNow, + ParentTaskId = upsert.ParentTaskId + }; + + _dbContext.Tasks.Add(entity); + } + } + + await _dbContext.SaveChangesAsync(cancellationToken); + + return new SyncResponse + { + ServerTimeUtc = DateTime.UtcNow, + Tasks = await GetTasksAsync(userId, cancellationToken) + }; + } + + private static CloudTaskItem MapToItem(TaskEntity task) + { + return new CloudTaskItem + { + Id = task.Id, + Title = task.Title, + Priority = task.Priority, + IsCompleted = task.IsCompleted, + CreatedAtUtc = task.CreatedAt, + UpdatedAtUtc = task.UpdatedAt, + ParentTaskId = task.ParentTaskId + }; + } +} + diff --git a/src/Hua.Todo.Application/CloudSync/Services/SecurityPolicyService.cs b/src/Hua.Todo.Application/CloudSync/Services/SecurityPolicyService.cs new file mode 100644 index 0000000..10d0ae1 --- /dev/null +++ b/src/Hua.Todo.Application/CloudSync/Services/SecurityPolicyService.cs @@ -0,0 +1,69 @@ +using Microsoft.EntityFrameworkCore; +using Hua.Todo.Application.CloudSync.Models; +using Hua.Todo.Application.Data; +using Hua.Todo.Core.Entities; + +namespace Hua.Todo.Application.CloudSync.Services; + +/// +/// 安全策略服务（按用户隔离）。 +/// +public class SecurityPolicyService +{ + private readonly TodoDbContext _dbContext; + + /// + /// 创建 。 + /// + /// 数据库上下文。 + public SecurityPolicyService(TodoDbContext dbContext) + { + _dbContext = dbContext; + } + + /// + /// 获取指定用户的安全策略。 + /// + /// 用户 ID。 + /// 取消令牌。 + /// 策略 DTO。 + public async Task GetPolicyAsync(Guid userId, CancellationToken cancellationToken) + { + var policy = await _dbContext.SecurityPolicies + .AsNoTracking() + .FirstOrDefaultAsync(p => p.UserId == userId, cancellationToken); + + return new SecurityPolicyDto + { + AllowPersist = policy?.AllowPersist ?? true, + AllowSync = policy?.AllowSync ?? true, + RequireSecondFactorFor = new List { "sync:write", "policy:write" } + }; + } + + /// + /// 更新指定用户的安全策略（覆盖式更新）。 + /// + /// 用户 ID。 + /// 是否允许落盘。 + /// 取消令牌。 + /// 更新后的策略 DTO。 + public async Task UpdatePolicyAsync(Guid userId, bool allowPersist, bool allowSync, CancellationToken cancellationToken) + { + var policy = await _dbContext.SecurityPolicies.FirstOrDefaultAsync(p => p.UserId == userId, cancellationToken); + if (policy == null) + { + policy = new SecurityPolicyEntity { Id = Guid.NewGuid(), UserId = userId, AllowPersist = allowPersist, AllowSync = allowSync }; + _dbContext.SecurityPolicies.Add(policy); + } + else + { + policy.AllowPersist = allowPersist; + policy.AllowSync = allowSync; + } + + await _dbContext.SaveChangesAsync(cancellationToken); + + return await GetPolicyAsync(userId, cancellationToken); + } +} diff --git a/src/Hua.Todo.Application/Data/TodoDbContext.cs b/src/Hua.Todo.Application/Data/TodoDbContext.cs index bb6f879..54a6c78 100644 --- a/src/Hua.Todo.Application/Data/TodoDbContext.cs +++ b/src/Hua.Todo.Application/Data/TodoDbContext.cs @@ -21,6 +21,21 @@ public class TodoDbContext : DbContext /// public DbSet Tasks { get; set; } + /// + /// 用户集合。 + /// + public DbSet Users { get; set; } + + /// + /// 用户会话集合。 + /// + public DbSet UserSessions { get; set; } + + /// + /// 安全策略集合。 + /// + public DbSet SecurityPolicies { get; set; } + /// /// 配置实体模型映射。 /// @@ -33,16 +48,58 @@ public class TodoDbContext : DbContext { entity.ToTable("Tasks"); entity.HasKey(e => e.Id); + entity.Property(e => e.UserId).IsRequired().HasDefaultValue(TodoUserIds.LocalUserId); entity.Property(e => e.Title).IsRequired().HasMaxLength(200); entity.Property(e => e.Priority).HasDefaultValue(TaskPriority.Medium); entity.Property(e => e.IsCompleted).HasDefaultValue(false); entity.Property(e => e.CreatedAt).HasDefaultValueSql("datetime('now')"); entity.Property(e => e.UpdatedAt).HasDefaultValueSql("datetime('now')"); + entity.HasOne(e => e.User) + .WithMany(u => u.Tasks) + .HasForeignKey(e => e.UserId) + .OnDelete(DeleteBehavior.Cascade); + entity.HasOne(e => e.ParentTask) .WithMany(e => e.SubTasks) .HasForeignKey(e => e.ParentTaskId) .OnDelete(DeleteBehavior.Restrict); }); + + modelBuilder.Entity(entity => + { + entity.ToTable("Users"); + entity.HasKey(e => e.Id); + entity.Property(e => e.UserName).IsRequired().HasMaxLength(64); + entity.HasIndex(e => e.UserName).IsUnique(); + entity.Property(e => e.PasswordHash).IsRequired(); + entity.Property(e => e.Role).IsRequired().HasMaxLength(32); + }); + + modelBuilder.Entity(entity => + { + entity.ToTable("UserSessions"); + entity.HasKey(e => e.Id); + entity.Property(e => e.CreatedAtUtc).IsRequired(); + entity.Property(e => e.ExpiresAtUtc).IsRequired(); + entity.HasIndex(e => e.UserId); + entity.HasOne(e => e.User) + .WithMany() + .HasForeignKey(e => e.UserId) + .OnDelete(DeleteBehavior.Cascade); + }); + + modelBuilder.Entity(entity => + { + entity.ToTable("SecurityPolicies"); + entity.HasKey(e => e.Id); + entity.Property(e => e.AllowPersist).HasDefaultValue(true); + entity.Property(e => e.AllowSync).HasDefaultValue(true); + entity.HasIndex(e => e.UserId).IsUnique(); + entity.HasOne(e => e.User) + .WithMany() + .HasForeignKey(e => e.UserId) + .OnDelete(DeleteBehavior.Cascade); + }); } } diff --git a/src/Hua.Todo.Application/Hua.Todo.Application.csproj b/src/Hua.Todo.Application/Hua.Todo.Application.csproj index ff4eedd..075eb79 100644 --- a/src/Hua.Todo.Application/Hua.Todo.Application.csproj +++ b/src/Hua.Todo.Application/Hua.Todo.Application.csproj @@ -13,6 +13,7 @@ + diff --git a/src/Hua.Todo.Application/Migrations/20260406172936_AddCloudSyncCoreEntities.Designer.cs b/src/Hua.Todo.Application/Migrations/20260406172936_AddCloudSyncCoreEntities.Designer.cs new file mode 100644 index 0000000..a368608 --- /dev/null +++ b/src/Hua.Todo.Application/Migrations/20260406172936_AddCloudSyncCoreEntities.Designer.cs @@ -0,0 +1,198 @@ +// +using System; +using Hua.Todo.Application.Data; +using Microsoft.EntityFrameworkCore; +using Microsoft.EntityFrameworkCore.Infrastructure; +using Microsoft.EntityFrameworkCore.Migrations; +using Microsoft.EntityFrameworkCore.Storage.ValueConversion; + +#nullable disable + +namespace Hua.Todo.Application.Migrations +{ + [DbContext(typeof(TodoDbContext))] + [Migration("20260406172936_AddCloudSyncCoreEntities")] + partial class AddCloudSyncCoreEntities + { + /// + protected override void BuildTargetModel(ModelBuilder modelBuilder) + { +#pragma warning disable 612, 618 + modelBuilder.HasAnnotation("ProductVersion", "10.0.5"); + + modelBuilder.Entity("Hua.Todo.Core.Entities.SecurityPolicyEntity", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT"); + + b.Property("AllowPersist") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER") + .HasDefaultValue(true); + + b.Property("UserId") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("UserId") + .IsUnique(); + + b.ToTable("SecurityPolicies", (string)null); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.TaskEntity", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CreatedAt") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT") + .HasDefaultValueSql("datetime('now')"); + + b.Property("IsCompleted") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER") + .HasDefaultValue(false); + + b.Property("ParentTaskId") + .HasColumnType("INTEGER"); + + b.Property("Priority") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER") + .HasDefaultValue(1); + + b.Property("Title") + .IsRequired() + .HasMaxLength(200) + .HasColumnType("TEXT"); + + b.Property("UpdatedAt") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT") + .HasDefaultValueSql("datetime('now')"); + + b.Property("UserId") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT") + .HasDefaultValue(new Guid("00000000-0000-0000-0000-000000000001")); + + b.HasKey("Id"); + + b.HasIndex("ParentTaskId"); + + b.HasIndex("UserId"); + + b.ToTable("Tasks", (string)null); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserEntity", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT"); + + b.Property("PasswordHash") + .IsRequired() + .HasColumnType("TEXT"); + + b.Property("Role") + .IsRequired() + .HasMaxLength(32) + .HasColumnType("TEXT"); + + b.Property("UserName") + .IsRequired() + .HasMaxLength(64) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("UserName") + .IsUnique(); + + b.ToTable("Users", (string)null); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserSessionEntity", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT"); + + b.Property("CreatedAtUtc") + .HasColumnType("TEXT"); + + b.Property("ExpiresAtUtc") + .HasColumnType("TEXT"); + + b.Property("StepUpExpiresAtUtc") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("UserId"); + + b.ToTable("UserSessions", (string)null); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.SecurityPolicyEntity", b => + { + b.HasOne("Hua.Todo.Core.Entities.UserEntity", "User") + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("User"); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.TaskEntity", b => + { + b.HasOne("Hua.Todo.Core.Entities.TaskEntity", "ParentTask") + .WithMany("SubTasks") + .HasForeignKey("ParentTaskId") + .OnDelete(DeleteBehavior.Restrict); + + b.HasOne("Hua.Todo.Core.Entities.UserEntity", "User") + .WithMany("Tasks") + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("ParentTask"); + + b.Navigation("User"); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserSessionEntity", b => + { + b.HasOne("Hua.Todo.Core.Entities.UserEntity", "User") + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("User"); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.TaskEntity", b => + { + b.Navigation("SubTasks"); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserEntity", b => + { + b.Navigation("Tasks"); + }); +#pragma warning restore 612, 618 + } + } +} diff --git a/src/Hua.Todo.Application/Migrations/20260406172936_AddCloudSyncCoreEntities.cs b/src/Hua.Todo.Application/Migrations/20260406172936_AddCloudSyncCoreEntities.cs new file mode 100644 index 0000000..1c20020 --- /dev/null +++ b/src/Hua.Todo.Application/Migrations/20260406172936_AddCloudSyncCoreEntities.cs @@ -0,0 +1,136 @@ +using System; +using Microsoft.EntityFrameworkCore.Migrations; + +#nullable disable + +namespace Hua.Todo.Application.Migrations +{ + /// + public partial class AddCloudSyncCoreEntities : Migration + { + /// + protected override void Up(MigrationBuilder migrationBuilder) + { + migrationBuilder.AddColumn( + name: "UserId", + table: "Tasks", + type: "TEXT", + nullable: false, + defaultValue: new Guid("00000000-0000-0000-0000-000000000001")); + + migrationBuilder.CreateTable( + name: "Users", + columns: table => new + { + Id = table.Column(type: "TEXT", nullable: false), + UserName = table.Column(type: "TEXT", maxLength: 64, nullable: false), + PasswordHash = table.Column(type: "TEXT", nullable: false), + Role = table.Column(type: "TEXT", maxLength: 32, nullable: false) + }, + constraints: table => + { + table.PrimaryKey("PK_Users", x => x.Id); + }); + + migrationBuilder.InsertData( + table: "Users", + columns: new[] { "Id", "UserName", "PasswordHash", "Role" }, + values: new object[] { new Guid("00000000-0000-0000-0000-000000000001"), "local", "", "local" }); + + migrationBuilder.CreateTable( + name: "SecurityPolicies", + columns: table => new + { + Id = table.Column(type: "TEXT", nullable: false), + UserId = table.Column(type: "TEXT", nullable: false), + AllowPersist = table.Column(type: "INTEGER", nullable: false, defaultValue: true) + }, + constraints: table => + { + table.PrimaryKey("PK_SecurityPolicies", x => x.Id); + table.ForeignKey( + name: "FK_SecurityPolicies_Users_UserId", + column: x => x.UserId, + principalTable: "Users", + principalColumn: "Id", + onDelete: ReferentialAction.Cascade); + }); + + migrationBuilder.CreateTable( + name: "UserSessions", + columns: table => new + { + Id = table.Column(type: "TEXT", nullable: false), + UserId = table.Column(type: "TEXT", nullable: false), + CreatedAtUtc = table.Column(type: "TEXT", nullable: false), + ExpiresAtUtc = table.Column(type: "TEXT", nullable: false), + StepUpExpiresAtUtc = table.Column(type: "TEXT", nullable: true) + }, + constraints: table => + { + table.PrimaryKey("PK_UserSessions", x => x.Id); + table.ForeignKey( + name: "FK_UserSessions_Users_UserId", + column: x => x.UserId, + principalTable: "Users", + principalColumn: "Id", + onDelete: ReferentialAction.Cascade); + }); + + migrationBuilder.CreateIndex( + name: "IX_Tasks_UserId", + table: "Tasks", + column: "UserId"); + + migrationBuilder.CreateIndex( + name: "IX_SecurityPolicies_UserId", + table: "SecurityPolicies", + column: "UserId", + unique: true); + + migrationBuilder.CreateIndex( + name: "IX_Users_UserName", + table: "Users", + column: "UserName", + unique: true); + + migrationBuilder.CreateIndex( + name: "IX_UserSessions_UserId", + table: "UserSessions", + column: "UserId"); + + migrationBuilder.AddForeignKey( + name: "FK_Tasks_Users_UserId", + table: "Tasks", + column: "UserId", + principalTable: "Users", + principalColumn: "Id", + onDelete: ReferentialAction.Cascade); + } + + /// + protected override void Down(MigrationBuilder migrationBuilder) + { + migrationBuilder.DropForeignKey( + name: "FK_Tasks_Users_UserId", + table: "Tasks"); + + migrationBuilder.DropTable( + name: "SecurityPolicies"); + + migrationBuilder.DropTable( + name: "UserSessions"); + + migrationBuilder.DropTable( + name: "Users"); + + migrationBuilder.DropIndex( + name: "IX_Tasks_UserId", + table: "Tasks"); + + migrationBuilder.DropColumn( + name: "UserId", + table: "Tasks"); + } + } +} diff --git a/src/Hua.Todo.Application/Migrations/20260406173734_AddAllowSyncToSecurityPolicy.Designer.cs b/src/Hua.Todo.Application/Migrations/20260406173734_AddAllowSyncToSecurityPolicy.Designer.cs new file mode 100644 index 0000000..a9c95e7 --- /dev/null +++ b/src/Hua.Todo.Application/Migrations/20260406173734_AddAllowSyncToSecurityPolicy.Designer.cs @@ -0,0 +1,203 @@ +// +using System; +using Hua.Todo.Application.Data; +using Microsoft.EntityFrameworkCore; +using Microsoft.EntityFrameworkCore.Infrastructure; +using Microsoft.EntityFrameworkCore.Migrations; +using Microsoft.EntityFrameworkCore.Storage.ValueConversion; + +#nullable disable + +namespace Hua.Todo.Application.Migrations +{ + [DbContext(typeof(TodoDbContext))] + [Migration("20260406173734_AddAllowSyncToSecurityPolicy")] + partial class AddAllowSyncToSecurityPolicy + { + /// + protected override void BuildTargetModel(ModelBuilder modelBuilder) + { +#pragma warning disable 612, 618 + modelBuilder.HasAnnotation("ProductVersion", "10.0.5"); + + modelBuilder.Entity("Hua.Todo.Core.Entities.SecurityPolicyEntity", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT"); + + b.Property("AllowPersist") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER") + .HasDefaultValue(true); + + b.Property("AllowSync") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER") + .HasDefaultValue(true); + + b.Property("UserId") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("UserId") + .IsUnique(); + + b.ToTable("SecurityPolicies", (string)null); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.TaskEntity", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CreatedAt") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT") + .HasDefaultValueSql("datetime('now')"); + + b.Property("IsCompleted") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER") + .HasDefaultValue(false); + + b.Property("ParentTaskId") + .HasColumnType("INTEGER"); + + b.Property("Priority") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER") + .HasDefaultValue(1); + + b.Property("Title") + .IsRequired() + .HasMaxLength(200) + .HasColumnType("TEXT"); + + b.Property("UpdatedAt") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT") + .HasDefaultValueSql("datetime('now')"); + + b.Property("UserId") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT") + .HasDefaultValue(new Guid("00000000-0000-0000-0000-000000000001")); + + b.HasKey("Id"); + + b.HasIndex("ParentTaskId"); + + b.HasIndex("UserId"); + + b.ToTable("Tasks", (string)null); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserEntity", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT"); + + b.Property("PasswordHash") + .IsRequired() + .HasColumnType("TEXT"); + + b.Property("Role") + .IsRequired() + .HasMaxLength(32) + .HasColumnType("TEXT"); + + b.Property("UserName") + .IsRequired() + .HasMaxLength(64) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("UserName") + .IsUnique(); + + b.ToTable("Users", (string)null); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserSessionEntity", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT"); + + b.Property("CreatedAtUtc") + .HasColumnType("TEXT"); + + b.Property("ExpiresAtUtc") + .HasColumnType("TEXT"); + + b.Property("StepUpExpiresAtUtc") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("UserId"); + + b.ToTable("UserSessions", (string)null); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.SecurityPolicyEntity", b => + { + b.HasOne("Hua.Todo.Core.Entities.UserEntity", "User") + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("User"); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.TaskEntity", b => + { + b.HasOne("Hua.Todo.Core.Entities.TaskEntity", "ParentTask") + .WithMany("SubTasks") + .HasForeignKey("ParentTaskId") + .OnDelete(DeleteBehavior.Restrict); + + b.HasOne("Hua.Todo.Core.Entities.UserEntity", "User") + .WithMany("Tasks") + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("ParentTask"); + + b.Navigation("User"); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserSessionEntity", b => + { + b.HasOne("Hua.Todo.Core.Entities.UserEntity", "User") + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("User"); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.TaskEntity", b => + { + b.Navigation("SubTasks"); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserEntity", b => + { + b.Navigation("Tasks"); + }); +#pragma warning restore 612, 618 + } + } +} diff --git a/src/Hua.Todo.Application/Migrations/20260406173734_AddAllowSyncToSecurityPolicy.cs b/src/Hua.Todo.Application/Migrations/20260406173734_AddAllowSyncToSecurityPolicy.cs new file mode 100644 index 0000000..f82db2c --- /dev/null +++ b/src/Hua.Todo.Application/Migrations/20260406173734_AddAllowSyncToSecurityPolicy.cs @@ -0,0 +1,29 @@ +using Microsoft.EntityFrameworkCore.Migrations; + +#nullable disable + +namespace Hua.Todo.Application.Migrations +{ + /// + public partial class AddAllowSyncToSecurityPolicy : Migration + { + /// + protected override void Up(MigrationBuilder migrationBuilder) + { + migrationBuilder.AddColumn( + name: "AllowSync", + table: "SecurityPolicies", + type: "INTEGER", + nullable: false, + defaultValue: true); + } + + /// + protected override void Down(MigrationBuilder migrationBuilder) + { + migrationBuilder.DropColumn( + name: "AllowSync", + table: "SecurityPolicies"); + } + } +} diff --git a/src/Hua.Todo.Application/Migrations/TodoDbContextModelSnapshot.cs b/src/Hua.Todo.Application/Migrations/TodoDbContextModelSnapshot.cs index 4e6620e..8a59e23 100644 --- a/src/Hua.Todo.Application/Migrations/TodoDbContextModelSnapshot.cs +++ b/src/Hua.Todo.Application/Migrations/TodoDbContextModelSnapshot.cs @@ -1,9 +1,9 @@ -// +// using System; +using Hua.Todo.Application.Data; using Microsoft.EntityFrameworkCore; using Microsoft.EntityFrameworkCore.Infrastructure; using Microsoft.EntityFrameworkCore.Storage.ValueConversion; -using Hua.Todo.Application.Data; #nullable disable @@ -17,6 +17,33 @@ namespace Hua.Todo.Application.Migrations #pragma warning disable 612, 618 modelBuilder.HasAnnotation("ProductVersion", "10.0.5"); + modelBuilder.Entity("Hua.Todo.Core.Entities.SecurityPolicyEntity", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT"); + + b.Property("AllowPersist") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER") + .HasDefaultValue(true); + + b.Property("AllowSync") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER") + .HasDefaultValue(true); + + b.Property("UserId") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("UserId") + .IsUnique(); + + b.ToTable("SecurityPolicies", (string)null); + }); + modelBuilder.Entity("Hua.Todo.Core.Entities.TaskEntity", b => { b.Property("Id") @@ -51,11 +78,82 @@ namespace Hua.Todo.Application.Migrations .HasColumnType("TEXT") .HasDefaultValueSql("datetime('now')"); + b.Property("UserId") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT") + .HasDefaultValue(new Guid("00000000-0000-0000-0000-000000000001")); + b.HasKey("Id"); b.HasIndex("ParentTaskId"); - b.ToTable("Tasks"); + b.HasIndex("UserId"); + + b.ToTable("Tasks", (string)null); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserEntity", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT"); + + b.Property("PasswordHash") + .IsRequired() + .HasColumnType("TEXT"); + + b.Property("Role") + .IsRequired() + .HasMaxLength(32) + .HasColumnType("TEXT"); + + b.Property("UserName") + .IsRequired() + .HasMaxLength(64) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("UserName") + .IsUnique(); + + b.ToTable("Users", (string)null); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserSessionEntity", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("TEXT"); + + b.Property("CreatedAtUtc") + .HasColumnType("TEXT"); + + b.Property("ExpiresAtUtc") + .HasColumnType("TEXT"); + + b.Property("StepUpExpiresAtUtc") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("UserId"); + + b.ToTable("UserSessions", (string)null); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.SecurityPolicyEntity", b => + { + b.HasOne("Hua.Todo.Core.Entities.UserEntity", "User") + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("User"); }); modelBuilder.Entity("Hua.Todo.Core.Entities.TaskEntity", b => @@ -65,13 +163,37 @@ namespace Hua.Todo.Application.Migrations .HasForeignKey("ParentTaskId") .OnDelete(DeleteBehavior.Restrict); + b.HasOne("Hua.Todo.Core.Entities.UserEntity", "User") + .WithMany("Tasks") + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + b.Navigation("ParentTask"); + + b.Navigation("User"); + }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserSessionEntity", b => + { + b.HasOne("Hua.Todo.Core.Entities.UserEntity", "User") + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("User"); }); modelBuilder.Entity("Hua.Todo.Core.Entities.TaskEntity", b => { b.Navigation("SubTasks"); }); + + modelBuilder.Entity("Hua.Todo.Core.Entities.UserEntity", b => + { + b.Navigation("Tasks"); + }); #pragma warning restore 612, 618 } } diff --git a/src/Hua.Todo.Application/Repositories/TaskRepository.cs b/src/Hua.Todo.Application/Repositories/TaskRepository.cs index b352d99..566d540 100644 --- a/src/Hua.Todo.Application/Repositories/TaskRepository.cs +++ b/src/Hua.Todo.Application/Repositories/TaskRepository.cs @@ -28,6 +28,7 @@ public class TaskRepository : ITaskRepository public async Task> GetAllAsync() { return await _context.Tasks + .Where(t => t.UserId == TodoUserIds.LocalUserId) .Include(t => t.SubTasks) .ToListAsync(); } @@ -41,7 +42,7 @@ public class TaskRepository : ITaskRepository { return await _context.Tasks .Include(t => t.SubTasks) - .FirstOrDefaultAsync(t => t.Id == id); + .FirstOrDefaultAsync(t => t.Id == id && t.UserId == TodoUserIds.LocalUserId); } /// @@ -51,7 +52,7 @@ public class TaskRepository : ITaskRepository public async Task> GetActiveTasksAsync() { return await _context.Tasks - .Where(t => !t.IsCompleted) + .Where(t => t.UserId == TodoUserIds.LocalUserId && !t.IsCompleted) .OrderByDescending(t => t.CreatedAt) .ToListAsync(); } @@ -63,7 +64,7 @@ public class TaskRepository : ITaskRepository public async Task> GetCompletedTasksAsync() { return await _context.Tasks - .Where(t => t.IsCompleted) + .Where(t => t.UserId == TodoUserIds.LocalUserId && t.IsCompleted) .OrderByDescending(t => t.UpdatedAt) .ToListAsync(); } @@ -75,6 +76,7 @@ public class TaskRepository : ITaskRepository /// 已持久化的任务实体（包含生成的 ID）。 public async Task AddAsync(TaskEntity taskEntity) { + taskEntity.UserId = TodoUserIds.LocalUserId; _context.Tasks.Add(taskEntity); await _context.SaveChangesAsync(); return taskEntity; @@ -100,7 +102,7 @@ public class TaskRepository : ITaskRepository /// 表示删除操作的任务。 public async Task DeleteAsync(int id) { - var task = await _context.Tasks.FindAsync(id); + var task = await _context.Tasks.FirstOrDefaultAsync(t => t.Id == id && t.UserId == TodoUserIds.LocalUserId); if (task != null) { _context.Tasks.Remove(task); @@ -116,7 +118,7 @@ public class TaskRepository : ITaskRepository public async Task> GetSubTasksAsync(int parentTaskId) { return await _context.Tasks - .Where(t => t.ParentTaskId == parentTaskId) + .Where(t => t.UserId == TodoUserIds.LocalUserId && t.ParentTaskId == parentTaskId) .OrderByDescending(t => t.CreatedAt) .ToListAsync(); } diff --git a/src/Hua.Todo.Avalonia/App.axaml b/src/Hua.Todo.Avalonia/App.axaml new file mode 100644 index 0000000..09bcd01 --- /dev/null +++ b/src/Hua.Todo.Avalonia/App.axaml @@ -0,0 +1,33 @@ + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/Hua.Todo.Avalonia/App.axaml.cs b/src/Hua.Todo.Avalonia/App.axaml.cs new file mode 100644 index 0000000..f0e3603 --- /dev/null +++ b/src/Hua.Todo.Avalonia/App.axaml.cs @@ -0,0 +1,270 @@ +using Avalonia; +using Avalonia.Controls; +using Avalonia.Controls.ApplicationLifetimes; +using Avalonia.Data.Core.Plugins; +using Avalonia.Markup.Xaml; +using Avalonia.Threading; +using AvaloniaWebView; +using Hua.Todo.Avalonia.Models; +using Hua.Todo.Avalonia.Services; +using Hua.Todo.Avalonia.Services.Platforms; +using Hua.Todo.Avalonia.ViewModels; +using Hua.Todo.Avalonia.Views; +using System; +using System.ComponentModel; +using System.IO; +using System.Linq; +using System.Text.Json; +using System.Threading.Tasks; + +namespace Hua.Todo.Avalonia; + +/// +/// Avalonia 应用入口。 +/// 负责启动嵌入式 WebServer、创建主窗口并初始化 WebView 能力。 +/// +public partial class App : global::Avalonia.Application +{ + private AppSettings? _appSettings; + private IEmbeddedWebServerService? _webServer; + private IHotKeySettingsService? _hotKeySettingsService; + private IGlobalHotKeyService? _hotKeyService; + private HotKeyConfig? _hotKeyConfig; + private WindowsKeyboardHandler? _keyboardHandler; + private MainWindow? _mainWindow; + private bool _isExitRequested; + private bool _isHotkeyRegistered; + + /// + /// 初始化应用资源并加载配置。 + /// + public override void Initialize() + { + AvaloniaXamlLoader.Load(this); + LoadSettings(); + } + + /// + /// 注册应用级服务。 + /// + public override void RegisterServices() + { + base.RegisterServices(); + AvaloniaWebViewBuilder.Initialize(default); + } + + private void LoadSettings() + { + try + { + var settingsPath = Path.Combine(AppContext.BaseDirectory, "appsettings.json"); + if (File.Exists(settingsPath)) + { + var json = File.ReadAllText(settingsPath); + _appSettings = JsonSerializer.Deserialize(json); + } + } + catch (Exception ex) + { + Console.WriteLine($"[App] Failed to load settings: {ex.Message}"); + } + + _appSettings ??= new AppSettings(); + + EnsureDefaultConnectionString(_appSettings); + } + + private static void EnsureDefaultConnectionString(AppSettings appSettings) + { + if (string.IsNullOrWhiteSpace(appSettings.WebServer.ConnectionString)) + { + var localAppData = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData); + var dbDir = Path.Combine(localAppData, "Hua.Todo"); + if (!Directory.Exists(dbDir)) + { + Directory.CreateDirectory(dbDir); + } + + var dbPath = Path.Combine(dbDir, "Hua.Todo.db"); + appSettings.WebServer.ConnectionString = $"Data Source={dbPath};Cache=Shared"; + } + } + + /// + /// Avalonia 框架初始化完成回调。 + /// 启动嵌入式 WebServer（后台启动并捕获异常，避免阻塞/崩溃），并创建主窗口。 + /// + public override void OnFrameworkInitializationCompleted() + { + if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop) + { + DisableAvaloniaDataAnnotationValidation(); + + _webServer = new EmbeddedWebServerService(_appSettings!); + _ = Task.Run(async () => + { + try + { + await _webServer.StartAsync(); + } + catch (Exception ex) + { + Console.WriteLine($"[App] Web server start failed: {ex}"); + } + }); + + _hotKeySettingsService = new HotKeySettingsService(_appSettings!); + _hotKeyConfig = _hotKeySettingsService.GetConfig(); + _hotKeyService = GlobalHotKeyServiceFactory.Create(); + + if (OperatingSystem.IsWindows()) + { + _keyboardHandler = new WindowsKeyboardHandler(); + _keyboardHandler.EscKeyPressed += (_, _) => + { + Dispatcher.UIThread.Post(() => + { + if (_mainWindow is { IsVisible: true }) + { + _mainWindow.WindowState = WindowState.Minimized; + } + }); + }; + } + + DataContext = new AppTrayViewModel( + AppMetadata.GetTrayTooltipText(), + ShowMainWindow, + () => ExitApplication(desktop)); + + _mainWindow = new MainWindow(_appSettings!, _webServer) + { + Width = 450, + Height = 640, + Title = AppMetadata.GetWindowTitle(), + }; + + _mainWindow.Opened += (_, _) => + { + RegisterHotkey(); + _keyboardHandler?.Start(); + }; + + _mainWindow.Closing += (_, e) => + { + if (_isExitRequested) + { + return; + } + + e.Cancel = true; + _mainWindow.Hide(); + }; + + desktop.MainWindow = _mainWindow; + + desktop.Exit += async (s, e) => + { + _keyboardHandler?.Dispose(); + _keyboardHandler = null; + + if (_isHotkeyRegistered) + { + _hotKeyService?.UnregisterHotKey(); + _isHotkeyRegistered = false; + } + + if (_hotKeyService is IDisposable disposableHotKeyService) + { + disposableHotKeyService.Dispose(); + } + + if (_webServer != null) + { + await _webServer.StopAsync(); + } + }; + } + + base.OnFrameworkInitializationCompleted(); + } + + private void ExitApplication(IClassicDesktopStyleApplicationLifetime desktop) + { + _isExitRequested = true; + desktop.Shutdown(); + } + + private void ShowMainWindow() + { + if (_mainWindow == null) return; + + if (!_mainWindow.IsVisible) + { + _mainWindow.Show(); + } + + if (_mainWindow.WindowState == WindowState.Minimized) + { + _mainWindow.WindowState = WindowState.Normal; + } + + _mainWindow.Activate(); + } + + private void RegisterHotkey() + { + if (_hotKeyService == null || _hotKeySettingsService == null) return; + + var config = _hotKeyConfig ?? _hotKeySettingsService.GetConfig(); + _hotKeyConfig = config; + + if (_hotKeyService.IsSupported && config.IsEnabled) + { + _hotKeyService.RegisterHotKey(config.Modifiers, config.Key, () => + { + Dispatcher.UIThread.Post(ShowMainWindow); + }); + _isHotkeyRegistered = true; + } + + config.PropertyChanged -= OnHotKeyConfigPropertyChanged; + config.PropertyChanged += OnHotKeyConfigPropertyChanged; + } + + private void OnHotKeyConfigPropertyChanged(object? sender, PropertyChangedEventArgs e) + { + if (_hotKeyService == null || _hotKeySettingsService == null || _hotKeyConfig == null) return; + + if (e.PropertyName != nameof(HotKeyConfig.Modifiers) && + e.PropertyName != nameof(HotKeyConfig.Key) && + e.PropertyName != nameof(HotKeyConfig.IsEnabled)) + { + return; + } + + _hotKeySettingsService.SaveConfig(_hotKeyConfig); + + if (_hotKeyConfig.IsEnabled && _hotKeyService.IsSupported) + { + _hotKeyService.UpdateHotKey(_hotKeyConfig.Modifiers, _hotKeyConfig.Key); + _isHotkeyRegistered = true; + } + else + { + _hotKeyService.UnregisterHotKey(); + _isHotkeyRegistered = false; + } + } + + private void DisableAvaloniaDataAnnotationValidation() + { + var dataValidationPluginsToRemove = + BindingPlugins.DataValidators.OfType().ToArray(); + + foreach (var plugin in dataValidationPluginsToRemove) + { + BindingPlugins.DataValidators.Remove(plugin); + } + } +} diff --git a/src/Hua.Todo.Avalonia/Assets/avalonia-logo.ico b/src/Hua.Todo.Avalonia/Assets/avalonia-logo.ico new file mode 100644 index 0000000..f7da8bb Binary files /dev/null and b/src/Hua.Todo.Avalonia/Assets/avalonia-logo.ico differ diff --git a/src/Hua.Todo.Avalonia/Hua.Todo.Avalonia.csproj b/src/Hua.Todo.Avalonia/Hua.Todo.Avalonia.csproj new file mode 100644 index 0000000..799f4a2 --- /dev/null +++ b/src/Hua.Todo.Avalonia/Hua.Todo.Avalonia.csproj @@ -0,0 +1,64 @@ + + + WinExe + net10.0 + enable + app.manifest + true + $([System.IO.Path]::GetFullPath('$(MSBuildProjectDirectory)/../Hua.Todo.Web')) + $(TodoWebDir)\dist + false + false + + + + + + + + + + + + + + + + + None + All + + + + + + + PreserveNewest + + + + + + + + + + + + + + + + + + + + <_TodoWebDistFiles Include="$(TodoWebDistDir)\**\*" /> + + + + + + + + diff --git a/src/Hua.Todo.Avalonia/Models/AppSettings.cs b/src/Hua.Todo.Avalonia/Models/AppSettings.cs new file mode 100644 index 0000000..3d531ba --- /dev/null +++ b/src/Hua.Todo.Avalonia/Models/AppSettings.cs @@ -0,0 +1,42 @@ +using System.Text.Json.Serialization; + +namespace Hua.Todo.Avalonia.Models; + +public class AppSettings +{ + [JsonPropertyName("WebServer")] + public WebServerSettings WebServer { get; set; } = new(); + + [JsonPropertyName("HotKey")] + public HotKeyDefaultSettings HotKey { get; set; } = new(); +} + +public class WebServerSettings +{ + [JsonPropertyName("Port")] + public int Port { get; set; } = 5057; + + [JsonPropertyName("IsUsingStatic")] + public bool IsUsingStatic { get; set; } = true; + + [JsonPropertyName("ConnectionString")] + public string ConnectionString { get; set; } = ""; + + [JsonPropertyName("HostUrl")] + public string HostUrl { get; set; } = "http://localhost:5057"; + + [JsonPropertyName("ForEndUrl")] + public string ForEndUrl { get; set; } = "http://localhost:5174"; +} + +public class HotKeyDefaultSettings +{ + [JsonPropertyName("DefaultModifiers")] + public string DefaultModifiers { get; set; } = "Alt"; + + [JsonPropertyName("DefaultKey")] + public string DefaultKey { get; set; } = "X"; + + [JsonPropertyName("DefaultIsEnabled")] + public bool DefaultIsEnabled { get; set; } = true; +} diff --git a/src/Hua.Todo.Avalonia/Models/HotKeyConfig.cs b/src/Hua.Todo.Avalonia/Models/HotKeyConfig.cs new file mode 100644 index 0000000..864cc12 --- /dev/null +++ b/src/Hua.Todo.Avalonia/Models/HotKeyConfig.cs @@ -0,0 +1,72 @@ +using System.ComponentModel; +using System.Runtime.CompilerServices; + +namespace Hua.Todo.Avalonia.Models; + +/// +/// 热键配置模型。 +/// 用于描述全局热键的修饰键、主键与启用状态，并通过通知机制驱动动态更新。 +/// +public sealed class HotKeyConfig : INotifyPropertyChanged +{ + private string _modifiers = "Alt"; + private string _key = "X"; + private bool _isEnabled = true; + + /// + /// 修饰键（例如 Alt、Control、Shift、Windows；多个键用逗号分隔）。 + /// + public string Modifiers + { + get => _modifiers; + set + { + if (_modifiers != value) + { + _modifiers = value; + OnPropertyChanged(); + } + } + } + + /// + /// 主键（例如 X、C、V）。 + /// + public string Key + { + get => _key; + set + { + if (_key != value) + { + _key = value; + OnPropertyChanged(); + } + } + } + + /// + /// 是否启用热键。 + /// + public bool IsEnabled + { + get => _isEnabled; + set + { + if (_isEnabled != value) + { + _isEnabled = value; + OnPropertyChanged(); + } + } + } + + /// + public event PropertyChangedEventHandler? PropertyChanged; + + private void OnPropertyChanged([CallerMemberName] string? propertyName = null) + { + PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName)); + } +} + diff --git a/src/Hua.Todo.Avalonia/Program.cs b/src/Hua.Todo.Avalonia/Program.cs new file mode 100644 index 0000000..c2d7bd8 --- /dev/null +++ b/src/Hua.Todo.Avalonia/Program.cs @@ -0,0 +1,23 @@ +using Avalonia; +using Avalonia.WebView.Desktop; +using System; + +namespace Hua.Todo.Avalonia; + +sealed class Program +{ + // Initialization code. Don't use any Avalonia, third-party APIs or any + // SynchronizationContext-reliant code before AppMain is called: things aren't initialized + // yet and stuff might break. + [STAThread] + public static void Main(string[] args) => BuildAvaloniaApp() + .StartWithClassicDesktopLifetime(args); + + // Avalonia configuration, don't remove; also used by visual designer. + public static AppBuilder BuildAvaloniaApp() + => AppBuilder.Configure() + .UsePlatformDetect() + .WithInterFont() + .LogToTrace() + .UseDesktopWebView(); +} diff --git a/src/Hua.Todo.Avalonia/Services/AppMetadata.cs b/src/Hua.Todo.Avalonia/Services/AppMetadata.cs new file mode 100644 index 0000000..b359b95 --- /dev/null +++ b/src/Hua.Todo.Avalonia/Services/AppMetadata.cs @@ -0,0 +1,60 @@ +using System.Reflection; + +namespace Hua.Todo.Avalonia.Services; + +/// +/// 应用元信息工具类。 +/// 负责生成窗口标题与托盘提示文本等展示字符串，避免在多处重复拼装并保持跨宿主一致性。 +/// +public static class AppMetadata +{ + private const string AppNameText = "待办事项"; + + /// + /// 应用名称（不含版本）。 + /// + public static string AppName => AppNameText; + + /// + /// 获取显示版本号（主版本.次版本.修订版本）。 + /// 若无法解析版本信息则返回 null。 + /// + public static string? GetDisplayVersion() + { + var asmVersion = Assembly.GetExecutingAssembly().GetName().Version; + if (asmVersion == null) + { + return null; + } + + return $"{asmVersion.Major}.{asmVersion.Minor}.{asmVersion.Build}"; + } + + /// + /// 获取托盘/关于等场景使用的显示标题（可能包含版本）。 + /// + public static string GetDisplayTitle() + { + var version = GetDisplayVersion(); + return string.IsNullOrWhiteSpace(version) ? AppName : $"{AppName} v{version}"; + } + + /// + /// 获取窗口标题栏文本（可能包含版本）。 + /// + public static string GetWindowTitle() + { + var version = GetDisplayVersion(); + return string.IsNullOrWhiteSpace(version) ? AppNameText : $"{AppNameText} v{version}"; + } + + /// + /// 获取托盘 Tooltip 文本（部分平台对长度有限制）。 + /// + public static string GetTrayTooltipText() + { + var text = GetDisplayTitle(); + return text.Length > 63 ? text[..63] : text; + } +} + diff --git a/src/Hua.Todo.Avalonia/Services/EmbeddedWebServerService.cs b/src/Hua.Todo.Avalonia/Services/EmbeddedWebServerService.cs new file mode 100644 index 0000000..412577b --- /dev/null +++ b/src/Hua.Todo.Avalonia/Services/EmbeddedWebServerService.cs @@ -0,0 +1,208 @@ +using Microsoft.AspNetCore.Builder; +using Microsoft.AspNetCore.Hosting; +using Microsoft.AspNetCore.Http; +using Microsoft.Data.Sqlite; +using Microsoft.EntityFrameworkCore; +using Microsoft.Extensions.DependencyInjection; +using Microsoft.Extensions.FileProviders; +using Microsoft.Extensions.Hosting; +using System; +using System.IO; +using System.Text.Json; +using System.Threading.Tasks; +using Hua.Todo.Application; +using Hua.Todo.Application.Data; +using Hua.Todo.Application.DynamicApi; +using Hua.Todo.Avalonia.Models; + +namespace Hua.Todo.Avalonia.Services; + +/// +/// 嵌入式 Web 服务器实现 +/// +public class EmbeddedWebServerService : IEmbeddedWebServerService +{ + private WebApplication? _webApp; + private readonly AppSettings _appSettings; + + /// + /// 服务器是否正在运行 + /// + public bool IsRunning => _webApp != null; + + /// + /// 服务器基础 URL + /// + public string BaseUrl => _appSettings.WebServer.HostUrl; + + /// + /// 初始化嵌入式 Web 服务器服务 + /// + /// 应用程序配置 + public EmbeddedWebServerService(AppSettings appSettings) + { + _appSettings = appSettings; + } + + /// + /// 异步启动服务器 + /// + public async Task StartAsync() + { + if (_webApp != null) return; + + var builder = WebApplication.CreateBuilder(); + + builder.WebHost.UseUrls(_appSettings.WebServer.HostUrl); + + // 配置控制器和 JSON 选项 + builder.Services.AddControllers() + .AddApplicationPart(typeof(Hua.Todo.Application.ServiceCollectionExtensions).Assembly) + .AddJsonOptions(options => + { + options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase; + }); + + builder.Services.AddEndpointsApiExplorer(); + + // 注册应用逻辑服务 + builder.Services.AddApplicationServices(_appSettings.WebServer.ConnectionString); + + // 配置跨域策略 + builder.Services.AddCors(options => + { + options.AddPolicy("AllowAll", policy => + { + policy.AllowAnyOrigin() + .AllowAnyMethod() + .AllowAnyHeader(); + }); + }); + + var app = builder.Build(); + + InitializeDatabase(app); + + // 如果配置为使用静态文件（前端托管），则配置静态文件服务 + if (_appSettings.WebServer.IsUsingStatic) + { + ServeStaticFiles(app); + } + + app.UseCors("AllowAll"); + app.UseAuthorization(); + app.UseDynamicApi(); + app.MapControllers(); + + _webApp = app; + + await _webApp.StartAsync(); + } + + private void InitializeDatabase(WebApplication app) + { + using var scope = app.Services.CreateScope(); + + try + { + var dbContext = scope.ServiceProvider.GetRequiredService(); + + var sqliteBuilder = new SqliteConnectionStringBuilder(_appSettings.WebServer.ConnectionString); + var actualDbPath = sqliteBuilder.DataSource; + if (!string.IsNullOrEmpty(actualDbPath)) + { + var dbDir = Path.GetDirectoryName(actualDbPath); + if (!string.IsNullOrEmpty(dbDir) && !Directory.Exists(dbDir)) + { + Directory.CreateDirectory(dbDir); + } + } + + dbContext.Database.ExecuteSqlRaw("PRAGMA journal_mode=WAL;"); + dbContext.Database.Migrate(); + } + catch (Exception ex) + { + Console.WriteLine($"[EmbeddedWebServer] Database initialization failed: {ex.Message}"); + + try + { + var dbContext = scope.ServiceProvider.GetRequiredService(); + dbContext.Database.EnsureCreated(); + } + catch (Exception ensureEx) + { + Console.WriteLine($"[EmbeddedWebServer] Database ensure-created failed: {ensureEx.Message}"); + } + } + } + + /// + /// 配置静态文件服务（用于托管 Vue 前端） + /// + /// Web 应用程序实例 + private void ServeStaticFiles(WebApplication app) + { + try + { + var wwwrootPath = Path.Combine(AppContext.BaseDirectory, "wwwroot"); + if (!Directory.Exists(wwwrootPath)) + { + Console.WriteLine($"[EmbeddedWebServer] wwwroot directory not found at: {wwwrootPath}. Static file serving disabled."); + return; + } + var fileProvider = new PhysicalFileProvider(wwwrootPath); + var defaultFilesOptions = new DefaultFilesOptions { FileProvider = fileProvider, RequestPath = "" }; + app.UseDefaultFiles(defaultFilesOptions); + + var staticFileOptions = new StaticFileOptions + { + FileProvider = fileProvider, + RequestPath = "", + OnPrepareResponse = ctx => + { + ctx.Context.Response.Headers["Cache-Control"] = "no-cache, no-store, must-revalidate"; + ctx.Context.Response.Headers["Pragma"] = "no-cache"; + ctx.Context.Response.Headers["Expires"] = "0"; + } + }; + app.UseStaticFiles(staticFileOptions); + + // 处理 SPA 路由 + app.Use(async (context, next) => + { + if (context.Request.Path.HasValue) + { + var path = context.Request.Path.Value; + if (path != "/" && !path.StartsWith("/assets", StringComparison.OrdinalIgnoreCase) && !path.StartsWith("/api", StringComparison.OrdinalIgnoreCase)) + { + var ext = Path.GetExtension(path); + if (string.IsNullOrEmpty(ext)) + { + context.Request.Path = "/index.html"; + } + } + } + await next(); + }); + + Console.WriteLine($"[EmbeddedWebServer] Serving static files from: {wwwrootPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"[EmbeddedWebServer] Failed to serve static files: {ex.Message}"); + } + } + + /// + /// 异步停止服务器 + /// + public async Task StopAsync() + { + if (_webApp == null) return; + + await _webApp.StopAsync(); + await _webApp.DisposeAsync(); + _webApp = null; + } +} diff --git a/src/Hua.Todo.Avalonia/Services/GlobalHotKeyServiceFactory.cs b/src/Hua.Todo.Avalonia/Services/GlobalHotKeyServiceFactory.cs new file mode 100644 index 0000000..a61cc9b --- /dev/null +++ b/src/Hua.Todo.Avalonia/Services/GlobalHotKeyServiceFactory.cs @@ -0,0 +1,25 @@ +using Hua.Todo.Avalonia.Services.Platforms; +using System; + +namespace Hua.Todo.Avalonia.Services; + +/// +/// 全局热键服务工厂。 +/// 通过运行时平台判断返回最合适的实现，避免在同一文件内混写大量条件编译代码。 +/// +public static class GlobalHotKeyServiceFactory +{ + /// + /// 创建平台对应的全局热键服务实现。 + /// + public static IGlobalHotKeyService Create() + { + if (OperatingSystem.IsWindows()) + { + return new WindowsGlobalHotKeyService(); + } + + return new NoopGlobalHotKeyService(); + } +} + diff --git a/src/Hua.Todo.Avalonia/Services/HotKeySettingsService.cs b/src/Hua.Todo.Avalonia/Services/HotKeySettingsService.cs new file mode 100644 index 0000000..9cfbd0d --- /dev/null +++ b/src/Hua.Todo.Avalonia/Services/HotKeySettingsService.cs @@ -0,0 +1,130 @@ +using Hua.Todo.Avalonia.Models; +using System; +using System.IO; +using System.Text.Json; + +namespace Hua.Todo.Avalonia.Services; + +/// +/// 热键设置服务接口。 +/// 负责读取/保存用户可配置的全局热键，并提供从默认值重置的能力。 +/// +public interface IHotKeySettingsService +{ + /// + /// 获取当前热键配置（若尚未持久化则返回默认配置）。 + /// + HotKeyConfig GetConfig(); + + /// + /// 保存热键配置。 + /// + /// 要保存的热键配置。 + void SaveConfig(HotKeyConfig config); + + /// + /// 重置为默认配置并落盘。 + /// + void ResetToDefault(); +} + +/// +/// 热键设置服务实现。 +/// Avalonia 侧使用本地 JSON 文件持久化配置，以保证桌面端与多平台运行时一致性。 +/// +public sealed class HotKeySettingsService : IHotKeySettingsService +{ + private const string SettingsFileName = "hotkey.json"; + private readonly AppSettings _appSettings; + private HotKeyConfig? _cached; + + /// + /// 创建 。 + /// + /// 应用配置（用于提供默认热键）。 + public HotKeySettingsService(AppSettings appSettings) + { + _appSettings = appSettings; + } + + /// + public HotKeyConfig GetConfig() + { + if (_cached != null) + { + return _cached; + } + + var path = GetSettingsPath(); + if (!File.Exists(path)) + { + _cached = GetDefaultConfig(); + return _cached; + } + + try + { + var json = File.ReadAllText(path); + _cached = JsonSerializer.Deserialize(json) ?? GetDefaultConfig(); + return _cached; + } + catch + { + _cached = GetDefaultConfig(); + return _cached; + } + } + + /// + public void SaveConfig(HotKeyConfig config) + { + var path = GetSettingsPath(); + EnsureSettingsDirectory(path); + + var json = JsonSerializer.Serialize(config); + File.WriteAllText(path, json); + + _cached ??= config; + } + + /// + public void ResetToDefault() + { + var defaultConfig = GetDefaultConfig(); + var current = GetConfig(); + + current.Modifiers = defaultConfig.Modifiers; + current.Key = defaultConfig.Key; + current.IsEnabled = defaultConfig.IsEnabled; + + SaveConfig(current); + } + + private HotKeyConfig GetDefaultConfig() + { + return new HotKeyConfig + { + Modifiers = _appSettings.HotKey.DefaultModifiers, + Key = _appSettings.HotKey.DefaultKey, + IsEnabled = _appSettings.HotKey.DefaultIsEnabled + }; + } + + private static string GetSettingsPath() + { + var localAppData = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData); + var dir = Path.Combine(localAppData, "Hua.Todo"); + return Path.Combine(dir, SettingsFileName); + } + + private static void EnsureSettingsDirectory(string settingsPath) + { + var dir = Path.GetDirectoryName(settingsPath); + if (string.IsNullOrWhiteSpace(dir)) + { + return; + } + + Directory.CreateDirectory(dir); + } +} diff --git a/src/Hua.Todo.Avalonia/Services/IEmbeddedWebServerService.cs b/src/Hua.Todo.Avalonia/Services/IEmbeddedWebServerService.cs new file mode 100644 index 0000000..9ccf9b7 --- /dev/null +++ b/src/Hua.Todo.Avalonia/Services/IEmbeddedWebServerService.cs @@ -0,0 +1,29 @@ +using System.Threading.Tasks; + +namespace Hua.Todo.Avalonia.Services; + +/// +/// 嵌入式 Web 服务器接口 +/// +public interface IEmbeddedWebServerService +{ + /// + /// 服务器是否正在运行 + /// + bool IsRunning { get; } + + /// + /// 服务器基础 URL + /// + string BaseUrl { get; } + + /// + /// 异步启动服务器 + /// + Task StartAsync(); + + /// + /// 异步停止服务器 + /// + Task StopAsync(); +} diff --git a/src/Hua.Todo.Avalonia/Services/IGlobalHotKeyService.cs b/src/Hua.Todo.Avalonia/Services/IGlobalHotKeyService.cs new file mode 100644 index 0000000..b72c013 --- /dev/null +++ b/src/Hua.Todo.Avalonia/Services/IGlobalHotKeyService.cs @@ -0,0 +1,36 @@ +using System; + +namespace Hua.Todo.Avalonia.Services; + +/// +/// 全局热键服务接口。 +/// 用于在桌面环境下注册系统级快捷键，以便在应用隐藏/最小化时快速唤起主窗口。 +/// +public interface IGlobalHotKeyService +{ + /// + /// 注册全局热键。 + /// + /// 修饰键（如 Alt、Control；多个键用逗号分隔）。 + /// 主键（如 X、C）。 + /// 热键触发时回调（不得阻塞，应自行切回 UI 线程）。 + void RegisterHotKey(string modifiers, string key, Action callback); + + /// + /// 注销已注册的热键。 + /// + void UnregisterHotKey(); + + /// + /// 更新热键配置。 + /// + /// 新的修饰键。 + /// 新的主键。 + void UpdateHotKey(string modifiers, string key); + + /// + /// 当前平台是否支持全局热键。 + /// + bool IsSupported { get; } +} + diff --git a/src/Hua.Todo.Avalonia/Services/NoopGlobalHotKeyService.cs b/src/Hua.Todo.Avalonia/Services/NoopGlobalHotKeyService.cs new file mode 100644 index 0000000..f5b7289 --- /dev/null +++ b/src/Hua.Todo.Avalonia/Services/NoopGlobalHotKeyService.cs @@ -0,0 +1,29 @@ +using System; + +namespace Hua.Todo.Avalonia.Services; + +/// +/// 不支持全局热键的平台默认实现。 +/// 该实现不会注册任何系统级热键，用于保持上层逻辑简洁一致。 +/// +public sealed class NoopGlobalHotKeyService : IGlobalHotKeyService +{ + /// + public void RegisterHotKey(string modifiers, string key, Action callback) + { + } + + /// + public void UnregisterHotKey() + { + } + + /// + public void UpdateHotKey(string modifiers, string key) + { + } + + /// + public bool IsSupported => false; +} + diff --git a/src/Hua.Todo.Avalonia/Services/Platforms/WindowsGlobalHotKeyService.cs b/src/Hua.Todo.Avalonia/Services/Platforms/WindowsGlobalHotKeyService.cs new file mode 100644 index 0000000..3340791 --- /dev/null +++ b/src/Hua.Todo.Avalonia/Services/Platforms/WindowsGlobalHotKeyService.cs @@ -0,0 +1,264 @@ +using System; +using System.Collections.Concurrent; +using System.Diagnostics; +using System.Runtime.InteropServices; +using System.Threading; + +namespace Hua.Todo.Avalonia.Services.Platforms; + +/// +/// Windows 平台全局热键服务实现。 +/// 通过 RegisterHotKey 将热键注册到专用线程的消息队列中，避免依赖窗口句柄与 WndProc Hook。 +/// +public sealed class WindowsGlobalHotKeyService : IGlobalHotKeyService, IDisposable +{ + private const int HotKeyId = 9000; + private const uint WmHotKey = 0x0312; + private const uint WmQuit = 0x0012; + private const uint WmAppExecute = 0x8001; + + public const uint ModAlt = 0x0001; + public const uint ModControl = 0x0002; + public const uint ModShift = 0x0004; + public const uint ModWin = 0x0008; + + private readonly ConcurrentDictionary _actions = new(); + private int _actionId; + private Thread? _thread; + private uint _threadId; + private ManualResetEventSlim? _threadStarted; + + private Action? _callback; + private bool _isRegistered; + private uint _currentModifiers; + private uint _currentKey; + private bool _isDisposed; + + /// + public bool IsSupported => OperatingSystem.IsWindows(); + + /// + public void RegisterHotKey(string modifiers, string key, Action callback) + { + if (!IsSupported) return; + + _callback = callback; + _currentModifiers = ParseModifiers(modifiers); + _currentKey = ParseKey(key); + + StartThreadIfNeeded(); + InvokeOnHotKeyThread(() => + { + UnregisterHotKeyInternal(); + + if (_currentKey == 0) + { + return; + } + + if (RegisterHotKey(IntPtr.Zero, HotKeyId, _currentModifiers, _currentKey)) + { + _isRegistered = true; + } + else + { + Debug.WriteLine("[WindowsGlobalHotKeyService] Failed to register hotkey."); + } + }); + } + + /// + public void UnregisterHotKey() + { + if (!IsSupported) return; + + StartThreadIfNeeded(); + InvokeOnHotKeyThread(UnregisterHotKeyInternal); + } + + /// + public void UpdateHotKey(string modifiers, string key) + { + if (_callback == null) return; + RegisterHotKey(modifiers, key, _callback); + } + + private void UnregisterHotKeyInternal() + { + if (_isRegistered) + { + UnregisterHotKey(IntPtr.Zero, HotKeyId); + _isRegistered = false; + } + } + + private void StartThreadIfNeeded() + { + if (_thread != null) return; + + _threadStarted = new ManualResetEventSlim(false); + _thread = new Thread(MessageLoop) + { + IsBackground = true, + Name = "Hua.Todo HotKey Thread" + }; + if (OperatingSystem.IsWindows()) + { + _thread.SetApartmentState(ApartmentState.STA); + } + _thread.Start(); + _threadStarted.Wait(); + } + + private void MessageLoop() + { + _threadId = GetCurrentThreadId(); + _threadStarted?.Set(); + + while (GetMessage(out var msg, IntPtr.Zero, 0, 0) != 0) + { + if (msg.message == WmHotKey && msg.wParam == (UIntPtr)HotKeyId) + { + try + { + _callback?.Invoke(); + } + catch (Exception ex) + { + Debug.WriteLine($"[WindowsGlobalHotKeyService] Hotkey callback failed: {ex}"); + } + continue; + } + + if (msg.message == WmAppExecute) + { + var id = unchecked((int)msg.wParam); + if (_actions.TryRemove(id, out var action)) + { + try + { + action(); + } + catch (Exception ex) + { + Debug.WriteLine($"[WindowsGlobalHotKeyService] Action execution failed: {ex}"); + } + } + continue; + } + + if (msg.message == WmQuit) + { + break; + } + + TranslateMessage(ref msg); + DispatchMessage(ref msg); + } + + _threadStarted?.Dispose(); + _threadStarted = null; + } + + private void InvokeOnHotKeyThread(Action action) + { + var id = Interlocked.Increment(ref _actionId); + _actions[id] = action; + + if (!PostThreadMessage(_threadId, WmAppExecute, (UIntPtr)id, IntPtr.Zero)) + { + _actions.TryRemove(id, out _); + } + } + + private static uint ParseModifiers(string modifiers) + { + uint mod = 0; + if (string.IsNullOrWhiteSpace(modifiers)) return mod; + + var parts = modifiers.Split(','); + foreach (var part in parts) + { + var p = part.Trim(); + if (p.Equals("Control", StringComparison.OrdinalIgnoreCase)) mod |= ModControl; + if (p.Equals("Alt", StringComparison.OrdinalIgnoreCase)) mod |= ModAlt; + if (p.Equals("Shift", StringComparison.OrdinalIgnoreCase)) mod |= ModShift; + if (p.Equals("Windows", StringComparison.OrdinalIgnoreCase)) mod |= ModWin; + } + + return mod; + } + + private static uint ParseKey(string key) + { + if (string.IsNullOrWhiteSpace(key)) return 0; + + if (key.Length == 1) + { + var c = char.ToUpperInvariant(key[0]); + if (c is >= 'A' and <= 'Z') return c; + if (c is >= '0' and <= '9') return c; + } + + return 0x58; // Default 'X' + } + + /// + public void Dispose() + { + if (_isDisposed) return; + _isDisposed = true; + + try + { + UnregisterHotKey(); + } + catch + { + } + + if (_threadId != 0) + { + PostThreadMessage(_threadId, WmQuit, UIntPtr.Zero, IntPtr.Zero); + } + } + + [StructLayout(LayoutKind.Sequential)] + private struct Msg + { + public IntPtr hwnd; + public uint message; + public UIntPtr wParam; + public IntPtr lParam; + public uint time; + public POINT pt; + } + + [StructLayout(LayoutKind.Sequential)] + private struct POINT + { + public int x; + public int y; + } + + [DllImport("user32.dll", SetLastError = true)] + private static extern bool RegisterHotKey(IntPtr hWnd, int id, uint fsModifiers, uint vk); + + [DllImport("user32.dll", SetLastError = true)] + private static extern bool UnregisterHotKey(IntPtr hWnd, int id); + + [DllImport("user32.dll")] + private static extern sbyte GetMessage(out Msg lpMsg, IntPtr hWnd, uint wMsgFilterMin, uint wMsgFilterMax); + + [DllImport("user32.dll")] + private static extern bool TranslateMessage(ref Msg lpMsg); + + [DllImport("user32.dll")] + private static extern IntPtr DispatchMessage(ref Msg lpMsg); + + [DllImport("user32.dll", SetLastError = true)] + private static extern bool PostThreadMessage(uint idThread, uint msg, UIntPtr wParam, IntPtr lParam); + + [DllImport("kernel32.dll")] + private static extern uint GetCurrentThreadId(); +} diff --git a/src/Hua.Todo.Avalonia/Services/Platforms/WindowsKeyboardHandler.cs b/src/Hua.Todo.Avalonia/Services/Platforms/WindowsKeyboardHandler.cs new file mode 100644 index 0000000..f09ef97 --- /dev/null +++ b/src/Hua.Todo.Avalonia/Services/Platforms/WindowsKeyboardHandler.cs @@ -0,0 +1,138 @@ +using System; +using System.Runtime.InteropServices; + +namespace Hua.Todo.Avalonia.Services.Platforms; + +/// +/// Windows 全局键盘事件处理器。 +/// 用于监听按键并向上层暴露事件（例如 Esc），以保证在 WebView 获得焦点时依旧可触发窗口级交互。 +/// +public sealed class WindowsKeyboardHandler : IDisposable +{ + private readonly KeyboardHook _keyboardHook; + private bool _isDisposed; + + /// + /// 当检测到 Esc 键抬起时触发。 + /// + public event EventHandler? EscKeyPressed; + + /// + /// 创建 。 + /// + public WindowsKeyboardHandler() + { + _keyboardHook = new KeyboardHook(); + _keyboardHook.KeyPressed += OnKeyPressed; + } + + /// + /// 开始监听键盘事件。 + /// + public void Start() + { + _keyboardHook.Hook(); + } + + private void OnKeyPressed(object? sender, KeyPressedEventArgs e) + { + if (e.Key == 0x1B && !e.IsKeyDown) + { + EscKeyPressed?.Invoke(this, EventArgs.Empty); + } + } + + /// + public void Dispose() + { + if (_isDisposed) return; + _isDisposed = true; + + _keyboardHook.Unhook(); + _keyboardHook.KeyPressed -= OnKeyPressed; + } + + private sealed class KeyboardHook : IDisposable + { + private const int WhKeyboardLl = 13; + private const int WmKeyDown = 0x0100; + private const int WmKeyUp = 0x0101; + private const int WmSysKeyDown = 0x0104; + private const int WmSysKeyUp = 0x0105; + + private readonly LowLevelKeyboardProc _proc; + private IntPtr _hookId = IntPtr.Zero; + private bool _isDisposed; + + public event EventHandler? KeyPressed; + + public KeyboardHook() + { + _proc = HookCallback; + } + + public void Hook() + { + if (_hookId != IntPtr.Zero) return; + _hookId = SetWindowsHookEx(WhKeyboardLl, _proc, GetModuleHandle(null), 0); + } + + public void Unhook() + { + if (_hookId == IntPtr.Zero) return; + UnhookWindowsHookEx(_hookId); + _hookId = IntPtr.Zero; + } + + private IntPtr HookCallback(int nCode, IntPtr wParam, IntPtr lParam) + { + if (nCode >= 0) + { + var vkCode = Marshal.ReadInt32(lParam); + var isKeyDown = wParam == (IntPtr)WmKeyDown || wParam == (IntPtr)WmSysKeyDown; + var isKeyUp = wParam == (IntPtr)WmKeyUp || wParam == (IntPtr)WmSysKeyUp; + + if (isKeyDown || isKeyUp) + { + KeyPressed?.Invoke(this, new KeyPressedEventArgs(vkCode, isKeyDown)); + } + } + + return CallNextHookEx(_hookId, nCode, wParam, lParam); + } + + public void Dispose() + { + if (_isDisposed) return; + _isDisposed = true; + Unhook(); + } + + [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)] + private static extern IntPtr SetWindowsHookEx(int idHook, LowLevelKeyboardProc lpfn, IntPtr hMod, uint dwThreadId); + + [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)] + private static extern bool UnhookWindowsHookEx(IntPtr hhk); + + [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)] + private static extern IntPtr CallNextHookEx(IntPtr hhk, int nCode, IntPtr wParam, IntPtr lParam); + + [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = true)] + private static extern IntPtr GetModuleHandle(string? lpModuleName); + } + + private delegate IntPtr LowLevelKeyboardProc(int nCode, IntPtr wParam, IntPtr lParam); + + private sealed class KeyPressedEventArgs : EventArgs + { + public int Key { get; } + public bool IsKeyDown { get; } + + public KeyPressedEventArgs(int key, bool isKeyDown) + { + Key = key; + IsKeyDown = isKeyDown; + } + } +} + diff --git a/src/Hua.Todo.Avalonia/ViewLocator.cs b/src/Hua.Todo.Avalonia/ViewLocator.cs new file mode 100644 index 0000000..1a0b661 --- /dev/null +++ b/src/Hua.Todo.Avalonia/ViewLocator.cs @@ -0,0 +1,37 @@ +using System; +using System.Diagnostics.CodeAnalysis; +using Avalonia.Controls; +using Avalonia.Controls.Templates; +using Hua.Todo.Avalonia.ViewModels; + +namespace Hua.Todo.Avalonia; + +/// +/// Given a view model, returns the corresponding view if possible. +/// +[RequiresUnreferencedCode( + "Default implementation of ViewLocator involves reflection which may be trimmed away.", + Url = "https://docs.avaloniaui.net/docs/concepts/view-locator")] +public class ViewLocator : IDataTemplate +{ + public Control? Build(object? param) + { + if (param is null) + return null; + + var name = param.GetType().FullName!.Replace("ViewModel", "View", StringComparison.Ordinal); + var type = Type.GetType(name); + + if (type != null) + { + return (Control)Activator.CreateInstance(type)!; + } + + return new TextBlock { Text = "Not Found: " + name }; + } + + public bool Match(object? data) + { + return data is ViewModelBase; + } +} diff --git a/src/Hua.Todo.Avalonia/ViewModels/AppTrayViewModel.cs b/src/Hua.Todo.Avalonia/ViewModels/AppTrayViewModel.cs new file mode 100644 index 0000000..a06cf3e --- /dev/null +++ b/src/Hua.Todo.Avalonia/ViewModels/AppTrayViewModel.cs @@ -0,0 +1,47 @@ +using CommunityToolkit.Mvvm.ComponentModel; +using CommunityToolkit.Mvvm.Input; +using System; + +namespace Hua.Todo.Avalonia.ViewModels; + +/// +/// 应用托盘交互的 ViewModel。 +/// 用于为 提供命令与提示文本，并将托盘事件路由到应用层逻辑。 +/// +public sealed partial class AppTrayViewModel : ObservableObject +{ + private readonly Action _showMainWindow; + private readonly Action _exitApplication; + + /// + /// 创建 。 + /// + /// 托盘提示文本（部分平台有长度限制）。 + /// 显示/激活主窗口回调。 + /// 退出应用回调（应触发应用生命周期关闭）。 + public AppTrayViewModel(string trayTooltipText, Action showMainWindow, Action exitApplication) + { + TrayTooltipText = trayTooltipText; + _showMainWindow = showMainWindow; + _exitApplication = exitApplication; + + ShowMainWindowCommand = new RelayCommand(_showMainWindow); + ExitApplicationCommand = new RelayCommand(_exitApplication); + } + + /// + /// 托盘提示文本。 + /// + public string TrayTooltipText { get; } + + /// + /// 显示/激活主窗口命令。 + /// + public IRelayCommand ShowMainWindowCommand { get; } + + /// + /// 退出应用命令。 + /// + public IRelayCommand ExitApplicationCommand { get; } +} + diff --git a/src/Hua.Todo.Avalonia/ViewModels/MainWindowViewModel.cs b/src/Hua.Todo.Avalonia/ViewModels/MainWindowViewModel.cs new file mode 100644 index 0000000..bfbd6d9 --- /dev/null +++ b/src/Hua.Todo.Avalonia/ViewModels/MainWindowViewModel.cs @@ -0,0 +1,6 @@ +namespace Hua.Todo.Avalonia.ViewModels; + +public partial class MainWindowViewModel : ViewModelBase +{ + public string Greeting { get; } = "Welcome to Avalonia!"; +} diff --git a/src/Hua.Todo.Avalonia/ViewModels/ViewModelBase.cs b/src/Hua.Todo.Avalonia/ViewModels/ViewModelBase.cs new file mode 100644 index 0000000..173e739 --- /dev/null +++ b/src/Hua.Todo.Avalonia/ViewModels/ViewModelBase.cs @@ -0,0 +1,7 @@ +using CommunityToolkit.Mvvm.ComponentModel; + +namespace Hua.Todo.Avalonia.ViewModels; + +public abstract class ViewModelBase : ObservableObject +{ +} diff --git a/src/Hua.Todo.Avalonia/Views/MainWindow.axaml b/src/Hua.Todo.Avalonia/Views/MainWindow.axaml new file mode 100644 index 0000000..57a9cab --- /dev/null +++ b/src/Hua.Todo.Avalonia/Views/MainWindow.axaml @@ -0,0 +1,21 @@ + + + + + + + + + diff --git a/src/Hua.Todo.Avalonia/Views/MainWindow.axaml.cs b/src/Hua.Todo.Avalonia/Views/MainWindow.axaml.cs new file mode 100644 index 0000000..9fa89e6 --- /dev/null +++ b/src/Hua.Todo.Avalonia/Views/MainWindow.axaml.cs @@ -0,0 +1,106 @@ +using Avalonia.Controls; +using Avalonia.Layout; +using Avalonia.Media; +using Hua.Todo.Avalonia.Models; +using Hua.Todo.Avalonia.Services; +using System; + +namespace Hua.Todo.Avalonia.Views; + +/// +/// 应用主窗口。 +/// 负责承载 WebView（前端 UI）并在导航完成后注入前端契约字段。 +/// +public partial class MainWindow : Window +{ + private readonly AppSettings _appSettings; + private readonly IEmbeddedWebServerService _webServer; + + /// + /// 创建用于设计器预览的主窗口实例。 + /// + public MainWindow() + { + InitializeComponent(); + _appSettings = new AppSettings(); + _webServer = new EmbeddedWebServerService(_appSettings); + } + + /// + /// 创建运行时主窗口实例。 + /// + /// 应用配置。 + /// 嵌入式 WebServer。 + public MainWindow(AppSettings appSettings, IEmbeddedWebServerService webServer) + { + InitializeComponent(); + _appSettings = appSettings; + _webServer = webServer; + + SetupWebView(); + } + + private void SetupWebView() + { + try + { + if (_appSettings.WebServer.IsUsingStatic) + { + MainWebView.Url = new Uri(_webServer.BaseUrl); + } + else + { + MainWebView.Url = new Uri(_appSettings.WebServer.ForEndUrl); + } + + MainWebView.NavigationCompleted += async (s, e) => + { + try + { + if (_webServer.IsRunning) + { + var apiBase = $"{_webServer.BaseUrl.TrimEnd('/')}/api"; + await MainWebView.ExecuteScriptAsync($"window.__API_BASE_URL__ = '{apiBase}';"); + } + + await MainWebView.ExecuteScriptAsync(@" + window.mauiInterop = { + onHotKeyConfigUpdated: null, + openHotKeySettings: function(config) { + const event = new CustomEvent('openHotKeySettings', { detail: config }); + window.dispatchEvent(event); + }, + updateHotKeyConfig: function(modifiers, key, isEnabled) { + const event = new CustomEvent('updateHotKeyConfig', { + detail: { modifiers, key, isEnabled } + }); + window.dispatchEvent(event); + } + }; + + window.addEventListener('hotKeyConfigChanged', function(e) { + if (window.mauiInterop.onHotKeyConfigUpdated) { + window.mauiInterop.onHotKeyConfigUpdated(e.detail); + } + }); + "); + } + catch (Exception ex) + { + Console.WriteLine($"[MainWindow] WebView script injection failed: {ex.Message}"); + } + }; + } + catch (Exception ex) + { + Console.WriteLine($"[MainWindow] WebView initialization failed: {ex}"); + Content = new TextBlock + { + Text = "WebView 初始化失败。请检查运行环境依赖（Windows 需要 WebView2 Runtime；Linux 需要 WebKitGTK）。", + HorizontalAlignment = HorizontalAlignment.Center, + VerticalAlignment = VerticalAlignment.Center, + TextWrapping = TextWrapping.Wrap + }; + } + } +} diff --git a/src/Hua.Todo.Avalonia/app.manifest b/src/Hua.Todo.Avalonia/app.manifest new file mode 100644 index 0000000..1dd0528 --- /dev/null +++ b/src/Hua.Todo.Avalonia/app.manifest @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + diff --git a/src/Hua.Todo.Avalonia/appsettings.json b/src/Hua.Todo.Avalonia/appsettings.json new file mode 100644 index 0000000..c4333de --- /dev/null +++ b/src/Hua.Todo.Avalonia/appsettings.json @@ -0,0 +1,14 @@ +{ + "WebServer": { + "Port": 5057, + "IsUsingStatic": false, + "ConnectionString": "", + "HostUrl": "http://localhost:5057", + "ForEndUrl": "http://localhost:5174" + }, + "HotKey": { + "DefaultModifiers": "Alt", + "DefaultKey": "X", + "DefaultIsEnabled": true + } +} diff --git a/src/Hua.Todo.Core/Entities/SecurityPolicyEntity.cs b/src/Hua.Todo.Core/Entities/SecurityPolicyEntity.cs new file mode 100644 index 0000000..f341ad7 --- /dev/null +++ b/src/Hua.Todo.Core/Entities/SecurityPolicyEntity.cs @@ -0,0 +1,32 @@ +namespace Hua.Todo.Core.Entities; + +/// +/// 安全策略配置（服务端下发）。 +/// +public class SecurityPolicyEntity +{ + /// + /// 策略唯一标识符。 + /// + public Guid Id { get; set; } + + /// + /// 策略所属用户 ID。 + /// + public Guid UserId { get; set; } + + /// + /// 策略所属用户导航属性。 + /// + public UserEntity? User { get; set; } + + /// + /// 是否允许客户端落盘（为 false 时客户端应进入“内存模式”，不产生本地持久化）。 + /// + public bool AllowPersist { get; set; } = true; + + /// + /// 是否允许执行同步写入（为 false 时应视为“禁止同步”）。 + /// + public bool AllowSync { get; set; } = true; +} diff --git a/src/Hua.Todo.Core/Entities/TaskEntity.cs b/src/Hua.Todo.Core/Entities/TaskEntity.cs index 998e4e4..242759d 100644 --- a/src/Hua.Todo.Core/Entities/TaskEntity.cs +++ b/src/Hua.Todo.Core/Entities/TaskEntity.cs @@ -5,6 +5,17 @@ namespace Hua.Todo.Core.Entities; /// public class TaskEntity { + /// + /// 任务所属用户 ID。 + /// 本地模式下使用固定的“本地用户”ID，以确保本地任务与云端多用户任务隔离。 + /// + public Guid UserId { get; set; } = TodoUserIds.LocalUserId; + + /// + /// 任务所属用户导航属性。 + /// + public UserEntity? User { get; set; } + /// /// 任务唯一标识符 /// diff --git a/src/Hua.Todo.Core/Entities/TodoUserIds.cs b/src/Hua.Todo.Core/Entities/TodoUserIds.cs new file mode 100644 index 0000000..f50fdb5 --- /dev/null +++ b/src/Hua.Todo.Core/Entities/TodoUserIds.cs @@ -0,0 +1,13 @@ +namespace Hua.Todo.Core.Entities; + +/// +/// 系统内置用户 ID 常量。 +/// +public static class TodoUserIds +{ + /// + /// 本地模式专用的内置用户 ID。 + /// + public static readonly Guid LocalUserId = Guid.Parse("00000000-0000-0000-0000-000000000001"); +} + diff --git a/src/Hua.Todo.Core/Entities/UserEntity.cs b/src/Hua.Todo.Core/Entities/UserEntity.cs new file mode 100644 index 0000000..ff4294e --- /dev/null +++ b/src/Hua.Todo.Core/Entities/UserEntity.cs @@ -0,0 +1,33 @@ +namespace Hua.Todo.Core.Entities; + +/// +/// 用户实体，用于云同步场景下的用户隔离与权限控制。 +/// +public class UserEntity +{ + /// + /// 用户唯一标识符。 + /// + public Guid Id { get; set; } + + /// + /// 登录用户名（全局唯一）。 + /// + public string UserName { get; set; } = string.Empty; + + /// + /// 登录密码哈希（不存储明文）。 + /// + public string PasswordHash { get; set; } = string.Empty; + + /// + /// 用户角色（用于 RBAC 权限映射）。 + /// + public string Role { get; set; } = "user"; + + /// + /// 用户任务集合。 + /// + public List Tasks { get; set; } = new(); +} + diff --git a/src/Hua.Todo.Core/Entities/UserSessionEntity.cs b/src/Hua.Todo.Core/Entities/UserSessionEntity.cs new file mode 100644 index 0000000..0b2a061 --- /dev/null +++ b/src/Hua.Todo.Core/Entities/UserSessionEntity.cs @@ -0,0 +1,38 @@ +namespace Hua.Todo.Core.Entities; + +/// +/// 用户会话实体（服务端会话令牌）。 +/// +public class UserSessionEntity +{ + /// + /// 会话唯一标识符，同时作为 Bearer Token 值使用。 + /// + public Guid Id { get; set; } + + /// + /// 会话所属用户 ID。 + /// + public Guid UserId { get; set; } + + /// + /// 会话所属用户导航属性。 + /// + public UserEntity? User { get; set; } + + /// + /// 会话创建时间（UTC）。 + /// + public DateTime CreatedAtUtc { get; set; } + + /// + /// 会话过期时间（UTC）。 + /// + public DateTime ExpiresAtUtc { get; set; } + + /// + /// 二次认证（step-up）有效期截止（UTC）；为空表示未进行二次认证。 + /// + public DateTime? StepUpExpiresAtUtc { get; set; } +} + diff --git a/src/Hua.Todo.Host/Program.cs b/src/Hua.Todo.Host/Program.cs index 2f98173..a3a48e7 100644 --- a/src/Hua.Todo.Host/Program.cs +++ b/src/Hua.Todo.Host/Program.cs @@ -1,6 +1,7 @@ using System.Text.Json; using Microsoft.EntityFrameworkCore; using Hua.Todo.Application; +using Hua.Todo.Application.CloudSync; using Hua.Todo.Application.DynamicApi; using Hua.Todo.Application.Interfaces; using Hua.Todo.Application.Models; @@ -9,7 +10,7 @@ var builder = WebApplication.CreateBuilder(args); builder.Services.AddEndpointsApiExplorer(); builder.Services.AddSwaggerGen(); -builder.Services.AddAuthorization(); +builder.Services.AddCloudSyncServer(); builder.Services.AddApplicationServices("Data Source=Hua.Todo.db"); @@ -40,7 +41,9 @@ if (app.Environment.IsDevelopment()) app.UseHttpsRedirection(); app.UseCors("AllowAll"); +app.UseAuthentication(); app.UseAuthorization(); +app.MapCloudSyncEndpoints(); app.UseDynamicApi(); app.Run(); diff --git a/src/Hua.Todo.Maui/Hua.Todo.Maui.csproj b/src/Hua.Todo.Maui/Hua.Todo.Maui.csproj index f233df9..9e820d1 100644 --- a/src/Hua.Todo.Maui/Hua.Todo.Maui.csproj +++ b/src/Hua.Todo.Maui/Hua.Todo.Maui.csproj @@ -29,7 +29,7 @@ com.companyname.Hua.Todo.maui - 1.1.5 + 1.1.9 $(Version) 1 @@ -95,8 +95,8 @@ - - + + @@ -146,13 +146,19 @@ - + + + + + + + - + - + <_TodoWebDistFiles Include="$(TodoWebDistDir)\**\*" /> @@ -169,15 +175,16 @@ - + - <_TodoWebDistFiles Include="$(TodoWebDistDir)\**\*" /> + <_MauiWwwrootFiles Include="$(MSBuildProjectDirectory)\wwwroot\**\*" /> - - - - + + + wwwroot/%(RecursiveDir)%(Filename)%(Extension) + + @@ -189,3 +196,7 @@ + + + + diff --git a/src/Hua.Todo.Maui/icon.jpg b/src/Hua.Todo.Maui/Resources/Images/icon.jpg similarity index 100% rename from src/Hua.Todo.Maui/icon.jpg rename to src/Hua.Todo.Maui/Resources/Images/icon.jpg diff --git a/src/Hua.Todo.Maui/appsettings.json b/src/Hua.Todo.Maui/appsettings.json index bac8595..842ac5f 100644 --- a/src/Hua.Todo.Maui/appsettings.json +++ b/src/Hua.Todo.Maui/appsettings.json @@ -1,7 +1,7 @@ { "WebServer": { "Port": 5057, - "IsUsingStatic": true, + "IsUsingStatic": false, "ConnectionString": "", "HostUrl": "http://localhost:5057", "ForEndUrl": "http://localhost:5174" diff --git a/src/Hua.Todo.Maui/setup.iss b/src/Hua.Todo.Maui/setup.iss index 35e0e26..9d58c2c 100644 --- a/src/Hua.Todo.Maui/setup.iss +++ b/src/Hua.Todo.Maui/setup.iss @@ -1,8 +1,8 @@ #define MyAppName "Hua.Todo" -#define MyAppVersion "1.1.4" +#define MyAppVersion "1.1.8" #define MyAppPublisher "ShaoHua" #define MyAppURL "https://git.we965.cn/Tools/Hua.Todo" -#define MyAppExeName "Hua.Todo.exe" +#define MyAppExeName "Hua.Todo.Maui.exe" [Setup] ; 1. 改用更快压缩（优先速度） diff --git a/src/Hua.Todo.Web/package.json b/src/Hua.Todo.Web/package.json index ee5dd60..b26c4bf 100644 --- a/src/Hua.Todo.Web/package.json +++ b/src/Hua.Todo.Web/package.json @@ -1,5 +1,5 @@ { - "name": "Hua.Todo-web", + "name": "Hua.Todo-Web", "private": true, "version": "0.0.0", "license": "AGPL-3.0", @@ -7,6 +7,7 @@ "scripts": { "dev": "vite", "build": "vue-tsc -b && vite build", + "build:maui": "vue-tsc -b && vite build --mode maui", "preview": "vite preview" }, "dependencies": { diff --git a/src/Hua.Todo.Web/src/App.vue b/src/Hua.Todo.Web/src/App.vue index a418d51..3b0654e 100644 --- a/src/Hua.Todo.Web/src/App.vue +++ b/src/Hua.Todo.Web/src/App.vue @@ -2,6 +2,7 @@ import { ref, onMounted } from 'vue'; import TaskList from './components/TaskList.vue'; import HotKeySettingsDialog from './components/HotKeySettingsDialog.vue'; +import CloudSyncSettingsDialog from './components/CloudSyncSettingsDialog.vue'; const toastMessage = ref(''); const toastType = ref<'error' | 'success'>('error'); @@ -26,6 +27,7 @@ onMounted(() => {
+ diff --git a/src/Hua.Todo.Web/src/api/cloudClient.ts b/src/Hua.Todo.Web/src/api/cloudClient.ts new file mode 100644 index 0000000..684e854 --- /dev/null +++ b/src/Hua.Todo.Web/src/api/cloudClient.ts @@ -0,0 +1,69 @@ +import axios from 'axios'; +import CloudSyncStorage from '../services/cloudSyncStorage'; + +const showNotification = (message: string, type: 'error' | 'success' = 'error') => { + if ((window as any).showToast) { + (window as any).showToast(message, type); + } else { + window.alert(message); + } +}; + +/** + * 云同步专用 HTTP Client。 + * + * 注意：本项目现有 `client.ts` 的 baseURL 固定为 `window.__API_BASE_URL__`（通常已包含 `/api`）， + * 但云同步服务端端点位于根路径（`/auth/*`、`/tasks/*` 等）。 + * 因此云同步需要独立的 baseURL（用户配置的服务端地址）。 + */ +const cloudClient = axios.create({ + timeout: 10000, + headers: { + 'Content-Type': 'application/json', + }, +}); + +cloudClient.interceptors.request.use((config) => { + const { serverUrl } = CloudSyncStorage.loadSettings(); + if (serverUrl) { + config.baseURL = serverUrl; + } + + const session = CloudSyncStorage.loadSession(); + if (session?.accessToken) { + config.headers = config.headers ?? {}; + (config.headers as any).Authorization = `Bearer ${session.accessToken}`; + } + + return config; +}); + +cloudClient.interceptors.response.use( + (response) => response, + (error) => { + let errorMessage = '网络错误，请稍后再试'; + + if (error?.response?.data) { + const data = error.response.data; + if (typeof data === 'string' && data.trim()) { + errorMessage = data; + } else if (data && typeof data === 'object') { + const message = (data.message ?? data.Message) as unknown; + const errors = (data.errors ?? data.Errors) as unknown; + + if (Array.isArray(errors) && errors.length > 0) { + errorMessage = errors.join('\n'); + } else if (typeof message === 'string' && message.trim()) { + errorMessage = message; + } + } + } else if (typeof error?.message === 'string' && error.message.trim()) { + errorMessage = error.message; + } + + showNotification(errorMessage, 'error'); + return Promise.reject(error); + } +); + +export default cloudClient; diff --git a/src/Hua.Todo.Web/src/api/cloudSync.ts b/src/Hua.Todo.Web/src/api/cloudSync.ts new file mode 100644 index 0000000..668bef4 --- /dev/null +++ b/src/Hua.Todo.Web/src/api/cloudSync.ts @@ -0,0 +1,98 @@ +import cloudClient from './cloudClient'; +import CloudSyncStorage from '../services/cloudSyncStorage'; +import type { Task } from '../types/task'; + +export interface CloudLoginRequest { + userName: string; + password: string; +} + +export interface CloudLoginResponse { + accessToken: string; + expiresAtUtc: string; + userId: string; + role: string; + permissions: string[]; +} + +export interface CloudTaskItem { + id: number; + title: string; + priority: 0 | 1 | 2; + isCompleted: boolean; + createdAtUtc: string; + updatedAtUtc: string; + parentTaskId?: number | null; +} + +/** + * 把 CloudSync 的扁平任务列表（ParentTaskId）组装成前端需要的树结构（subTasks）。 + */ +export const buildTaskTreeFromCloudItems = (items: CloudTaskItem[]): Task[] => { + const map = new Map(); + for (const item of items) { + map.set(item.id, { + id: item.id, + title: item.title ?? '', + priority: item.priority ?? 1, + isCompleted: Boolean(item.isCompleted), + createdAt: item.createdAtUtc, + updatedAt: item.updatedAtUtc, + parentTaskId: item.parentTaskId ?? undefined, + subTasks: [], + }); + } + + const roots: Task[] = []; + for (const task of map.values()) { + const parentId = task.parentTaskId; + if (typeof parentId === 'number' && map.has(parentId)) { + map.get(parentId)!.subTasks.push(task); + } else { + roots.push(task); + } + } + + return roots; +}; + +/** + * 云同步 API（v1.2.0 最小闭环：登录 + 拉取任务）。 + */ +export const cloudSyncApi = { + /** + * 登录云同步服务端并保存会话（默认存入 sessionStorage）。 + */ + async login(request: CloudLoginRequest): Promise { + const response = await cloudClient.post('/auth/login', request); + const session = response.data; + + CloudSyncStorage.saveSession({ + accessToken: session.accessToken, + expiresAtUtc: session.expiresAtUtc, + userId: session.userId, + role: session.role, + permissions: Array.isArray(session.permissions) ? session.permissions : [], + }); + + return session; + }, + + /** + * 清空云同步会话（登出）。 + */ + logout(): void { + CloudSyncStorage.clearSession(); + }, + + /** + * 获取云端任务全量，并转换为前端树结构。 + */ + async getTasks(): Promise { + const response = await cloudClient.get('/tasks/'); + const items = Array.isArray(response.data) ? response.data : []; + return buildTaskTreeFromCloudItems(items); + }, +}; + +export default cloudSyncApi; diff --git a/src/Hua.Todo.Web/src/components/CloudSyncSettingsDialog.vue b/src/Hua.Todo.Web/src/components/CloudSyncSettingsDialog.vue new file mode 100644 index 0000000..59a54e6 --- /dev/null +++ b/src/Hua.Todo.Web/src/components/CloudSyncSettingsDialog.vue @@ -0,0 +1,534 @@ + + + + + diff --git a/src/Hua.Todo.Web/src/components/TaskItem.vue b/src/Hua.Todo.Web/src/components/TaskItem.vue index 98b1f16..6533457 100644 --- a/src/Hua.Todo.Web/src/components/TaskItem.vue +++ b/src/Hua.Todo.Web/src/components/TaskItem.vue @@ -4,13 +4,14 @@ -
- -