---
paths: swagger/*.json
---
# 规则：不要加载或修改 swagger/*.json 文件

## 规则说明

`swagger/` 目录下的 JSON 文件是后端服务自动生成的 OpenAPI 规范文件，由后端团队维护。

## 禁止行为

- ❌ 直接读取 `swagger/*.json` 文件
- ❌ 修改 `swagger/*.json` 文件
- ❌ 在前端代码中依赖这些文件
- ❌ 将 swagger JSON 文件纳入版本控制（如需跟踪，应由后端处理）

## 正确做法

1. **更新 API 类型**：如需更新前端 API 类型定义，运行命令：
   ```bash
   cd packages/app-operation
   pnpm openapi
   ```

2. **使用生成的 services**：前端应使用 `src/services/` 目录下自动生成的 API 客户端代码，而非直接解析 swagger 文件

## 违反此规则的后果

- 可能导致前端与后端 API 不同步
- 手动修改的 swagger 文件会在下次后端同步时被覆盖
- 破坏前后端约定的 OpenAPI 规范