feat: 补全后端 API 并对齐前后端类型

- 后端新增: Project CRUD / Brief CRUD / 组织关系管理 / 工作台统计 / SSE 推送 / 认证依赖注入 - 后端完善: 任务 API 全流程(创建/审核/申诉) + Task Service + Task Schema - 前端修复: login 页面 localStorage key 错误 (miaosi_auth -> miaosi_user) - 前端对齐: types/task.ts 与后端 TaskStage/TaskResponse 完全对齐 - 前端新增: project/brief/organization/dashboard 类型定义 - 前端补全: api.ts 新增 30+ API 方法覆盖所有后端接口 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-09 14:13:08 +08:00
parent 23835ee790
commit a32102f583
20 changed files with 3775 additions and 260 deletions
@@ -14,7 +14,32 @@ import type {
  TaskListResponse,
  TaskScriptUploadRequest,
  TaskVideoUploadRequest,
+  TaskCreateRequest,
+  TaskReviewRequest,
+  TaskStage,
+  ReviewTaskListResponse,
+  AppealRequest,
 } from '@/types/task'
+import type {
+  ProjectResponse,
+  ProjectListResponse,
+  ProjectCreateRequest,
+  ProjectUpdateRequest,
+} from '@/types/project'
+import type {
+  BriefResponse,
+  BriefCreateRequest,
+} from '@/types/brief'
+import type {
+  AgencyListResponse,
+  CreatorListResponse,
+  BrandListResponse,
+} from '@/types/organization'
+import type {
+  CreatorDashboard,
+  AgencyDashboard,
+  BrandDashboard,
+} from '@/types/dashboard'

 const API_BASE_URL = process.env.NEXT_PUBLIC_API_BASE_URL || 'http://localhost:8000'
 const STORAGE_KEY_ACCESS = 'miaosi_access_token'
@@ -305,11 +330,29 @@ class ApiClient {

  // ==================== 审核任务 ====================

+  /**
+   * 创建任务（代理商操作）
+   */
+  async createTask(data: TaskCreateRequest): Promise<TaskResponse> {
+    const response = await this.client.post<TaskResponse>('/tasks', data)
+    return response.data
+  }
+
  /**
   * 查询任务列表
   */
-  async listTasks(page: number = 1, pageSize: number = 20): Promise<TaskListResponse> {
+  async listTasks(page: number = 1, pageSize: number = 20, stage?: TaskStage): Promise<TaskListResponse> {
    const response = await this.client.get<TaskListResponse>('/tasks', {
+      params: { page, page_size: pageSize, stage },
+    })
+    return response.data
+  }
+
+  /**
+   * 查询待审核任务列表
+   */
+  async listPendingReviews(page: number = 1, pageSize: number = 20): Promise<ReviewTaskListResponse> {
+    const response = await this.client.get<ReviewTaskListResponse>('/tasks/pending', {
      params: { page, page_size: pageSize },
    })
    return response.data
@@ -339,6 +382,227 @@ class ApiClient {
    return response.data
  }

+  /**
+   * 审核脚本
+   */
+  async reviewScript(taskId: string, data: TaskReviewRequest): Promise<TaskResponse> {
+    const response = await this.client.post<TaskResponse>(`/tasks/${taskId}/script/review`, data)
+    return response.data
+  }
+
+  /**
+   * 审核视频
+   */
+  async reviewVideo(taskId: string, data: TaskReviewRequest): Promise<TaskResponse> {
+    const response = await this.client.post<TaskResponse>(`/tasks/${taskId}/video/review`, data)
+    return response.data
+  }
+
+  /**
+   * 提交申诉（达人操作）
+   */
+  async submitAppeal(taskId: string, data: AppealRequest): Promise<TaskResponse> {
+    const response = await this.client.post<TaskResponse>(`/tasks/${taskId}/appeal`, data)
+    return response.data
+  }
+
+  /**
+   * 增加申诉次数（代理商操作）
+   */
+  async increaseAppealCount(taskId: string): Promise<TaskResponse> {
+    const response = await this.client.post<TaskResponse>(`/tasks/${taskId}/appeal-count`)
+    return response.data
+  }
+
+  // ==================== 项目 ====================
+
+  /**
+   * 创建项目（品牌方操作）
+   */
+  async createProject(data: ProjectCreateRequest): Promise<ProjectResponse> {
+    const response = await this.client.post<ProjectResponse>('/projects', data)
+    return response.data
+  }
+
+  /**
+   * 查询项目列表
+   */
+  async listProjects(page: number = 1, pageSize: number = 20, status?: string): Promise<ProjectListResponse> {
+    const response = await this.client.get<ProjectListResponse>('/projects', {
+      params: { page, page_size: pageSize, status },
+    })
+    return response.data
+  }
+
+  /**
+   * 查询项目详情
+   */
+  async getProject(projectId: string): Promise<ProjectResponse> {
+    const response = await this.client.get<ProjectResponse>(`/projects/${projectId}`)
+    return response.data
+  }
+
+  /**
+   * 更新项目
+   */
+  async updateProject(projectId: string, data: ProjectUpdateRequest): Promise<ProjectResponse> {
+    const response = await this.client.put<ProjectResponse>(`/projects/${projectId}`, data)
+    return response.data
+  }
+
+  /**
+   * 分配代理商到项目
+   */
+  async assignAgencies(projectId: string, agencyIds: string[]): Promise<ProjectResponse> {
+    const response = await this.client.post<ProjectResponse>(`/projects/${projectId}/agencies`, {
+      agency_ids: agencyIds,
+    })
+    return response.data
+  }
+
+  /**
+   * 从项目移除代理商
+   */
+  async removeAgencyFromProject(projectId: string, agencyId: string): Promise<ProjectResponse> {
+    const response = await this.client.delete<ProjectResponse>(`/projects/${projectId}/agencies/${agencyId}`)
+    return response.data
+  }
+
+  // ==================== Brief ====================
+
+  /**
+   * 获取项目 Brief
+   */
+  async getBrief(projectId: string): Promise<BriefResponse> {
+    const response = await this.client.get<BriefResponse>(`/projects/${projectId}/brief`)
+    return response.data
+  }
+
+  /**
+   * 创建项目 Brief
+   */
+  async createBrief(projectId: string, data: BriefCreateRequest): Promise<BriefResponse> {
+    const response = await this.client.post<BriefResponse>(`/projects/${projectId}/brief`, data)
+    return response.data
+  }
+
+  /**
+   * 更新项目 Brief
+   */
+  async updateBrief(projectId: string, data: BriefCreateRequest): Promise<BriefResponse> {
+    const response = await this.client.put<BriefResponse>(`/projects/${projectId}/brief`, data)
+    return response.data
+  }
+
+  // ==================== 组织关系 ====================
+
+  /**
+   * 品牌方：查询代理商列表
+   */
+  async listBrandAgencies(): Promise<AgencyListResponse> {
+    const response = await this.client.get<AgencyListResponse>('/organizations/brand/agencies')
+    return response.data
+  }
+
+  /**
+   * 品牌方：邀请代理商
+   */
+  async inviteAgency(agencyId: string): Promise<void> {
+    await this.client.post('/organizations/brand/agencies', { agency_id: agencyId })
+  }
+
+  /**
+   * 品牌方：移除代理商
+   */
+  async removeAgency(agencyId: string): Promise<void> {
+    await this.client.delete(`/organizations/brand/agencies/${agencyId}`)
+  }
+
+  /**
+   * 品牌方：更新代理商权限
+   */
+  async updateAgencyPermission(agencyId: string, forcePassEnabled: boolean): Promise<void> {
+    await this.client.put(`/organizations/brand/agencies/${agencyId}/permission`, {
+      force_pass_enabled: forcePassEnabled,
+    })
+  }
+
+  /**
+   * 代理商：查询达人列表
+   */
+  async listAgencyCreators(): Promise<CreatorListResponse> {
+    const response = await this.client.get<CreatorListResponse>('/organizations/agency/creators')
+    return response.data
+  }
+
+  /**
+   * 代理商：邀请达人
+   */
+  async inviteCreator(creatorId: string): Promise<void> {
+    await this.client.post('/organizations/agency/creators', { creator_id: creatorId })
+  }
+
+  /**
+   * 代理商：移除达人
+   */
+  async removeCreator(creatorId: string): Promise<void> {
+    await this.client.delete(`/organizations/agency/creators/${creatorId}`)
+  }
+
+  /**
+   * 代理商：查询关联品牌方
+   */
+  async listAgencyBrands(): Promise<BrandListResponse> {
+    const response = await this.client.get<BrandListResponse>('/organizations/agency/brands')
+    return response.data
+  }
+
+  /**
+   * 搜索代理商
+   */
+  async searchAgencies(keyword: string): Promise<AgencyListResponse> {
+    const response = await this.client.get<AgencyListResponse>('/organizations/search/agencies', {
+      params: { keyword },
+    })
+    return response.data
+  }
+
+  /**
+   * 搜索达人
+   */
+  async searchCreators(keyword: string): Promise<CreatorListResponse> {
+    const response = await this.client.get<CreatorListResponse>('/organizations/search/creators', {
+      params: { keyword },
+    })
+    return response.data
+  }
+
+  // ==================== 工作台统计 ====================
+
+  /**
+   * 达人工作台数据
+   */
+  async getCreatorDashboard(): Promise<CreatorDashboard> {
+    const response = await this.client.get<CreatorDashboard>('/dashboard/creator')
+    return response.data
+  }
+
+  /**
+   * 代理商工作台数据
+   */
+  async getAgencyDashboard(): Promise<AgencyDashboard> {
+    const response = await this.client.get<AgencyDashboard>('/dashboard/agency')
+    return response.data
+  }
+
+  /**
+   * 品牌方工作台数据
+   */
+  async getBrandDashboard(): Promise<BrandDashboard> {
+    const response = await this.client.get<BrandDashboard>('/dashboard/brand')
+    return response.data
+  }
+
  // ==================== 健康检查 ====================

  /**