starcoach-hackathon/zarinpal-analytics-backend
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: aggregate daily payment history by hour

Browse Source
This commit is contained in:
Amirhossein Khalili
2026-08-21 16:28:13 +08:00
parent 927319807b
commit 7140213857
4 changed files with 64 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/ANALYTICS-SPEC.md
View File

@@ -81,8 +81,8 @@ Every section uses a versioned typed contract and has independent `queued`, `cal
## Terminal scope and payment history
- `terminalId` is optional and is resolved only under the merchant from the authenticated server-side session. Omission means all merchant terminals; unknown and other-merchant identifiers fail identically.
- Overview, payment-performance, fees, and daily payment-history calculations use the selected terminal predicate when present.
- Daily payment-history points use Tehran-local dates and return total sessions, bank-paid sessions, and bank-paid amount in Rial for each date with source sessions in the selected period/scope.
- Overview, payment-performance, fees, and payment-history calculations use the selected terminal predicate when present.
- Payment-history points use Tehran-local buckets and return total sessions, bank-paid sessions, and bank-paid amount in Rial. `DAY` periods are grouped by hour and include `localHour` from 0 through 23; longer periods remain grouped by date.
- The payment-history array is bounded by the maximum approved period length and never contains payer tokens, peer rows, or attempt-grain money.
## Transaction evidence