owl-admin/app/Http/Controllers/Coach/ProjectController.php

<?php

namespace App\Http\Controllers\Coach;

use App\Http\Controllers\Controller;
use App\Services\Coach\ProjectService;
use App\Traits\ResponseTrait;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;

/**
 * @group 技师端
 *
 * 项目管理相关的API接口
 */
class ProjectController extends Controller
{
    use ResponseTrait;

    protected ProjectService $service;

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

    /**
     * [项目]获取可开通项目列表
     *
     * @description 获取技师可以开通的项目列表
     *
     * @authenticated
     *
     * @response {
     *   "data": {
     *     "items": [
     *       {
     *         "id": 1,
     *         "name": "精油推拿",
     *         "cover": "http://example.com/cover.jpg",
     *         "price": "188.00",
     *         "duration": 60,
     *         "description": "项目描述",
     *         "qualification_requirements": "资质要求"
     *       }
     *     ],
     *     "total": 10
     *   }
     * }
     */
    public function getAvailableProjects()
    {
        return $this->success($this->service->getAvailableProjects(Auth::user()->id));
    }

    /**
     * [项目]开通项目
     *
     * @description 技师开通新的服务项目
     *
     * @authenticated
     *
     * @bodyParam project_id integer required 项目ID Example: 1
     *
     * @response {
     *   "message": "项目开通成功",
     *   "project_id": 1,
     *   "project_name": "精油推拿"
     * }
     */
    public function openProject(Request $request)
    {
        $data = $request->validate([
            'project_id' => 'required|integer|exists:project,id',
        ]);

        return $this->success($this->service->openProject(Auth::user()->id, $data));
    }

    /**
     * [项目]获取已开通项目列表
     *
     * @description 获取技师已开通的项目列表
     *
     * @authenticated
     *
     * @response {
     *   "data": {
     *     "items": [
     *       {
     *         "id": 1,
     *         "name": "精油推拿",
     *         "cover": "http://example.com/cover.jpg",
     *         "price": "188.00",
     *         "duration": 60,
     *         "discount_amount": "10.00",
     *         "traffic_fee": "20.00",
     *         "is_round_trip": true,
     *         "opened_at": "2024-03-21 10:00:00"
     *       }
     *     ],
     *     "total": 5
     *   }
     * }
     */
    public function getOpenedProjects()
    {
        return $this->success($this->service->getOpenedProjects(Auth::user()->id));
    }
}