CaiWuXiTong/app/Business/CourierSurchargeQuoteRepository.php

<?php

namespace App\Business;

use App\Models\Business\CourierSurchargeQuote;
use App\Models\Business\CourierSurchargeType;
use Illuminate\Database\QueryException;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Schema;

/**
 * 快递附加费报价的固定读写入口。
 *
 * 页面和控制器不直接操作数据库，所有公司范围、字段白名单和状态转换
 * 都在这里集中处理，便于后续结算页面复用同一套报价规则。
 */
class CourierSurchargeQuoteRepository
{
    public const TYPES = [
        '退回费', '拦截费', '改地址', '异形件', '超长费',
        '上楼费', '送货费', '超区费', '安装费', '保费', '发出运费附加',
    ];

    public const MODES = [
        '固定单价', '按重量', '按体积', '按尺寸/最长边',
        '聚工单客服核实', '取发出运费', '发出运费倍数', '按账单',
    ];

    public const SCOPES = ['自有快递', '代发仓'];

    public function __construct(private readonly CourierSurchargeTypeRepository $types)
    {
    }

    public function ready(): bool
    {
        try {
            return Schema::hasTable((new CourierSurchargeQuote())->getTable()) && $this->types->ready();
        } catch (QueryException) {
            return false;
        }
    }

    /**
     * @param array<string,string> $filters
     * @return array{ready:bool, rows:Collection, summary:array<string,int>, options:array<string,Collection|array>}
     */
    public function pageData(array $filters): array
    {
        if (! $this->ready()) {
            return [
                'ready' => false,
                'rows' => collect(),
                'summary' => ['total' => 0, 'active' => 0, 'inactive' => 0, 'couriers' => 0],
                'options' => $this->emptyOptions(),
            ];
        }

        try {
            $all = CourierSurchargeQuote::query()
                ->orderByDesc('effective_at')
                ->orderByDesc('id')
                ->get();
        } catch (QueryException) {
            return [
                'ready' => false,
                'rows' => collect(),
                'summary' => ['total' => 0, 'active' => 0, 'inactive' => 0, 'couriers' => 0],
                'options' => $this->emptyOptions(),
            ];
        }

        $filtered = $all->filter(function (CourierSurchargeQuote $quote) use ($filters): bool {
            foreach (['courier', 'scope', 'reconciler', 'mode'] as $key) {
                if (($filters[$key] ?? '') !== '' && (string) $quote->{$key} !== $filters[$key]) {
                    return false;
                }
            }

            if (($filters['type'] ?? '') !== '' && ! in_array($filters['type'], (array) $quote->types, true)) {
                return false;
            }

            if (($filters['status'] ?? '') !== '' && $quote->statusLabel() !== $filters['status']) {
                return false;
            }

            $keyword = trim((string) ($filters['keyword'] ?? ''));
            if ($keyword !== '') {
                $searchable = implode('|', [
                    $quote->courier,
                    $quote->scope,
                    $quote->reconciler,
                    $quote->typeLabel(),
                    $quote->mode,
                    $quote->standard,
                    $quote->condition,
                    (string) $quote->remark,
                ]);

                if (! str_contains($searchable, $keyword)) {
                    return false;
                }
            }

            return true;
        })->values();

        $typeRecords = $this->types->all();
        $activeTypeNames = $typeRecords
            ->where('status', CourierSurchargeType::STATUS_ACTIVE)
            ->pluck('name')
            ->values();

        return [
            'ready' => true,
            'rows' => $filtered->map(fn (CourierSurchargeQuote $quote): array => $this->present($quote)),
            'summary' => [
                'total' => $filtered->count(),
                'active' => $filtered->where('status', CourierSurchargeQuote::STATUS_ACTIVE)->count(),
                'inactive' => $filtered->where('status', CourierSurchargeQuote::STATUS_INACTIVE)->count(),
                'couriers' => $filtered->pluck('courier')->unique()->count(),
            ],
            'options' => [
                'couriers' => $all->pluck('courier')->filter()->unique()->sort()->values(),
                'types' => $activeTypeNames,
                'filter_types' => $typeRecords->pluck('name')->values(),
                'type_records' => $typeRecords->map(fn ($type): array => [
                    'id' => $type->id,
                    'name' => $type->name,
                    'status' => $type->status,
                    'status_label' => $type->statusLabel(),
                ])->values(),
                'modes' => collect(self::MODES),
                'scopes' => self::SCOPES,
                'reconcilers' => $all->pluck('reconciler')->filter()->unique()->sort()->values(),
                'statuses' => ['已启用', '已停用'],
            ],
        ];
    }

    /** @return list<string> */
    public function validTypeNames(): array
    {
        return $this->types->validNames();
    }

    /** @return list<string> */
    public function activeTypeNames(): array
    {
        return $this->types->activeNames();
    }

    /** @param array<string,mixed> $data */
    public function create(array $data, int $userId): CourierSurchargeQuote
    {
        return CourierSurchargeQuote::query()->create($this->attributes($data, $userId) + [
            'status' => CourierSurchargeQuote::STATUS_ACTIVE,
            'created_by' => $userId,
        ]);
    }

    /** @param array<string,mixed> $data */
    public function update(CourierSurchargeQuote $quote, array $data, int $userId): CourierSurchargeQuote
    {
        $quote->update($this->attributes($data, $userId));

        return $quote->fresh();
    }

    public function setStatus(CourierSurchargeQuote $quote, string $status, int $userId): CourierSurchargeQuote
    {
        abort_unless(in_array($status, [CourierSurchargeQuote::STATUS_ACTIVE, CourierSurchargeQuote::STATUS_INACTIVE], true), 422, '报价规则状态不合法。');

        $quote->forceFill(['status' => $status, 'updated_by' => $userId])->save();

        return $quote->fresh();
    }

    /** @param array<string,mixed> $data */
    private function attributes(array $data, int $userId): array
    {
        return [
            'company_id' => company_id(),
            'courier' => trim((string) $data['courier']),
            'scope' => trim((string) $data['scope']),
            'reconciler' => trim((string) $data['reconciler']),
            'types' => array_values(array_unique(array_map('strval', $data['types']))),
            'mode' => trim((string) $data['mode']),
            'standard' => trim((string) $data['standard']),
            'condition' => trim((string) $data['condition']),
            'effective_at' => $data['effective_at'],
            'remark' => trim((string) ($data['remark'] ?? '')) ?: null,
            'updated_by' => $userId,
        ];
    }

    /** @return array<string,mixed> */
    private function present(CourierSurchargeQuote $quote): array
    {
        return [
            'id' => 'SUR-' . str_pad((string) $quote->id, 3, '0', STR_PAD_LEFT),
            'db_id' => $quote->id,
            'courier' => $quote->courier,
            'scope' => $quote->scope,
            'reconciler' => $quote->reconciler,
            'types' => array_values((array) $quote->types),
            'type' => $quote->typeLabel(),
            'mode' => $quote->mode,
            'standard' => $quote->standard,
            'condition' => $quote->condition,
            'effective_at' => optional($quote->effective_at)->format('Y-m-d'),
            'status_code' => $quote->status,
            'status' => $quote->statusLabel(),
            'remark' => $quote->remark,
        ];
    }

    /** @return array<string,Collection|array> */
    private function emptyOptions(): array
    {
        return [
            'couriers' => collect(),
            'types' => collect(self::TYPES),
            'filter_types' => collect(self::TYPES),
            'type_records' => collect(),
            'modes' => collect(self::MODES),
            'scopes' => self::SCOPES,
            'reconcilers' => collect(),
            'statuses' => ['已启用', '已停用'],
        ];
    }
}