docs: 在接口文档补全 title 与 desc 并标注 ID 序列化形式

desc/api/community.api

@@ -2,6 +2,13 @@ syntax = "v1"
 
 import "common.api"
 
+info (
+	title:   "聚玩社区服务"
+	desc:    "处理帖子、评论、点赞等社区互动。ID 字段（int64）以 string 传输"
+	author:  "Asadz"
+	version: "1.0"
+)
+
 type (
 	PathId {
 		Id int64 `path:"id"`

desc/api/dispute.api

@@ -2,6 +2,13 @@ syntax = "v1"
 
 import "common.api"
 
+info (
+	title:   "聚玩争议服务"
+	desc:    "处理订单争议申诉与仲裁。ID 字段（int64）以 string 传输"
+	author:  "Asadz"
+	version: "1.0"
+)
+
 type (
 	DisputePathId {
 		Id int64 `path:"id"`

desc/api/docs/community-api.json

@@ -1,8 +1,9 @@
 {
   "swagger": "2.0",
   "info": {
-    "title": "",
+    "title": "聚玩社区服务",
-    "version": ""
+    "description": "处理帖子、评论、点赞等社区互动。ID 字段（int64）以 string 传输",
+    "version": "1.0"
   },
   "schemes": [
     "http",

desc/api/docs/dispute-api.json

@@ -1,8 +1,9 @@
 {
   "swagger": "2.0",
   "info": {
-    "title": "",
+    "title": "聚玩争议服务",
-    "version": ""
+    "description": "处理订单争议申诉与仲裁。ID 字段（int64）以 string 传输",
+    "version": "1.0"
   },
   "schemes": [
     "http",

desc/api/docs/email-api.json

@@ -1,7 +1,8 @@
 {
   "swagger": "2.0",
   "info": {
-    "title": "",
+    "title": "聚玩邮件服务",
+    "description": "处理邮件验证码发送与密码找回",
     "version": "1.0"
   },
   "schemes": [

desc/api/docs/game-api.json

@@ -1,8 +1,9 @@
 {
   "swagger": "2.0",
   "info": {
-    "title": "",
+    "title": "聚玩游戏服务",
-    "version": ""
+    "description": "管理游戏目录与分类。ID 字段（int64）以 string 传输",
+    "version": "1.0"
   },
   "schemes": [
     "http",

desc/api/docs/notification-api.json

@@ -1,8 +1,9 @@
 {
   "swagger": "2.0",
   "info": {
-    "title": "",
+    "title": "聚玩通知服务",
-    "version": ""
+    "description": "管理站内消息通知。ID 字段（int64）以 string 传输",
+    "version": "1.0"
   },
   "schemes": [
     "http",

desc/api/docs/order-api.json

@@ -2,7 +2,7 @@
   "swagger": "2.0",
   "info": {
     "title": "聚玩订单服务",
-    "description": "处理订单业务",
+    "description": "处理订单业务。ID 字段（int64）以 string 传输",
     "version": "1.0"
   },
   "schemes": [

desc/api/docs/player-api.json

@@ -2,7 +2,7 @@
   "swagger": "2.0",
   "info": {
     "title": "聚玩打手服务",
-    "description": "聚玩用户服务处理打手信息管理、服务发布及订单相关接口",
+    "description": "聚玩用户服务处理打手信息管理、服务发布及订单相关接口。ID 字段（int64）以 string 传输",
     "version": "1.0"
   },
   "schemes": [

desc/api/docs/review-api.json

@@ -1,8 +1,9 @@
 {
   "swagger": "2.0",
   "info": {
-    "title": "",
+    "title": "聚玩评价服务",
-    "version": ""
+    "description": "处理订单评价与评分。ID 字段（int64）以 string 传输",
+    "version": "1.0"
   },
   "schemes": [
     "http",

desc/api/docs/search-api.json

@@ -1,8 +1,9 @@
 {
   "swagger": "2.0",
   "info": {
-    "title": "",
+    "title": "聚玩搜索服务",
-    "version": ""
+    "description": "内容搜索与首页推荐",
+    "version": "1.0"
   },
   "schemes": [
     "http",

desc/api/docs/shop-api.json

@@ -1,8 +1,9 @@
 {
   "swagger": "2.0",
   "info": {
-    "title": "",
+    "title": "聚玩店铺服务",
-    "version": ""
+    "description": "管理店铺信息、员工邀请、模板配置。ID 字段（int64）以 string 传输",
+    "version": "1.0"
   },
   "schemes": [
     "http",

desc/api/docs/users-api.json

@@ -2,7 +2,7 @@
   "swagger": "2.0",
   "info": {
     "title": "聚玩用户服务",
-    "description": "处理用户注册、登录、个人信息管理及关注系统",
+    "description": "处理用户注册、登录、个人信息管理及关注系统。ID 字段（int64）以 string 传输",
     "version": "1.0"
   },
   "schemes": [

desc/api/docs/wallet-api.json

@@ -2,7 +2,7 @@
   "swagger": "2.0",
   "info": {
     "title": "钱包服务",
-    "description": "处理钱包充值相关",
+    "description": "处理钱包充值相关。ID 字段（int64）以 string 传输",
     "version": "1.0"
   },
   "schemes": [

desc/api/email.api

@@ -1,6 +1,8 @@
 syntax = "v1"
 
 info (
+	title:   "聚玩邮件服务"
+	desc:    "处理邮件验证码发送与密码找回"
 	author:  "Asadz"
 	date:    "2024-06-19"
 	version: "1.0"

desc/api/game.api

@@ -2,6 +2,13 @@ syntax = "v1"
 
 import "common.api"
 
+info (
+	title:   "聚玩游戏服务"
+	desc:    "管理游戏目录与分类。ID 字段（int64）以 string 传输"
+	author:  "Asadz"
+	version: "1.0"
+)
+
 type (
 	Game {
 		Id       int64  `json:"id,string,optional"`

desc/api/notification.api

@@ -2,6 +2,13 @@ syntax = "v1"
 
 import "common.api"
 
+info (
+	title:   "聚玩通知服务"
+	desc:    "管理站内消息通知。ID 字段（int64）以 string 传输"
+	author:  "Asadz"
+	version: "1.0"
+)
+
 type (
 	PathId {
 		Id int64 `path:"id"`

desc/api/order.api

@@ -4,7 +4,7 @@ import "common.api"
 
 info (
 	title:   "聚玩订单服务"
-	desc:    "处理订单业务"
+	desc:    "处理订单业务。ID 字段（int64）以 string 传输"
 	author:  "Asadz"
 	version: "1.0"
 )

desc/api/player.api

@@ -2,7 +2,7 @@ syntax = "v1"
 
 info (
 	title:   "聚玩打手服务"
-	desc:    "聚玩用户服务处理打手信息管理、服务发布及订单相关接口"
+	desc:    "聚玩用户服务处理打手信息管理、服务发布及订单相关接口。ID 字段（int64）以 string 传输"
 	author:  "Asadz"
 	version: "1.0"
 )

desc/api/review.api

@@ -2,6 +2,13 @@ syntax = "v1"
 
 import "common.api"
 
+info (
+	title:   "聚玩评价服务"
+	desc:    "处理订单评价与评分。ID 字段（int64）以 string 传输"
+	author:  "Asadz"
+	version: "1.0"
+)
+
 type (
 	ReviewPathId {
 		Id int64 `path:"id"`

desc/api/search.api

@@ -2,6 +2,13 @@ syntax = "v1"
 
 import "common.api"
 
+info (
+	title:   "聚玩搜索服务"
+	desc:    "内容搜索与首页推荐"
+	author:  "Asadz"
+	version: "1.0"
+)
+
 type (
 	PathIDReq {
 		Id int64 `path:"id"`

desc/api/shop.api

@@ -2,6 +2,13 @@ syntax = "v1"
 
 import "common.api"
 
+info (
+	title:   "聚玩店铺服务"
+	desc:    "管理店铺信息、员工邀请、模板配置。ID 字段（int64）以 string 传输"
+	author:  "Asadz"
+	version: "1.0"
+)
+
 type (
 	ShopProfile {
 		Id                     string      `json:"id"`

desc/api/users.api

@@ -2,7 +2,7 @@ syntax = "v1"
 
 info (
 	title:   "聚玩用户服务"
-	desc:    "处理用户注册、登录、个人信息管理及关注系统"
+	desc:    "处理用户注册、登录、个人信息管理及关注系统。ID 字段（int64）以 string 传输"
 	author:  "Asadz"
 	version: "1.0"
 )

desc/api/wallet.api

@@ -2,7 +2,7 @@ syntax = "v1"
 
 info (
 	title:   "钱包服务"
-	desc:    "处理钱包充值相关"
+	desc:    "处理钱包充值相关。ID 字段（int64）以 string 传输"
 	author:  "Asadz"
 	version: "1.0"
 )