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

<?php

namespace App\Http\Controllers\Client;

use App\Http\Controllers\Controller;
use App\Services\Client\MarketDistTeamService;
use Auth;
use Illuminate\Http\Request;

/**
 * @group 用户端
 *
 * 团队相关的API接口
 */
class MarketDistTeamController extends Controller
{
    protected MarketDistTeamService $service;

    public function __construct(MarketDistTeamService $service)
    {
        $this->service = $service;
    }

    /**
     * [团队]我的团队
     *
     * @description 获取我的团队列表，包含团队成员信息
     *
     * @queryParam page int 页码. Example: 1
     * @queryParam per_page int 每页数量. Example: 15
     *
     * @response {
     *  "code": 200,
     *  "message": "success",
     *  "data": {
     *    "current_page": 1,
     *    "data": [
     *      {
     *        "id": 1,
     *        "team_name": "销售一组",
     *        "leader_id": 10,
     *        "leader_name": "张三",
     *        "member_count": 5,
     *        "created_at": "2024-03-20 10:00:00",
     *        "members": [
     *          {
     *            "id": 11,
     *            "name": "李四",
     *            "avatar": "http://example.com/avatar.jpg",
     *            "role": "member",
     *            "join_time": "2024-03-20 10:00:00"
     *          }
     *        ]
     *      }
     *    ],
     *    "total": 10,
     *    "per_page": 15
     *  }
     * }
     */
    public function index(Request $request)
    {
        $validated = $request->validate([
            'page' => 'nullable|integer|min:1',
            'per_page' => 'nullable|integer|min:1|max:100',
        ]);

        return $this->service->getTeamList(
            Auth::user()->id,
            $validated['per_page'] ?? 15
        );
    }
}