2
0

AdminCreditLedgerController.php 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. <?php
  2. namespace App\Http\Controllers\V3;
  3. use App\Http\Controllers\Controller;
  4. use App\Http\Requests\V3\IndexAdminCreditLedgerRequest;
  5. use App\Http\Resources\V3\AdminCreditLedgerResource;
  6. use App\Services\V3\CreditAdminService;
  7. /**
  8. * 管理后台:AI 对话积分流水(仅 root / administrator)。新资源,没有 v2 前身。底层表 `credit_ledger`。
  9. */
  10. class AdminCreditLedgerController extends Controller
  11. {
  12. public function __construct(private readonly CreditAdminService $credits) {}
  13. /**
  14. * 列出积分流水
  15. *
  16. * 最新的在前。包括结算赚取(earn)、提问扣减(spend)、出错退回(refund)与手工调整(adjust)。
  17. *
  18. * @queryParam filter[account_type] string 账号类型;给 account_id 时必填。Enum: user,guest
  19. * @queryParam filter[account_id] string 账号 id(用户 uuid 或游客设备 id)
  20. * @queryParam filter[kind] string 流水类型。Enum: earn,spend,refund,adjust
  21. * @queryParam filter[bucket] string 池子:free 每日赠送 / earned 积分余额。Enum: free,earned
  22. * @queryParam filter[source] string 来源。Enum: reading,editing,agent_run,admin
  23. * @queryParam filter[from] string 起始日(UTC,Y-m-d,按流水归属日)
  24. * @queryParam filter[to] string 结束日(UTC,Y-m-d,含当天)
  25. * @queryParam page integer 页码。Default: 1
  26. * @queryParam per_page integer 每页数量,最大 100。Default: 20
  27. */
  28. public function index(IndexAdminCreditLedgerRequest $request)
  29. {
  30. return AdminCreditLedgerResource::collection(
  31. $this->credits->ledger($request->validated(), $request->integer('per_page', 20))
  32. );
  33. }
  34. }