2
0

AdminCreditAccountController.php 1.4 KB

1234567891011121314151617181920212223242526272829303132333435
  1. <?php
  2. namespace App\Http\Controllers\V3;
  3. use App\Http\Controllers\Controller;
  4. use App\Http\Requests\V3\IndexAdminCreditAccountRequest;
  5. use App\Http\Resources\V3\AdminCreditAccountResource;
  6. use App\Services\V3\CreditAdminService;
  7. /**
  8. * 管理后台:AI 对话积分账号一览(仅 root / administrator)。新资源,没有 v2 前身。
  9. */
  10. class AdminCreditAccountController extends Controller
  11. {
  12. public function __construct(private readonly CreditAdminService $credits) {}
  13. /**
  14. * 列出积分账号
  15. *
  16. * 有积分流水的账号(登录用户与游客设备),每行是该账号的汇总:积分余额、累计赚取、累计手工调整、
  17. * 累计消耗、今天用掉的赠送额度。最近有动静的在前。没有任何流水的用户不在列表里,
  18. * 但仍可以直接给他加积分(`POST /v3/admin/credit-adjustments`)。
  19. *
  20. * @queryParam filter[account_type] string 账号类型。Enum: user,guest
  21. * @queryParam filter[q] string 登录用户按用户名 / 昵称 / 邮箱模糊匹配,游客按设备 id 前缀匹配
  22. * @queryParam page integer 页码。Default: 1
  23. * @queryParam per_page integer 每页数量,最大 100。Default: 20
  24. */
  25. public function index(IndexAdminCreditAccountRequest $request)
  26. {
  27. return AdminCreditAccountResource::collection(
  28. $this->credits->accounts($request->validated(), $request->integer('per_page', 20))
  29. );
  30. }
  31. }