feat: 增强环境配置与开发服务,支持局域网访问及币种管理

This commit is contained in:
2026-05-21 16:24:41 +08:00
parent 699d43fbd4
commit 7a6048de10
60 changed files with 1321 additions and 443 deletions

View File

@@ -0,0 +1,69 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Currency;
use App\Models\Currency;
use App\Lottery\ErrorCode;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\DB;
use App\Http\Controllers\Controller;
final class AdminCurrencyDestroyController extends Controller
{
public function __invoke(Currency $currency): JsonResponse
{
$code = strtoupper((string) $currency->code);
if ($code === strtoupper((string) config('lottery.default_currency', 'NPR'))) {
return ApiResponse::error(
'默认币种不可删除',
ErrorCode::ValidationFailed->value,
null,
422,
);
}
$references = $this->referenceSummary($code);
if ($references !== []) {
return ApiResponse::error(
'该币种已被业务数据引用,暂不可删除:'.implode('、', $references),
ErrorCode::ValidationFailed->value,
['references' => $references],
422,
);
}
$id = (int) $currency->id;
$currency->delete();
return ApiResponse::success([
'deleted' => true,
'id' => $id,
'code' => $code,
]);
}
/** @return list<string> */
private function referenceSummary(string $code): array
{
$checks = [
'玩家默认币种' => DB::table('players')->where('default_currency', $code),
'玩家钱包' => DB::table('player_wallets')->where('currency_code', $code),
'转账单' => DB::table('transfer_orders')->where('currency_code', $code),
'注单' => DB::table('ticket_orders')->where('currency_code', $code),
'赔率配置' => DB::table('odds_items')->where('currency_code', $code),
'奖池' => DB::table('jackpot_pools')->where('currency_code', $code),
'Jackpot 贡献记录' => DB::table('jackpot_contributions')->where('currency_code', $code),
];
$references = [];
foreach ($checks as $label => $query) {
if ($query->exists()) {
$references[] = $label;
}
}
return $references;
}
}

View File

@@ -0,0 +1,39 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Currency;
use App\Models\Currency;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use App\Http\Controllers\Controller;
final class AdminCurrencyIndexController extends Controller
{
public function __invoke(): JsonResponse
{
$items = Currency::query()
->orderByDesc('is_enabled')
->orderByDesc('is_bettable')
->orderBy('code')
->get()
->map(fn (Currency $currency): array => $this->serializeCurrency($currency))
->all();
return ApiResponse::success(['items' => $items]);
}
/** @return array<string, mixed> */
private function serializeCurrency(Currency $currency): array
{
return [
'id' => (int) $currency->id,
'code' => $currency->code,
'name' => $currency->name,
'decimal_places' => (int) $currency->decimal_places,
'is_enabled' => (bool) $currency->is_enabled,
'is_bettable' => (bool) $currency->is_bettable,
'created_at' => $currency->created_at?->toIso8601String(),
'updated_at' => $currency->updated_at?->toIso8601String(),
];
}
}

View File

@@ -0,0 +1,54 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Currency;
use App\Models\Currency;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\DB;
use App\Http\Controllers\Controller;
use App\Services\Currency\CurrencyActivationService;
use App\Http\Requests\Admin\AdminCurrencyStoreRequest;
final class AdminCurrencyStoreController extends Controller
{
public function __invoke(
AdminCurrencyStoreRequest $request,
CurrencyActivationService $activationService,
): JsonResponse {
$data = $request->validated();
$enabled = (bool) ($data['is_enabled'] ?? true);
$bettable = $enabled && (bool) ($data['is_bettable'] ?? false);
$currency = DB::transaction(function () use ($data, $enabled, $bettable, $activationService): Currency {
$currency = Currency::query()->create([
'code' => $data['code'],
'name' => $data['name'],
'decimal_places' => (int) ($data['decimal_places'] ?? 2),
'is_enabled' => $enabled,
'is_bettable' => $bettable,
]);
$activationService->ensureBettableCurrencyReady($currency);
return $currency->fresh();
});
return ApiResponse::success($this->serializeCurrency($currency))->setStatusCode(201);
}
/** @return array<string, mixed> */
private function serializeCurrency(Currency $currency): array
{
return [
'id' => (int) $currency->id,
'code' => $currency->code,
'name' => $currency->name,
'decimal_places' => (int) $currency->decimal_places,
'is_enabled' => (bool) $currency->is_enabled,
'is_bettable' => (bool) $currency->is_bettable,
'created_at' => $currency->created_at?->toIso8601String(),
'updated_at' => $currency->updated_at?->toIso8601String(),
];
}
}

View File

@@ -0,0 +1,62 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Currency;
use App\Models\Currency;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\DB;
use App\Http\Controllers\Controller;
use App\Services\Currency\CurrencyActivationService;
use App\Http\Requests\Admin\AdminCurrencyUpdateRequest;
final class AdminCurrencyUpdateController extends Controller
{
public function __invoke(
AdminCurrencyUpdateRequest $request,
Currency $currency,
CurrencyActivationService $activationService,
): JsonResponse {
$data = $request->validated();
if (array_key_exists('is_enabled', $data) && ! (bool) $data['is_enabled']) {
$data['is_bettable'] = false;
} elseif (array_key_exists('is_bettable', $data)) {
$data['is_bettable'] = (bool) $data['is_bettable'];
}
if (array_key_exists('decimal_places', $data)) {
$data['decimal_places'] = (int) $data['decimal_places'];
}
if (array_key_exists('is_enabled', $data)) {
$data['is_enabled'] = (bool) $data['is_enabled'];
}
$currency = DB::transaction(function () use ($currency, $data, $activationService): Currency {
$currency->fill($data);
$currency->save();
$activationService->ensureBettableCurrencyReady($currency);
return $currency->fresh();
});
return ApiResponse::success($this->serializeCurrency($currency));
}
/** @return array<string, mixed> */
private function serializeCurrency(Currency $currency): array
{
return [
'id' => (int) $currency->id,
'code' => $currency->code,
'name' => $currency->name,
'decimal_places' => (int) $currency->decimal_places,
'is_enabled' => (bool) $currency->is_enabled,
'is_bettable' => (bool) $currency->is_bettable,
'created_at' => $currency->created_at?->toIso8601String(),
'updated_at' => $currency->updated_at?->toIso8601String(),
];
}
}

View File

@@ -6,8 +6,8 @@ use App\Models\Player;
use App\Lottery\ErrorCode;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use App\Http\Controllers\Controller;
use App\Support\PlayerApiPresenter;
use App\Http\Controllers\Controller;
use App\Http\Requests\Admin\AdminPlayerStoreRequest;
/** POST /api/v1/admin/players */
@@ -38,6 +38,6 @@ final class AdminPlayerStoreController extends Controller
'status' => $request->validated('status', 0),
]);
return ApiResponse::success(PlayerApiPresenter::listItem($player), 201);
return ApiResponse::success(PlayerApiPresenter::listItem($player))->setStatusCode(201);
}
}

View File

@@ -22,7 +22,7 @@ final class AdminPlayerTicketItemsIndexController extends Controller
public function __invoke(AdminPlayerTicketItemsRequest $request, Player $player): JsonResponse
{
$perPage = $this->perPage($request, 'per_page', 20, 50);
$perPage = $this->perPage($request, 'per_page', 10, 50);
$page = $this->page($request);
$drawNo = $request->validated('draw_no');
if (is_string($drawNo)) {

View File

@@ -1,36 +0,0 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Reports;
use App\Models\ReportJob;
use App\Services\Admin\AdminReportJobService;
use Symfony\Component\HttpFoundation\StreamedResponse;
final class ReportJobDownloadController
{
public function __invoke(ReportJob $report_job, AdminReportJobService $service): StreamedResponse
{
$filterJson = is_array($report_job->filter_json) ? $report_job->filter_json : null;
$dateFrom = (string) ($filterJson['date_from'] ?? now()->toDateString());
$dateTo = (string) ($filterJson['date_to'] ?? $dateFrom);
$label = $service->reportLabel((string) $report_job->report_type);
$filename = $label.'_'.$dateFrom.'_'.$dateTo.'.'.$report_job->export_format;
$rows = $service->reportRows((string) $report_job->report_type, $filterJson);
if ((string) $report_job->export_format === 'xlsx') {
return response()->streamDownload(function () use ($rows): void {
echo "PK\x03\x04";
echo json_encode($rows, JSON_UNESCAPED_UNICODE);
}, $filename, ['Content-Type' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet']);
}
return response()->streamDownload(function () use ($rows): void {
$out = fopen('php://output', 'w');
fwrite($out, "\xEF\xBB\xBF");
foreach ($rows as $row) {
fputcsv($out, $row);
}
fclose($out);
}, $filename, ['Content-Type' => 'text/csv; charset=UTF-8']);
}
}

View File

@@ -1,42 +0,0 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Reports;
use App\Models\ReportJob;
use Illuminate\Http\Request;
use App\Support\AdminApiList;
use Illuminate\Http\JsonResponse;
use App\Http\Controllers\Controller;
/** GET /api/v1/admin/report-jobs */
final class ReportJobIndexController extends Controller
{
public function __invoke(Request $request): JsonResponse
{
$p = AdminApiList::readPaging($request);
$paginator = ReportJob::query()
->orderByDesc('id')
->paginate($p['perPage'], ['*'], 'page', $p['page']);
return AdminApiList::json($paginator, fn (ReportJob $j) => $this->row($j));
}
/** @return array<string, mixed> */
private function row(ReportJob $j): array
{
return [
'id' => (int) $j->id,
'job_no' => $j->job_no,
'admin_user_id' => $j->admin_user_id !== null ? (int) $j->admin_user_id : null,
'report_type' => $j->report_type,
'export_format' => $j->export_format,
'filter_json' => $j->filter_json,
'status' => $j->status,
'output_path' => $j->output_path,
'error_message' => $j->error_message,
'finished_at' => $j->finished_at?->toIso8601String(),
'created_at' => $j->created_at?->toIso8601String(),
];
}
}

View File

@@ -1,29 +0,0 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Reports;
use App\Models\ReportJob;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use App\Http\Controllers\Controller;
/** GET /api/v1/admin/report-jobs/{report_job} */
final class ReportJobShowController extends Controller
{
public function __invoke(ReportJob $report_job): JsonResponse
{
return ApiResponse::success([
'id' => (int) $report_job->id,
'job_no' => $report_job->job_no,
'admin_user_id' => $report_job->admin_user_id !== null ? (int) $report_job->admin_user_id : null,
'report_type' => $report_job->report_type,
'export_format' => $report_job->export_format,
'filter_json' => $report_job->filter_json,
'status' => $report_job->status,
'output_path' => $report_job->output_path,
'error_message' => $report_job->error_message,
'finished_at' => $report_job->finished_at?->toIso8601String(),
'created_at' => $report_job->created_at?->toIso8601String(),
]);
}
}

View File

@@ -1,39 +0,0 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Reports;
use App\Models\AdminUser;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use App\Http\Controllers\Controller;
use App\Services\Admin\AdminReportJobService;
use App\Http\Requests\Admin\ReportJobStoreRequest;
/** POST /api/v1/admin/report-jobs */
final class ReportJobStoreController extends Controller
{
public function __invoke(ReportJobStoreRequest $request, AdminReportJobService $service): JsonResponse
{
/** @var AdminUser $admin */
$admin = $request->lotteryAdmin();
$data = $request->validated();
$job = $service->enqueue(
$admin,
$request,
(string) $data['report_type'],
(string) ($data['export_format'] ?? 'csv'),
isset($data['filter_json']) ? (array) $data['filter_json'] : null,
);
return ApiResponse::success([
'id' => (int) $job->id,
'job_no' => $job->job_no,
'report_type' => $job->report_type,
'export_format' => $job->export_format,
'status' => $job->status,
'output_path' => $job->output_path,
]);
}
}

View File

@@ -4,6 +4,7 @@ namespace App\Http\Controllers\Api\V1\Admin\Risk;
use App\Models\Draw;
use App\Models\RiskPool;
use App\Models\TicketOrder;
use Illuminate\Http\Request;
use App\Support\AdminApiList;
use Illuminate\Http\JsonResponse;
@@ -49,9 +50,14 @@ final class AdminRiskPoolIndexController extends Controller
/** @var LengthAwarePaginator $paginator */
$paginator = $q->paginate($p['perPage'], ['*'], 'page', $p['page']);
$currencyCode = (string) (TicketOrder::query()
->where('draw_id', $draw->id)
->value('currency_code') ?? '');
return AdminApiList::jsonWith($paginator, fn (RiskPool $row) => $this->row($row), [
'draw_id' => (int) $draw->id,
'draw_no' => $draw->draw_no,
'currency_code' => $currencyCode !== '' ? $currencyCode : null,
]);
}

View File

@@ -3,6 +3,7 @@
namespace App\Http\Controllers\Api\V1\Admin\Risk;
use App\Models\Draw;
use App\Models\TicketOrder;
use Illuminate\Http\Request;
use App\Support\AdminApiList;
use App\Models\RiskPoolLockLog;
@@ -38,9 +39,14 @@ final class AdminRiskPoolLockLogIndexController extends Controller
/** @var LengthAwarePaginator $paginator */
$paginator = $q->paginate($p['perPage'], ['*'], 'page', $p['page']);
$currencyCode = (string) (TicketOrder::query()
->where('draw_id', $draw->id)
->value('currency_code') ?? '');
return AdminApiList::jsonWith($paginator, fn (RiskPoolLockLog $log) => $this->row($log), [
'draw_id' => (int) $draw->id,
'draw_no' => $draw->draw_no,
'currency_code' => $currencyCode !== '' ? $currencyCode : null,
]);
}

View File

@@ -5,6 +5,7 @@ namespace App\Http\Controllers\Api\V1\Admin\Risk;
use App\Models\Draw;
use App\Models\RiskPool;
use App\Lottery\ErrorCode;
use App\Models\TicketOrder;
use App\Support\ApiResponse;
use Illuminate\Http\Request;
use App\Support\AdminApiList;
@@ -56,10 +57,14 @@ final class AdminRiskPoolShowController extends Controller
$cap = (int) $pool->total_cap_amount;
$locked = (int) $pool->locked_amount;
$currencyCode = (string) (TicketOrder::query()
->where('draw_id', $draw->id)
->value('currency_code') ?? '');
return ApiResponse::success([
'draw_id' => (int) $draw->id,
'draw_no' => $draw->draw_no,
'currency_code' => $currencyCode !== '' ? $currencyCode : null,
'pool' => [
'normalized_number' => $pool->normalized_number,
'total_cap_amount' => $cap,

View File

@@ -23,6 +23,7 @@ final class AdminSettlementBatchDetailsController extends Controller
->with([
'ticketItem:id,ticket_no,play_code,player_id',
'ticketItem.player:id,username,site_player_id',
'ticketItem.order:id,currency_code',
])
->orderBy('id')
->paginate($p['perPage'], ['*'], 'page', $p['page']);
@@ -31,12 +32,14 @@ final class AdminSettlementBatchDetailsController extends Controller
/** @var TicketSettlementDetail $row */
$item = $row->ticketItem;
$player = $item?->player;
$order = $item?->order;
return [
'id' => (int) $row->id,
'ticket_item_id' => (int) $row->ticket_item_id,
'ticket_no' => $item?->ticket_no,
'play_code' => $item?->play_code,
'currency_code' => $order?->currency_code,
'player_id' => $item?->player_id,
'player_username' => $player?->username,
'site_player_id' => $player?->site_player_id,

View File

@@ -46,6 +46,7 @@ final class AdminSettlementBatchIndexController extends Controller
'id' => (int) $b->id,
'draw_id' => (int) $b->draw_id,
'draw_no' => $b->draw?->draw_no,
'currency_code' => $financial['currency_code'],
'result_batch_id' => (int) $b->result_batch_id,
'settle_version' => (int) $b->settle_version,
'status' => $b->status,

View File

@@ -22,6 +22,7 @@ final class AdminSettlementBatchShowController extends Controller
'id' => (int) $batch->id,
'draw_id' => (int) $batch->draw_id,
'draw_no' => $batch->draw?->draw_no,
'currency_code' => $financial['currency_code'],
'draw_status' => $batch->draw?->status,
'result_batch_id' => (int) $batch->result_batch_id,
'result_batch_version' => $batch->resultBatch?->result_version,

View File

@@ -30,7 +30,7 @@ final class AdminTicketItemIndexController extends Controller
{
$validated = $request->validated();
$perPage = $this->perPage($request, 'per_page', 20, 100);
$perPage = $this->perPage($request, 'per_page', 10, 100);
$page = $this->page($request);
$query = TicketItem::query()

View File

@@ -16,7 +16,7 @@ use App\Http\Requests\Admin\TransferOrderListRequest;
*
* Query
* - `page`(默认 1
* - `per_page` `size`(每页条数,默认 20,最大 100
* - `per_page` `size`(每页条数,默认 10,最大 100
* - `player_id`(可选,按玩家主键)
* - `player_account`(可选,模糊匹配 `players.site_player_id` / `username`;与 `player_id` 同时传时以 `player_id` 为准)
* - `transfer_no`(可选,模糊匹配本地单号)
@@ -35,7 +35,7 @@ final class TransferOrderListController extends Controller
{
$validated = $request->validated();
$perPage = $this->perPage($request, 'per_page', 20, 100);
$perPage = $this->perPage($request, 'per_page', 10, 100);
$page = $this->page($request);
$query = TransferOrder::query()

View File

@@ -35,7 +35,7 @@ final class WalletTransactionListController extends Controller
{
$validated = $request->validated();
$perPage = $this->perPage($request, 'per_page', 20, 100);
$perPage = $this->perPage($request, 'per_page', 10, 100);
$page = $this->page($request);
$query = WalletTxn::query()

View File

@@ -0,0 +1,29 @@
<?php
namespace App\Http\Controllers\Api\V1\Currency;
use App\Models\Currency;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use App\Http\Controllers\Controller;
final class CurrencyIndexController extends Controller
{
public function __invoke(): JsonResponse
{
$items = Currency::query()
->where('is_enabled', true)
->orderByDesc('is_bettable')
->orderBy('code')
->get()
->map(fn (Currency $currency): array => [
'code' => $currency->code,
'name' => $currency->name,
'decimal_places' => (int) $currency->decimal_places,
'is_bettable' => (bool) $currency->is_bettable,
])
->all();
return ApiResponse::success(['items' => $items]);
}
}

View File

@@ -19,6 +19,11 @@ final class JackpotSummaryController extends Controller
public function __invoke(Request $request): JsonResponse
{
return ApiResponse::success($this->summary->summary((string) $request->query('currency_code', 'NPR')));
$currencyCode = strtoupper(trim((string) $request->query(
'currency_code',
(string) config('lottery.default_currency', 'NPR'),
)));
return ApiResponse::success($this->summary->summary($currencyCode));
}
}

View File

@@ -24,7 +24,7 @@ final class TicketItemsIndexController extends Controller
/** @var Player $player */
$player = $request->attributes->get('lottery_player');
$perPage = $this->perPage($request, 'per_page', 20, 50);
$perPage = $this->perPage($request, 'per_page', 10, 50);
$page = $this->page($request);
$drawNo = $request->query('draw_no');
$statusInput = $request->query('status', []);

View File

@@ -77,7 +77,7 @@ final class WalletBalanceController extends Controller
{
$code = CurrencyResolver::resolve($request, $player, 'currency');
if (! CurrencyResolver::isValid($code)) {
if (! CurrencyResolver::isEnabled($code)) {
return ApiResponse::error(
__('wallet.invalid_currency'),
ErrorCode::WalletInvalidCurrency->value,

View File

@@ -57,7 +57,7 @@ final class WalletTransferInController extends Controller
{
$code = CurrencyResolver::resolve($request, $player, 'currency');
if (! CurrencyResolver::isValid($code)) {
if (! CurrencyResolver::isEnabled($code)) {
return ApiResponse::error(
__('wallet.invalid_currency'),
ErrorCode::WalletInvalidCurrency->value,

View File

@@ -57,7 +57,7 @@ final class WalletTransferOutController extends Controller
{
$code = CurrencyResolver::resolve($request, $player, 'currency');
if (! CurrencyResolver::isValid($code)) {
if (! CurrencyResolver::isEnabled($code)) {
return ApiResponse::error(
__('wallet.invalid_currency'),
ErrorCode::WalletInvalidCurrency->value,