feat: add knowledge directory management for documents and FAQs

- Implemented directory validation in Create and Update knowledge document services.
- Added directory selection in document and FAQ edit dialogs with a new KnowledgeDirectoryPanel component.
- Enhanced API to support fetching, creating, updating, and deleting knowledge directories.
- Updated data models to include directory information for knowledge documents and FAQs.
- Added translations for directory-related messages in English and Chinese.

internal/handlers/dashboard/knowledge_directory_handler.go

@@ -0,0 +1,120 @@
+package dashboard
+
+import (
+	"agent-desk/internal/builders"
+	"agent-desk/internal/models"
+	"agent-desk/internal/pkg/constants"
+	"agent-desk/internal/pkg/dto/request"
+	"agent-desk/internal/pkg/dto/response"
+	"agent-desk/internal/pkg/errorsx"
+	"agent-desk/internal/pkg/httpx"
+	"agent-desk/internal/pkg/httpx/params"
+	"agent-desk/internal/services"
+
+	"github.com/gin-gonic/gin"
+)
+
+func KnowledgeDirectoryGetList_all(ctx *gin.Context) {
+	if _, err := services.AuthService.RequirePermission(ctx, constants.PermissionKnowledgeBaseView); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	knowledgeBaseID, ok := params.GetInt64(ctx, "knowledgeBaseId")
+	if !ok || knowledgeBaseID <= 0 {
+		httpx.WriteJSON(ctx, errorsx.InvalidParam("知识库不存在"))
+		return
+	}
+	list := services.KnowledgeDirectoryService.FindAllByKnowledgeBaseID(knowledgeBaseID)
+	httpx.WriteJSON(ctx, buildKnowledgeDirectoryTreeResponses(list))
+}
+
+func KnowledgeDirectoryPostCreate(ctx *gin.Context) {
+	operator, err := services.AuthService.RequirePermission(ctx, constants.PermissionKnowledgeBaseCreate)
+	if err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	req := request.CreateKnowledgeDirectoryRequest{}
+	if err := params.ReadJSON(ctx, &req); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	item, err := services.KnowledgeDirectoryService.CreateDirectory(req, operator)
+	if err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	resp := builders.BuildKnowledgeDirectory(item)
+	httpx.WriteJSON(ctx, &resp)
+}
+
+func KnowledgeDirectoryPostUpdate(ctx *gin.Context) {
+	operator, err := services.AuthService.RequirePermission(ctx, constants.PermissionKnowledgeBaseUpdate)
+	if err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	req := request.UpdateKnowledgeDirectoryRequest{}
+	if err := params.ReadJSON(ctx, &req); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	if err := services.KnowledgeDirectoryService.UpdateDirectory(req, operator); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	httpx.WriteJSON(ctx, nil)
+}
+
+func KnowledgeDirectoryPostDelete(ctx *gin.Context) {
+	if _, err := services.AuthService.RequirePermission(ctx, constants.PermissionKnowledgeBaseDelete); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	req := request.DeleteKnowledgeDirectoryRequest{}
+	if err := params.ReadJSON(ctx, &req); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	if err := services.KnowledgeDirectoryService.DeleteDirectory(req.ID); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	httpx.WriteJSON(ctx, nil)
+}
+
+func KnowledgeDirectoryPostUpdate_sort(ctx *gin.Context) {
+	var req struct {
+		KnowledgeBaseID int64   `json:"knowledgeBaseId"`
+		ParentID        int64   `json:"parentId"`
+		IDs             []int64 `json:"ids"`
+	}
+	if err := params.ReadJSON(ctx, &req); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	if err := services.KnowledgeDirectoryService.UpdateSort(req.KnowledgeBaseID, req.ParentID, req.IDs); err != nil {
+		httpx.WriteJSON(ctx, err)
+		return
+	}
+	httpx.WriteJSON(ctx, nil)
+}
+
+func buildKnowledgeDirectoryTreeResponses(list []models.KnowledgeDirectory) []response.KnowledgeDirectoryResponse {
+	childrenByParent := make(map[int64][]models.KnowledgeDirectory, len(list))
+	for _, item := range list {
+		childrenByParent[item.ParentID] = append(childrenByParent[item.ParentID], item)
+	}
+	var build func(parentID int64) []response.KnowledgeDirectoryResponse
+	build = func(parentID int64) []response.KnowledgeDirectoryResponse {
+		items := childrenByParent[parentID]
+		ret := make([]response.KnowledgeDirectoryResponse, 0, len(items))
+		for _, item := range items {
+			resp := builders.BuildKnowledgeDirectory(&item)
+			resp.Children = build(item.ID)
+			ret = append(ret, resp)
+		}
+		return ret
+	}
+	return build(0)
+}

internal/handlers/dashboard/knowledge_document_handler.go

@@ -25,6 +25,10 @@ func KnowledgeDocumentAnyList(ctx *gin.Context) {
 		params.QueryFilter{ParamName: "knowledgeBaseId"},
 		params.QueryFilter{ParamName: "title", Op: params.Like},
 	).Desc("id")
+	knowledgeBaseID, _ := params.GetInt64(ctx, "knowledgeBaseId")
+	if directoryID, ok := params.GetInt64(ctx, "directoryId"); ok {
+		cnd.Where("directory_id = ?", directoryID)
+	}
 
 	if status, ok := params.GetInt64(ctx, "status"); ok {
 		cnd.Where("status = ?", status)
@@ -40,9 +44,12 @@ func KnowledgeDocumentAnyList(ctx *gin.Context) {
 	}
 
 	list, paging := services.KnowledgeDocumentService.FindPageListByCnd(cnd)
+	directoryPaths := services.KnowledgeDirectoryService.PathMap(knowledgeBaseID)
 	results := make([]response.KnowledgeDocumentListResponse, 0, len(list))
 	for _, item := range list {
-		results = append(results, builders.BuildKnowledgeDocumentList(&item))
+		resp := builders.BuildKnowledgeDocumentList(&item)
+		fillKnowledgeDocumentDirectory(&resp, directoryPaths)
+		results = append(results, resp)
 	}
 	httpx.WriteJSON(ctx, &web.PageResult{Results: results, Page: paging})
 }
@@ -62,7 +69,20 @@ func KnowledgeDocumentGetBy(ctx *gin.Context) {
 		httpx.WriteJSON(ctx, web.JsonErrorMsg("文档不存在"))
 		return
 	}
-	httpx.WriteJSON(ctx, builders.BuildKnowledgeDocument(item))
+	resp := builders.BuildKnowledgeDocument(item)
+	fillKnowledgeDocumentDirectory(&resp, services.KnowledgeDirectoryService.PathMap(item.KnowledgeBaseID))
+	httpx.WriteJSON(ctx, resp)
+}
+
+func fillKnowledgeDocumentDirectory(resp any, directoryPaths map[int64]string) {
+	switch item := resp.(type) {
+	case *response.KnowledgeDocumentResponse:
+		item.DirectoryPath = directoryPaths[item.DirectoryID]
+		item.DirectoryName = item.DirectoryPath
+	case *response.KnowledgeDocumentListResponse:
+		item.DirectoryPath = directoryPaths[item.DirectoryID]
+		item.DirectoryName = item.DirectoryPath
+	}
 }
 
 func KnowledgeDocumentPostCreate(ctx *gin.Context) {

internal/handlers/dashboard/knowledge_faq_handler.go

@@ -101,10 +101,17 @@ func KnowledgeFAQAnyList(ctx *gin.Context) {
 		params.QueryFilter{ParamName: "question", Op: params.Like},
 		params.QueryFilter{ParamName: "indexStatus"},
 	).Desc("id")
+	knowledgeBaseID, _ := params.GetInt64(ctx, "knowledgeBaseId")
+	if directoryID, ok := params.GetInt64(ctx, "directoryId"); ok {
+		cnd.Where("directory_id = ?", directoryID)
+	}
 	list, paging := services.KnowledgeFAQService.FindPageByCnd(cnd)
+	directoryPaths := services.KnowledgeDirectoryService.PathMap(knowledgeBaseID)
 	results := make([]response.KnowledgeFAQResponse, 0, len(list))
 	for _, item := range list {
-		results = append(results, builders.BuildKnowledgeFAQ(&item))
+		resp := builders.BuildKnowledgeFAQ(&item)
+		fillKnowledgeFAQDirectory(&resp, directoryPaths)
+		results = append(results, resp)
 	}
 	httpx.WriteJSON(ctx, &web.PageResult{Results: results, Page: paging})
 }
@@ -124,7 +131,9 @@ func KnowledgeFAQGetBy(ctx *gin.Context) {
 		httpx.WriteJSON(ctx, web.JsonErrorMsg("FAQ不存在"))
 		return
 	}
-	httpx.WriteJSON(ctx, builders.BuildKnowledgeFAQ(item))
+	resp := builders.BuildKnowledgeFAQ(item)
+	fillKnowledgeFAQDirectory(&resp, services.KnowledgeDirectoryService.PathMap(item.KnowledgeBaseID))
+	httpx.WriteJSON(ctx, resp)
 }
 
 func KnowledgeFAQPostCreate(ctx *gin.Context) {
@@ -188,3 +197,8 @@ func writeKnowledgeFAQExcelFile(ctx *gin.Context, file *response.KnowledgeFAQExp
 	ctx.Header("Cache-Control", "no-store")
 	ctx.Data(http.StatusOK, file.ContentType, file.Data)
 }
+
+func fillKnowledgeFAQDirectory(resp *response.KnowledgeFAQResponse, directoryPaths map[int64]string) {
+	resp.DirectoryPath = directoryPaths[resp.DirectoryID]
+	resp.DirectoryName = resp.DirectoryPath
+}