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

docs: move lazy analytics cache to redis

Browse Source
This commit is contained in:
Amirhossein Khalili
2026-08-20 16:28:29 +03:30
parent 680596fe73
commit be3cb9f36b
7 changed files with 72 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
CONTEXT.md
View File

@@ -42,11 +42,15 @@ A deterministic numerical measure with a definition, source fields, filters, per
## Analytics Projection
A rebuildable summary derived from normalized source-of-truth records to answer an approved metric efficiently. A projection is not independent business truth.
A rebuildable, versioned analytics result derived from normalized PostgreSQL facts and cached in Redis for one merchant/cohort revision. It is not independent business truth.
## Analytics Revision
A monotonically increasing merchant or cohort version changed when a related payment fact is inserted. Cached projections record the revision they represent; a revision mismatch makes them stale and triggers lazy recomputation on the next relevant dashboard request.
A monotonically increasing PostgreSQL merchant or cohort version changed when a related payment fact is inserted. Redis cache keys include the revisions they represent; a mismatch causes request-triggered section jobs to calculate new keys while older keys expire through TTL.
## Analytics Section
One independently calculable and deliverable part of the dashboard, such as overview, payment performance, fees, or peer comparison. All core sections start on first dashboard access and become visible independently through authenticated SSE events.
## Peer Cohort