Cursor是越来越难用了！逼着我写mdc文档比代码还多

---
description: TypeScript项目规范
globs: *.ts, *.tsx
---

# TypeScript编码规范
- 使用严格模式（strict: true）
- 优先使用函数组件而非类组件
- 代码中必须包含完整类型注解

---
description: 企业级TypeScript全栈应用架构规范
globs: *.ts, *.tsx
priority: 10
---

# TypeScript全栈架构规范

## 核心架构原则
- 采用**六边形架构**（Hexagonal Architecture）设计模式
- 领域逻辑与框架、UI、数据库等基础设施隔离
- 依赖关系必须指向领域核心，禁止反向依赖
- 接口定义在领域层，实现在基础设施层

## 类型系统规范
- 禁止使用`any`类型，必须使用`unknown`作为未知类型的默认选择
- 对所有函数参数和返回值进行显式类型注解
- 对于复杂对象，使用以下模式定义类型：
```typescript
// 领域实体基础类型
type UserProperties = {
id: string;
email: string;
firstName: string;
lastName: string;
role: UserRole;
createdAt: Date;
updatedAt: Date;
};

// 实体类
export class User {
private props: UserProperties;

private constructor(props: UserProperties) {
this.props = props;
}

// 工厂方法
public static create(props: Omit<UserProperties, 'id' | 'createdAt' | 'updatedAt'>): Result<User> {
// 验证逻辑...
return Result.ok(new User({
...props,
id: UUID.generate(),
createdAt: new Date(),
updatedAt: new Date()
}));
}

// 访问器方法
get id(): string { return this.props.id; }
get email(): string { return this.props.email; }
// ...其他访问器
}

### 微服务架构设计规范

---
description: 微服务架构设计规范与最佳实践
globs: *.{ts,js,go,py}
priority: 20
---

# 微服务架构设计规范

## 架构总体原则
- 采用**Domain-Driven Design (DDD)**思想设计微服务边界
- 每个微服务应满足"单一职责"原则
- 服务间通信优先考虑异步事件驱动模式
- 遵循API优先设计原则，先定义接口再实现

## 服务间通信规范
### 同步通信
- REST API必须遵循以下规范：
- 使用HAL（Hypertext Application Language）表示资源关系
- 统一错误响应格式：
```json
{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "请求的资源不存在",
"details": {
"resource_id": "12345",
"resource_type": "user"
},
"trace_id": "abcd1234-5678-efgh-ijkl-mnopqrstuvwx",
"timestamp": "2025-03-28T12:34:56Z"
}
}
```
- API版本控制策略：Accept header中指定版本，例如`Accept: application/vnd.company.api+json;version=1`

### 异步通信
- 事件结构规范：
```json
{
"id": "uuid-v4-format",
"type": "user.created",
"version": "1.0",
"source": "user-service",
"time": "2025-03-28T12:34:56Z",
"dataContentType": "application/json",
"data": {
// 事件具体数据
},
"correlationId": "related-request-id",
"subject": "users"
}