2026-05-25: 等级体系升级(20级)+论坛二级分类+会员空间

.trae/specs/modules/02-api.md

@@ -35,14 +35,59 @@
 ### GET/POST /api/auth/[...nextauth]
 NextAuth认证端点（登录/回调/CSRF等）。
 
-### 用户相关API（需NextAuth用户认证）
+### POST /api/auth/register
+用户注册（邮箱+密码）。
+
+### GET /api/categories/[slug]
+获取分类详情。
+
+### GET /api/daily-reports
+获取AI日报列表。
+
+### GET /api/recommendations
+获取推荐内容。
+
+### 评测榜单API（公开）
 
 | 路由 | 方法 | 功能 |
 |------|------|------|
+| /api/skill-reviews | GET | 获取评测列表（分页，仅PUBLISHED） |
+| /api/skill-reviews/rankings | GET | 获取评测榜单：topByRating(评测分TOP10) + topByStarsChange(Stars涨幅周榜TOP10) |
+
+---
+
+## 用户相关API（需NextAuth用户认证）
+
+### /api/user/profile
+- GET: 获取当前用户资料
+- PUT: 更新用户资料
+
+### /api/user/favorites
+| 路由 | 方法 | 功能 |
+|------|------|------|
+| /api/user/favorites/status | GET | 获取收藏状态 |
 | /api/user/favorites | GET | 获取当前用户收藏列表（工具+技能） |
 | /api/user/favorites | POST | 添加收藏（body: { targetType, targetId }） |
 | /api/user/favorites | DELETE | 取消收藏（body: { targetType, targetId }） |
+
+### /api/user/history
+| 路由 | 方法 | 功能 |
+|------|------|------|
 | /api/user/history | GET | 获取浏览历史 |
+| /api/user/history | POST | 记录浏览历史 |
+
+### /api/user/collections
+| 路由 | 方法 | 功能 |
+|------|------|------|
+| /api/user/collections | GET | 获取收藏夹列表 |
+| /api/user/collections | POST | 创建收藏夹 |
+| /api/user/collections/[id] | GET | 获取单个收藏夹详情 |
+| /api/user/collections/[id] | PUT | 更新收藏夹 |
+| /api/user/collections/[id] | DELETE | 删除收藏夹 |
+| /api/user/collections/[id]/items | GET | 获取收藏夹项目 |
+| /api/user/collections/[id]/items | POST | 添加收藏夹项目 |
+| /api/user/collections/[id]/items/[itemId] | PUT | 更新收藏夹项目 |
+| /api/user/collections/[id]/items/[itemId] | DELETE | 删除收藏夹项目 |
 
 ---
 
@@ -112,11 +157,21 @@ NextAuth认证端点（登录/回调/CSRF等）。
 |------|------|------|
 | /api/admin/discover-tools | POST | 导入工具JSON数组（body: {tools: [...], categoryId}），自动去重导入待审核列表 |
 | /api/admin/discover-skills | POST | 导入技能JSON数组（body: {skills: [...], categoryId}），自动去重导入待审核列表 |
+| /api/admin/discover-skills/run | POST | 一键运行技能探索 |
 | /api/admin/discover-news | POST | 导入新闻JSON数组（body: {items: [...]}），自动生成今日AI日报 |
 | /api/admin/discover-news | GET | 获取今日AI日报 |
 | /api/admin/check-tools | POST | 检测工具网站可访问性+抓取缺失Logo（body: {type: "published"/"pending"}），返回logoFetched/logoMethod/logoUrl |
 | /api/admin/update-stars | POST | 更新GitHub Star数（body: {type: "published"/"pending"}） |
 
+### 评测管理
+
+| 路由 | 方法 | 功能 |
+|------|------|------|
+| /api/admin/reviews | GET | 获取评测列表 |
+| /api/admin/reviews/[id] | GET | 获取单个评测详情 |
+| /api/admin/reviews/[id] | PUT | 更新评测状态 |
+| /api/admin/reviews/[id]/generate | POST | AI生成评测内容（长文+视频脚本+社交卡片） |
+
 ### 系统配置
 
 | 路由 | 方法 | 功能 |
@@ -124,12 +179,37 @@ NextAuth认证端点（登录/回调/CSRF等）。
 | /api/admin/system-config | GET | 获取所有配置 |
 | /api/admin/system-config | PUT | 批量更新配置（upsert） |
 
-### 评论API（需NextAuth用户认证）
+### 角色权限管理
 
 | 路由 | 方法 | 功能 |
 |------|------|------|
-| /api/reviews | GET | 获取评论列表（query: type, targetId） |
-| /api/reviews | POST | 创建评论（body: { type, targetId, content, rating? }） |
+| /api/admin/roles | GET | 获取所有角色列表 |
+| /api/admin/roles | POST | 创建角色 |
+| /api/admin/roles/[id] | PUT | 更新角色 |
+| /api/admin/roles/[id] | DELETE | 删除角色 |
+| /api/admin/permissions | GET | 获取全部权限点列表 |
+| /api/admin/user-permissions | GET | 获取当前用户权限（roleId/userId/当前用户） |
+
+### 日报管理
+
+| 路由 | 方法 | 功能 |
+|------|------|------|
+| /api/admin/daily-reports | GET | 获取日报列表 |
+| /api/admin/daily-reports/[id] | GET | 获取单个日报详情 |
+| /api/admin/daily-reports/[id] | PUT | 更新日报 |
+| /api/admin/daily-reports/[id] | DELETE | 删除日报 |
+| /api/admin/daily-reports/generate | POST | AI一键生成日报内容 |
+
+### 任务调度API（需NextAuth认证）
+
+| 路由 | 方法 | 功能 |
+|------|------|------|
+| /api/admin/tasks/configs | GET | 获取全部6个任务配置（合并TaskConfig+默认值） |
+| /api/admin/tasks/configs | PUT | 更新/创建任务配置（body: { taskKey, enabled?, cronExpr?, config? }） |
+| /api/admin/tasks/logs | GET | 获取任务执行日志（分页，query: taskKey?, page, pageSize） |
+| /api/admin/tasks/run | POST | 手动触发任务执行（body: { taskKey }），通过child_process.exec运行对应脚本 |
+
+---
 
 ## SystemConfig 配置键