api definition: get knowledge and tags of knowledge #2192

actiontech · Feb 8, 2025 · 0719fe8 · 0719fe8
1 parent f1fbe1a
commit 0719fe8
Show file tree

Hide file tree

Showing 4 changed files with 458 additions and 0 deletions.
diff --git a/sqle/api/controller/v1/knowledge.go b/sqle/api/controller/v1/knowledge.go
@@ -0,0 +1,64 @@
+package v1
+
+import (
+	"github.com/actiontech/sqle/sqle/api/controller"
+	"github.com/labstack/echo/v4"
+)
+
+type GetKnowledgeListReq struct {
+	KeyWords string   `json:"keywords" query:"keywords" example:"keywords"` // 搜索内容
+	Tags     []string `json:"tags" query:"tags" example:"tag1"`             // 搜索标签
+	Limit    uint32   `json:"limit" query:"limit" example:"10" validate:"required"`
+	Offset   uint32   `json:"offset" query:"offset" example:"0"`
+}
+
+type GetKnowledgeListRes struct {
+	controller.BaseRes
+	Data      []*Knowledge `json:"data"`
+	TotalNums uint64       `json:"total_nums"`
+}
+
+type Knowledge struct {
+	ID          uint   `json:"id"`          // 知识库ID
+	Title       string `json:"title"`       // 标题
+	Description string `json:"description"` // 描述
+	Content     string `json:"content"`     // 内容
+	Tags        []*Tag `json:"tags"`        // 标签
+}
+
+type Tag struct {
+	ID   uint   `json:"id"`   // 标签ID
+	Name string `json:"name"` // 标签名称
+}
+
+// GetKnowledgeList
+// @Summary 获取知识库列表
+// @Description get knowledge list
+// @Id getKnowledgeList
+// @Tags knowledge
+// @Param keywords query string false "keywords"
+// @Param tags query []string false "tags"
+// @Security ApiKeyAuth
+// @Success 200 {object} v1.GetKnowledgeListRes
+// @router /v1/knowledge [get]
+func GetKnowledgeList(c echo.Context) error {
+	return nil
+}
+
+type GetKnowledgeTagListRes struct {
+	controller.BaseRes
+	TotalNums uint64 `json:"total_nums"`
+	Data      []*Tag `json:"data"`
+}
+
+// GetKnowledgeTagList
+// @Summary 获取知识库标签列表
+// @Description get knowledge tag list
+// @Id getKnowledgeTagList
+// @Tags knowledge
+// @Security ApiKeyAuth
+// @Success 200 {object} v1.GetKnowledgeTagListRes
+// @router /v1/knowledge/tags [get]
+func GetKnowledgeTagList(c echo.Context) error {
+	return nil
+}
diff --git a/sqle/docs/docs.go b/sqle/docs/docs.go
@@ -1369,6 +1369,69 @@ var doc = `{
                 }
             }
         },
+        "/v1/knowledge": {
+            "get": {
+                "security": [
+                    {
+                        "ApiKeyAuth": []
+                    }
+                ],
+                "description": "get knowledge list",
+                "tags": [
+                    "knowledge"
+                ],
+                "summary": "获取知识库列表",
+                "operationId": "getKnowledgeList",
+                "parameters": [
+                    {
+                        "type": "string",
+                        "description": "keywords",
+                        "name": "keywords",
+                        "in": "query"
+                    },
+                    {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        },
+                        "description": "tags",
+                        "name": "tags",
+                        "in": "query"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/v1.GetKnowledgeListRes"
+                        }
+                    }
+                }
+            }
+        },
+        "/v1/knowledge/tags": {
+            "get": {
+                "security": [
+                    {
+                        "ApiKeyAuth": []
+                    }
+                ],
+                "description": "get knowledge tag list",
+                "tags": [
+                    "knowledge"
+                ],
+                "summary": "获取知识库标签列表",
+                "operationId": "getKnowledgeTagList",
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/v1.GetKnowledgeTagListRes"
+                        }
+                    }
+                }
+            }
+        },
         "/v1/operation_records": {
             "get": {
                 "security": [
@@ -14496,6 +14559,50 @@ var doc = `{
                 }
             }
         },
+        "v1.GetKnowledgeListRes": {
+            "type": "object",
+            "properties": {
+                "code": {
+                    "type": "integer",
+                    "example": 0
+                },
+                "data": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/v1.Knowledge"
+                    }
+                },
+                "message": {
+                    "type": "string",
+                    "example": "ok"
+                },
+                "total_nums": {
+                    "type": "integer"
+                }
+            }
+        },
+        "v1.GetKnowledgeTagListRes": {
+            "type": "object",
+            "properties": {
+                "code": {
+                    "type": "integer",
+                    "example": 0
+                },
+                "data": {
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/v1.Tag"
+                    }
+                },
+                "message": {
+                    "type": "string",
+                    "example": "ok"
+                },
+                "total_nums": {
+                    "type": "integer"
+                }
+            }
+        },
         "v1.GetLicenseResV1": {
             "type": "object",
             "properties": {
@@ -16197,6 +16304,34 @@ var doc = `{
                 }
             }
         },
+        "v1.Knowledge": {
+            "type": "object",
+            "properties": {
+                "content": {
+                    "description": "内容",
+                    "type": "string"
+                },
+                "description": {
+                    "description": "描述",
+                    "type": "string"
+                },
+                "id": {
+                    "description": "知识库ID",
+                    "type": "integer"
+                },
+                "tags": {
+                    "description": "标签",
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/v1.Tag"
+                    }
+                },
+                "title": {
+                    "description": "标题",
+                    "type": "string"
+                }
+            }
+        },
         "v1.LicenseItem": {
             "type": "object",
             "properties": {
@@ -17997,6 +18132,19 @@ var doc = `{
                 }
             }
         },
+        "v1.Tag": {
+            "type": "object",
+            "properties": {
+                "id": {
+                    "description": "标签ID",
+                    "type": "integer"
+                },
+                "name": {
+                    "description": "标签名称",
+                    "type": "string"
+                }
+            }
+        },
         "v1.TargetReleaseInstance": {
             "type": "object",
             "properties": {