Initial commit: Takt SMEs Platform

Author: Takt365

.cursor/rules/architecture.mdc

@@ -0,0 +1,76 @@
+---
+alwaysApply: true
+---
+
+# 架构规范
+
+## 分层架构原则
+
+项目采用 Clean Architecture（清洁架构），依赖方向只能向下：
+
+```
+Fluent (表现层) -> Application (应用层) -> Domain (领域层) -> Infrastructure (基础设施层) -> Common (通用层)
+```
+
+**项目命名空间前缀**：`Takt.*`
+
+**文件位置**：
+- 表现层：@src/Takt.Fluent/
+- 应用层：@src/Takt.Application/
+- 领域层：@src/Takt.Domain/
+- 基础设施层：@src/Takt.Infrastructure/
+- 通用层：@src/Takt.Common/
+
+## 各层职责
+
+### Takt.Fluent (表现层)
+- **职责**: UI展示、用户交互、视图逻辑
+- **包含**: Views, ViewModels, UI Services, Helpers, Models
+- **示例**: @src/Takt.Fluent/Views/MainWindow.xaml, @src/Takt.Fluent/ViewModels/MainWindowViewModel.cs
+
+### Takt.Application (应用层)
+- **职责**: 业务逻辑编排、应用服务
+- **包含**: Services, DTOs, Mappers
+- **示例**: @src/Takt.Application/Services/
+
+### Takt.Domain (领域层)
+- **职责**: 领域模型、业务规则
+- **包含**: Entities, Repository Interfaces
+- **示例**: @src/Takt.Domain/Entities/
+
+### Takt.Infrastructure (基础设施层)
+- **职责**: 数据访问、外部服务集成
+- **包含**: Data Access, Repository Implementation
+- **示例**: @src/Takt.Infrastructure/Data/
+
+### Takt.Common (通用层)
+- **职责**: 共享组件、工具类
+- **包含**: Logging, Helpers, Results
+- **示例**: @src/Takt.Common/Logging/
+
+## 禁止事项
+
+- ❌ 表现层不能直接调用基础设施层
+- ❌ 不能跨层调用
+- ❌ 不能违反依赖方向
+
+## 代码示例
+
+```csharp
+// ✅ 正确：ViewModel 调用应用层服务
+public class UserViewModel : ViewModelBase
+{
+    private readonly IHbtUserService _userService;  // 应用层接口
+    
+    public UserViewModel(IHbtUserService userService)
+    {
+        _userService = userService;
+    }
+}
+
+// ❌ 错误：ViewModel 直接调用基础设施层
+public class UserViewModel : ViewModelBase
+{
+    private readonly IUserRepository _repository;  // ❌ 基础设施层
+}
+```

.cursor/rules/async.mdc

@@ -0,0 +1,65 @@
+---
+alwaysApply: true
+---
+
+# 异步编程规范
+
+## 异步方法命名
+
+**强制要求**：异步方法必须以 `Async` 结尾
+
+```csharp
+// ✅ 正确
+public async Task<List<UserDto>> GetUsersAsync() { }
+public async Task<UserDto> GetUserByIdAsync(int id) { }
+
+// ❌ 错误
+public async Task<List<UserDto>> GetUsers() { }  // 缺少 Async 后缀
+```
+
+**示例文件**：
+- @src/Takt.Application/Services/（查看实际异步方法）
+
+## 异步调用规范
+
+**禁止使用 `.Result` 或 `.Wait()`**：
+
+```csharp
+// ✅ 正确：使用 async/await
+private async Task LoadUsersAsync()
+{
+    var result = await _userService.GetListAsync();
+    if (result.Success)
+    {
+        Users = new ObservableCollection<UserDto>(result.Data);
+    }
+}
+
+// ❌ 错误：使用 .Result 或 .Wait()
+private void LoadUsers()
+{
+    var result = _userService.GetListAsync().Result;  // ❌ 死锁风险
+    _userService.GetListAsync().Wait();  // ❌ 死锁风险
+}
+```
+
+## UI 线程操作
+
+**规范**：在后台线程执行，回到 UI 线程更新
+
+```csharp
+// ✅ 正确
+private async Task LoadUsersAsync()
+{
+    var users = await _userService.GetListAsync();  // 后台线程
+    
+    // 自动回到 UI 线程（如果 ViewModel 在 UI 线程创建）
+    Users = new ObservableCollection<UserDto>(users);
+    
+    // 或者显式调度到 UI 线程
+    Application.Current.Dispatcher.Invoke(() =>
+    {
+        Users = new ObservableCollection<UserDto>(users);
+    });
+}
+```

.cursor/rules/context.mdc

@@ -0,0 +1,74 @@
+---
+alwaysApply: true
+---
+
+# 上下文管理规范
+
+## 上下文分类
+
+**必须提供的信息**：
+
+1. **代码上下文**（必须）：
+```markdown
+**相关代码**：
+- @src/Takt.Fluent/Views/MainWindow.xaml
+- @src/Takt.Fluent/Models/AvalonDocument.cs:114
+```
+
+2. **架构上下文**（必须）：
+```markdown
+**架构上下文**：
+- 分层架构：Fluent -> Application -> Domain -> Infrastructure
+- MVVM 模式：View -> ViewModel -> Service -> Repository
+```
+
+3. **当前状态**（必须）：
+```markdown
+**当前状态**：
+- 已完成：图标转换逻辑已实现，IconSource 已正确设置
+- 存在问题：图标在 UI 中不显示
+- 已验证：日志显示 IconSource=RenderTargetBitmap, 16x16
+```
+
+## 文件引用规范
+
+**引用格式**：
+
+- 完整文件：`@src/Takt.Fluent/Views/MainWindow.xaml`
+- 特定行：`@src/Takt.Fluent/Models/AvalonDocument.cs:114`
+- 行范围：`@src/Takt.Fluent/Models/AvalonDocument.cs:60-138`
+- 多文件：
+```markdown
+**相关文件**：
+- @src/Takt.Fluent/Views/MainWindow.xaml（DockingManager 配置）
+- @src/Takt.Fluent/Models/AvalonDocument.cs（图标转换逻辑）
+```
+
+## 上下文完整性检查
+
+**必须检查项**：
+
+- [ ] 是否提供了项目名称、技术栈、架构模式？
+- [ ] 是否提供了所有相关文件的路径（使用 @ 符号）？
+- [ ] 是否说明了模块间的依赖关系？
+- [ ] 是否说明了当前实现状态和问题？
+- [ ] 是否提供了相关的日志输出？
+- [ ] 是否提供了可重现的测试步骤？
+
+## 上下文更新规范
+
+**更新时机**：
+
+1. **代码变更后**（必须更新）：
+```markdown
+**上下文更新**：
+- 更新原因：代码已修改，需要重新分析
+- 更新内容：@src/Takt.Fluent/Models/AvalonDocument.cs:114（已修改）
+```
+
+2. **问题状态变化**（必须更新）：
+```markdown
+**问题状态更新**：
+- 之前状态：图标不显示
+- 当前状态：图标已显示，但位置不正确
+```

.cursor/rules/dependency-injection.mdc

@@ -0,0 +1,65 @@
+---
+alwaysApply: true
+---
+
+# 依赖注入规范
+
+## 服务注册
+
+**文件位置**：@src/Takt.Fluent/App.xaml.cs
+
+**示例**：
+```csharp
+// @src/Takt.Fluent/App.xaml.cs
+public partial class App : Application
+{
+    public static IServiceProvider? Services { get; private set; }
+    
+    protected override void OnStartup(StartupEventArgs e)
+    {
+        var services = new ServiceCollection();
+        
+        // 注册服务
+        services.AddScoped<ITaktUserService, TaktUserService>();
+        services.AddTransient<UserViewModel>();
+        services.AddTransient<UserView>();
+        
+        Services = services.BuildServiceProvider();
+    }
+}
+```
+
+## 构造函数注入
+
+**规范**：必须通过构造函数注入，禁止使用 ServiceLocator
+
+```csharp
+// ✅ 正确：通过构造函数注入
+// @src/Takt.Fluent/ViewModels/Identity/UserViewModel.cs
+public class UserViewModel : ViewModelBase
+{
+    private readonly ITaktUserService _userService;
+    
+    public UserViewModel(ITaktUserService userService)
+    {
+        _userService = userService ?? throw new ArgumentNullException(nameof(userService));
+    }
+}
+
+// ❌ 错误：使用 ServiceLocator 反模式
+public class UserViewModel : ViewModelBase
+{
+    private readonly ITaktUserService _userService;
+    
+    public UserViewModel()
+    {
+        _userService = App.Services.GetService<ITaktUserService>();  // ❌ 反模式
+    }
+}
+```
+
+## 服务生命周期
+
+- `Singleton`：整个应用生命周期单例（如配置服务）
+- `Scoped`：每个请求/窗口一个实例（如业务服务）
+- `Transient`：每次获取都创建新实例（如 ViewModel、View）

.cursor/rules/mvvm.mdc

@@ -0,0 +1,100 @@
+---
+alwaysApply: true
+---
+
+# MVVM 模式规范
+
+## View（视图层）
+
+**职责**：仅负责 UI 展示和用户交互，不包含业务逻辑
+
+**文件位置**：@src/Takt.Fluent/Views/
+
+**示例**：
+```xml
+<!-- ✅ 正确：View 只负责 UI -->
+<!-- @src/Takt.Fluent/Views/Identity/UserView.xaml -->
+<UserControl x:Class="Takt.Fluent.Views.Identity.UserView">
+    <DataGrid ItemsSource="{Binding Users}" 
+              SelectedItem="{Binding SelectedUser, Mode=TwoWay}"/>
+</UserControl>
+```
+
+```csharp
+// ❌ 错误：View 中包含业务逻辑
+// @src/Takt.Fluent/Views/Identity/UserView.xaml.cs
+private void DataGrid_SelectionChanged(object sender, SelectionChangedEventArgs e)
+{
+    // ❌ 不要在 View 中直接调用服务
+    var service = App.Services.GetService<IUserService>();
+    service.GetUsersAsync();
+}
+```
+
+## ViewModel（视图模型层）
+
+**职责**：管理 View 的状态和数据，处理用户交互命令
+
+**文件位置**：@src/Takt.Fluent/ViewModels/
+
+**示例**：
+```csharp
+// ✅ 正确：ViewModel 继承 ViewModelBase
+// @src/Takt.Fluent/ViewModels/Identity/UserViewModel.cs
+public class UserViewModel : ViewModelBase
+{
+    private readonly IHbtUserService _userService;
+    private ObservableCollection<UserDto> _users = new();
+    
+    public ObservableCollection<UserDto> Users
+    {
+        get => _users;
+        set => SetProperty(ref _users, value);
+    }
+    
+    public ICommand LoadUsersCommand { get; }
+    
+    public UserViewModel(IHbtUserService userService)
+    {
+        _userService = userService;
+        LoadUsersCommand = new RelayCommand(async () => await LoadUsersAsync());
+    }
+    
+    private async Task LoadUsersAsync()
+    {
+        var result = await _userService.GetListAsync();
+        if (result.Success)
+        {
+            Users = new ObservableCollection<UserDto>(result.Data);
+        }
+    }
+}
+```
+
+**关键要求**：
+- ✅ 必须通过构造函数注入依赖服务
+- ✅ 使用 `SetProperty` 方法更新属性以触发通知
+- ✅ 所有异步操作使用 `async/await`
+- ✅ 命令使用 `ICommand` 接口
+
+## Model（模型层）
+
+**职责**：定义数据模型（Entity、DTO）
+
+**文件位置**：
+- Entity：@src/Takt.Domain/Entities/
+- DTO：@src/Takt.Application/Dtos/
+
+**示例**：
+```csharp
+// ✅ 正确：Entity 定义
+// @src/Takt.Domain/Entities/Identity/User.cs
+public class User : EntityBase
+{
+    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
+    public int Id { get; set; }
+    
+    [SugarColumn(Length = 50)]
+    public string UserName { get; set; } = string.Empty;
+}
+```