## 工具偏好与使用约定

### 首选工具
- 代码检索: 语义检索优先，其次精确 `grep`（限定范围/文件类型）
- 文件读取: 分段读取，避免大文件全量；聚焦导入/实体/控制器/服务、测试
- 编辑变更: 小步、原地最小改动；优先迁移后删除，避免职责重复
- 运行与测试: `npm run build`，`npm run test`（单测/集成），e2e 按 `playground` 配置

### 偏好策略
- 并行检索: 控制器/服务/实体/DTO/模块定义并行查看
- 批量对齐: 字段/命名统一替换前先定位所有引用
- 规范优先: 不因快捷而破坏分层与依赖约束

### 常用检查点
- DB 对齐: 实体字段名、类型、软删、时间戳
- 配置统一: `sys_config.value(JSON)`，无 `config_value`、无 `app_type`
- 路由前缀: `/adminapi` 与 `/api`
- 守卫: 管理端 `JwtAuthGuard + RolesGuard`
- DTO: `class-validator`，必要时 `Pipes`（JSON/Timestamp）
- 事件/队列: 用例完成后发布事件、必要时入队 