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

feat: 新增玩家管理与转账对账相关功能

Browse Source 
1.  新增完整的后台玩家管理CRUD接口，包括列表、创建、详情、更新、删除
2.  新增转账订单冲正和人工处理功能，支持待对账订单状态变更
3.  扩展钱包流水和转账订单的状态支持，新增reversed、manually_processed等状态
4.  新增玩家API数据统一输出类，标准化玩家信息返回格式
This commit is contained in:
kang
2026-05-14 10:43:33 +08:00
parent c9c1fecfcf
commit d877b5e37a
19 changed files with 569 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

51
app/Http/Controllers/Api/V1/Admin/Player/AdminPlayerDestroyController.php Normal file
View File

@@ -0,0 +1,51 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Player;
use App\Models\Player;
use App\Lottery\ErrorCode;
use App\Support\ApiResponse;
use Illuminate\Http\Request;
use Illuminate\Http\JsonResponse;
use App\Http\Controllers\Controller;
use Illuminate\Database\Eloquent\Relations\HasMany;
/** DELETE /api/v1/admin/players/{player} */
final class AdminPlayerDestroyController extends Controller
{
public function __invoke(Request $request, Player $player): JsonResponse
{
$hasWallets = Player::query()
->whereKey($player->getKey())
->whereHas('wallets', static fn (HasMany $q) => $q->whereRaw('balance != 0'))
->exists();
if ($hasWallets) {
return ApiResponse::error(
'该玩家钱包仍有余额，请先清空后再删除',
ErrorCode::ValidationFailed->value,
null,
422,
);
}
$hasTickets = Player::query()
->whereKey($player->getKey())
->whereHas('ticketOrders')
->exists();
if ($hasTickets) {
return ApiResponse::error(
'该玩家存在注单记录，无法删除',
ErrorCode::ValidationFailed->value,
null,
422,
);
}
$player->wallets()->delete();
$player->delete();
return ApiResponse::success(['deleted' => true]);
}
}

43
app/Http/Controllers/Api/V1/Admin/Player/AdminPlayerIndexController.php Normal file
View File

@@ -0,0 +1,43 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Player;
use App\Models\Player;
use Illuminate\Http\Request;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use App\Http\Controllers\Controller;
use App\Support\AdminApiList;
use App\Support\PlayerApiPresenter;
/** GET /api/v1/admin/players */
final class AdminPlayerIndexController extends Controller
{
public function __invoke(Request $request): JsonResponse
{
$p = AdminApiList::readPaging($request);
$keyword = trim((string) $request->query('keyword', ''));
$status = $request->query('status');
$q = Player::query()
->with(['wallets' => static fn ($wq) => $wq->orderBy('wallet_type')->orderBy('currency_code')])
->orderByDesc('id');
if ($keyword !== '') {
$term = '%'.addcslashes($keyword, '%_\\').'%';
$q->where(static function ($sub) use ($term): void {
$sub->where('site_player_id', 'like', $term)
->orWhere('username', 'like', $term)
->orWhere('nickname', 'like', $term);
});
}
if ($status !== null && $status !== '') {
$q->where('status', (int) $status);
}
$paginator = $q->paginate($p['perPage'], ['*'], 'page', $p['page']);
return AdminApiList::json($paginator, fn (Player $player): array => PlayerApiPresenter::listItem($player));
}
}

17
app/Http/Controllers/Api/V1/Admin/Player/AdminPlayerShowController.php Normal file
View File

@@ -0,0 +1,17 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Player;
use App\Models\Player;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use App\Http\Controllers\Controller;
/** GET /api/v1/admin/players/{player} */
final class AdminPlayerShowController extends Controller
{
public function __invoke(Player $player): JsonResponse
{
return ApiResponse::success(PlayerApiPresenter::listItem($player));
}
}

43
app/Http/Controllers/Api/V1/Admin/Player/AdminPlayerStoreController.php Normal file
View File

@@ -0,0 +1,43 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Player;
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\Requests\Admin\AdminPlayerStoreRequest;
/** POST /api/v1/admin/players */
final class AdminPlayerStoreController extends Controller
{
public function __invoke(AdminPlayerStoreRequest $request): JsonResponse
{
$exists = Player::query()
->where('site_code', $request->validated('site_code'))
->where('site_player_id', $request->validated('site_player_id'))
->exists();
if ($exists) {
return ApiResponse::error(
'该主站玩家已在彩票平台注册',
ErrorCode::ValidationFailed->value,
null,
422,
);
}
$player = Player::query()->create([
'site_code' => $request->validated('site_code'),
'site_player_id' => $request->validated('site_player_id'),
'username' => $request->validated('username'),
'nickname' => $request->validated('nickname'),
'default_currency' => $request->validated('default_currency', 'NPR'),
'status' => $request->validated('status', 0),
]);
return ApiResponse::success(PlayerApiPresenter::listItem($player), 201);
}
}

29
app/Http/Controllers/Api/V1/Admin/Player/AdminPlayerUpdateController.php Normal file
View File

@@ -0,0 +1,29 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Player;
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\Requests\Admin\AdminPlayerUpdateRequest;
/** PUT /api/v1/admin/players/{player} */
final class AdminPlayerUpdateController extends Controller
{
public function __invoke(AdminPlayerUpdateRequest $request, Player $player): JsonResponse
{
$data = $request->validated();
if (isset($data['status'])) {
$data['status'] = (int) $data['status'];
}
$player->fill(array_filter($data, static fn ($v) => $v !== ''));
$player->save();
return ApiResponse::success(PlayerApiPresenter::listItem($player));
}
}

4
app/Http/Controllers/Api/V1/Admin/Wallet/TransferOrderListController.php
View File

@@ -22,14 +22,14 @@ use App\Http\Requests\Admin\TransferOrderListRequest;
* - `transfer_no`（可选，模糊匹配本地单号）
* - `external_ref_no`（可选，模糊匹配主站流水号）
* - `created_from` / `created_to`（可选，`Y-m-d`，筛选创建时间）
* - `status`（可选，逗号分隔：`processing`,`success`,`failed`,`pending_reconcile`）
* - `status`（可选，逗号分隔：`processing`,`success`,`failed`,`pending_reconcile`,`reversed`,`manually_processed`）
* - `abnormal=1`（仅看异常：processing / failed / pending_reconcile，与 `status` 同时出现时优先）
*/
final class TransferOrderListController extends Controller
{
use PaginationTrait;
private const ALLOWED_STATUS = ['processing', 'success', 'failed', 'pending_reconcile'];
private const ALLOWED_STATUS = ['processing', 'success', 'failed', 'pending_reconcile', 'reversed', 'manually_processed'];
public function __invoke(TransferOrderListRequest $request): JsonResponse
{

74
app/Http/Controllers/Api/V1/Admin/Wallet/TransferOrderReconcileController.php Normal file
View File

@@ -0,0 +1,74 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin\Wallet;
use App\Models\TransferOrder;
use App\Support\ApiResponse;
use App\Support\LotteryMessage;
use App\Exceptions\WalletOperationException;
use App\Services\Wallet\LotteryTransferService;
use App\Http\Controllers\Controller;
use App\Http\Requests\Admin\Wallet\TransferOrderReverseRequest;
use App\Http\Requests\Admin\Wallet\TransferOrderManuallyProcessRequest;
use Illuminate\Http\JsonResponse;
/**
* 后台：转账订单对账操作（冲正 / 人工处理）。
* PRD §12：待对账 -> 已冲正 / 已人工处理。
*/
final class TransferOrderReconcileController extends Controller
{
public function __construct(
private readonly LotteryTransferService $transferService,
) {}
public function reverse(TransferOrderReverseRequest $request, string $transferNo): JsonResponse
{
$order = TransferOrder::query()->where('transfer_no', $transferNo)->first();
if ($order === null) {
return ApiResponse::error(__('wallet.order_not_found'), 404);
}
try {
$this->transferService->reconcileTransferOrder(
$order,
'reverse',
(string) $request->validated('remark', ''),
);
} catch (WalletOperationException $e) {
return ApiResponse::error(
LotteryMessage::wallet($request, $e->lotteryCode),
$e->lotteryCode,
null,
$e->httpStatus,
);
}
return ApiResponse::success(['transfer_no' => $transferNo, 'status' => 'reversed']);
}
public function manuallyProcess(TransferOrderManuallyProcessRequest $request, string $transferNo): JsonResponse
{
$order = TransferOrder::query()->where('transfer_no', $transferNo)->first();
if ($order === null) {
return ApiResponse::error(__('wallet.order_not_found'), 404);
}
try {
$this->transferService->reconcileTransferOrder(
$order,
'manually_process',
(string) $request->validated('remark', ''),
);
} catch (WalletOperationException $e) {
return ApiResponse::error(
LotteryMessage::wallet($request, $e->lotteryCode),
$e->lotteryCode,
null,
$e->httpStatus,
);
}
return ApiResponse::success(['transfer_no' => $transferNo, 'status' => 'manually_processed']);
}
}

2
app/Http/Controllers/Api/V1/Admin/Wallet/WalletTransactionListController.php
View File

@@ -29,7 +29,7 @@ final class WalletTransactionListController extends Controller
{
use PaginationTrait;
private const ALLOWED_STATUS = ['posted', 'pending_reconcile'];
private const ALLOWED_STATUS = ['posted', 'pending_reconcile', 'reversed'];
public function __invoke(WalletTransactionListRequest $request): JsonResponse
{

4
app/Http/Controllers/Api/V1/Wallet/WalletLogsController.php
View File

@@ -15,7 +15,7 @@ use App\Http\Controllers\Controller;
/**
* PRD §10.1.1：`GET /api/v1/wallet/logs` — 钱包流水。
*
* Query：`page`、`size`（每页条数，默认 20）、`type`（逗号分隔：transfer_in,transfer_out,bet,prize,refund）
* Query：`page`、`size`（每页条数，默认 20）、`type`（逗号分隔：transfer_in,transfer_out,bet,prize,refund,reversal）
*/
final class WalletLogsController extends Controller
{
@@ -26,6 +26,7 @@ final class WalletLogsController extends Controller
'transfer_in' => ['transfer_in'],
'transfer_out' => ['transfer_out'],
'refund' => ['transfer_out_refund'],
'reversal' => ['reversal'],
'bet' => ['bet'],
'prize' => ['prize'],
];
@@ -152,6 +153,7 @@ final class WalletLogsController extends Controller
{
return match ($biz) {
'transfer_out_refund' => 'refund',
'reversal' => 'reversal',
default => $biz,
};
}