ShaoHua
14868c45c7
1. 重构用户与任务实体：UserEntity实现IUser<Guid>，TaskEntity继承ABP风格FullAuditedEntityWithUser，主键从int改为Guid 2. 新增云同步代理系统：嵌入式WebServer支持CloudSyncProxy转发云同步请求，新增配置API与持久化 3. 完善前端适配：新增Guid工具函数，更新任务类型定义与API交互逻辑，调整云同步设置弹窗适配本地代理 4. 文档与配置优化：更新文档结构，新增部署文档、版本记录，统一各项目配置项 5. 补充测试与迁移：新增单元测试，更新EF Core数据库迁移快照
47 lines
1.8 KiB
Markdown
47 lines
1.8 KiB
Markdown
# 技术栈与模块说明
|
||
|
||
## 🛠️ 技术栈
|
||
|
||
### 后端技术栈
|
||
- **开发语言**：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。
|