混剪功能

CLAUDE.md

@@ -300,6 +300,56 @@ frontend/app/web-gold/src/
 4. 更新 `src/router/index.js` 中的路由
 5. 使用 `npm run dev` 测试
 
+## 常见易错点与正确用法
+
+### 1. CommonResult 错误处理
+❌ `CommonResult.error("msg")`
+✅ `CommonResult.error(GlobalErrorCodeConstants.UNAUTHORIZED)`
+
+### 2. JSON 序列化
+❌ `parseJson()`, `toJson()`
+✅ `JsonUtils.parseObject(text, new TypeReference<List<T>>() {})` / `JsonUtils.toJsonString(obj)`
+
+### 3. DO基类
+❌ `common.pojo.TenantBaseDO`
+✅ `tenant.core.db.TenantBaseDO`
+
+### 4. 分页参数
+❌ 自定义pageNo/pageSize
+✅ `VO extends SortablePageParam` + `selectPage(reqVO, wrapper)`
+
+### 5. 用户认证
+❌ `Long userId = 1L`
+✅ `SecurityFrameworkUtils.getLoginUserId()`
+
+### 6. Mapper查询
+❌ `QueryWrapper` + 字符串字段
+✅ `LambdaQueryWrapperX` + 方法引用
+
+### 7. JSON字段
+❌ `private List<String> urls`
+✅ `private String urls` + `getUrlList()/setUrlList()` 转换
+
+### 8. Bean转换
+❌ `org.springframework.beans.BeanUtils`
+✅ `framework.common.util.object.BeanUtils`
+
+### 9. 异步处理
+❌ 同步调用ICE API
+✅ `CompletableFuture.runAsync(() -> {...})`
+
+### 10. Logger使用
+❌ `log.info("msg")` 无定义Logger
+✅ `@Slf4j` 注解类 或 `private static final Logger log = LoggerFactory.getLogger(...)`
+
+### 11. Cron配置
+❌ `@Scheduled(cron = "*/30 * * * * ?")`
+✅ `@Scheduled(cron = Constants.CRON_CHECK_STATUS)`
+
+### 12. OSS配额检查
+❌ 直接上传文件到OSS而不检查配额
+✅ 上传前检查用户/系统配额，限制文件大小和数量，记录使用量
+
 ## 多租户
 
 - 配置中默认启用
@@ -402,6 +452,7 @@ yudao:
 5. **端口：** 后端默认 9900，前端默认 5173
 6. **API 密钥：** `application.yaml` 中配置了多个 AI 服务 API 密钥 - 不要提交到公共仓库
 7. **多租户：** 默认启用 - 所有 DO 类应继承 `TenantBaseDO`
+8. **OSS 配额：** 使用阿里云 OSS、文件上传、混剪视频存储等功能时**必须**检查和限制配额，防止超出存储/流量限制
 
 ## 故障排除