perf(billing,settlement): paginate claims and wallet transactions (H9, H10)
GET /billing/claims loaded every tenant claim with no limit. Add
findByTenant(page, limit) + countByTenant (shared query builder), default
limit 50 / max 100, and expose totals as data.meta — kept inside the existing
{ data: { data: [...] } } envelope so current clients are unaffected.
GET /wallet/transactions was already bounded (findByUser defaulted to limit 50)
but page-less; add page/offset + countByUser + the same additive meta.
Regression: tests/Billing/ClaimsListPaginationTest,
tests/Settlement/WalletTransactionsPaginationTest.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -120,6 +120,10 @@
|
||||
| `from` | int (Unix) | مطالبات با `created_at >= from` (شروع بازه) |
|
||||
| `to` | int (Unix) | مطالبات با `created_at <= to` (پایان بازه) |
|
||||
| `q` | string | جستجوی بیمار: موبایل، کدملی یا نام (LIKE) |
|
||||
| `page` | int | شماره صفحه (پیشفرض ۱) |
|
||||
| `limit` | int | تعداد در هر صفحه (پیشفرض ۵۰، حداکثر ۱۰۰) |
|
||||
|
||||
> **صفحهبندی:** پاسخ علاوه بر `data.data` (آرایهی مطالبات) یک `data.meta` با `totalRecords`/`totalPages`/`currentPage` دارد. پاکت قبلی (`data.data`) دستنخورده است؛ کلاینتهای موجود بدون تغییر کار میکنند.
|
||||
|
||||
> بازهی تاریخ شمسی (سال/ماه/روز خاص) در سمت کلاینت به `from`/`to` یونیکس تبدیل میشود؛ backend فقط بازهی یونیکس میگیرد. فیلتر `q` از طریق زنجیره `claim → claim_item → invoice_item → invoice → patient_record → user` با `EXISTS` اعمال میشود.
|
||||
|
||||
|
||||
+28
-19
@@ -39,32 +39,41 @@ Get authenticated user's wallet balance.
|
||||
|
||||
## GET `/api/v1/wallet/transactions`
|
||||
|
||||
Get wallet transaction history for the authenticated user.
|
||||
Get wallet transaction history for the authenticated user (paginated, newest first).
|
||||
|
||||
**Permission:** `AUTH`
|
||||
|
||||
### Query Parameters
|
||||
| پارامتر | نوع | توضیح |
|
||||
|---------|-----|-------|
|
||||
| `page` | int | شماره صفحه (پیشفرض ۱) |
|
||||
| `limit` | int | تعداد در هر صفحه (پیشفرض ۵۰، حداکثر ۱۰۰) |
|
||||
|
||||
### Response `200`
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{
|
||||
"uuid": "...",
|
||||
"type": "credit",
|
||||
"amount_rials": 500000,
|
||||
"balance_after": 2500000,
|
||||
"description": "دریافت از نوبت",
|
||||
"created_at": 1717000000
|
||||
},
|
||||
{
|
||||
"uuid": "...",
|
||||
"type": "debit",
|
||||
"amount_rials": 200000,
|
||||
"balance_after": 2300000,
|
||||
"description": "تسویهحساب",
|
||||
"created_at": 1716900000
|
||||
}
|
||||
]
|
||||
"data": {
|
||||
"data": [
|
||||
{
|
||||
"uuid": "...",
|
||||
"type": "credit",
|
||||
"amount_rials": 500000,
|
||||
"balance_after": 2500000,
|
||||
"description": "دریافت از نوبت",
|
||||
"created_at": 1717000000
|
||||
},
|
||||
{
|
||||
"uuid": "...",
|
||||
"type": "debit",
|
||||
"amount_rials": 200000,
|
||||
"balance_after": 2300000,
|
||||
"description": "تسویهحساب",
|
||||
"created_at": 1716900000
|
||||
}
|
||||
],
|
||||
"meta": { "totalRecords": 124, "totalPages": 3, "currentPage": 1 }
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user