fixed：添加类全局分组

app/Http/Controllers/Client/AccountController.php

@@ -7,6 +7,8 @@ use App\Services\Client\AccountService;
 use Illuminate\Http\Request;
 
 /**
+ * @group 用户端-账户管理
+ *
  * 账户相关的API接口
  */
 class AccountController extends Controller
@@ -20,10 +22,11 @@ class AccountController extends Controller
 
     /**
      * [账户管理] 发送验证码
-     * 
+     *
      * 向指定手机号发送验证码
-     * 
+     *
      * @bodyParam mobile string required 手机号码. Example: 13800138000
+     *
      * @response {
      *   "code": 200,
      *   "message": "验证码发送成功",
@@ -33,16 +36,18 @@ class AccountController extends Controller
     public function sendVerifyCode(Request $request)
     {
         $mobile = $request->input('mobile');
+
         return $this->service->sendVerifyCode($mobile);
     }
 
     /**
      * [账户管理] 用户登录
-     * 
+     *
      * 使用手机号和验证码登录账户
-     * 
+     *
      * @bodyParam mobile string required 手机号码. Example: 13800138000
      * @bodyParam code string required 验证码. Example: 123456
+     *
      * @response {
      *   "code": 200,
      *   "message": "登录成功",
@@ -60,15 +65,17 @@ class AccountController extends Controller
     {
         $mobile = $request->input('mobile');
         $code = $request->input('code');
+
         return $this->service->login($mobile, $code);
     }
 
     /**
      * [账户管理] 微信登录
-     * 
+     *
      * 使用微信openid登录账户
-     * 
+     *
      * @bodyParam openid string required 微信openid. Example: wx_123456789
+     *
      * @response {
      *   "code": 200,
      *   "message": "登录成功",
@@ -85,15 +92,17 @@ class AccountController extends Controller
     public function wxLogin(Request $request)
     {
         $openid = $request->input('openid');
+
         return $this->service->wxLogin($openid);
     }
 
     /**
      * [账户管理] 用户退出
-     * 
+     *
      * 退出当前账户登录状态
-     * 
+     *
      * @authenticated
+     *
      * @response {
      *   "code": 200,
      *   "message": "退出成功",
@@ -107,10 +116,11 @@ class AccountController extends Controller
 
     /**
      * [账户管理] 用户注销
-     * 
+     *
      * 永久注销当前账户
-     * 
+     *
      * @authenticated
+     *
      * @response {
      *   "code": 200,
      *   "message": "注销成功",
@@ -121,4 +131,4 @@ class AccountController extends Controller
     {
         return $this->service->deleteAccount();
     }
-}
+}

app/Http/Controllers/Client/AgentController.php

@@ -6,6 +6,11 @@ use App\Http\Controllers\Controller;
 use App\Services\Client\AgentService;
 use Illuminate\Http\Request;
 
+/**
+ * @group 用户端-代理商管理
+ *
+ * 代理商相关的API接口
+ */
 class AgentController extends Controller
 {
     protected AgentService $service;
@@ -21,6 +26,7 @@ class AgentController extends Controller
     public function getConfig(Request $request)
     {
         $agentId = $request->input('agent_id');
+
         return $this->service->getAgentConfig($agentId);
     }
 
@@ -30,6 +36,7 @@ class AgentController extends Controller
     public function getAgent(Request $request)
     {
         $areaCode = $request->input('area_code');
+
         return $this->service->getAgent($areaCode);
     }
 
@@ -40,6 +47,7 @@ class AgentController extends Controller
     {
         $categoryId = $request->input('category_id');
         $agentId = $request->input('agent_id');
+
         return $this->service->getProjectList($categoryId, $agentId);
     }
 
@@ -50,6 +58,7 @@ class AgentController extends Controller
     {
         $projectId = $request->input('project_id');
         $agentId = $request->input('agent_id');
+
         return $this->service->getProjectDetail($projectId, $agentId);
     }
-} 
+}

app/Http/Controllers/Client/CoachController.php

@@ -6,6 +6,11 @@ use App\Http\Controllers\Controller;
 use App\Services\Client\CoachService;
 use Illuminate\Http\Request;
 
+/**
+ * @group 用户端-技师管理
+ *
+ * 技师相关的API接口
+ */
 class CoachController extends Controller
 {
     protected CoachService $service;

app/Http/Controllers/Client/CoachLocationController.php

@@ -6,6 +6,11 @@ use App\Http\Controllers\Controller;
 use App\Services\Client\CoachLocationService;
 use Illuminate\Http\Request;
 
+/**
+ * @group 用户端-技师定位管理
+ *
+ * 技师定位相关的API接口
+ */
 class CoachLocationController extends Controller
 {
     protected $coachLocationService;

app/Http/Controllers/Client/CommentController.php

@@ -6,6 +6,11 @@ use App\Http\Controllers\Controller;
 use App\Services\Client\CommentService;
 use Illuminate\Http\Request;
 
+/**
+ * @group 用户端-评论管理
+ *
+ * 评论相关的API接口
+ */
 class CommentController extends Controller
 {
     protected CommentService $service;
@@ -16,23 +21,64 @@ class CommentController extends Controller
     }
 
     /**
+     * [评论管理] 发表评价
+     *
      * 发表评价
+     *
+     * @authenticated
+     *
+     * @bodyParam coach_id int required 技师ID. Example: 1
+     * @bodyParam content string required 评价内容. Example: 很棒的服务！
+     * @bodyParam rating int required 评分. Example: 5
+     *
+     * @response {
+     *   "code": 200,
+     *   "message": "评价成功",
+     *   "data": {
+     *     "id": 1,
+     *     "coach_id": 1,
+     *     "content": "很棒的服务！",
+     *     "rating": 5,
+     *     "created_at": "2024-01-01 10:00:00"
+     *   }
+     * }
      */
     public function create(Request $request)
     {
         $coachId = $request->input('coach_id');
         $content = $request->input('content');
         $rating = $request->input('rating');
-        
+
         return $this->service->createComment($coachId, $content, $rating);
     }
 
     /**
-     * 评价列表
+     * [评论管理] 评价列表
+     *
+     * 获取评价列表
+     *
+     * @authenticated
+     *
+     * @queryParam coach_id int required 技师ID. Example: 1
+     *
+     * @response {
+     *   "code": 200,
+     *   "message": "获取成功",
+     *   "data": [
+     *     {
+     *       "id": 1,
+     *       "coach_id": 1,
+     *       "content": "很棒的服务！",
+     *       "rating": 5,
+     *       "created_at": "2024-01-01 10:00:00"
+     *     }
+     *   ]
+     * }
      */
     public function list(Request $request)
     {
         $coachId = $request->input('coach_id');
+
         return $this->service->getCommentList($coachId);
     }
-} 
+}

app/Http/Controllers/Client/CommonController.php

@@ -6,6 +6,11 @@ use App\Http\Controllers\Controller;
 use App\Services\Client\CommonService;
 use Illuminate\Http\Request;
 
+/**
+ * @group 用户端-公共管理
+ *
+ * 公共相关的API接口
+ */
 class CommonController extends Controller
 {
     protected CommonService $service;
@@ -16,32 +21,71 @@ class CommonController extends Controller
     }
 
     /**
-     * 获取代理商配置
+     * [公共管理] 获取代理商配置
+     *
+     * 获取指定代理商的配置信息
+     *
+     * @authenticated
+     *
+     * @bodyParam agent_id int required 代理商ID. Example: 1
+     *
+     * @response {
+     *   "min_distance": 0,
+     *   "min_fee": 0,
+     *   "per_km_fee": 0
+     * }
      */
     public function getConfig(Request $request)
     {
         $agentId = $request->input('agent_id');
+
         return $this->service->getAgentConfig($agentId);
     }
 
     /**
-     * 获取技师配置
+     * [公共管理] 获取技师配置
+     *
+     * 获取指定技师的配置信息
+     *
+     * @authenticated
+     *
+     * @bodyParam coach_id int required 技师ID. Example: 1
+     *
+     * @response {
+     *   "delivery_fee_type": "round_trip",
+     *   "charge_delivery_fee": true
+     * }
      */
     public function getCoachConfig(Request $request)
     {
         $coachId = $request->input('coach_id');
+
         return $this->service->getCoachConfig($coachId);
     }
 
     /**
-     * 计算路费金额
+     * [公共管理] 计算路费金额
+     *
+     * 根据距离和其他参数计算路费
+     *
+     * @authenticated
+     *
+     * @bodyParam coach_id int required 技师ID. Example: 1
+     * @bodyParam agent_id int 可选 代理商ID. Example: 1
+     * @bodyParam distance float required 距离. Example: 10.5
+     * @bodyParam latitude float 纬度. Example: 34.0522
+     * @bodyParam longitude float 经度. Example: -118.2437
+     *
+     * @response {
+     *   "fee": 15.75
+     * }
      */
     public function calculateDeliveryFee(Request $request)
     {
         $coachId = $request->input('coach_id');
         $agentId = $request->input('agent_id');
         $distance = $request->input('distance');
-        $latitude = $request->input('latitude'); 
+        $latitude = $request->input('latitude');
         $longitude = $request->input('longitude');
 
         if ($agentId) {
@@ -50,4 +94,4 @@ class CommonController extends Controller
             return $this->service->calculateDeliveryFeeByLocation($coachId, $latitude, $longitude, $distance);
         }
     }
-} 
+}

app/Http/Controllers/Client/ExtendOrderController.php

@@ -6,6 +6,11 @@ use App\Http\Controllers\Controller;
 use App\Services\Client\ExtendOrderService;
 use Illuminate\Http\Request;
 
+/**
+ * @group 用户端-加钟管理
+ *
+ * 加钟相关的API接口
+ */
 class ExtendOrderController extends Controller
 {
     protected ExtendOrderService $service;
@@ -21,6 +26,7 @@ class ExtendOrderController extends Controller
     public function getProjectList(Request $request)
     {
         $projectId = $request->input('project_id');
+
         return $this->service->getProjectList($projectId);
     }
 
@@ -30,6 +36,7 @@ class ExtendOrderController extends Controller
     public function extend(Request $request)
     {
         $orderId = $request->route('order_id');
+
         return $this->service->extend($orderId);
     }
-} 
+}

app/Http/Controllers/Client/OrderController.php

@@ -7,6 +7,11 @@ use App\Services\Client\OrderService;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
 
+/**
+ * @group 用户端-订单管理
+ *
+ * 订单相关的API接口
+ */
 class OrderController extends Controller
 {
     protected OrderService $service;
@@ -19,18 +24,18 @@ class OrderController extends Controller
     /**
      * [订单管理] 订单初始化
      *
-     * @description 初始化订单
+     * 初始化订单
      *
-     * @bodyParam coach_id int required 技师ID Example: 1
-     * @bodyParam area_code string required 区划代码 Example: 370602
-     * @bodyParam project_id int required 项目ID Example: 1
+     * @authenticated
+     *
+     * @bodyParam coach_id int required 技师ID. Example: 1
+     * @bodyParam area_code string required 区划代码. Example: 370602
+     * @bodyParam project_id int required 项目ID. Example: 1
      *
      * @response {
      *   "status": "success",
      *   "data": {}
      * }
-     *
-     * @return \Illuminate\Http\JsonResponse
      */
     public function initialize(Request $request)
     {
@@ -42,14 +47,16 @@ class OrderController extends Controller
     /**
      * [订单管理] 创建订单
      *
-     * @description 创建订单
+     * 创建订单
+     *
+     * @authenticated
      *
-     * @bodyParam project_id int required 项目ID Example: 1
-     * @bodyParam address_id int required 地址ID Example: 1
-     * @bodyParam coach_id int required 技师ID Example: 6
-     * @bodyParam use_balance boolean 使用余额 Example: false
-     * @bodyParam service_time datetime required 服务时间 Example: 2024-01-01 10:00:00
-     * @bodyParam order_id int 订单ID Example: null
+     * @bodyParam project_id int required 项目ID. Example: 1
+     * @bodyParam address_id int required 地址ID. Example: 1
+     * @bodyParam coach_id int required 技师ID. Example: 6
+     * @bodyParam use_balance boolean 使用余额. Example: false
+     * @bodyParam service_time datetime required 服务时间. Example: 2024-01-01 10:00:00
+     * @bodyParam order_id int 订单ID. Example: null
      *
      * @response {
      *   "status": "success",
@@ -66,16 +73,16 @@ class OrderController extends Controller
     /**
      * [订单管理] 结束订单
      *
-     * @description 结束订单
+     * 结束订单
      *
-     * @bodyParam order_id int required 订单ID Example: 1
+     * @authenticated
+     *
+     * @bodyParam order_id int required 订单ID. Example: 1
      *
      * @response {
      *   "status": "success",
      *   "data": {}
      * }
-     *
-     * @return \Illuminate\Http\JsonResponse
      */
     public function finish(Request $request)
     {
@@ -88,16 +95,16 @@ class OrderController extends Controller
     /**
      * [订单管理] 确认技师离开
      *
-     * @description 确认技师离开
+     * 确认技师离开
      *
-     * @bodyParam order_id int required 订单ID Example: 123
+     * @authenticated
+     *
+     * @bodyParam order_id int required 订单ID. Example: 123
      *
      * @response {
      *   "status": "success",
      *   "data": {}
      * }
-     *
-     * @return \Illuminate\Http\JsonResponse
      */
     public function confirmLeave(Request $request)
     {
@@ -110,16 +117,16 @@ class OrderController extends Controller
     /**
      * [订单管理] 取消订单
      *
-     * @description 取消订单
+     * 取消订单
      *
-     * @bodyParam order_id int required 订单ID Example: 123
+     * @authenticated
+     *
+     * @bodyParam order_id int required 订单ID. Example: 123
      *
      * @response {
      *   "status": "success",
      *   "data": {}
      * }
-     *
-     * @return \Illuminate\Http\JsonResponse
      */
     public function cancel(Request $request)
     {
@@ -132,14 +139,14 @@ class OrderController extends Controller
     /**
      * [订单管理] 获取订单列表
      *
-     * @description 获取订单列表
+     * 获取订单列表
+     *
+     * @authenticated
      *
      * @response {
      *   "status": "success",
      *   "data": []
      * }
-     *
-     * @return \Illuminate\Http\JsonResponse
      */
     public function list()
     {
@@ -149,17 +156,16 @@ class OrderController extends Controller
     /**
      * [订单管理] 获取订单详情
      *
-     * @description 获取订单详情
+     * 获取订单详情
      *
-     * @urlParam id required 订单ID Example: 123
+     * @authenticated
+     *
+     * @urlParam id required 订单ID. Example: 1
      *
      * @response {
      *   "status": "success",
      *   "data": {}
      * }
-     *
-     * @param  int  $id
-     * @return \Illuminate\Http\JsonResponse
      */
     public function detail($id)
     {
@@ -169,15 +175,16 @@ class OrderController extends Controller
     /**
      * [订单管理] 订单退款
      *
-     * @description 订单退款
+     * 订单退款
+     *
+     * @authenticated
+     *
+     * @urlParam id required 订单ID. Example: 1
      *
      * @response {
      *   "status": "success",
      *   "data": {}
      * }
-     *
-     * @param  int  $id
-     * @return \Illuminate\Http\JsonResponse
      */
     public function refund($id)
     {
@@ -187,15 +194,17 @@ class OrderController extends Controller
     /**
      * [订单管理] 获取代理商配置
      *
-     * @description 获取代理商配置
+     * 获取代理商配置
+     *
+     * @authenticated
+     *
+     * @bodyParam agent_id int required 代理商ID. Example: 1
      *
      * @response {
      *   "min_distance": 0,
      *   "min_fee": 0,
      *   "per_km_fee": 0
      * }
-     *
-     * @return array
      */
     public function getAgentConfig(Request $request)
     {
@@ -207,14 +216,16 @@ class OrderController extends Controller
     /**
      * [订单管理] 获取技师配置
      *
-     * @description 获取技师配置
+     * 获取技师配置
+     *
+     * @authenticated
+     *
+     * @bodyParam coach_id int required 技师ID. Example: 1
      *
      * @response {
      *   "delivery_fee_type": "round_trip",
      *   "charge_delivery_fee": true
      * }
-     *
-     * @return array
      */
     public function getCoachConfig(Request $request)
     {
@@ -226,13 +237,19 @@ class OrderController extends Controller
     /**
      * [订单管理] 计算路费金额
      *
-     * @description 计算路费金额
+     * 计算路费金额
+     *
+     * @authenticated
+     *
+     * @bodyParam coach_id int required 技师ID. Example: 1
+     * @bodyParam agent_id int 可选 代理商ID. Example: 1
+     * @bodyParam distance float required 距离. Example: 10.5
+     * @bodyParam latitude float 纬度. Example: 34.0522
+     * @bodyParam longitude float 经度. Example: -118.2437
      *
      * @response {
-     *   "fee": 0
+     *   "fee": 15.75
      * }
-     *
-     * @return float
      */
     public function calculateDeliveryFee(Request $request)
     {
@@ -245,14 +262,22 @@ class OrderController extends Controller
         if ($agentId) {
             return $this->service->calculateDeliveryFee($coachId, $agentId, $distance);
         } else {
-            // return $this->service->calculateDeliveryFeeByLocation($coachId, $latitude, $longitude, $distance);
+            return $this->service->calculateDeliveryFeeByLocation($coachId, $latitude, $longitude, $distance);
         }
     }
 
     /**
      * [订单管理] 计算订单金额
      *
-     * @description 计算订单金额
+     * 计算订单金额
+     *
+     * @authenticated
+     *
+     * @bodyParam address_id int required 地址ID. Example: 1
+     * @bodyParam coach_id int required 技师ID. Example: 1
+     * @bodyParam project_id int required 项目ID. Example: 1
+     * @bodyParam agent_id int 代理商ID. Example: 1
+     * @bodyParam use_balance boolean 使用余额. Example: 0
      *
      * @response {
      *   "total_amount": 0,
@@ -263,12 +288,10 @@ class OrderController extends Controller
      *   "project_amount": 0,
      *   "delivery_fee": 0
      * }
-     *
-     * @return array
      */
     public function calculateOrderAmount(Request $request)
     {
-        $userId = Auth::id();
+        $userId = Auth::user()->id;
         $addressId = $request->input('address_id');
         $coachId = $request->input('coach_id');
         $projectId = $request->input('project_id');
@@ -281,9 +304,11 @@ class OrderController extends Controller
     /**
      * [订单管理] 加钟
      *
-     * @description 加钟
+     * 加钟
      *
-     * @urlParam order_id required 订单ID Example: 123
+     * @authenticated
+     *
+     * @urlParam order_id required 订单ID. Example: 123
      *
      * @response {
      *   "status": "success",
@@ -292,7 +317,7 @@ class OrderController extends Controller
      */
     public function addTime(Request $request, $orderId)
     {
-        $userId = Auth::id();
+        $userId = Auth::user()->id;
 
         return $this->service->addTime($userId, $orderId);
     }
@@ -300,11 +325,13 @@ class OrderController extends Controller
     /**
      * [订单管理] 指定技师
      *
-     * @description 指定技师
+     * 指定技师
      *
-     * @urlParam order_id required 订单ID Example: 123
+     * @authenticated
      *
-     * @bodyParam coach_id int required 技师ID Example: 1
+     * @urlParam order_id required 订单ID. Example: 123
+     *
+     * @bodyParam coach_id int required 技师ID. Example: 1
      *
      * @response {
      *   "status": "success",
@@ -313,7 +340,7 @@ class OrderController extends Controller
      */
     public function assignCoach(Request $request, $orderId)
     {
-        $userId = Auth::id();
+        $userId = Auth::user()->id;
         $coachId = $request->input('coach_id');
 
         return $this->service->assignCoach($userId, $orderId, $coachId);

app/Http/Controllers/Client/PaymentController.php

@@ -6,6 +6,11 @@ use App\Http\Controllers\Controller;
 use App\Services\Client\PaymentService;
 use Illuminate\Http\Request;
 
+/**
+ * @group 用户端-支付管理
+ *
+ * 支付相关的API接口
+ */
 class PaymentController extends Controller
 {
     protected PaymentService $service;
@@ -21,6 +26,7 @@ class PaymentController extends Controller
     public function getConfig(Request $request)
     {
         $orderId = $request->input('order_id');
+
         return $this->service->getPaymentConfig($orderId);
     }
-} 
+}

app/Http/Controllers/Client/ProjectController.php

@@ -7,7 +7,9 @@ use App\Services\Client\ProjectService;
 use Illuminate\Http\Request;
 
 /**
- * 项目管理相关的API接口
+ * @group 用户端-项目管理
+ *
+ * 项目相关的API接口
  */
 class ProjectController extends Controller
 {

app/Http/Controllers/Client/TeamController.php

@@ -4,8 +4,12 @@ namespace App\Http\Controllers\Client;
 
 use App\Http\Controllers\Controller;
 use App\Services\Client\TeamService;
-use Illuminate\Http\Request;
 
+/**
+ * @group 用户端-团队管理
+ *
+ * 团队相关的API接口
+ */
 class TeamController extends Controller
 {
     protected TeamService $service;
@@ -22,4 +26,4 @@ class TeamController extends Controller
     {
         return $this->service->getTeamList();
     }
-} 
+}

app/Http/Controllers/Client/UserAddressController.php

@@ -7,6 +7,11 @@ use App\Services\Client\UserAddressService;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
 
+/**
+ * @group 用户端-地址管理
+ *
+ * 用户地址相关的API接口
+ */
 class UserAddressController extends Controller
 {
     protected $userAddressService;

app/Http/Controllers/Client/UserController.php

@@ -7,6 +7,8 @@ use App\Services\Client\UserService;
 use Illuminate\Http\Request;
 
 /**
+ * @group 用户端-用户管理
+ *
  * 用户相关的API接口
  */
 class UserController extends Controller
@@ -24,6 +26,7 @@ class UserController extends Controller
      * 获取当前用户的信息
      *
      * @authenticated
+     *
      * @response {
      *   "code": 200,
      *   "message": "获取成功",
@@ -45,8 +48,10 @@ class UserController extends Controller
      * 修改当前用户的信息
      *
      * @authenticated
+     *
      * @bodyParam nickname string 用户昵称. Example: 用户昵称
      * @bodyParam avatar string 用户头像. Example: https://example.com/avatar.jpg
+     *
      * @response {
      *   "code": 200,
      *   "message": "修改成功",
@@ -56,6 +61,7 @@ class UserController extends Controller
     public function update(Request $request)
     {
         $data = $request->all();
+
         return $this->service->updateUserInfo($data);
     }
 
@@ -65,6 +71,7 @@ class UserController extends Controller
      * 获取当前用户的钱包信息
      *
      * @authenticated
+     *
      * @response {
      *   "code": 200,
      *   "message": "获取成功",
@@ -85,9 +92,11 @@ class UserController extends Controller
      * 提现用户的余额
      *
      * @authenticated
+     *
      * @bodyParam amount decimal 提现金额. Example: 100.00
      * @bodyParam type string 提现方式. Example: wechat
      * @bodyParam area_code string 行政区划代码. Example: 330100
+     *
      * @response {
      *   "code": 200,
      *   "message": "提现成功",
@@ -99,6 +108,7 @@ class UserController extends Controller
         $amount = $request->input('amount');
         $type = $request->input('type', 'wechat');
         $area_code = $request->input('area_code', '');
+
         return $this->service->withdraw($amount, $type, $area_code);
     }
 
@@ -108,7 +118,9 @@ class UserController extends Controller
      * 提交用户的反馈信息
      *
      * @authenticated
+     *
      * @bodyParam content string 反馈内容. Example: 这是一个反馈信息
+     *
      * @response {
      *   "code": 200,
      *   "message": "提交成功",
@@ -118,6 +130,7 @@ class UserController extends Controller
     public function feedback(Request $request)
     {
         $content = $request->input('content');
+
         return $this->service->feedback($content);
     }
 
@@ -127,10 +140,12 @@ class UserController extends Controller
      * 申请成为技师
      *
      * @authenticated
+     *
      * @bodyParam mobile string 手机号. Example: 13800138000
      * @bodyParam gender string 性别. Example: male
      * @bodyParam work_years string 工作年限. Example: 5
      * @bodyParam intention_city string 意向城市. Example: 杭州
+     *
      * @response {
      *   "code": 200,
      *   "message": "申请成功",
@@ -143,6 +158,7 @@ class UserController extends Controller
         $gender = $request->input('gender');
         $work_years = $request->input('work_years');
         $intention_city = $request->input('intention_city');
+
         return $this->service->applyCoach($mobile, $gender, $work_years, $intention_city);
     }
 }

app/Http/Controllers/Client/WalletController.php

@@ -5,6 +5,11 @@ namespace App\Http\Controllers\Client;
 use App\Http\Controllers\Controller;
 use App\Services\Client\WalletService;
 
+/**
+ * @group 用户端-钱包管理
+ *
+ * 钱包相关的API接口
+ */
 class WalletController extends Controller
 {
     protected WalletService $service;
@@ -20,6 +25,7 @@ class WalletController extends Controller
      * 获取钱包明细
      *
      * @authenticated
+     *
      * @response {
      *   "code": 200,
      *   "message": "获取成功",