Skip to content

Financial automation rules engine

ID MOD-051
System SD08
Repo bank-app
Build status Not started
Deployed No

Customer-configurable rules (sweep, round-up, rate alert) executed automatically. Rules stored as structured JSON in Postgres. Kafka consumer evaluates rules on transaction events. See ADR-018.


Module dependencies

Depends on

Module Title Required? Contract Reason
MOD-020 Pre-payment validation suite Required Automated payments triggered by rules pass through the same pre-payment validation as manual payments.
MOD-001 Double-entry posting engine Required Rule-triggered fund sweeps and round-ups generate ledger postings via the posting engine.
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-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

(No modules in this wiki currently declare a dependency on this module.)


Policies satisfied

Policy Title Mode How
CON-001 Customer Fairness & Conduct Policy AUTO Automated actions executed exactly as customer configured — no discretionary deviation
PAY-001 Payment Operations Policy GATE Automated payments subject to same pre-payment validation as manual payments
CON-005 Fee & Pricing Transparency Policy LOG Rule execution logged and visible to customer — full transparency of automated actions

Capabilities satisfied

Capability Title Mode How
CAP-026 Exception-only case routing AUTO Routes only cases that fail automated rules to a human queue, so compliant transactions require no manual review.
CAP-064 Customer automation rules AUTO Evaluates and executes customer-defined automation rules (sweep, round-up, safety net) in real time as transactions arrive.
CAP-044 Cashback & rewards programme AUTO Evaluates cashback rules against each posted transaction and credits the qualifying cashback amount to the customer's account automatically.
CAP-053 Round-up savings (spare change) AUTO Rounds up each debit transaction to the nearest configured denomination and sweeps the difference to the customer's designated savings pot.
CAP-054 Goal-based savings with target date AUTO Monitors progress toward a customer-defined savings target and executes configured top-up rules — automated sweeps or one-tap contributions — to keep the goal on track.

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