fix: 修复一系列问题并生成swagger一键脚本

backend/docs/swagger.yaml

@@ -1,6 +1,6 @@
 basePath: /
 definitions:
-  model.CreateEdgeRequest:
+  knowledge-graph-backend_internal_model.CreateEdgeRequest:
     properties:
       id:
         example: edge_123
@@ -26,7 +26,7 @@ definitions:
     - source
     - target
     type: object
-  model.CreateNodeRequest:
+  knowledge-graph-backend_internal_model.CreateNodeRequest:
     properties:
       id:
         example: node_123
@@ -51,7 +51,7 @@ definitions:
     - label
     - type
     type: object
-  model.DeleteResponse:
+  knowledge-graph-backend_internal_model.DeleteResponse:
     properties:
       id:
         example: node_123
@@ -63,7 +63,7 @@ definitions:
         example: true
         type: boolean
     type: object
-  model.Edge:
+  knowledge-graph-backend_internal_model.Edge:
     properties:
       id:
         type: string
@@ -82,7 +82,7 @@ definitions:
       type:
         type: string
     type: object
-  model.EdgeResponse:
+  knowledge-graph-backend_internal_model.EdgeResponse:
     properties:
       id:
         example: edge_123
@@ -103,36 +103,38 @@ definitions:
         example: CONTAINS
         type: string
     type: object
-  model.ErrorResponse:
+  knowledge-graph-backend_internal_model.ErrorResponse:
     properties:
       error:
+        example: bad_request
         type: string
       message:
+        example: invalid request
         type: string
     type: object
-  model.GraphData:
+  knowledge-graph-backend_internal_model.GraphData:
     properties:
       edges:
         items:
-          $ref: '#/definitions/model.Edge'
+          $ref: '#/definitions/knowledge-graph-backend_internal_model.Edge'
         type: array
       nodes:
         items:
-          $ref: '#/definitions/model.Node'
+          $ref: '#/definitions/knowledge-graph-backend_internal_model.Node'
         type: array
     type: object
-  model.NeighborResponse:
+  knowledge-graph-backend_internal_model.NeighborResponse:
     properties:
       edges:
         items:
-          $ref: '#/definitions/model.Edge'
+          $ref: '#/definitions/knowledge-graph-backend_internal_model.Edge'
         type: array
       nodes:
         items:
-          $ref: '#/definitions/model.Node'
+          $ref: '#/definitions/knowledge-graph-backend_internal_model.Node'
         type: array
     type: object
-  model.Node:
+  knowledge-graph-backend_internal_model.Node:
     properties:
       id:
         type: string
@@ -151,7 +153,7 @@ definitions:
       "y":
         type: number
     type: object
-  model.NodeResponse:
+  knowledge-graph-backend_internal_model.NodeResponse:
     properties:
       id:
         type: string
@@ -159,7 +161,7 @@ definitions:
         type: string
       neighbors:
         items:
-          $ref: '#/definitions/model.Node'
+          $ref: '#/definitions/knowledge-graph-backend_internal_model.Node'
         type: array
       properties:
         additionalProperties: true
@@ -174,18 +176,18 @@ definitions:
       "y":
         type: number
     type: object
-  model.SearchResponse:
+  knowledge-graph-backend_internal_model.SearchResponse:
     properties:
       count:
         type: integer
       nodes:
         items:
-          $ref: '#/definitions/model.Node'
+          $ref: '#/definitions/knowledge-graph-backend_internal_model.Node'
         type: array
       query:
         type: string
     type: object
-  model.SimpleEdge:
+  knowledge-graph-backend_internal_model.SimpleEdge:
     properties:
       label:
         example: 包含
@@ -200,18 +202,18 @@ definitions:
         example: CONTAINS
         type: string
     type: object
-  model.SimpleGraphData:
+  knowledge-graph-backend_internal_model.SimpleGraphData:
     properties:
       edges:
         items:
-          $ref: '#/definitions/model.SimpleEdge'
+          $ref: '#/definitions/knowledge-graph-backend_internal_model.SimpleEdge'
         type: array
       nodes:
         items:
-          $ref: '#/definitions/model.SimpleNode'
+          $ref: '#/definitions/knowledge-graph-backend_internal_model.SimpleNode'
         type: array
     type: object
-  model.SimpleNode:
+  knowledge-graph-backend_internal_model.SimpleNode:
     properties:
       id:
         example: "1"
@@ -223,7 +225,7 @@ definitions:
         example: 概念
         type: string
     type: object
-  model.UpdateNodeRequest:
+  knowledge-graph-backend_internal_model.UpdateNodeRequest:
     properties:
       label:
         example: 机器学习
@@ -259,30 +261,30 @@ paths:
         name: request
         required: true
         schema:
-          $ref: '#/definitions/model.CreateEdgeRequest'
+          $ref: '#/definitions/knowledge-graph-backend_internal_model.CreateEdgeRequest'
       produces:
       - application/json
       responses:
         "200":
           description: 创建成功
           schema:
-            $ref: '#/definitions/model.EdgeResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.EdgeResponse'
         "400":
           description: 请求错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "404":
           description: 源节点或目标节点未找到
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "409":
           description: 边已存在
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "500":
           description: 内部错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
       summary: 创建边
   /api/edges/{id}:
     delete:
@@ -299,15 +301,15 @@ paths:
         "200":
           description: 删除成功
           schema:
-            $ref: '#/definitions/model.DeleteResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.DeleteResponse'
         "404":
           description: 边未找到
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "500":
           description: 内部错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
       summary: 删除边
   /api/graph:
     get:
@@ -318,11 +320,11 @@ paths:
         "200":
           description: 成功
           schema:
-            $ref: '#/definitions/model.GraphData'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.GraphData'
         "500":
           description: 内部错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
       summary: 获取图数据
   /api/graph/simpleJson:
     get:
@@ -333,11 +335,11 @@ paths:
         "200":
           description: 成功
           schema:
-            $ref: '#/definitions/model.SimpleGraphData'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.SimpleGraphData'
         "500":
           description: 内部错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
       summary: 获取简化图数据
   /api/graph/stats:
     get:
@@ -353,7 +355,7 @@ paths:
         "500":
           description: 内部错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
       summary: 获取图统计信息
   /api/nodes:
     post:
@@ -366,26 +368,26 @@ paths:
         name: request
         required: true
         schema:
-          $ref: '#/definitions/model.CreateNodeRequest'
+          $ref: '#/definitions/knowledge-graph-backend_internal_model.CreateNodeRequest'
       produces:
       - application/json
       responses:
         "200":
           description: 创建成功
           schema:
-            $ref: '#/definitions/model.Node'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.Node'
         "400":
           description: 请求错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "409":
           description: 节点已存在
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "500":
           description: 内部错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
       summary: 创建节点
   /api/nodes/{id}:
     delete:
@@ -402,15 +404,15 @@ paths:
         "200":
           description: 删除成功
           schema:
-            $ref: '#/definitions/model.DeleteResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.DeleteResponse'
         "404":
           description: 节点未找到
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "500":
           description: 内部错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
       summary: 删除节点
     get:
       description: 根据节点 ID 获取知识图谱中的节点详细信息
@@ -426,19 +428,19 @@ paths:
         "200":
           description: 成功
           schema:
-            $ref: '#/definitions/model.NodeResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.NodeResponse'
         "400":
           description: 请求错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "404":
           description: 节点未找到
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "500":
           description: 内部错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
       summary: 获取节点详情
     put:
       consumes:
@@ -455,26 +457,26 @@ paths:
         name: request
         required: true
         schema:
-          $ref: '#/definitions/model.UpdateNodeRequest'
+          $ref: '#/definitions/knowledge-graph-backend_internal_model.UpdateNodeRequest'
       produces:
       - application/json
       responses:
         "200":
           description: 更新成功
           schema:
-            $ref: '#/definitions/model.Node'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.Node'
         "400":
           description: 请求错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "404":
           description: 节点未找到
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "500":
           description: 内部错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
       summary: 更新节点
   /api/nodes/{id}/neighbors:
     get:
@@ -491,19 +493,19 @@ paths:
         "200":
           description: 成功
           schema:
-            $ref: '#/definitions/model.NeighborResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.NeighborResponse'
         "400":
           description: 请求错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "404":
           description: 节点未找到
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "500":
           description: 内部错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
       summary: 获取节点邻居
   /api/search:
     get:
@@ -520,14 +522,14 @@ paths:
         "200":
           description: 成功
           schema:
-            $ref: '#/definitions/model.SearchResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.SearchResponse'
         "400":
           description: 请求错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
         "500":
           description: 内部错误
           schema:
-            $ref: '#/definitions/model.ErrorResponse'
+            $ref: '#/definitions/knowledge-graph-backend_internal_model.ErrorResponse'
       summary: 搜索节点
 swagger: "2.0"