Cursor rule

1---
2description: CodeSpirit 命名约定规范 - 实体、DTO、服务、控制器等命名规则
3globs: *.cs
4alwaysApply: false
5---
6 
7# 实体类 (Entity)
8- 命名格式：`{EntityName}` (如 `User`, `Question`)
9- 继承：`AuditableEntityBase<TKey>` 或 `EntityBase<TKey>`
10- 多租户：需租户隔离的实体必须实现 `IMultiTenant` 接口
11 
12# DTO 类
13- **创建**: `Create{EntityName}Dto` (如 `CreateUserDto`)
14- **更新**: `Update{EntityName}Dto` (如 `UpdateUserDto`)
15- **查询**: `{EntityName}Dto` 或 `{EntityName}QueryDto`
16- **列表项**: `{EntityName}ListItemDto`
17- **批量导入**: `{EntityName}BatchImportItemDto`
18 
19# 服务类
20- **业务服务**: `{EntityName}Service` (如 `UserService`)
21- **接口**: `I{EntityName}Service`
22- **查询服务**: `{EntityName}QueryService`
23- **基础 CRUD**: 继承 `BaseCRUDService<TEntity, TKey, TCreateDto, TUpdateDto, TQueryDto>`
24- **生命周期标记**: 实现 `IScopedDependency` / `ITransientDependency` / `ISingletonDependency`
25 
26示例：
27```csharp
28public interface IUserService : IBaseCRUDService<User, long, CreateUserDto, UpdateUserDto, UserQueryDto>
29{
30}
31 
32public class UserService : BaseCRUDService<User, long, CreateUserDto, UpdateUserDto, UserQueryDto>, 
33    IUserService, IScopedDependency
34{
35}
36```
37 
38# 控制器
39- 命名：`{EntityName}Controller` (如 `UsersController`)，使用复数形式
40- 路由：`[Route("/[service]/api/[controller]")]` 或具体路由如 `[Route("/exam/api/Questions")]`
41- 继承：项目中的 `ApiControllerBase`
42 
43# 配置类
44- API配置：`{ApiName}Configuration` (如 `ExamApiConfiguration`)
45- 实体配置：`{EntityName}Configuration` (如 `UserConfiguration`)
46- 位置：`Configuration` 文件夹
47 
48# 资源文件
49- **共享资源**: `SharedResources`, `SharedResources.resx`
50- **显示资源**: `DisplayResources`, `Display.resx`
51- **验证资源**: `ValidationResources`, `Validation.resx`
52- **服务特定**: `{Service}DisplayResources`, `{Service}Display.resx`
53- **多语言**: `*.en.resx` (英文), `*.zh-CN.resx` (中文)
54 
55# 常量
56- 类名：`{Module}Constants` (如 `AuthConstants`)
57- 字段：全大写，下划线分隔 (如 `MAX_LOGIN_ATTEMPTS`)
58 
59# 事件
60- 命名：`{EntityName}{Action}Event` (如 `UserCreatedEvent`, `OrderCancelledEvent`)
61- 租户感知：继承 `TenantAwareEventBase`
62