Skip to content

Transaction history & search

ID MOD-070
System SD08
Repo bank-app
Build status Deployed
Deployed Yes
Last commit c98d4214fd3e613d6a3c873f68551d129ff1a485

Transaction history and search provides the customer's view of their financial activity across all accounts and currencies. It reads from the immutable transaction log and real-time balance engine, enriches each entry with merchant name, logo, and category data from the enrichment model, and presents the result in a paginated, searchable list.

The module provides full-text search across merchant names and transaction descriptions, with filters for date range, amount, category, and account. Results load progressively so the customer sees the most recent activity immediately while older data pages in. Tapping an entry shows the full detail: merchant, original currency amount, exchange rate applied, fee if any, and the running balance at that point.

Export produces a formatted PDF (bank statement style) or CSV of any filtered view, suitable for tax records, expense claims, or visa applications. All export requests are logged against the customer's session for audit purposes.


Module dependencies

Depends on

Module Title Required? Contract Reason
MOD-002 Immutable transaction log Required Transaction history is read from the immutable transaction log maintained by this module.
MOD-041 Categorisation & merchant enrichment model Optional Merchant enrichment and categorisation from the categorisation model enhances the transaction display.
MOD-104 AWS shared infrastructure bootstrap Required AWS shared infrastructure provisioned by MOD-104 (EventBridge buses, S3, KMS, Kinesis, Cognito) is required before this module can be deployed.
MOD-068 Authentication & session management Required All MOD-070 routes are authenticated via Cognito JWT; MOD-068 provisions the user pool ARN and resolves the JWT to party_id + jurisdiction for the session.
MOD-103 Neon database platform bootstrap Required Neon database and schema provisioned by MOD-103 must exist before this module can read or write Postgres.

Required by

Module Title As Contract
MOD-077 Account dashboard & insight feed Hard dependency

Policies satisfied

Policy Title Mode How
CON-005 Fee & Pricing Transparency Policy AUTO Customers can view a complete, accurate transaction history with fee and FX detail for every entry — no charges are hidden or obscured.
GOV-006 Internal Audit Policy LOG Customer-facing transaction history is derived from the immutable ledger — any access or export request is logged.

Capabilities satisfied

Capability Title Mode How
CAP-011 Real-time balance & transaction feed AUTO Reads the real-time transaction feed and renders each entry with enriched merchant name, logo, category, and amount in base and foreign currency.
CAP-112 Transaction search & filter AUTO Provides full-text search across transaction descriptions and merchant names, with filters for date range, category, amount, and account.
CAP-113 Statement & transaction export AUTO Generates a formatted PDF or CSV export of the filtered transaction set, usable as a bank statement or evidence for tax or expense purposes.

Part of SD08 — Customer App & Back Office Platform Compiled 2026-05-22 from source/entities/modules/MOD-070.yaml