---
description: 后端特定的开发规范（仅作用于 backend 目录）
globs:
alwaysApply: true
---

# 后端特定规范

本规则仅作用于 `backend/` 目录。

## NestJS 最佳实践

### 依赖注入

始终使用构造函数注入：

```typescript
@Injectable()
export class MyService {
  constructor(
    private readonly prisma: PrismaService,
    private readonly otherService: OtherService,
  ) {}
}
```

### 全局模块

PrismaModule 已设为全局模块，无需在每个模块中导入。

### 环境变量

使用 `@nestjs/config` 的 ConfigService：

```typescript
constructor(private configService: ConfigService) {
  const jwtSecret = this.configService.get<string>('JWT_SECRET');
}
```

## 测试规范

### 单元测试

```typescript
describe('UsersService', () => {
  let service: UsersService;
  let prisma: PrismaService;

  beforeEach(async () => {
    const module = await Test.createTestingModule({
      providers: [
        UsersService,
        {
          provide: PrismaService,
          useValue: mockPrismaService,
        },
      ],
    }).compile();

    service = module.get<UsersService>(UsersService);
    prisma = module.get<PrismaService>(PrismaService);
  });

  it('should create a user', async () => {
    const dto = { username: 'test', password: 'pass123' };
    const result = await service.create(dto, 1);
    expect(result).toBeDefined();
  });
});
```

## 日志记录

使用 NestJS Logger：

```typescript
import { Logger } from '@nestjs/common';

export class MyService {
  private readonly logger = new Logger(MyService.name);

  async someMethod() {
    this.logger.log('执行某操作');
    this.logger.warn('警告信息');
    this.logger.error('错误信息', error.stack);
  }
}
```

## 常用脚本

```bash
# 开发
pnpm start:dev

# 数据库迁移
pnpm prisma:migrate:dev

# 初始化管理员
pnpm init:admin

# 初始化菜单
pnpm init:menus
```

## 项目结构

```
src/
├── auth/           # 认证模块
├── users/          # 用户管理
├── roles/          # 角色管理
├── permissions/    # 权限管理
├── menus/          # 菜单管理
├── tenants/        # 租户管理
├── school/         # 学校管理
├── contests/       # 竞赛管理
├── common/         # 公共模块
├── prisma/         # Prisma 服务
└── main.ts         # 入口文件
```