slake-school-service/app/Support/ScheduleProgressStatus.php

<?php

namespace App\Support;

use Carbon\Carbon;

/**
 * 课程/活动进度：1 未开始 / 2 进行中 / 3 已结束
 * 进行中：处于开课/活动日期内，或处于报名起止日期内（开课前报名阶段也算进行中）
 */
class ScheduleProgressStatus
{
    public static function resolve(
        ?string $periodStart,
        ?string $periodEnd,
        ?string $signupStart = null,
        ?string $signupEnd = null,
    ): int {
        $today = now()->startOfDay();

        if ($periodEnd) {
            $endDate = Carbon::parse($periodEnd)->startOfDay();
            if ($today->gt($endDate)) {
                return 3;
            }
        }

        if ($periodStart) {
            $startDate = Carbon::parse($periodStart)->startOfDay();
            if ($today->gte($startDate)) {
                if (! $periodEnd || $today->lte(Carbon::parse($periodEnd)->startOfDay())) {
                    return 2;
                }
            }
        }

        if ($signupStart && $signupEnd) {
            $signupFrom = Carbon::parse($signupStart)->startOfDay();
            $signupTo = Carbon::parse($signupEnd)->startOfDay();
            if ($today->gte($signupFrom) && $today->lte($signupTo)) {
                return 2;
            }
        }

        if ($periodStart && $today->lt(Carbon::parse($periodStart)->startOfDay())) {
            return 1;
        }

        return 2;
    }
}