feat: 整合知识库管理页面

src/api/kb/review.ts

@@ -1,169 +1,70 @@
 import { request } from '@/api/request'
+import type { Document } from './document'
+import type { Faq, KbReply } from './faq'
 
-export type ReviewStatsResourceType = 'all' | 'document' | 'faq'
+export type ReviewResourceType = 'all' | 'document' | 'faq'
 
-/** 审核统计接口返回的 data 字段 */
-export interface ReviewStatsPayload {
-  need_my_review_document?: number
-  need_my_review_faq?: number
-  need_my_review_total?: number
-  need_my_review_unreviewed_document?: number
-  need_my_review_unreviewed_faq?: number
-  need_my_review_unreviewed_total?: number
-}
-
-/** 文档资源类型 */
-export interface DocumentResource {
-  id: number
-  created_at: string
-  updated_at: string
-  doc_no: string
-  title: string
-  description: string
-  content: string
-  type: string
-  status: string
-  category_id: number
-  sub_category: string
-  author_id: number
-  author_name: string
-  reviewer_id: number
-  reviewer_name: string
-  reviewed_at: string | null
-  published_at: string | null
-  publisher_id: number
-  view_count: number
-  like_count: number
-  comment_count: number
-  download_count: number
-  version: string
-  version_notes: string
-  tags: string
-  attachments: string | null
-  related_docs: string | null
-  metadata: string | null
-  keywords: string
-  remarks: string
-}
-
-/** FAQ资源类型 */
-export interface FaqResource {
-  id: number
-  created_at: string
-  updated_at: string
-  faq_no: string
-  question: string
-  answer: string
-  status: string
-  priority: string
-  category_id: number
-  sub_category: string
-  problem_type: string
-  solution: string
-  process_steps: string
-  prerequisites: string
-  author_id: number
-  author_name: string
-  reviewer_id: number
-  reviewer_name: string
-  reviewed_at: string | null
-  published_at: string | null
-  view_count: number
-  use_count: number
-  helpful_count: number
-  useless_count: number
-  tags: string
-  related_faqs: string | null
-  related_docs: string | null
-  related_links: string | null
-  attachments: string | null
-  keywords: string
-  applicable_scope: string
-  remarks: string
-}
-
-/** 审核列表项（resource_type 为 all 时） */
+/** 统一审核列表项。 */
 export interface ReviewListItem {
   type: 'document' | 'faq'
-  resource: DocumentResource | FaqResource
+  resource: Document | Faq
 }
 
-/** 分页响应类型 */
-export interface PaginatedResponse<T> {
+/** 审核分页结果。 */
+export interface ReviewPage {
   total: number
   page: number
   page_size: number
-  data: T[]
+  data: ReviewListItem[]
 }
 
-/** API响应包装类型 */
-export interface ApiResponse<T = any> {
-  code: number
-  message: string
-  data: T
+/** 当前审核人的待审数量。 */
+export interface ReviewStats {
+  need_my_review_document: number
+  need_my_review_faq: number
+  need_my_review_total: number
+  need_my_review_unreviewed_document: number
+  need_my_review_unreviewed_faq: number
+  need_my_review_unreviewed_total: number
 }
 
-/** 获取审核列表参数 */
+/** 审核列表参数。 */
 export interface FetchReviewListParams {
   page?: number
   page_size?: number
-  resource_type?: ReviewStatsResourceType
+  resource_type?: ReviewResourceType
 }
 
-/** 审核通过参数 */
 export interface ApproveParams {
   resource_type: 'document' | 'faq'
   id: number
 }
 
-/** 审核拒绝参数 */
-export interface RejectParams {
-  resource_type: 'document' | 'faq'
-  id: number
-  reason?: string
+export interface RejectParams extends ApproveParams {
+  reason: string
 }
 
-/** 按当前登录用户统计需要本人审核的数量（不含本人为作者的稿件） */
-export const fetchReviewStats = (params?: { resource_type?: ReviewStatsResourceType }) =>
-  request.get('/Kb/v1/review/stats', params ? { params } : undefined)
+/** 获取当前用户可审核的待审资源。 */
+export const fetchReviewList = (params: FetchReviewListParams) => request.get<KbReply<ReviewPage>>('/Kb/v1/review/list', { params })
 
-/** 获取待审核列表 */
-export const fetchReviewList = (params?: FetchReviewListParams) =>
-  request.get<ApiResponse<PaginatedResponse<ReviewListItem | DocumentResource | FaqResource>>>('/Kb/v1/review/list', { params })
+/** 获取当前审核人的待审统计。 */
+export const fetchReviewStats = (params: { resource_type?: ReviewResourceType } = {}) =>
+  request.get<KbReply<ReviewStats>>('/Kb/v1/review/stats', { params })
 
-/** 审核通过 */
-export const approveReview = (data: ApproveParams) => request.post<ApiResponse<string>>('/Kb/v1/review/approve', data)
+/** 审核通过。 */
+export const approveReview = (data: ApproveParams) => request.post<KbReply<string>>('/Kb/v1/review/approve', data)
 
-/** 审核拒绝 */
-export const rejectReview = (data: RejectParams) => request.post<ApiResponse<string>>('/Kb/v1/review/reject', data)
+/** 审核拒绝。 */
+export const rejectReview = (data: RejectParams) => request.post<KbReply<string>>('/Kb/v1/review/reject', data)
 
-/** 获取文档详情 */
-export const fetchDocumentDetail = (id: number) => request.get<ApiResponse<DocumentResource>>(`/Kb/v1/document/${id}`)
-
-/** 获取FAQ详情 */
-export const fetchFaqDetail = (id: number) => request.get<ApiResponse<FaqResource>>(`/Kb/v1/faq/${id}`)
-
-/** 资源类型选项 */
-export const resourceTypeOptions = [
+export const resourceTypeOptions: Array<{ label: string; value: ReviewResourceType }> = [
   { label: '全部', value: 'all' },
   { label: '文档', value: 'document' },
   { label: 'FAQ', value: 'faq' },
 ]
 
-/** 获取资源类型文本 */
-export const getResourceTypeText = (type: string): string => {
-  const typeMap: Record<string, string> = {
-    document: '文档',
-    faq: 'FAQ',
-  }
-  return typeMap[type] || type
-}
+/** 获取审核资源类型文案。 */
+export const getResourceTypeText = (type: string) => ({ document: '文档', faq: 'FAQ' })[type] || type
 
-/** 获取资源类型颜色 */
-export const getResourceTypeColor = (type: string): string => {
-  const colorMap: Record<string, string> = {
-    document: 'arcoblue',
-    faq: 'green',
-  }
-  return colorMap[type] || 'gray'
-}
+/** 获取审核资源类型颜色。 */
+export const getResourceTypeColor = (type: string) => ({ document: 'arcoblue', faq: 'green' })[type] || 'gray'