AdminCreditSettlementController.php 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. <?php
  2. namespace App\Http\Controllers\V3;
  3. use App\Http\Controllers\Concerns\ResolvesCurrentUser;
  4. use App\Http\Controllers\Controller;
  5. use App\Http\Requests\V3\StoreAdminCreditSettlementRequest;
  6. use App\Http\Resources\V3\AdminCreditSettlementResource;
  7. use App\Services\V3\CreditAdminService;
  8. /**
  9. * 管理后台:手工跑一次积分结算(仅 root / administrator)。新资源,没有 v2 前身。
  10. *
  11. * 每日任务 `artisan credits:settle-activity` 出问题时用。两者同一套逻辑(CreditAdminService::settle)。
  12. */
  13. class AdminCreditSettlementController extends Controller
  14. {
  15. use ResolvesCurrentUser;
  16. public function __construct(private readonly CreditAdminService $credits) {}
  17. /**
  18. * 手工结算积分
  19. *
  20. * 把登录用户的读经、编辑时长结算成积分。可重复执行:同一用户同一天的积分是覆盖不是累加,不会重复入账。
  21. * 不给 `date`:从积分上线日到昨天,补齐所有漏结算的「用户 + 日」(与每日任务相同);
  22. * 给 `date`:按当前策略重算那一天的所有用户。同步执行。
  23. *
  24. * @responseStatus 201 结算完成。响应体与 200 同形
  25. *
  26. * @bodyParam date string 只重算这一天(UTC,Y-m-d),不早于积分上线日、不晚于今天
  27. */
  28. public function store(StoreAdminCreditSettlementRequest $request)
  29. {
  30. $date = $request->validated('date');
  31. return AdminCreditSettlementResource::make($this->credits->settle(
  32. $date === null ? null : now('UTC')->parse($date),
  33. $this->currentUser($request)['user_uid'],
  34. ))->response()->setStatusCode(201);
  35. }
  36. }