Cursor rule

1---
2description: CodeSpirit 项目结构详细说明 - 完整的项目目录树和组件分类
3globs: 
4alwaysApply: false
5---
6 
7# CodeSpirit 项目结构
8 
9## 完整目录树
10 
11```
12Src/
13├── ApiServices/                                        # API服务层
14│   ├── CodeSpirit.AiCardsApi/                         # AI卡片API服务
15│   ├── CodeSpirit.ApprovalApi/                        # 审批工作流API服务
16│   ├── CodeSpirit.ConfigCenter/                       # 配置中心API
17│   ├── CodeSpirit.ContentApi/                         # 内容管理API
18│   ├── CodeSpirit.DigitalPartner.Plugins.ExamAnalyst/ # 考试分析插件（AI伙伴工具）
19│   ├── CodeSpirit.ExamApi/                            # 考试系统API
20│   ├── CodeSpirit.FileStorageApi/                     # 文件存储API
21│   ├── CodeSpirit.IdentityApi/                        # 身份认证API
22│   ├── CodeSpirit.MallApi/                            # 商城API
23│   ├── CodeSpirit.MessagingApi/                       # 消息服务API
24│   ├── CodeSpirit.PartnerApi/                         # 伙伴API（AI助手前端）
25│   ├── CodeSpirit.PathfinderAgent/                    # Pathfinder代理（AI目标管理代理）
26│   ├── CodeSpirit.PathfinderApi/                      # Pathfinder API（AI目标管理）
27│   └── CodeSpirit.SurveyApi/                          # 问卷调查API
28├── Components/                                         # 独立组件库
29│   ├── CodeSpirit.Aggregator/                         # 数据聚合器组件
30│   ├── CodeSpirit.AiFormFill/                         # AI表单智能填充组件
31│   ├── CodeSpirit.Amis/                               # AMIS界面生成引擎
32│   ├── CodeSpirit.Audit/                              # 审计追踪组件（含LLM审计）
33│   ├── CodeSpirit.Authorization/                      # 权限管理组件（RBAC+ABAC）
34│   ├── CodeSpirit.Caching/                            # 分布式缓存组件（多级缓存+分布式锁）
35│   ├── CodeSpirit.Charts/                             # 智能图表组件
36│   ├── CodeSpirit.ConfigCenter.Client/                # 配置中心客户端
37│   ├── CodeSpirit.LLM/                                # 大语言模型集成组件
38│   ├── CodeSpirit.Localization/                       # 多语言本地化组件
39│   ├── CodeSpirit.Messaging/                          # 消息队列组件
40│   ├── CodeSpirit.MultiTenant/                        # 多租户组件
41│   ├── CodeSpirit.Navigation/                         # 导航组件
42│   ├── CodeSpirit.OData/                              # OData查询组件
43│   ├── CodeSpirit.PartnerSdk/                         # 伙伴SDK（AI助手工具SDK）
44│   ├── CodeSpirit.PathfinderTools/                    # Pathfinder工具库
45│   ├── CodeSpirit.PdfGeneration/                      # PDF生成组件
46│   ├── CodeSpirit.ScheduledTasks/                     # 定时任务组件（分布式调度）
47│   ├── CodeSpirit.Settings/                           # 设置管理组件
48│   ├── CodeSpirit.Shared/                             # 组件共享库
49│   ├── CodeSpirit.UdlCards/                           # UDL卡片组件
50│   └── CodeSpirit.VectorSearch/                       # 向量搜索组件（AI语义搜索）
51├── CodeSpirit.AppHost/                                 # Aspire应用宿主（启动项目）
52├── CodeSpirit.Core/                                    # 核心框架定义
53├── CodeSpirit.ServiceDefaults/                         # 服务默认配置
54├── CodeSpirit.Shared/                                  # 全局共享库
55└── CodeSpirit.Web/                                     # Web前端项目
56```
57 
58## 项目分类说明
59 
60### API服务层 (14个服务)
61 
62**注意**: 项目数量可能随开发进度变化，此处列出当前主要服务。
63 
64#### 核心业务系统
65- **IdentityApi**: JWT认证、用户管理、角色权限、部门组织
66- **ExamApi**: 题库管理、考试系统、阅卷、统计分析
67- **SurveyApi**: 问卷设计、数据收集、统计分析
68- **ApprovalApi**: 审批流程、表单流转、工作流引擎
69 
70#### AI 增强系统
71- **AiCardsApi**: AI卡片、智能生成
72- **PartnerApi**: AI伙伴对话前端
73- **DigitalPartner.Plugins.ExamAnalyst**: 考试分析AI插件
74- **PathfinderApi**: AI驱动的目标管理系统
75- **PathfinderAgent**: Pathfinder智能代理
76 
77#### 基础设施服务
78- **ConfigCenter**: 配置中心、动态配置管理
79- **FileStorageApi**: 文件存储、引用计数、生命周期管理
80- **MessagingApi**: 消息服务、通知推送
81- **ContentApi**: 内容管理
82- **MallApi**: 商城系统
83 
84### 核心组件库 (多个组件)
85 
86**注意**: 组件数量可能随开发进度变化，此处列出主要组件。
87 
88#### 界面生成
89- **Amis**: 零前端代码CRUD界面生成引擎
90- **UdlCards**: UDL卡片组件库
91- **Navigation**: 智能导航组件
92 
93#### AI 集成
94- **LLM**: 大语言模型统一接口（OpenAI、通义千问、DeepSeek）
95- **AiFormFill**: AI表单智能填充组件
96- **VectorSearch**: 向量搜索、AI语义搜索
97- **PartnerSdk**: AI助手工具开发SDK
98- **PathfinderTools**: Pathfinder工具库
99 
100#### 权限审计
101- **Authorization**: RBAC+ABAC混合权限模型
102- **Audit**: 审计追踪组件（含LLM审计）
103 
104#### 多租户
105- **MultiTenant**: 多租户数据隔离
106- **Localization**: 多语言本地化
107 
108#### 性能优化
109- **Caching**: 多级缓存（L1内存+L2Redis）、分布式锁
110- **ScheduledTasks**: 分布式定时任务调度
111 
112#### 数据处理
113- **Aggregator**: 数据聚合器、字段替换
114- **Charts**: 智能图表、可视化
115- **OData**: OData查询支持
116 
117#### 基础设施
118- **Settings**: 设置管理组件
119- **PdfGeneration**: PDF生成服务
120- **ConfigCenter.Client**: 配置中心客户端
121- **Messaging**: 消息队列、事件总线
122- **Shared**: 组件共享库
123 
124## 典型API项目结构
125 
126```
127CodeSpirit.ExamApi/
128├── Configuration/              # API配置类
129│   └── ExamApiConfiguration.cs
130├── Controllers/                # API控制器
131│   ├── QuestionsController.cs
132│   └── ExamsController.cs
133├── Data/                       # 数据访问层
134│   ├── ExamDbContext.cs
135│   ├── MySqlExamDbContext.cs
136│   ├── SqlServerExamDbContext.cs
137│   └── Configurations/         # 实体配置
138├── Dtos/                       # 数据传输对象
139│   ├── Question/
140│   │   ├── CreateQuestionDto.cs
141│   │   ├── UpdateQuestionDto.cs
142│   │   └── QuestionDto.cs
143│   └── Exam/
144├── Services/                   # 业务服务
145│   ├── IQuestionService.cs
146│   └── QuestionService.cs
147├── MappingProfiles/            # AutoMapper配置
148├── Resources/                  # 多语言资源
149│   ├── ExamDisplayResources.cs
150│   ├── ExamDisplay.resx
151│   └── ExamDisplay.en.resx
152├── Migrations/                 # 数据库迁移
153│   ├── MySql/
154│   └── SqlServer/
155└── Program.cs                  # 启动文件（仅2行代码）
156```
157 
158## 开发流程
159 
160### 新建 API 服务
1611. 创建项目并引用 `CodeSpirit.Shared`
1622. 创建 `Configuration/{ApiName}Configuration.cs` 继承 `BaseApiConfiguration`
1633. `Program.cs` 中使用统一启动框架（2行代码）
1644. 创建 DbContext、实体、配置
1655. 创建迁移（MySql 和 SqlServer）
166 
167### 开发 CRUD 功能
1681. 定义实体（Entity）
1692. 创建 DTO（Create/Update/Query/List）
1703. 实现服务（Service）继承 `BaseCRUDService`
1714. 创建控制器（Controller）继承 `ApiControllerBase`
1725. 添加 AutoMapper 配置
1736. 前端自动生成（零前端代码）
174 
175### 添加多语言
1761. 在 `Resources/` 创建资源文件
1772. DTO 使用 `[Display(ResourceType = typeof(...))]`
1783. 验证使用 `ErrorMessageResourceType`
1794. 异常使用资源键 `throw new BusinessException("Errors.NotFound")`
180 
181## 技术栈对应
182 
183| 功能 | 技术选型 | 对应组件 |
184|------|---------|---------|
185| API开发 | .NET 10 + Aspire | ServiceDefaults, Core |
186| 数据访问 | EF Core 9 | Shared (BaseCRUDService) |
187| 数据库 | MySQL/SQL Server | 多数据库迁移支持 |
188| 缓存 | Redis | Caching 组件 |
189| 消息队列 | RabbitMQ | Messaging 组件 |
190| 权限 | RBAC+ABAC | Authorization 组件 |
191| 审计 | Elasticsearch/GreptimeDB | Audit 组件 |
192| 多租户 | 数据隔离 | MultiTenant 组件 |
193| 多语言 | Resx资源文件 | Localization 组件 |
194| 前端生成 | AMIS | Amis 组件 |
195| AI集成 | OpenAI/通义千问/DeepSeek | LLM, AiFormFill 组件 |
196| 定时任务 | 分布式调度 | ScheduledTasks 组件 |
197 
198## 参考文档
199 
200详细的开发指南请参考：
201- [命名约定规范](mdc:.cursor/rules/naming-conventions.mdc)
202- [API设计规范](mdc:.cursor/rules/api-design.mdc)
203- [统一启动框架](mdc:.cursor/rules/startup-framework.mdc)
204- [依赖注入规范](mdc:.cursor/rules/dependency-injection.mdc)
205