owl-admin/app/Http/Controllers/Client/CoachGroupController.php

<?php

namespace App\Http\Controllers\Client;

use App\Http\Controllers\Controller;
use App\Http\Requests\Client\CoachGroupRequest;
use App\Services\Client\CoachGroupService;

class CoachGroupController extends Controller
{
    /**
     * 获取技师分组列表
     *
     * @group 用户端-技师分组
     * @description 获取技师分组列表，包括技术组、明星组和新人组
     *
     * @queryParam latitude float 纬度，范围：-90到90 Example: 39.9042
     * @queryParam longitude float 经度，范围：-180到180 Example: 116.4074
     * @queryParam radius integer 搜索半径(公里)，范围：1到100 Example: 20
     *
     * @response {
     *  "code": 0,
     *  "message": "操作成功",
     *  "data": {
     *    "technical": [
     *      {
     *        "id": 1,
     *        "name": "张三",
     *        "avatar": "头像地址",
     *        "portrait_images": ["图片1", "图片2"],
     *        "formal_photo": "正式照片",
     *        "city": "北京",
     *        "work_years": 5,
     *        "avg_score": 4.8,
     *        "comment_count": 100,
     *        "skill_tags": ["标签1", "标签2"],
     *        "description": "个人简介",
     *        "gender": 1,
     *        "age": 28,
     *        "height": 175,
     *        "weight": 65,
     *        "distance": 1.5
     *      }
     *    ],
     *    "star": [],
     *    "newcomer": []
     *  }
     * }
     */
    public function index(CoachGroupRequest $request): array
    {
        $service = new CoachGroupService(
            latitude: $request->input('latitude'),
            longitude: $request->input('longitude'),
            radius: $request->input('radius')
        );

        return $this->success($service->getAllGroups());
    }
}