24_admin_credits.php 5.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135
  1. <?php
  2. use \WikipaliApi\Api\AdminApi;
  3. use \WikipaliApi\Model\PostApiV3AdminCreditAdjustmentsRequest;
  4. use \WikipaliApi\Model\PostApiV3AdminCreditSettlementsRequest;
  5. /*
  6. * v3 管理后台 · AI 对话积分:/v3/admin/credit-overview、credit-accounts、credit-ledger、
  7. * credit-adjustments、credit-settlements(仅 root / administrator)。
  8. *
  9. * 测试账号是普通用户时只测 401 / 403;是管理员时再测读、422 与写。
  10. * 写都是幂等的:结算重复执行结果覆盖;给自己 +1 再 -1 用固定的 ref,每台服务器只入账一次、净额为 0。
  11. */
  12. /** 测试账号是不是管理员(看 /v3/me 的 roles) */
  13. function credit_admin(string $token): bool
  14. {
  15. $me = raw('GET', '/v3/me', null, null, $token);
  16. assert_status(200, $me, 'me');
  17. $roles = $me['body']['data']['roles'] ?? [];
  18. return (bool) array_intersect(['administrator', 'root'], $roles);
  19. }
  20. function admin_token_or_skip(): string
  21. {
  22. $token = required_token();
  23. if (! credit_admin($token)) {
  24. skip('测试账号不是管理员');
  25. }
  26. return $token;
  27. }
  28. /* ---- 无 token → 401 ---- */
  29. test('GET /v3/admin/credit-overview(无 token)→ 401', function () {
  30. $res = request(fn () => api(AdminApi::class)->getApiV3AdminCreditOverviewWithHttpInfo());
  31. assert_status(401, $res, 'credit-overview');
  32. assert_problem($res, 'credit-overview');
  33. });
  34. test('POST /v3/admin/credit-settlements(无 token)→ 401', function () {
  35. $res = request(fn () => api(AdminApi::class)->postApiV3AdminCreditSettlementsWithHttpInfo(new PostApiV3AdminCreditSettlementsRequest()));
  36. assert_status(401, $res, 'credit-settlements');
  37. });
  38. /* ---- 普通用户 → 403 ---- */
  39. test('GET /v3/admin/credit-accounts(非管理员)→ 403', function () {
  40. $token = required_token();
  41. if (credit_admin($token)) {
  42. skip('测试账号是管理员');
  43. }
  44. $res = request(fn () => api(AdminApi::class, $token)->getApiV3AdminCreditAccountsWithHttpInfo());
  45. assert_status(403, $res, 'credit-accounts');
  46. assert_problem($res, 'credit-accounts');
  47. });
  48. /* ---- 管理员:读 ---- */
  49. test('GET /v3/admin/credit-overview → 200', function () {
  50. $res = request(fn () => api(AdminApi::class, admin_token_or_skip())->getApiV3AdminCreditOverviewWithHttpInfo());
  51. assert_status(200, $res, 'credit-overview');
  52. foreach (['today', 'earn_since', 'policy_version', 'policy', 'totals', 'recent_days', 'last_settlement'] as $key) {
  53. assert_has_key($key, $res['body']['data'], 'credit-overview.data');
  54. }
  55. assert_eq(14, count($res['body']['data']['recent_days']), 'recent_days 14 天');
  56. });
  57. test('GET /v3/admin/credit-accounts → 200 分页', function () {
  58. $res = request(fn () => api(AdminApi::class, admin_token_or_skip())->getApiV3AdminCreditAccountsWithHttpInfo(per_page: 5));
  59. assert_status(200, $res, 'credit-accounts');
  60. assert_has_key('total', $res['body']['meta'], 'credit-accounts.meta');
  61. foreach ($res['body']['data'] as $row) {
  62. foreach (['account_type', 'account_id', 'earned_balance', 'spent_total', 'free_used_today', 'daily_free'] as $key) {
  63. assert_has_key($key, $row, 'credit-accounts.data[]');
  64. }
  65. }
  66. });
  67. test('GET /v3/admin/credit-ledger(只给 account_id)→ 422', function () {
  68. $res = request(fn () => api(AdminApi::class, admin_token_or_skip())->getApiV3AdminCreditLedgerWithHttpInfo(
  69. filter_account_id: '00000000-0000-4000-8000-000000000000',
  70. ));
  71. assert_status(422, $res, 'credit-ledger');
  72. assert_field_error('filter.account_type', $res, 'credit-ledger');
  73. });
  74. /* ---- 管理员:写(幂等) ---- */
  75. test('POST /v3/admin/credit-settlements → 201(可重复执行)', function () {
  76. $res = request(fn () => api(AdminApi::class, admin_token_or_skip())->postApiV3AdminCreditSettlementsWithHttpInfo(
  77. new PostApiV3AdminCreditSettlementsRequest(),
  78. ));
  79. assert_status(201, $res, 'credit-settlements');
  80. assert_eq('missing', $res['body']['data']['mode'], 'credit-settlements.mode');
  81. });
  82. test('POST /v3/admin/credit-settlements(未来日期)→ 422', function () {
  83. $body = new PostApiV3AdminCreditSettlementsRequest();
  84. $body->setDate(gmdate('Y-m-d', time() + 86400 * 2));
  85. $res = request(fn () => api(AdminApi::class, admin_token_or_skip())->postApiV3AdminCreditSettlementsWithHttpInfo($body));
  86. assert_status(422, $res, 'credit-settlements');
  87. assert_field_error('date', $res, 'credit-settlements');
  88. });
  89. test('POST /v3/admin/credit-adjustments:给自己 +1 再 -1(固定 ref,只入账一次)', function () {
  90. $token = admin_token_or_skip();
  91. $me = raw('GET', '/v3/me', null, null, $token);
  92. assert_status(200, $me, 'me');
  93. $me = $me['body']['data']['id'];
  94. foreach ([['8f0b5a52-3c1e-4e0a-9d7a-5b1f0c2e0001', 1], ['8f0b5a52-3c1e-4e0a-9d7a-5b1f0c2e0002', -1]] as [$ref, $delta]) {
  95. $body = new PostApiV3AdminCreditAdjustmentsRequest();
  96. $body->setUser($me);
  97. $body->setDelta($delta);
  98. $body->setNote('api-test 幂等写入');
  99. $body->setRef($ref);
  100. $res = request(fn () => api(AdminApi::class, $token)->postApiV3AdminCreditAdjustmentsWithHttpInfo($body));
  101. if (! in_array($res['status'], [200, 201], true)) {
  102. assert_status(201, $res, "credit-adjustments {$delta}");
  103. }
  104. assert_eq($delta, $res['body']['data']['delta'], 'credit-adjustments.delta');
  105. }
  106. });
  107. test('POST /v3/admin/credit-adjustments(delta 为 0、缺原因)→ 422', function () {
  108. $body = new PostApiV3AdminCreditAdjustmentsRequest();
  109. $body->setUser('nobody');
  110. $body->setDelta(0);
  111. $body->setNote('');
  112. $res = request(fn () => api(AdminApi::class, admin_token_or_skip())->postApiV3AdminCreditAdjustmentsWithHttpInfo($body));
  113. assert_status(422, $res, 'credit-adjustments');
  114. assert_field_error('delta', $res, 'credit-adjustments');
  115. });