feat: aggregate daily payment history by hour

docs/ANALYTICS-SPEC.md

@@ -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

docs/openapi.yaml

@@ -1639,6 +1639,11 @@ components:
         localDate:
           type: string
           format: date
+        localHour:
+          type: integer
+          minimum: 0
+          maximum: 23
+          description: Tehran-local hour bucket, present only for DAY periods.
         totalSessions:
           type: integer
           format: int64