xiaokang/lotteryLaravel
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 添加新的错误码以支持配置版本管理，更新彩票配置以启用手动审核，增强 API 路由以支持玩法和赔率版本化管理

Browse Source
This commit is contained in:
kang
2026-05-11 10:08:48 +08:00
parent aeaf124096
commit 067c2b39f5
41 changed files with 2578 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
app/Http/Controllers/Api/V1/Admin/Config/OddsItemsReplaceController.php Normal file
View File

@@ -0,0 +1,54 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Lottery\ConfigVersionStatus;
use App\Lottery\ErrorCode;
use App\Models\AdminUser;
use App\Models\OddsVersion;
use App\Services\Config\OddsStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Validation\Rule;
/** PUT /api/v1/admin/config/odds-versions/{id}/items */
final class OddsItemsReplaceController extends Controller
{
public function __invoke(Request $request, int $id, OddsStreamService $service): JsonResponse
{
/** @var AdminUser $admin */
$admin = $request->lotteryAdmin();
/** @var OddsVersion $version */
$version = OddsVersion::query()->whereKey($id)->firstOrFail();
if ($version->status !== ConfigVersionStatus::Draft->value) {
return ApiResponse::error(
'version is not draft',
ErrorCode::ConfigVersionNotDraft->value,
null,
400,
);
}
$data = $request->validate([
'items' => ['required', 'array', 'min:1'],
'items.*.play_code' => ['required', 'string', 'max:32', Rule::exists('play_types', 'play_code')],
'items.*.prize_scope' => ['required', 'string', 'max:32'],
'items.*.odds_value' => ['required', 'integer', 'min:0'],
'items.*.rebate_rate' => ['sometimes', 'numeric'],
'items.*.commission_rate' => ['sometimes', 'numeric'],
'items.*.currency_code' => ['required', 'string', 'max:16', Rule::exists('currencies', 'code')],
'items.*.extra_config_json' => ['sometimes', 'nullable', 'array'],
]);
$service->replaceItems($version, $data['items'], $admin);
return ApiResponse::success(
AdminConfigPresenter::oddsVersionDetail($version->fresh()->load('items')),
);
}
}

33
app/Http/Controllers/Api/V1/Admin/Config/OddsVersionIndexController.php Normal file
View File

@@ -0,0 +1,33 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Models\OddsVersion;
use App\Services\Config\OddsStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** GET /api/v1/admin/config/odds-versions */
final class OddsVersionIndexController extends Controller
{
public function __invoke(Request $request, OddsStreamService $service): JsonResponse
{
$perPage = min(max((int) $request->integer('per_page', 25), 1), 100);
$status = trim((string) $request->query('status', ''));
$paginator = $service->paginate($status === '' ? null : $status, $perPage);
return ApiResponse::success([
'items' => collect($paginator->items())->map(fn (OddsVersion $v) => AdminConfigPresenter::oddsVersionSummary($v))->all(),
'meta' => [
'current_page' => $paginator->currentPage(),
'per_page' => $paginator->perPage(),
'total' => $paginator->total(),
'last_page' => $paginator->lastPage(),
],
]);
}
}

42
app/Http/Controllers/Api/V1/Admin/Config/OddsVersionPublishController.php Normal file
View File

@@ -0,0 +1,42 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Lottery\ConfigVersionStatus;
use App\Lottery\ErrorCode;
use App\Models\AdminUser;
use App\Models\OddsVersion;
use App\Services\Config\OddsStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** POST /api/v1/admin/config/odds-versions/{id}/publish */
final class OddsVersionPublishController extends Controller
{
public function __invoke(Request $request, int $id, OddsStreamService $service): JsonResponse
{
/** @var AdminUser $admin */
$admin = $request->lotteryAdmin();
/** @var OddsVersion $version */
$version = OddsVersion::query()->whereKey($id)->firstOrFail();
if ($version->status !== ConfigVersionStatus::Draft->value) {
return ApiResponse::error(
'version is not draft',
ErrorCode::ConfigVersionNotDraft->value,
null,
400,
);
}
$service->publish($version, $admin, $request);
return ApiResponse::success(
AdminConfigPresenter::oddsVersionDetail($version->fresh()->load('items')),
);
}
}

21
app/Http/Controllers/Api/V1/Admin/Config/OddsVersionShowController.php Normal file
View File

@@ -0,0 +1,21 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Models\OddsVersion;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
/** GET /api/v1/admin/config/odds-versions/{id} */
final class OddsVersionShowController extends Controller
{
public function __invoke(int $id): JsonResponse
{
/** @var OddsVersion $v */
$v = OddsVersion::query()->with('items')->whereKey($id)->firstOrFail();
return ApiResponse::success(AdminConfigPresenter::oddsVersionDetail($v));
}
}

36
app/Http/Controllers/Api/V1/Admin/Config/OddsVersionStoreController.php Normal file
View File

@@ -0,0 +1,36 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Models\AdminUser;
use App\Services\Config\OddsStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** POST /api/v1/admin/config/odds-versions */
final class OddsVersionStoreController extends Controller
{
public function __invoke(Request $request, OddsStreamService $service): JsonResponse
{
/** @var AdminUser $admin */
$admin = $request->lotteryAdmin();
$data = $request->validate([
'reason' => ['nullable', 'string', 'max:255'],
'clone_from_version_id' => ['nullable', 'integer', 'exists:odds_versions,id'],
]);
$draft = $service->createDraft(
$admin,
$data['reason'] ?? null,
$data['clone_from_version_id'] ?? null,
);
return ApiResponse::success(
AdminConfigPresenter::oddsVersionDetail($draft->load('items')),
);
}
}

56
app/Http/Controllers/Api/V1/Admin/Config/PlayConfigItemsReplaceController.php Normal file
View File

@@ -0,0 +1,56 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Lottery\ConfigVersionStatus;
use App\Lottery\ErrorCode;
use App\Models\AdminUser;
use App\Models\PlayConfigVersion;
use App\Services\Config\PlayConfigStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Validation\Rule;
/** PUT /api/v1/admin/config/play-versions/{id}/items */
final class PlayConfigItemsReplaceController extends Controller
{
public function __invoke(Request $request, int $id, PlayConfigStreamService $service): JsonResponse
{
/** @var AdminUser $admin */
$admin = $request->lotteryAdmin();
/** @var PlayConfigVersion $version */
$version = PlayConfigVersion::query()->whereKey($id)->firstOrFail();
if ($version->status !== ConfigVersionStatus::Draft->value) {
return ApiResponse::error(
'version is not draft',
ErrorCode::ConfigVersionNotDraft->value,
null,
400,
);
}
$data = $request->validate([
'items' => ['required', 'array', 'min:1'],
'items.*.play_code' => ['required', 'string', 'max:32', Rule::exists('play_types', 'play_code')],
'items.*.is_enabled' => ['sometimes', 'boolean'],
'items.*.min_bet_amount' => ['required', 'integer', 'min:0'],
'items.*.max_bet_amount' => ['required', 'integer', 'min:0'],
'items.*.display_order' => ['sometimes', 'integer'],
'items.*.rule_text_zh' => ['sometimes', 'nullable', 'string'],
'items.*.rule_text_en' => ['sometimes', 'nullable', 'string'],
'items.*.rule_text_ne' => ['sometimes', 'nullable', 'string'],
'items.*.extra_config_json' => ['sometimes', 'nullable', 'array'],
]);
$service->replaceItems($version, $data['items'], $admin);
return ApiResponse::success(
AdminConfigPresenter::playConfigVersionDetail($version->fresh()->load('items')),
);
}
}

33
app/Http/Controllers/Api/V1/Admin/Config/PlayConfigVersionIndexController.php Normal file
View File

@@ -0,0 +1,33 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Models\PlayConfigVersion;
use App\Services\Config\PlayConfigStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** GET /api/v1/admin/config/play-versions */
final class PlayConfigVersionIndexController extends Controller
{
public function __invoke(Request $request, PlayConfigStreamService $service): JsonResponse
{
$perPage = min(max((int) $request->integer('per_page', 25), 1), 100);
$status = trim((string) $request->query('status', ''));
$paginator = $service->paginate($status === '' ? null : $status, $perPage);
return ApiResponse::success([
'items' => collect($paginator->items())->map(fn (PlayConfigVersion $v) => AdminConfigPresenter::playConfigVersionSummary($v))->all(),
'meta' => [
'current_page' => $paginator->currentPage(),
'per_page' => $paginator->perPage(),
'total' => $paginator->total(),
'last_page' => $paginator->lastPage(),
],
]);
}
}

42
app/Http/Controllers/Api/V1/Admin/Config/PlayConfigVersionPublishController.php Normal file
View File

@@ -0,0 +1,42 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Lottery\ConfigVersionStatus;
use App\Lottery\ErrorCode;
use App\Models\AdminUser;
use App\Models\PlayConfigVersion;
use App\Services\Config\PlayConfigStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** POST /api/v1/admin/config/play-versions/{id}/publish */
final class PlayConfigVersionPublishController extends Controller
{
public function __invoke(Request $request, int $id, PlayConfigStreamService $service): JsonResponse
{
/** @var AdminUser $admin */
$admin = $request->lotteryAdmin();
/** @var PlayConfigVersion $version */
$version = PlayConfigVersion::query()->whereKey($id)->firstOrFail();
if ($version->status !== ConfigVersionStatus::Draft->value) {
return ApiResponse::error(
'version is not draft',
ErrorCode::ConfigVersionNotDraft->value,
null,
400,
);
}
$service->publish($version, $admin, $request);
return ApiResponse::success(
AdminConfigPresenter::playConfigVersionDetail($version->fresh()->load('items')),
);
}
}

21
app/Http/Controllers/Api/V1/Admin/Config/PlayConfigVersionShowController.php Normal file
View File

@@ -0,0 +1,21 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Models\PlayConfigVersion;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
/** GET /api/v1/admin/config/play-versions/{id} */
final class PlayConfigVersionShowController extends Controller
{
public function __invoke(int $id): JsonResponse
{
/** @var PlayConfigVersion $v */
$v = PlayConfigVersion::query()->with('items')->whereKey($id)->firstOrFail();
return ApiResponse::success(AdminConfigPresenter::playConfigVersionDetail($v));
}
}

36
app/Http/Controllers/Api/V1/Admin/Config/PlayConfigVersionStoreController.php Normal file
View File

@@ -0,0 +1,36 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Models\AdminUser;
use App\Services\Config\PlayConfigStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** POST /api/v1/admin/config/play-versions — 新建草稿（默认克隆当前 active，若无则按 play_types 生成）。 */
final class PlayConfigVersionStoreController extends Controller
{
public function __invoke(Request $request, PlayConfigStreamService $service): JsonResponse
{
/** @var AdminUser $admin */
$admin = $request->lotteryAdmin();
$data = $request->validate([
'reason' => ['nullable', 'string', 'max:255'],
'clone_from_version_id' => ['nullable', 'integer', 'exists:play_config_versions,id'],
]);
$draft = $service->createDraft(
$admin,
$data['reason'] ?? null,
$data['clone_from_version_id'] ?? null,
);
return ApiResponse::success(
AdminConfigPresenter::playConfigVersionDetail($draft->load('items')),
);
}
}

50
app/Http/Controllers/Api/V1/Admin/Config/RiskCapItemsReplaceController.php Normal file
View File

@@ -0,0 +1,50 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Lottery\ConfigVersionStatus;
use App\Lottery\ErrorCode;
use App\Models\AdminUser;
use App\Models\RiskCapVersion;
use App\Services\Config\RiskCapStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** PUT /api/v1/admin/config/risk-cap-versions/{id}/items */
final class RiskCapItemsReplaceController extends Controller
{
public function __invoke(Request $request, int $id, RiskCapStreamService $service): JsonResponse
{
/** @var AdminUser $admin */
$admin = $request->lotteryAdmin();
/** @var RiskCapVersion $version */
$version = RiskCapVersion::query()->whereKey($id)->firstOrFail();
if ($version->status !== ConfigVersionStatus::Draft->value) {
return ApiResponse::error(
'version is not draft',
ErrorCode::ConfigVersionNotDraft->value,
null,
400,
);
}
$data = $request->validate([
'items' => ['required', 'array', 'min:1'],
'items.*.draw_id' => ['sometimes', 'nullable', 'integer', 'exists:draws,id'],
'items.*.normalized_number' => ['required', 'string', 'size:4', 'regex:/^[0-9]{4}$/'],
'items.*.cap_amount' => ['required', 'integer', 'min:0'],
'items.*.cap_type' => ['required', 'string', 'max:16'],
]);
$service->replaceItems($version, $data['items'], $admin);
return ApiResponse::success(
AdminConfigPresenter::riskCapVersionDetail($version->fresh()->load('items')),
);
}
}

33
app/Http/Controllers/Api/V1/Admin/Config/RiskCapVersionIndexController.php Normal file
View File

@@ -0,0 +1,33 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Models\RiskCapVersion;
use App\Services\Config\RiskCapStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** GET /api/v1/admin/config/risk-cap-versions */
final class RiskCapVersionIndexController extends Controller
{
public function __invoke(Request $request, RiskCapStreamService $service): JsonResponse
{
$perPage = min(max((int) $request->integer('per_page', 25), 1), 100);
$status = trim((string) $request->query('status', ''));
$paginator = $service->paginate($status === '' ? null : $status, $perPage);
return ApiResponse::success([
'items' => collect($paginator->items())->map(fn (RiskCapVersion $v) => AdminConfigPresenter::riskCapVersionSummary($v))->all(),
'meta' => [
'current_page' => $paginator->currentPage(),
'per_page' => $paginator->perPage(),
'total' => $paginator->total(),
'last_page' => $paginator->lastPage(),
],
]);
}
}

42
app/Http/Controllers/Api/V1/Admin/Config/RiskCapVersionPublishController.php Normal file
View File

@@ -0,0 +1,42 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Lottery\ConfigVersionStatus;
use App\Lottery\ErrorCode;
use App\Models\AdminUser;
use App\Models\RiskCapVersion;
use App\Services\Config\RiskCapStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** POST /api/v1/admin/config/risk-cap-versions/{id}/publish */
final class RiskCapVersionPublishController extends Controller
{
public function __invoke(Request $request, int $id, RiskCapStreamService $service): JsonResponse
{
/** @var AdminUser $admin */
$admin = $request->lotteryAdmin();
/** @var RiskCapVersion $version */
$version = RiskCapVersion::query()->whereKey($id)->firstOrFail();
if ($version->status !== ConfigVersionStatus::Draft->value) {
return ApiResponse::error(
'version is not draft',
ErrorCode::ConfigVersionNotDraft->value,
null,
400,
);
}
$service->publish($version, $admin, $request);
return ApiResponse::success(
AdminConfigPresenter::riskCapVersionDetail($version->fresh()->load('items')),
);
}
}

21
app/Http/Controllers/Api/V1/Admin/Config/RiskCapVersionShowController.php Normal file
View File

@@ -0,0 +1,21 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Models\RiskCapVersion;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
/** GET /api/v1/admin/config/risk-cap-versions/{id} */
final class RiskCapVersionShowController extends Controller
{
public function __invoke(int $id): JsonResponse
{
/** @var RiskCapVersion $v */
$v = RiskCapVersion::query()->with('items')->whereKey($id)->firstOrFail();
return ApiResponse::success(AdminConfigPresenter::riskCapVersionDetail($v));
}
}

36
app/Http/Controllers/Api/V1/Admin/Config/RiskCapVersionStoreController.php Normal file
View File

@@ -0,0 +1,36 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Config;
use App\Http\Controllers\Controller;
use App\Models\AdminUser;
use App\Services\Config\RiskCapStreamService;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** POST /api/v1/admin/config/risk-cap-versions */
final class RiskCapVersionStoreController extends Controller
{
public function __invoke(Request $request, RiskCapStreamService $service): JsonResponse
{
/** @var AdminUser $admin */
$admin = $request->lotteryAdmin();
$data = $request->validate([
'reason' => ['nullable', 'string', 'max:255'],
'clone_from_version_id' => ['nullable', 'integer', 'exists:risk_cap_versions,id'],
]);
$draft = $service->createDraft(
$admin,
$data['reason'] ?? null,
$data['clone_from_version_id'] ?? null,
);
return ApiResponse::success(
AdminConfigPresenter::riskCapVersionDetail($draft->load('items')),
);
}
}

22
app/Http/Controllers/Api/V1/Admin/PlayTypeIndexController.php Normal file
View File

@@ -0,0 +1,22 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin;
use App\Http\Controllers\Controller;
use App\Models\PlayType;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
/** GET /api/v1/admin/play-types */
final class PlayTypeIndexController extends Controller
{
public function __invoke(): JsonResponse
{
$rows = PlayType::query()->orderBy('sort_order')->orderBy('play_code')->get();
return ApiResponse::success([
'items' => $rows->map(fn (PlayType $t) => AdminConfigPresenter::playType($t))->values()->all(),
]);
}
}

37
app/Http/Controllers/Api/V1/Admin/PlayTypePatchController.php Normal file
View File

@@ -0,0 +1,37 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin;
use App\Http\Controllers\Controller;
use App\Models\PlayType;
use App\Support\AdminConfigPresenter;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/** PATCH /api/v1/admin/play-types/{play_code} — 主目录层开关与展示名（不等同于版本化 items）。 */
final class PlayTypePatchController extends Controller
{
public function __invoke(Request $request, string $play_code): JsonResponse
{
/** @var PlayType $type */
$type = PlayType::query()->where('play_code', $play_code)->firstOrFail();
$data = $request->validate([
'is_enabled' => ['sometimes', 'boolean'],
'sort_order' => ['sometimes', 'integer'],
'display_name_zh' => ['sometimes', 'nullable', 'string', 'max:64'],
'display_name_en' => ['sometimes', 'nullable', 'string', 'max:64'],
'display_name_ne' => ['sometimes', 'nullable', 'string', 'max:64'],
'supports_multi_number' => ['sometimes', 'boolean'],
'reserved_rule_json' => ['sometimes', 'nullable', 'array'],
]);
if ($data !== []) {
$type->fill($data);
$type->save();
}
return ApiResponse::success(AdminConfigPresenter::playType($type->fresh()));
}
}

45
app/Http/Controllers/Api/V1/Play/PlayEffectiveCatalogController.php Normal file
View File

@@ -0,0 +1,45 @@
<?php
namespace App\Http\Controllers\Api\V1\Play;
use App\Http\Controllers\Controller;
use App\Lottery\ErrorCode;
use App\Services\Config\EffectivePlayCatalogService;
use App\Support\ApiResponse;
use Illuminate\Database\Eloquent\ModelNotFoundException;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
/**
* GET /api/v1/play/effective — 当前生效的玩法目录 + 赔率 + 封顶（公开，无需登录）。
*/
final class PlayEffectiveCatalogController extends Controller
{
public function __invoke(Request $request, EffectivePlayCatalogService $catalog): JsonResponse
{
$currency = $request->query('currency');
$c = is_string($currency) && $currency !== '' ? $currency : null;
try {
return ApiResponse::success($catalog->build($c));
} catch (ModelNotFoundException) {
return ApiResponse::error(
'effective config not initialized',
ErrorCode::NotFound->value,
null,
404,
);
} catch (\InvalidArgumentException $e) {
if ($e->getMessage() === 'currency') {
return ApiResponse::error(
'invalid or disabled currency',
ErrorCode::ConfigCurrencyInvalid->value,
null,
400,
);
}
throw $e;
}
}
}