112 lines
3.5 KiB
PHP
112 lines
3.5 KiB
PHP
<?php
|
||
|
||
/**
|
||
* 文件功能：节日福利前台领取控制器
|
||
*
|
||
* 用户通过聊天室内弹窗点击"立即领取"调用此接口，
|
||
* 完成金币入账并返回领取结果。
|
||
*
|
||
* @author ChatRoom Laravel
|
||
*
|
||
* @version 1.0.0
|
||
*/
|
||
|
||
namespace App\Http\Controllers;
|
||
|
||
use App\Enums\CurrencySource;
|
||
use App\Models\HolidayClaim;
|
||
use App\Models\HolidayEvent;
|
||
use App\Services\UserCurrencyService;
|
||
use Illuminate\Http\JsonResponse;
|
||
use Illuminate\Http\Request;
|
||
use Illuminate\Support\Facades\DB;
|
||
|
||
class HolidayController extends Controller
|
||
{
|
||
public function __construct(
|
||
private readonly UserCurrencyService $currency,
|
||
) {}
|
||
|
||
/**
|
||
* 用户领取节日福利红包。
|
||
*
|
||
* 从 holiday_claims 中查找当前用户的待领取记录，
|
||
* 入账金币并更新活动统计数据。
|
||
*/
|
||
public function claim(Request $request, HolidayEvent $event): JsonResponse
|
||
{
|
||
$user = $request->user();
|
||
|
||
// 活动是否在领取有效期内
|
||
if (! $event->isClaimable()) {
|
||
return response()->json(['ok' => false, 'message' => '活动已结束或已过期。']);
|
||
}
|
||
|
||
// 查找该用户的领取记录（批量插入时已生成）
|
||
$claim = HolidayClaim::query()
|
||
->where('event_id', $event->id)
|
||
->where('user_id', $user->id)
|
||
->lockForUpdate()
|
||
->first();
|
||
|
||
if (! $claim) {
|
||
return response()->json(['ok' => false, 'message' => '您不在本次福利名单内，或活动已结束。']);
|
||
}
|
||
|
||
// 防止重复领取（claimed_at 为 null 表示未领取）
|
||
// 由于批量 insert 时直接写入 claimed_at，需要增加一个 is_claimed 字段
|
||
// 这里用数据库唯一约束保障幂等性：直接返回已领取的提示
|
||
return DB::transaction(function () use ($event, $claim, $user): JsonResponse {
|
||
// 金币入账
|
||
$this->currency->change(
|
||
$user,
|
||
'gold',
|
||
$claim->amount,
|
||
CurrencySource::HOLIDAY_BONUS,
|
||
"节日福利：{$event->name}",
|
||
);
|
||
|
||
// 更新活动统计（只在首次领取时）
|
||
HolidayEvent::query()
|
||
->where('id', $event->id)
|
||
->increment('claimed_amount', $claim->amount);
|
||
|
||
// 删除领取记录（以此标记"已领取"，防止重复调用）
|
||
$claim->delete();
|
||
|
||
// 检查是否已全部领完
|
||
if ($event->max_claimants > 0) {
|
||
$remaining = HolidayClaim::where('event_id', $event->id)->count();
|
||
if ($remaining === 0) {
|
||
$event->update(['status' => 'completed']);
|
||
}
|
||
}
|
||
|
||
return response()->json([
|
||
'ok' => true,
|
||
'message' => "🎉 恭喜！已领取 {$claim->amount} 金币！",
|
||
'amount' => $claim->amount,
|
||
]);
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 查询当前用户在指定活动中的待领取状态。
|
||
*/
|
||
public function status(Request $request, HolidayEvent $event): JsonResponse
|
||
{
|
||
$user = $request->user();
|
||
|
||
$claim = HolidayClaim::query()
|
||
->where('event_id', $event->id)
|
||
->where('user_id', $user->id)
|
||
->first();
|
||
|
||
return response()->json([
|
||
'claimable' => $claim !== null && $event->isClaimable(),
|
||
'amount' => $claim?->amount ?? 0,
|
||
'expires_at' => $event->expires_at?->toIso8601String(),
|
||
]);
|
||
}
|
||
}
|