portal/app/app/Http/Controllers/Api/AdminYandex360BalanceController.php

<?php

declare(strict_types=1);

namespace App\Http\Controllers\Api;

use App\Http\Controllers\Controller;
use App\Services\External\Yandex360BalanceStore;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;

/**
 * SaaS-admin → Система: ручной ввод баланса Яндекс 360 (почта).
 * Владелец периодически вписывает сумму из кабинета (у Яндекса нет API баланса).
 */
class AdminYandex360BalanceController extends Controller
{
    public function __construct(private readonly Yandex360BalanceStore $store) {}

    /** GET /api/admin/settings/yandex360-balance */
    public function show(): JsonResponse
    {
        return response()->json($this->store->status());
    }

    /** PUT /api/admin/settings/yandex360-balance — {balance:number|null} */
    public function update(Request $request): JsonResponse
    {
        $raw = $request->input('balance');
        $balance = ($raw === null || $raw === '') ? null : (float) $raw;
        if ($balance !== null && $balance < 0) {
            return response()->json([
                'message' => 'Баланс не может быть отрицательным.',
                'errors' => ['balance' => ['Введите сумму ≥ 0 или очистите поле.']],
            ], 422);
        }

        $this->store->set($balance);

        return response()->json($this->store->status());
    }
}