feat

src/api/kb/document.ts

@@ -0,0 +1,212 @@
+import { request } from "@/api/request";
+
+/** 文档状态 */
+export type DocumentStatus = 'draft' | 'published' | 'reviewed' | 'rejected';
+
+/** 文档类型 */
+export type DocumentType = 'common' | 'guide' | 'solution' | 'troubleshoot' | 'process' | 'technical';
+
+/** 文档接口类型 */
+export interface Document {
+  id: number;
+  created_at: string;
+  updated_at: string;
+  doc_no: string;
+  title: string;
+  description: string;
+  content: string;
+  type: DocumentType;
+  status: DocumentStatus;
+  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;
+  is_favorited?: boolean;
+}
+
+/** API响应包装类型 */
+export interface ApiResponse<T = any> {
+  code: number;
+  message: string;
+  data: T;
+}
+
+/** 分页响应类型 */
+export interface PaginatedResponse<T> {
+  total: number;
+  page: number;
+  page_size: number;
+  data: T[];
+}
+
+/** 创建文档请求参数 */
+export interface CreateDocumentParams {
+  title: string;
+  description?: string;
+  content: string;
+  type?: DocumentType;
+  category_id?: number;
+  sub_category?: string;
+  keywords?: string;
+  tags?: string;
+  remarks?: string;
+}
+
+/** 更新文档请求参数 */
+export interface UpdateDocumentParams {
+  id: number;
+  title?: string;
+  description?: string;
+  content?: string;
+  type?: DocumentType;
+  category_id?: number;
+  sub_category?: string;
+  keywords?: string;
+  tags?: string;
+  remarks?: string;
+}
+
+/** 获取文档列表参数 */
+export interface FetchDocumentListParams {
+  page?: number;
+  page_size?: number;
+  keyword?: string;
+  type?: DocumentType;
+  status?: DocumentStatus;
+  category_id?: number;
+}
+
+/** 文档类型选项 */
+export const documentTypeOptions = [
+  { label: '通用文档', value: 'common' },
+  { label: '操作指南', value: 'guide' },
+  { label: '解决方案', value: 'solution' },
+  { label: '故障排查', value: 'troubleshoot' },
+  { label: '流程规范', value: 'process' },
+  { label: '技术文档', value: 'technical' },
+];
+
+/** 文档状态选项 */
+export const documentStatusOptions = [
+  { label: '草稿', value: 'draft' },
+  { label: '已发布', value: 'published' },
+  { label: '已审核', value: 'reviewed' },
+  { label: '未通过审核', value: 'rejected' },
+];
+
+/** 获取文档状态文本 */
+export const getDocumentStatusText = (status: DocumentStatus): string => {
+  const statusMap: Record<DocumentStatus, string> = {
+    draft: '草稿',
+    published: '已发布',
+    reviewed: '已审核',
+    rejected: '未通过审核',
+  };
+  return statusMap[status] || status;
+};
+
+/** 获取文档状态颜色 */
+export const getDocumentStatusColor = (status: DocumentStatus): string => {
+  const colorMap: Record<DocumentStatus, string> = {
+    draft: 'gray',
+    published: 'blue',
+    reviewed: 'green',
+    rejected: 'red',
+  };
+  return colorMap[status] || 'gray';
+};
+
+/** 获取文档类型文本 */
+export const getDocumentTypeText = (type: DocumentType): string => {
+  const typeMap: Record<DocumentType, string> = {
+    common: '通用文档',
+    guide: '操作指南',
+    solution: '解决方案',
+    troubleshoot: '故障排查',
+    process: '流程规范',
+    technical: '技术文档',
+  };
+  return typeMap[type] || type;
+};
+
+/** 创建文档 */
+export const createDocument = (data: CreateDocumentParams) => {
+  return request.post<ApiResponse<Document>>("/Kb/v1/document/create", data);
+};
+
+/** 更新文档 */
+export const updateDocument = (data: UpdateDocumentParams) => {
+  return request.post<ApiResponse<Document>>("/Kb/v1/document/update", data);
+};
+
+/** 删除文档（移入回收站） */
+export const deleteDocument = (id: number) => {
+  return request.delete<ApiResponse<string>>(`/Kb/v1/document/${id}`);
+};
+
+/** 获取文档详情 */
+export const fetchDocumentDetail = (id: number) => {
+  return request.get<ApiResponse<Document>>(`/Kb/v1/document/${id}`);
+};
+
+/** 获取文档列表 */
+export const fetchDocumentList = (params?: FetchDocumentListParams) => {
+  return request.get<ApiResponse<PaginatedResponse<Document>>>("/Kb/v1/document/list", { params });
+};
+
+/** 发布文档 */
+export const publishDocument = (id: number) => {
+  return request.post<ApiResponse<string>>("/Kb/v1/document/publish", { id });
+};
+
+/** 移入回收站 */
+export const moveToTrash = (id: number) => {
+  return request.post<ApiResponse<string>>("/Kb/v1/trash/move", { id, type: 'document' });
+};
+
+/** 获取我的文档列表（由我创建的所有文档） */
+export const fetchMyDocumentList = (params?: FetchDocumentListParams) => {
+  return request.get<ApiResponse<PaginatedResponse<Document>>>("/Kb/v1/review/publish/list", { params });
+};
+
+/** 获取已审核通过的文档列表 */
+export const fetchApprovedDocumentList = (params?: FetchDocumentListParams) => {
+  return request.get<ApiResponse<PaginatedResponse<Document>>>("/Kb/v1/review/approved/list", { params });
+};
+
+/** 收藏文档 */
+export const favoriteDocument = (id: number) => {
+  return request.post<ApiResponse<string>>("/Kb/v1/favorite/create", { resource_type: 'document', resource_id: id });
+};
+
+/** 取消收藏文档 */
+export const unfavoriteDocument = (id: number) => {
+  return request.delete<ApiResponse<string>>("/Kb/v1/favorite/delete", { data: { resource_type: 'document', resource_id: id } });
+};
+
+/** 检查文档是否已收藏 */
+export const checkFavorite = (id: number) => {
+  return request.get<ApiResponse<{ is_favorited: boolean }>>(`/Kb/v1/favorite/check`, { params: { resource_type: 'document', resource_id: id } });
+};
+
+/** 下载文档 */
+export const downloadDocument = (id: number) => {
+  return request.get<Blob>(`/Kb/v1/document/${id}/download`, { responseType: 'blob' });
+};