refactor: 按go modules规范重构

This commit is contained in:
2026-04-15 15:19:39 +08:00
parent 8c5cd3705a
commit 5d4bf761b8
21 changed files with 524 additions and 679 deletions
+83 -93
View File
@@ -32,7 +32,7 @@ const docTemplate = `{
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/models.CreateEdgeRequest"
"$ref": "#/definitions/model.CreateEdgeRequest"
}
}
],
@@ -40,31 +40,31 @@ const docTemplate = `{
"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"
}
}
}
@@ -90,19 +90,19 @@ const docTemplate = `{
"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"
}
}
}
@@ -119,13 +119,13 @@ const docTemplate = `{
"200": {
"description": "成功",
"schema": {
"$ref": "#/definitions/models.GraphData"
"$ref": "#/definitions/model.GraphData"
}
},
"500": {
"description": "内部错误",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"$ref": "#/definitions/model.ErrorResponse"
}
}
}
@@ -142,13 +142,13 @@ const docTemplate = `{
"200": {
"description": "成功",
"schema": {
"$ref": "#/definitions/models.SimpleGraphData"
"$ref": "#/definitions/model.SimpleGraphData"
}
},
"500": {
"description": "内部错误",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"$ref": "#/definitions/model.ErrorResponse"
}
}
}
@@ -172,7 +172,7 @@ const docTemplate = `{
"500": {
"description": "内部错误",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"$ref": "#/definitions/model.ErrorResponse"
}
}
}
@@ -195,7 +195,7 @@ const docTemplate = `{
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/models.CreateNodeRequest"
"$ref": "#/definitions/model.CreateNodeRequest"
}
}
],
@@ -203,25 +203,25 @@ const docTemplate = `{
"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"
}
}
}
@@ -247,25 +247,25 @@ const docTemplate = `{
"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"
}
}
}
@@ -293,7 +293,7 @@ const docTemplate = `{
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/models.UpdateNodeRequest"
"$ref": "#/definitions/model.UpdateNodeRequest"
}
}
],
@@ -301,25 +301,25 @@ const docTemplate = `{
"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"
}
}
}
@@ -343,19 +343,19 @@ const docTemplate = `{
"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"
}
}
}
@@ -381,25 +381,25 @@ const docTemplate = `{
"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"
}
}
}
@@ -425,19 +425,19 @@ const docTemplate = `{
"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"
}
}
}
@@ -445,7 +445,7 @@ const docTemplate = `{
}
},
"definitions": {
"models.CreateEdgeRequest": {
"model.CreateEdgeRequest": {
"type": "object",
"required": [
"id",
@@ -455,38 +455,32 @@ const docTemplate = `{
],
"properties": {
"id": {
"description": "边的唯一标识",
"type": "string",
"example": "edge_123"
},
"label": {
"description": "边的显示标签",
"type": "string",
"example": "包含"
},
"properties": {
"description": "自定义属性",
"type": "object",
"additionalProperties": true
},
"source": {
"description": "源节点ID",
"type": "string",
"example": "node_1"
},
"target": {
"description": "目标节点ID",
"type": "string",
"example": "node_2"
},
"type": {
"description": "边的类型(可选,默认为关系类型)",
"type": "string",
"example": "CONTAINS"
}
}
},
"models.CreateNodeRequest": {
"model.CreateNodeRequest": {
"type": "object",
"required": [
"id",
@@ -495,58 +489,49 @@ const docTemplate = `{
],
"properties": {
"id": {
"description": "节点唯一标识",
"type": "string",
"example": "node_123"
},
"label": {
"description": "节点显示标签",
"type": "string",
"example": "人工智能"
},
"properties": {
"description": "自定义属性",
"type": "object",
"additionalProperties": true
},
"type": {
"description": "节点类型",
"type": "string",
"example": "概念"
},
"x": {
"description": "X坐标(可选)",
"type": "number",
"example": 100
},
"y": {
"description": "Y坐标(可选)",
"type": "number",
"example": 200
}
}
},
"models.DeleteResponse": {
"model.DeleteResponse": {
"type": "object",
"properties": {
"id": {
"description": "被删除的实体ID(可选)",
"type": "string",
"example": "node_123"
},
"message": {
"description": "消息",
"type": "string",
"example": "节点已成功删除"
},
"success": {
"description": "是否成功",
"type": "boolean",
"example": true
}
}
},
"models.Edge": {
"model.Edge": {
"type": "object",
"properties": {
"id": {
@@ -574,42 +559,36 @@ const docTemplate = `{
}
}
},
"models.EdgeResponse": {
"model.EdgeResponse": {
"type": "object",
"properties": {
"id": {
"description": "边的ID",
"type": "string",
"example": "edge_123"
},
"label": {
"description": "边的显示标签",
"type": "string",
"example": "包含"
},
"properties": {
"description": "自定义属性",
"type": "object",
"additionalProperties": true
},
"source": {
"description": "源节点ID",
"type": "string",
"example": "node_1"
},
"target": {
"description": "目标节点ID",
"type": "string",
"example": "node_2"
},
"type": {
"description": "边的类型",
"type": "string",
"example": "CONTAINS"
}
}
},
"models.ErrorResponse": {
"model.ErrorResponse": {
"type": "object",
"properties": {
"error": {
@@ -620,41 +599,41 @@ const docTemplate = `{
}
}
},
"models.GraphData": {
"model.GraphData": {
"type": "object",
"properties": {
"edges": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Edge"
"$ref": "#/definitions/model.Edge"
}
},
"nodes": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Node"
"$ref": "#/definitions/model.Node"
}
}
}
},
"models.NeighborResponse": {
"model.NeighborResponse": {
"type": "object",
"properties": {
"edges": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Edge"
"$ref": "#/definitions/model.Edge"
}
},
"nodes": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Node"
"$ref": "#/definitions/model.Node"
}
}
}
},
"models.Node": {
"model.Node": {
"type": "object",
"properties": {
"id": {
@@ -682,42 +661,58 @@ const docTemplate = `{
}
}
},
"models.NodeResponse": {
"model.NodeResponse": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "1"
"type": "string"
},
"label": {
"type": "string",
"example": "人工智能"
"type": "string"
},
"neighbors": {
"type": "array",
"items": {
"$ref": "#/definitions/model.Node"
}
},
"properties": {
"type": "object",
"additionalProperties": true
},
"style": {
"type": "object",
"additionalProperties": true
},
"type": {
"type": "string",
"example": "概念"
"type": "string"
},
"x": {
"type": "number"
},
"y": {
"type": "number"
}
}
},
"models.SearchResponse": {
"model.SearchResponse": {
"type": "object",
"properties": {
"count": {
"type": "integer"
},
"results": {
"nodes": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Node"
"$ref": "#/definitions/model.Node"
}
},
"query": {
"type": "string"
}
}
},
"models.SimpleEdge": {
"model.SimpleEdge": {
"type": "object",
"properties": {
"label": {
@@ -738,24 +733,24 @@ const docTemplate = `{
}
}
},
"models.SimpleGraphData": {
"model.SimpleGraphData": {
"type": "object",
"properties": {
"edges": {
"type": "array",
"items": {
"$ref": "#/definitions/models.SimpleEdge"
"$ref": "#/definitions/model.SimpleEdge"
}
},
"nodes": {
"type": "array",
"items": {
"$ref": "#/definitions/models.SimpleNode"
"$ref": "#/definitions/model.SimpleNode"
}
}
}
},
"models.SimpleNode": {
"model.SimpleNode": {
"type": "object",
"properties": {
"id": {
@@ -772,31 +767,26 @@ const docTemplate = `{
}
}
},
"models.UpdateNodeRequest": {
"model.UpdateNodeRequest": {
"type": "object",
"properties": {
"label": {
"description": "节点显示标签",
"type": "string",
"example": "机器学习"
},
"properties": {
"description": "自定义属性(更新)",
"type": "object",
"additionalProperties": true
},
"type": {
"description": "节点类型",
"type": "string",
"example": "工具"
},
"x": {
"description": "X坐标",
"type": "number",
"example": 150
},
"y": {
"description": "Y坐标",
"type": "number",
"example": 250
}
+83 -93
View File
@@ -26,7 +26,7 @@
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/models.CreateEdgeRequest"
"$ref": "#/definitions/model.CreateEdgeRequest"
}
}
],
@@ -34,31 +34,31 @@
"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"
}
}
}
@@ -84,19 +84,19 @@
"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"
}
}
}
@@ -113,13 +113,13 @@
"200": {
"description": "成功",
"schema": {
"$ref": "#/definitions/models.GraphData"
"$ref": "#/definitions/model.GraphData"
}
},
"500": {
"description": "内部错误",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"$ref": "#/definitions/model.ErrorResponse"
}
}
}
@@ -136,13 +136,13 @@
"200": {
"description": "成功",
"schema": {
"$ref": "#/definitions/models.SimpleGraphData"
"$ref": "#/definitions/model.SimpleGraphData"
}
},
"500": {
"description": "内部错误",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"$ref": "#/definitions/model.ErrorResponse"
}
}
}
@@ -166,7 +166,7 @@
"500": {
"description": "内部错误",
"schema": {
"$ref": "#/definitions/models.ErrorResponse"
"$ref": "#/definitions/model.ErrorResponse"
}
}
}
@@ -189,7 +189,7 @@
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/models.CreateNodeRequest"
"$ref": "#/definitions/model.CreateNodeRequest"
}
}
],
@@ -197,25 +197,25 @@
"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"
}
}
}
@@ -241,25 +241,25 @@
"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"
}
}
}
@@ -287,7 +287,7 @@
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/models.UpdateNodeRequest"
"$ref": "#/definitions/model.UpdateNodeRequest"
}
}
],
@@ -295,25 +295,25 @@
"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"
}
}
}
@@ -337,19 +337,19 @@
"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"
}
}
}
@@ -375,25 +375,25 @@
"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"
}
}
}
@@ -419,19 +419,19 @@
"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"
}
}
}
@@ -439,7 +439,7 @@
}
},
"definitions": {
"models.CreateEdgeRequest": {
"model.CreateEdgeRequest": {
"type": "object",
"required": [
"id",
@@ -449,38 +449,32 @@
],
"properties": {
"id": {
"description": "边的唯一标识",
"type": "string",
"example": "edge_123"
},
"label": {
"description": "边的显示标签",
"type": "string",
"example": "包含"
},
"properties": {
"description": "自定义属性",
"type": "object",
"additionalProperties": true
},
"source": {
"description": "源节点ID",
"type": "string",
"example": "node_1"
},
"target": {
"description": "目标节点ID",
"type": "string",
"example": "node_2"
},
"type": {
"description": "边的类型(可选,默认为关系类型)",
"type": "string",
"example": "CONTAINS"
}
}
},
"models.CreateNodeRequest": {
"model.CreateNodeRequest": {
"type": "object",
"required": [
"id",
@@ -489,58 +483,49 @@
],
"properties": {
"id": {
"description": "节点唯一标识",
"type": "string",
"example": "node_123"
},
"label": {
"description": "节点显示标签",
"type": "string",
"example": "人工智能"
},
"properties": {
"description": "自定义属性",
"type": "object",
"additionalProperties": true
},
"type": {
"description": "节点类型",
"type": "string",
"example": "概念"
},
"x": {
"description": "X坐标(可选)",
"type": "number",
"example": 100
},
"y": {
"description": "Y坐标(可选)",
"type": "number",
"example": 200
}
}
},
"models.DeleteResponse": {
"model.DeleteResponse": {
"type": "object",
"properties": {
"id": {
"description": "被删除的实体ID(可选)",
"type": "string",
"example": "node_123"
},
"message": {
"description": "消息",
"type": "string",
"example": "节点已成功删除"
},
"success": {
"description": "是否成功",
"type": "boolean",
"example": true
}
}
},
"models.Edge": {
"model.Edge": {
"type": "object",
"properties": {
"id": {
@@ -568,42 +553,36 @@
}
}
},
"models.EdgeResponse": {
"model.EdgeResponse": {
"type": "object",
"properties": {
"id": {
"description": "边的ID",
"type": "string",
"example": "edge_123"
},
"label": {
"description": "边的显示标签",
"type": "string",
"example": "包含"
},
"properties": {
"description": "自定义属性",
"type": "object",
"additionalProperties": true
},
"source": {
"description": "源节点ID",
"type": "string",
"example": "node_1"
},
"target": {
"description": "目标节点ID",
"type": "string",
"example": "node_2"
},
"type": {
"description": "边的类型",
"type": "string",
"example": "CONTAINS"
}
}
},
"models.ErrorResponse": {
"model.ErrorResponse": {
"type": "object",
"properties": {
"error": {
@@ -614,41 +593,41 @@
}
}
},
"models.GraphData": {
"model.GraphData": {
"type": "object",
"properties": {
"edges": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Edge"
"$ref": "#/definitions/model.Edge"
}
},
"nodes": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Node"
"$ref": "#/definitions/model.Node"
}
}
}
},
"models.NeighborResponse": {
"model.NeighborResponse": {
"type": "object",
"properties": {
"edges": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Edge"
"$ref": "#/definitions/model.Edge"
}
},
"nodes": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Node"
"$ref": "#/definitions/model.Node"
}
}
}
},
"models.Node": {
"model.Node": {
"type": "object",
"properties": {
"id": {
@@ -676,42 +655,58 @@
}
}
},
"models.NodeResponse": {
"model.NodeResponse": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "1"
"type": "string"
},
"label": {
"type": "string",
"example": "人工智能"
"type": "string"
},
"neighbors": {
"type": "array",
"items": {
"$ref": "#/definitions/model.Node"
}
},
"properties": {
"type": "object",
"additionalProperties": true
},
"style": {
"type": "object",
"additionalProperties": true
},
"type": {
"type": "string",
"example": "概念"
"type": "string"
},
"x": {
"type": "number"
},
"y": {
"type": "number"
}
}
},
"models.SearchResponse": {
"model.SearchResponse": {
"type": "object",
"properties": {
"count": {
"type": "integer"
},
"results": {
"nodes": {
"type": "array",
"items": {
"$ref": "#/definitions/models.Node"
"$ref": "#/definitions/model.Node"
}
},
"query": {
"type": "string"
}
}
},
"models.SimpleEdge": {
"model.SimpleEdge": {
"type": "object",
"properties": {
"label": {
@@ -732,24 +727,24 @@
}
}
},
"models.SimpleGraphData": {
"model.SimpleGraphData": {
"type": "object",
"properties": {
"edges": {
"type": "array",
"items": {
"$ref": "#/definitions/models.SimpleEdge"
"$ref": "#/definitions/model.SimpleEdge"
}
},
"nodes": {
"type": "array",
"items": {
"$ref": "#/definitions/models.SimpleNode"
"$ref": "#/definitions/model.SimpleNode"
}
}
}
},
"models.SimpleNode": {
"model.SimpleNode": {
"type": "object",
"properties": {
"id": {
@@ -766,31 +761,26 @@
}
}
},
"models.UpdateNodeRequest": {
"model.UpdateNodeRequest": {
"type": "object",
"properties": {
"label": {
"description": "节点显示标签",
"type": "string",
"example": "机器学习"
},
"properties": {
"description": "自定义属性(更新)",
"type": "object",
"additionalProperties": true
},
"type": {
"description": "节点类型",
"type": "string",
"example": "工具"
},
"x": {
"description": "X坐标",
"type": "number",
"example": 150
},
"y": {
"description": "Y坐标",
"type": "number",
"example": 250
}
+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"