wonder/knowledge-graph-agent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor: 按go modules规范重构

Browse Source
This commit is contained in:
wonder
2026-04-15 15:19:39 +08:00
parent 8c5cd3705a
commit 5d4bf761b8
21 changed files with 524 additions and 679 deletions
Download Patch File Download Diff File Expand all files Collapse all files
backend/docs/swagger.yaml
+74 -90
View File
@@ -1,29 +1,23 @@
basePath: /
definitions:
models.CreateEdgeRequest:
model.CreateEdgeRequest:
properties:
id:
description: 边的唯一标识
example: edge_123
type: string
label:
description: 边的显示标签
example: 包含
type: string
properties:
additionalProperties: true
description: 自定义属性
type: object
source:
description: 源节点ID
example: node_1
type: string
target:
description: 目标节点ID
example: node_2
type: string
type:
description: 边的类型（可选，默认为关系类型）
example: CONTAINS
type: string
required:
@@ -32,30 +26,24 @@ definitions:
- source
- target
type: object
models.CreateNodeRequest:
model.CreateNodeRequest:
properties:
id:
description: 节点唯一标识
example: node_123
type: string
label:
description: 节点显示标签
example: 人工智能
type: string
properties:
additionalProperties: true
description: 自定义属性
type: object
type:
description: 节点类型
example: 概念
type: string
x:
description: X坐标（可选）
example: 100
type: number
"y":
description: Y坐标（可选）
example: 200
type: number
required:
@@ -63,22 +51,19 @@ definitions:
- label
- type
type: object
models.DeleteResponse:
model.DeleteResponse:
properties:
id:
description: 被删除的实体ID（可选）
example: node_123
type: string
message:
description: 消息
example: 节点已成功删除
type: string
success:
description: 是否成功
example: true
type: boolean
type: object
models.Edge:
model.Edge:
properties:
id:
type: string
@@ -97,63 +82,57 @@ definitions:
type:
type: string
type: object
models.EdgeResponse:
model.EdgeResponse:
properties:
id:
description: 边的ID
example: edge_123
type: string
label:
description: 边的显示标签
example: 包含
type: string
properties:
additionalProperties: true
description: 自定义属性
type: object
source:
description: 源节点ID
example: node_1
type: string
target:
description: 目标节点ID
example: node_2
type: string
type:
description: 边的类型
example: CONTAINS
type: string
type: object
models.ErrorResponse:
model.ErrorResponse:
properties:
error:
type: string
message:
type: string
type: object
models.GraphData:
model.GraphData:
properties:
edges:
items:
$ref: '#/definitions/models.Edge'
$ref: '#/definitions/model.Edge'
type: array
nodes:
items:
$ref: '#/definitions/models.Node'
$ref: '#/definitions/model.Node'
type: array
type: object
models.NeighborResponse:
model.NeighborResponse:
properties:
edges:
items:
$ref: '#/definitions/models.Edge'
$ref: '#/definitions/model.Edge'
type: array
nodes:
items:
$ref: '#/definitions/models.Node'
$ref: '#/definitions/model.Node'
type: array
type: object
models.Node:
model.Node:
properties:
id:
type: string
@@ -172,31 +151,41 @@ definitions:
"y":
type: number
type: object
models.NodeResponse:
model.NodeResponse:
properties:
id:
example: "1"
type: string
label:
example: 人工智能
type: string
neighbors:
items:
$ref: '#/definitions/model.Node'
type: array
properties:
additionalProperties: true
type: object
style:
additionalProperties: true
type: object
type:
example: 概念
type: string
x:
type: number
"y":
type: number
type: object
models.SearchResponse:
model.SearchResponse:
properties:
count:
type: integer
results:
nodes:
items:
$ref: '#/definitions/models.Node'
$ref: '#/definitions/model.Node'
type: array
query:
type: string
type: object
models.SimpleEdge:
model.SimpleEdge:
properties:
label:
example: 包含
@@ -211,18 +200,18 @@ definitions:
example: CONTAINS
type: string
type: object
models.SimpleGraphData:
model.SimpleGraphData:
properties:
edges:
items:
$ref: '#/definitions/models.SimpleEdge'
$ref: '#/definitions/model.SimpleEdge'
type: array
nodes:
items:
$ref: '#/definitions/models.SimpleNode'
$ref: '#/definitions/model.SimpleNode'
type: array
type: object
models.SimpleNode:
model.SimpleNode:
properties:
id:
example: "1"
@@ -234,26 +223,21 @@ definitions:
example: 概念
type: string
type: object
models.UpdateNodeRequest:
model.UpdateNodeRequest:
properties:
label:
description: 节点显示标签
example: 机器学习
type: string
properties:
additionalProperties: true
description: 自定义属性（更新）
type: object
type:
description: 节点类型
example: 工具
type: string
x:
description: X坐标
example: 150
type: number
"y":
description: Y坐标
example: 250
type: number
type: object
@@ -275,30 +259,30 @@ paths:
name: request
required: true
schema:
$ref: '#/definitions/models.CreateEdgeRequest'
$ref: '#/definitions/model.CreateEdgeRequest'
produces:
- application/json
responses:
"200":
description: 创建成功
schema:
$ref: '#/definitions/models.EdgeResponse'
$ref: '#/definitions/model.EdgeResponse'
"400":
description: 请求错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"404":
description: 源节点或目标节点未找到
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"409":
description: 边已存在
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"500":
description: 内部错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
summary: 创建边
/api/edges/{id}:
delete:
@@ -315,15 +299,15 @@ paths:
"200":
description: 删除成功
schema:
$ref: '#/definitions/models.DeleteResponse'
$ref: '#/definitions/model.DeleteResponse'
"404":
description: 边未找到
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"500":
description: 内部错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
summary: 删除边
/api/graph:
get:
@@ -334,11 +318,11 @@ paths:
"200":
description: 成功
schema:
$ref: '#/definitions/models.GraphData'
$ref: '#/definitions/model.GraphData'
"500":
description: 内部错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
summary: 获取图数据
/api/graph/simpleJson:
get:
@@ -349,11 +333,11 @@ paths:
"200":
description: 成功
schema:
$ref: '#/definitions/models.SimpleGraphData'
$ref: '#/definitions/model.SimpleGraphData'
"500":
description: 内部错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
summary: 获取简化图数据
/api/graph/stats:
get:
@@ -369,7 +353,7 @@ paths:
"500":
description: 内部错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
summary: 获取图统计信息
/api/nodes:
post:
@@ -382,26 +366,26 @@ paths:
name: request
required: true
schema:
$ref: '#/definitions/models.CreateNodeRequest'
$ref: '#/definitions/model.CreateNodeRequest'
produces:
- application/json
responses:
"200":
description: 创建成功
schema:
$ref: '#/definitions/models.Node'
$ref: '#/definitions/model.Node'
"400":
description: 请求错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"409":
description: 节点已存在
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"500":
description: 内部错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
summary: 创建节点
/api/nodes/{id}:
delete:
@@ -418,15 +402,15 @@ paths:
"200":
description: 删除成功
schema:
$ref: '#/definitions/models.DeleteResponse'
$ref: '#/definitions/model.DeleteResponse'
"404":
description: 节点未找到
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"500":
description: 内部错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
summary: 删除节点
get:
description: 根据节点 ID 获取知识图谱中的节点详细信息
@@ -442,19 +426,19 @@ paths:
"200":
description: 成功
schema:
$ref: '#/definitions/models.NodeResponse'
$ref: '#/definitions/model.NodeResponse'
"400":
description: 请求错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"404":
description: 节点未找到
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"500":
description: 内部错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
summary: 获取节点详情
put:
consumes:
@@ -471,26 +455,26 @@ paths:
name: request
required: true
schema:
$ref: '#/definitions/models.UpdateNodeRequest'
$ref: '#/definitions/model.UpdateNodeRequest'
produces:
- application/json
responses:
"200":
description: 更新成功
schema:
$ref: '#/definitions/models.Node'
$ref: '#/definitions/model.Node'
"400":
description: 请求错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"404":
description: 节点未找到
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"500":
description: 内部错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
summary: 更新节点
/api/nodes/{id}/neighbors:
get:
@@ -507,19 +491,19 @@ paths:
"200":
description: 成功
schema:
$ref: '#/definitions/models.NeighborResponse'
$ref: '#/definitions/model.NeighborResponse'
"400":
description: 请求错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"404":
description: 节点未找到
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"500":
description: 内部错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
summary: 获取节点邻居
/api/search:
get:
@@ -536,14 +520,14 @@ paths:
"200":
description: 成功
schema:
$ref: '#/definitions/models.SearchResponse'
$ref: '#/definitions/model.SearchResponse'
"400":
description: 请求错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
"500":
description: 内部错误
schema:
$ref: '#/definitions/models.ErrorResponse'
$ref: '#/definitions/model.ErrorResponse'
summary: 搜索节点
swagger: "2.0"