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
     *
     * @bodyParam project_id integer required 项目ID Example: 1
     * @bodyParam discount_amount numeric 优惠金额(0-10元) Example: 5.00
     * @bodyParam service_gender integer 服务性别(0:不限 1:男 2:女) Example: 0
     * @bodyParam service_distance integer 服务距离(公里,0表示不限) Example: 5
     * @bodyParam traffic_fee_type integer 交通费类型(0:免费 1:单程 2:双程) Example: 2
     * @bodyParam traffic_fee numeric 交通费金额 Example: 10.00
     *
     * @response {
     *   "message": "项目设置更新成功",
     *   "project_id": 1,
     *   "settings": {
     *     "discount_amount": "5.00",
     *     "service_gender": 0,
     *     "service_distance": 5,
     *     "traffic_fee_type": 2,
     *     "traffic_fee": "10.00"
     *   }
     * }
     */
    public function setProject(Request $request)
    {
        $data = $request->validate([
            'project_id' => 'required|integer|exists:project,id',
            'discount_amount' => 'nullable|numeric|min:0|max:10',
            'service_gender' => 'nullable|integer|in:0,1,2',
            'service_distance' => 'nullable|integer|min:0',
            'traffic_fee_type' => 'nullable|integer|in:0,1,2',
            'traffic_fee' => 'nullable|numeric|min:0',
        ]);

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