feat: 接入swagger功能

src/modules/chart/controller/chart_graph.go

@@ -25,6 +25,15 @@ type ChartGraphController struct {
 // 获取关系图组名
 //
 // GET /groups
+//
+//	@Tags			chart
+//	@Accept			json
+//	@Produce		json
+//	@Success		200	{object}	map[string]any	"data"
+//	@Security		ApiKeyAuth
+//	@Summary		Get relationship graph group name
+//	@Description	Get relationship graph group name
+//	@Router			/chart/graph/groups [get]
 func (s *ChartGraphController) GroupNames(c *gin.Context) {
 	data := s.chartGraphService.SelectGroup()
 	c.JSON(200, result.OkData(data))
@@ -33,6 +42,17 @@ func (s *ChartGraphController) GroupNames(c *gin.Context) {
 // 获取关系图数据
 //
 // GET /
+//
+//	@Tags			chart
+//	@Accept			json
+//	@Produce		json
+//	@Param			group	query		string			true	"Group"
+//	@Param			type	query		string			true	"Type oneof=node edge combo"	Enums(node, edge, combo)
+//	@Success		200		{object}	map[string]any	"data"
+//	@Security		ApiKeyAuth
+//	@Summary		Getting Relationship Map Data
+//	@Description	Getting Relationship Map Data
+//	@Router			/chart/graph [get]
 func (s *ChartGraphController) Load(c *gin.Context) {
 	language := ctx.AcceptLanguage(c)
 	var querys struct {
@@ -51,6 +71,16 @@ func (s *ChartGraphController) Load(c *gin.Context) {
 // 保存关系图数据
 //
 // POST /
+//
+//	@Tags			chart
+//	@Accept			json
+//	@Produce		json
+//	@Param			data	body		map[string]any	true	"{group:'',data:{nodes:[],edges:[],combos:[]}}"
+//	@Success		200		{object}	map[string]any	"data"
+//	@Security		ApiKeyAuth
+//	@Summary		Saving Relationship Diagram Data
+//	@Description	Saving Relationship Diagram Data
+//	@Router			/chart/graph/ [post]
 func (s *ChartGraphController) Save(c *gin.Context) {
 	language := ctx.AcceptLanguage(c)
 	var body struct {
@@ -83,6 +113,16 @@ func (s *ChartGraphController) Save(c *gin.Context) {
 // 删除关系图数据
 //
 // DELETE /:group
+//
+//	@Tags			chart
+//	@Accept			json
+//	@Produce		json
+//	@Param			group	path		string			true	"Group"
+//	@Success		200		{object}	map[string]any	"data"
+//	@Security		ApiKeyAuth
+//	@Summary		Deleting Relationship Diagram Data
+//	@Description	Deleting Relationship Diagram Data
+//	@Router			/chart/graph/:group [delete]
 func (s *ChartGraphController) Delete(c *gin.Context) {
 	language := ctx.AcceptLanguage(c)
 	group := c.Param("group")