@mindbase/express-knowledge 1.0.4 → 1.0.8

package/routes/knowledge.route.ts

@@ -0,0 +1,378 @@
+import { Router, type Request, type Response, type NextFunction } from "express";
+import { logger, validate } from "@mindbase/express-common";
+import * as KnowledgeService from "../service/KnowledgeService";
+import * as schemas from "../zod/knowledge.schema";
+
+const router = Router();
+
+// ==================== 知识库内容路由 ====================
+
+/**
+ * 获取目录树
+ * @apiParam {number} [parentId] 父节点ID（可选，不传则获取根节点）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object[]} data 目录树结构
+ * @apiSuccess {number} data[].id 节点ID
+ * @apiSuccess {string} data[].name 名称
+ * @apiSuccess {number} data[].type 类型（0:文件夹, 1:笔记, 2:书籍）
+ * @apiSuccess {number} data[].level 层级
+ * @apiSuccess {Object} data[].children 子节点
+ */
+router.get("/tree", async (req: Request, res: Response, next: NextFunction) => {
+  const userId = res.locals.user?.id;
+  const permissions = res.locals.permissions || [];
+  const isAdmin = permissions.includes('admin') || permissions.includes('*:*:*');
+  const { parentId } = req.query;
+
+  try {
+    const tree = await KnowledgeService.getKnowledgeTree({
+      parentId: parentId ? Number(parentId) : null,
+      userId,
+      isAdmin,
+    });
+    res.json({ code: 200, message: "获取成功", data: tree });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 获取目录树失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 获取内容列表（分页）
+ * @apiParam {number} [pageIndex] 页码（可选，默认1）
+ * @apiParam {number} [pageSize] 每页数量（可选，默认10）
+ * @apiParam {number} [level] 层级筛选（可选）
+ * @apiParam {number} [type] 类型筛选（可选，0:文件夹, 1:笔记, 2:书籍）
+ * @apiParam {number[]} [safe] 安全等级筛选（可选）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object} data 内容列表
+ * @apiSuccess {Object[]} data.list 内容数组
+ * @apiSuccess {number} data.total 总数
+ * @apiSuccess {number} data.pageIndex 当前页
+ * @apiSuccess {number} data.pageSize 每页数量
+ */
+router.get("/list", validate(schemas.listKnowledgeSchema, "query"), async (req: Request, res: Response, next: NextFunction) => {
+  const userId = res.locals.user?.id;
+  const permissions = res.locals.permissions || [];
+  const isAdmin = permissions.includes('admin') || permissions.includes('*:*:*');
+
+  try {
+    const result = await KnowledgeService.listKnowledge({
+      ...req.query as any,
+      userId,
+      isAdmin,
+    });
+    res.json({ code: 200, message: "获取成功", data: result });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 获取内容列表失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 搜索内容
+ * @apiParam {string} keyword 搜索关键词（必填）
+ * @apiParam {number} [pageIndex] 页码（可选，默认1）
+ * @apiParam {number} [pageSize] 每页数量（可选，默认10）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object} data 搜索结果
+ * @apiSuccess {Object[]} data.list 结果数组
+ * @apiSuccess {number} data.total 总数
+ */
+router.get("/search", validate(schemas.searchKnowledgeSchema, "query"), async (req: Request, res: Response, next: NextFunction) => {
+  const userId = res.locals.user?.id;
+  const permissions = res.locals.permissions || [];
+  const isAdmin = permissions.includes('admin') || permissions.includes('*:*:*');
+
+  try {
+    const result = await KnowledgeService.searchKnowledge({
+      ...req.query as any,
+      userId,
+      isAdmin,
+    });
+    res.json({ code: 200, message: "搜索成功", data: result });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 搜索失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 获取内容详情
+ * @apiParam {number} id 内容ID（路径参数，必填）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object} data 内容详情
+ * @apiSuccess {number} data.id ID
+ * @apiSuccess {string} data.name 名称
+ * @apiSuccess {string} data.content 内容
+ * @apiSuccess {string} data.description 描述
+ * @apiSuccess {number} data.type 类型
+ * @apiSuccess {number} data.safe 安全等级
+ * @apiSuccess {boolean} data.isTop 是否置顶
+ */
+router.get("/:id", async (req: Request, res: Response, next: NextFunction) => {
+  const { id } = req.params;
+  const userId = res.locals.user?.id;
+  const permissions = res.locals.permissions || [];
+  const isAdmin = permissions.includes('admin') || permissions.includes('*:*:*');
+
+  try {
+    const knowledge = await KnowledgeService.getKnowledgeById(Number(id));
+
+    if (!knowledge) {
+      return res.status(404).json({ code: 404, message: "内容不存在", data: null });
+    }
+
+    // 权限检查
+    if (knowledge.safe === 2 && knowledge.userId !== userId && !isAdmin) {
+      return res.status(403).json({ code: 403, message: "无权访问", data: null });
+    }
+
+    res.json({ code: 200, message: "获取成功", data: knowledge });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 获取详情失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 获取子节点
+ * @apiParam {number} id 父节点ID（路径参数，必填）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object[]} data 子节点列表
+ */
+router.get("/:id/children", async (req: Request, res: Response, next: NextFunction) => {
+  const { id } = req.params;
+
+  try {
+    const children = await KnowledgeService.getChildren(Number(id));
+    res.json({ code: 200, message: "获取成功", data: children });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 获取子节点失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 创建内容
+ * @apiParam {string} name 名称（必填）
+ * @apiParam {number} type 类型（必填，0:文件夹, 1:笔记, 2:书籍）
+ * @apiParam {number} [safe] 安全等级（可选，默认0）
+ * @apiParam {string} [description] 描述（可选）
+ * @apiParam {string} [content] 内容（可选）
+ * @apiParam {string} [contentText] 文本内容（可选）
+ * @apiParam {string} [coverImage] 封面图片（可选）
+ * @apiParam {string} [author] 作者（可选）
+ * @apiParam {string} [isbn] ISBN（可选）
+ * @apiParam {number} [parentId] 父节点ID（可选）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object} data 创建的内容信息
+ */
+router.post("/", validate(schemas.createKnowledgeSchema), async (req: Request, res: Response, next: NextFunction) => {
+  const userId = res.locals.user?.id;
+  const { parentId, ...data } = req.body;
+
+  try {
+    const result = await KnowledgeService.createKnowledge({
+      ...data,
+      userId,
+      parentId,
+    });
+    res.json({ code: 200, message: "创建成功", data: result });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 创建失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 批量创建
+ * @apiParam {number} [parentId] 父节点ID（可选）
+ * @apiParam {Object[]} items 批量项目（必填）
+ * @apiParam {string} items[].name 名称（必填）
+ * @apiParam {number} items[].type 类型（必填，0:文件夹, 1:笔记, 2:书籍）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object[]} data 批量创建结果
+ */
+router.post("/batch", validate(schemas.batchCreateKnowledgeSchema), async (req: Request, res: Response, next: NextFunction) => {
+  const userId = res.locals.user?.id;
+  const { parentId, items } = req.body;
+
+  try {
+    const results = await KnowledgeService.createKnowledgeBatch(items, userId, parentId);
+    res.json({ code: 200, message: "批量创建完成", data: results });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 批量创建失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 批量获取详情
+ * @apiParam {number[]} ids 内容ID数组（必填）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object[]} data 内容详情数组
+ */
+router.post("/batch-detail", validate(schemas.batchDetailKnowledgeSchema), async (req: Request, res: Response, next: NextFunction) => {
+  const { ids } = req.body;
+
+  try {
+    const result = await KnowledgeService.getKnowledgeByIds(ids);
+    res.json({ code: 200, message: "获取成功", data: result });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 批量获取详情失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 更新内容
+ * @apiParam {number} id 内容ID（路径参数，必填）
+ * @apiParam {string} [name] 名称（可选）
+ * @apiParam {number} [type] 类型（可选）
+ * @apiParam {number} [safe] 安全等级（可选）
+ * @apiParam {string} [description] 描述（可选）
+ * @apiParam {string} [content] 内容（可选）
+ * @apiParam {string} [contentText] 文本内容（可选）
+ * @apiParam {string} [coverImage] 封面图片（可选）
+ * @apiParam {string} [author] 作者（可选）
+ * @apiParam {string} [isbn] ISBN（可选）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object} data 更新后的内容信息
+ */
+router.post("/:id", validate(schemas.updateKnowledgeSchema), async (req: Request, res: Response, next: NextFunction) => {
+  const { id } = req.params;
+  const userId = res.locals.user?.id;
+  const data = req.body;
+
+  try {
+    await KnowledgeService.updateKnowledge(Number(id), data, userId);
+    const result = await KnowledgeService.getKnowledgeById(Number(id));
+    res.json({ code: 200, message: "更新成功", data: result });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 更新失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 移动节点
+ * @apiParam {number} id 内容ID（路径参数，必填）
+ * @apiParam {number} newParentId 新父节点ID（必填）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object} data 移动结果
+ */
+router.post("/:id/move", validate(schemas.moveKnowledgeSchema), async (req: Request, res: Response, next: NextFunction) => {
+  const { id } = req.params;
+  const userId = res.locals.user?.id;
+  const { newParentId } = req.body;
+
+  try {
+    const result = await KnowledgeService.moveKnowledge(Number(id), newParentId, userId);
+    res.json({ code: 200, message: "移动成功", data: result });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 移动失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 更新置顶状态
+ * @apiParam {number} id 内容ID（路径参数，必填）
+ * @apiParam {number} isTop 是否置顶（必填，0:否, 1:是）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object} data 更新结果
+ */
+router.post("/:id/isTop", validate(schemas.updateIsTopSchema), async (req: Request, res: Response, next: NextFunction) => {
+  const { id } = req.params;
+  const userId = res.locals.user?.id;
+  const { isTop } = req.body;
+
+  try {
+    const result = await KnowledgeService.updateIsTop(Number(id), isTop, userId);
+    res.json({ code: 200, message: "更新成功", data: result });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 更新置顶状态失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 更新安全等级
+ * @apiParam {number} id 内容ID（路径参数，必填）
+ * @apiParam {number} safe 安全等级（必填，0:公开, 1:私有, 2:加密）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {Object} data 更新结果
+ */
+router.post("/:id/safe", validate(schemas.updateSafeSchema), async (req: Request, res: Response, next: NextFunction) => {
+  const { id } = req.params;
+  const userId = res.locals.user?.id;
+  const { safe } = req.body;
+
+  try {
+    const result = await KnowledgeService.updateSafe(Number(id), safe, userId);
+    res.json({ code: 200, message: "更新成功", data: result });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 更新安全等级失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 逻辑删除
+ * @apiParam {number} id 内容ID（路径参数，必填）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {null} data 返回空
+ */
+router.delete("/:id", async (req: Request, res: Response, next: NextFunction) => {
+  const { id } = req.params;
+  const userId = res.locals.user?.id;
+
+  try {
+    await KnowledgeService.deleteKnowledge(Number(id), userId);
+    res.json({ code: 200, message: "删除成功", data: null });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 删除失败:", error);
+    next(error);
+  }
+});
+
+/**
+ * 真实删除（管理员）
+ * @apiParam {number} id 内容ID（路径参数，必填）
+ * @apiSuccess {number} code 状态码
+ * @apiSuccess {string} message 消息
+ * @apiSuccess {null} data 返回空
+ */
+router.delete("/:id/real", async (req: Request, res: Response, next: NextFunction) => {
+  const { id } = req.params;
+  const permissions = res.locals.permissions || [];
+  const isAdmin = permissions.includes('admin') || permissions.includes('*:*:*');
+
+  if (!isAdmin) {
+    return res.status(403).json({ code: 403, message: "需要管理员权限", data: null });
+  }
+
+  try {
+    await KnowledgeService.deleteKnowledgeReal(Number(id));
+    res.json({ code: 200, message: "删除成功", data: null });
+  } catch (error) {
+    logger.error("[KnowledgeRoute] 真实删除失败:", error);
+    next(error);
+  }
+});
+
+export default router;