Hua.Todo/docs/manual/技术栈与模块.md

技术栈与模块说明

🛠️ 技术栈

后端技术栈

• 开发语言：C# 13 (基于 .NET 10)
• 框架：.NET 10 (Preview/Early Adopter)
• UI 框架：MAUI（移动端/部分桌面） + Avalonia（桌面端）
• Web 服务器：Kestrel (ASP.NET Core 内置)
• API 框架：ASP.NET Core Web API (支持动态 API 生成)
• 数据访问：Entity Framework Core 10.0
• 数据库：SQLite (本地存储)
• 依赖注入：Microsoft.Extensions.DependencyInjection

前端技术栈

• 开发语言：TypeScript 5+
• 框架：Vue.js 3
• 构建工具：Vite 5+
• HTTP 客户端：Axios
• 状态管理：Pinia
• UI 组件库：Element Plus / Vant (移动端)
• CSS 预处理器：SCSS

🎯 核心模块说明

Hua.Todo.Core

领域实体层，定义核心实体（TaskEntity）、安全策略实体（SecurityPolicyEntity）、枚举（TaskPriority）以及仓储接口（ITaskRepository）。

Hua.Todo.Application

应用层实现，包含：

• 业务逻辑：TaskService 实现。
• 动态 API：基于 Middleware 的动态 API 生成逻辑。
• 云同步 (CloudSync)：包含 Auth 验证、同步服务、安全策略管理等。
• 数据访问：EF Core 数据库上下文（TodoDbContext）与迁移。

Hua.Todo.Host

后端 API 宿主，作为独立 Server 运行时提供运行环境和配置。

Hua.Todo.Web

前端 Web 项目，基于 Vue.js 3 + TypeScript + Vite，提供用户界面，通过 HTTP API 与后端通信。

Hua.Todo.Maui

跨平台客户端项目，将 Web 内容嵌入到原生容器中，支持 Windows、Android、iOS 和 macOS。

Hua.Todo.Avalonia

桌面客户端项目（Avalonia + WebView），用于提供 Linux/Windows/macOS 桌面形态；同样通过嵌入式 WebServer + WebView 承载前端 UI。