AdminCreditAdjustmentController.php 2.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  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\StoreAdminCreditAdjustmentRequest;
  6. use App\Http\Resources\V3\AdminCreditLedgerResource;
  7. use App\Services\V3\CreditAdminService;
  8. /**
  9. * 管理后台:手工加减 AI 对话积分(仅 root / administrator)。新资源,没有 v2 前身。
  10. * 与 `artisan credits:adjust` 同一套记账,后台这边另记操作人。
  11. */
  12. class AdminCreditAdjustmentController extends Controller
  13. {
  14. use ResolvesCurrentUser;
  15. public function __construct(private readonly CreditAdminService $credits) {}
  16. /**
  17. * 手工加减积分
  18. *
  19. * 加到登录用户的积分余额(不过期)。负数为扣减,扣减后余额不能为负。
  20. * 同一 `ref` 只入账一次:重复提交返回原来那条(200),新入账是 201。
  21. *
  22. * @bodyParam user string required 用户 uuid、用户名或邮箱
  23. * @bodyParam delta integer required 加减多少积分,非零,绝对值最大 1000000
  24. * @bodyParam note string required 原因(记进流水备注)
  25. * @bodyParam ref string 调整单号(uuid),防重复提交;不给由服务端生成
  26. *
  27. * @responseStatus 201 新入账。响应体与 200 同形(200 是同一 ref 已经入账过,返回原来那条)
  28. *
  29. * @meta created boolean 这次是否新入账
  30. * @meta earned_balance integer 该用户调整后的积分余额
  31. */
  32. public function store(StoreAdminCreditAdjustmentRequest $request)
  33. {
  34. $result = $this->credits->adjust(
  35. $this->currentUser($request)['user_uid'],
  36. $request->validated('user'),
  37. $request->integer('delta'),
  38. $request->validated('note'),
  39. $request->validated('ref'),
  40. );
  41. return AdminCreditLedgerResource::make($result['entry'])->additional(['meta' => [
  42. 'created' => $result['created'],
  43. 'earned_balance' => $result['earned_balance'],
  44. ]]);
  45. }
  46. }