You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
STORY: Orchestrate transfer saga with ledger-driven completion #103
Sprint 3 transfer-saga implementation evidence: Transaction Service PRs #6, #7, #8, #9, #10, #11, and #12 are merged. They implement the transfer lifecycle, process manager, internal HTTP API, authorization, transactional outboxes, reservation transport, and ledger transport. Child task #182 is complete. SIT end-to-end rollout validation remains the next operational checkpoint.
Reopened for accurate delivery tracking. The transfer implementation PRs #6-#12 were merged into stacked feature branches, but the resulting code is not yet on transaction-service main. Integration PR: digital-bank-java/transaction-service#13. The story will return to Done after PR #13 is reviewed and merged, followed by SIT rollout verification.
Transaction Service mainline at commit c97b156 (after PR #13 and PR #14) passes ./mvnw verify:
80 unit-phase tests passed
15 PostgreSQL-backed integration tests passed
The transfer process manager, durable workflow state, inbox, and Kafka transport are present on main. SIT end-to-end verification remains pending because Transaction Service is not deployed in digital-bank-sit. Remaining rollout dependencies are transaction-service#15 and config-repo#38, followed by deployment and Kafka verification. The auth-service-secrets Secret is now present in SIT.
SIT verification update after merged transaction-service#15 and config-repo#38:
Transaction Service image digital-bank-java/transaction-service:0.0.3 deployed successfully from merged main.
Helm release transaction-service is deployed in digital-bank-sit.
Pod and deployment are 1/1; /actuator/health reports liveness and readiness groups UP.
PostgreSQL startup/migrations completed and Kafka consumers initialized for ledger and reservation event topics.
Full transfer saga verification remains pending because Account reservation integration and the remaining saga test prerequisites are separate Sprint 3 work.
This does not close the story yet; it records the Transaction Service runtime prerequisite as complete.
Current Sprint 3 checkpoint: transaction-service#22 is the reviewable consistency fix for exact ledger completion-line validation; all checks are green and it remains open. The manual SIT guide is refreshed in .github#241 for the deployed transfer-bound MFA flow. Keep this story open until controlled successful transfer, duplicate delivery, and malformed-event DLQ evidence is recorded.
The PR removes the duplicate ReleaseAccountReservation command after LedgerPostingFailed. Transaction Service now persists AWAITING_RESERVATION_RELEASE and waits for Account Service's AccountReservationReleased.v1 fact. All existing unit, integration, Helm, and container checks pass.
The story remains open for the controlled SIT transfer success, rejection, duplicate-delivery, and compensation evidence.
Terminal transfer outcome wave is merged and rolled out to local SIT. transaction-service#27 publishes durable TransferCompleted.v1 and TransferFailed.v1 facts; config-repo#49 enables the publisher in SIT; infra-sit#42 provisions the terminal topics and DLQs. Transaction Service 0.0.6 is healthy, Config Server serves terminal settings, and Kafka lists both terminal topics and DLQs. The Account Service timestamp compatibility fix is merged in account-service#42.
Tracking update: all six native child items are now closed, including #244. The implementation and SIT infrastructure are complete, but the story remains open intentionally for the final controlled acceptance: a positive-balance transfer, duplicate terminal-event delivery proof, and malformed-event DLQ proof.
2026-09-07 SIT update: the merged terminal-event rollout initially exposed a Transaction Service startup defect when multiple KafkaTemplate beans were enabled. Follow-up transaction-service PR #28 explicitly qualifies the transaction event publishers and is open for review. The rebuilt candidate is healthy in SIT and returned X-Correlation-ID logging-fix-20260907 with a matching structured HTTP request-completed record. The story remains open for positive-balance successful transfer, duplicate delivery, and malformed-event DLQ evidence.
Ledger posting-command recovery is implemented for review in ledger-service #23. The Ledger consumer now has bounded retries and publishes malformed/unprocessable records to ledger.posting.requested.v1.dlq while preserving valid business-failure handling through LedgerPostingFailed.v1. The handoff entry is tracked in .github #256. Post-merge SIT verification remains required for a malformed event, DLQ publication, and partition recovery.
Post-merge SIT acceptance completed for the Ledger posting-command DLQ slice.\n\n- Merged implementation: ledger-service #23\n- Merged handoff design: .github #256\n- Reviewable handoff evidence: .github #257\n- Image: \n- Helm revision: 10 in \n- Deployment: ready, zero restarts; profile ; Flyway current through version 9.\n- Kafka consumer group: is Stable with one member assigned to .\n- Controlled malformed record key reached after bounded retries.\n- Source offset committed: current 1, log end 1, lag 0.\n- Read-only PostgreSQL verification: , ; no business inbox or ledger posting was created.\n- No database mutation was used during verification.\n\nThis closes the malformed-event recovery acceptance for the Ledger portion of this story. The remaining story boundary is controlled positive-balance transfer success, duplicate delivery, and end-to-end consistency evidence.
Deployment: 1/1 ready, zero restarts; profile sit; Flyway current through version 9.
Kafka consumer group: ledger-service is Stable with one member assigned to ledger.posting.requested.v1-0.
Controlled malformed record key dlq-sit-1788788306489 reached ledger.posting.requested.v1.dlq after bounded retries.
Source offset committed: current 1, log end 1, lag 0.
Read-only PostgreSQL verification: ledger_posting_command_inbox_rows=0, dlq_test_ids=0; no business inbox or ledger posting was created.
No database mutation was used during verification.
This closes the malformed-event recovery acceptance for the Ledger portion of this story. The remaining story boundary is controlled positive-balance transfer success, duplicate delivery, and end-to-end consistency evidence.
Correction: the preceding comment was posted with shell-escaped Markdown rendered incorrectly. This file-backed comment is the authoritative evidence record.
The controlled SIT data exposed a stale deployment problem in the reservation event path:
Account Service consumed two synthetic reservation requests and published two AccountReservationRejected.v1 decisions.
Transaction Service rejected both records because the deployed payload did not contain the required occurredAt field; both records were routed to account.reservation.rejected.v1.dlq.
The timestamp serialization fix is already merged in account-service #42 and present on Account Service main through commit f787876.
Built digital-bank-java/account-service:sit-account-main-20260907 from merged main. The image build passed the existing verification with 65 unit-phase tests and no failures.
Rolled out with Helm revision 11 in digital-bank-sit; the Account Service deployment is healthy with one ready replica.
The two historical DLQ records were not replayed or modified. A fresh authorized synthetic transfer is still required to prove the complete saga path: success, reservation rejection to FAILED, duplicate terminal-event idempotency, and ledger-failure compensation. No credential or secret value was read or recorded.
Fresh read-only verification confirms the platform is healthy, but the protected transfer acceptance cannot be completed without an approved SIT Auth fixture:
Gateway health: HTTP 200.
Customer, Account, and Transaction Service health through the Gateway: HTTP 200.
Ledger health is intentionally not a public Gateway route.
Centralized Swagger and protected customer/account routes correctly require authentication.
Direct Transaction Service transfer access also returns HTTP 401 (authentication-required), so bypassing the Gateway does not remove the authorization requirement.
The documented alice@example.com fixture attempt returned HTTP 401; no token or business mutation was produced.
No Kubernetes Secret value was read, no existing Secret was changed, no temporary Secret was created, and no deployment override was applied.
No customer, account, reservation, ledger, outbox, inbox, or Kafka business record was created by this attempt.
The remaining acceptance boundary is unchanged: positive-balance completion, insufficient-balance rejection to FAILED, duplicate terminal-event idempotency, and account-owned compensation. A valid approved SIT fixture for the configured transfer-orchestrator subject is required to execute those scenarios end to end.
The acceptance blocker is broader than the missing Auth credential:
Aggregate-only Account Service verification found 6 SIT accounts and 0 accounts with a positive available balance.
The Account database contains 0 reservation rows and 0 ledger-outcome inbox rows, so there is no reusable synthetic reservation or posting history.
Account opening correctly initializes current and available balances to zero.
The architecture intentionally exposes no direct balance-update API.
Consequently, a successful positive-balance transfer cannot be created in the current SIT environment even after authentication; a governed SIT funding fixture or a later cash-in/deposit capability is required.
No database row was inserted, updated, deleted, or replayed during this investigation. This is now the authoritative acceptance blocker alongside the missing approved transfer-orchestrator credential.
The merged Transaction, Account, Ledger, Gateway, and SIT infrastructure work has been verified in the approved controlled local-SIT fixture. Evidence covers successful reservation and Ledger completion, insufficient-funds rejection, Ledger failure compensation with reservation release, and duplicate Ledger completion without duplicate terminal output.
MFA step-up assurance remains separately tracked under Sprint 4 #208 and is not part of this story closeout.
Closes the Sprint 3 ledger-driven transfer orchestration story.
Activity
ramioooz commentedon Sep 1, 2026
Sprint 3 transfer-saga implementation evidence: Transaction Service PRs #6, #7, #8, #9, #10, #11, and #12 are merged. They implement the transfer lifecycle, process manager, internal HTTP API, authorization, transactional outboxes, reservation transport, and ledger transport. Child task #182 is complete. SIT end-to-end rollout validation remains the next operational checkpoint.
ramioooz commentedon Sep 3, 2026
Reopened for accurate delivery tracking. The transfer implementation PRs #6-#12 were merged into stacked feature branches, but the resulting code is not yet on transaction-service main. Integration PR: digital-bank-java/transaction-service#13. The story will return to Done after PR #13 is reviewed and merged, followed by SIT rollout verification.
ramioooz commentedon Sep 3, 2026
2026-09-04 verification update
Transaction Service mainline at commit c97b156 (after PR #13 and PR #14) passes ./mvnw verify:
The transfer process manager, durable workflow state, inbox, and Kafka transport are present on main. SIT end-to-end verification remains pending because Transaction Service is not deployed in digital-bank-sit. Remaining rollout dependencies are transaction-service#15 and config-repo#38, followed by deployment and Kafka verification. The auth-service-secrets Secret is now present in SIT.
ramioooz commentedon Sep 3, 2026
SIT verification update after merged
transaction-service#15andconfig-repo#38:digital-bank-java/transaction-service:0.0.3deployed successfully from merged main.transaction-serviceis deployed indigital-bank-sit.1/1;/actuator/healthreportslivenessandreadinessgroupsUP.This does not close the story yet; it records the Transaction Service runtime prerequisite as complete.
ramioooz commentedon Sep 5, 2026
Current Sprint 3 checkpoint: transaction-service#22 is the reviewable consistency fix for exact ledger completion-line validation; all checks are green and it remains open. The manual SIT guide is refreshed in .github#241 for the deployed transfer-bound MFA flow. Keep this story open until controlled successful transfer, duplicate delivery, and malformed-event DLQ evidence is recorded.
5 remaining items
ramioooz commentedon Sep 6, 2026
Summary
AWAITING_RESERVATION_RELEASEafterLedgerPostingFailed.Verification
./mvnw --batch-mode --no-transfer-progress test: 96 tests passed../mvnw --batch-mode --no-transfer-progress verify -DskipUnitTests=true: 16 integration tests passed with Testcontainers.git diff --check: passed.Relates to #103.
ramioooz commentedon Sep 6, 2026
Account-owned release correction
Reviewable PR: transaction-service#26
The PR removes the duplicate
ReleaseAccountReservationcommand afterLedgerPostingFailed. Transaction Service now persistsAWAITING_RESERVATION_RELEASEand waits for Account Service'sAccountReservationReleased.v1fact. All existing unit, integration, Helm, and container checks pass.The story remains open for the controlled SIT transfer success, rejection, duplicate-delivery, and compensation evidence.
ramioooz commentedon Sep 6, 2026
Terminal transfer outcome wave is merged and rolled out to local SIT. transaction-service#27 publishes durable TransferCompleted.v1 and TransferFailed.v1 facts; config-repo#49 enables the publisher in SIT; infra-sit#42 provisions the terminal topics and DLQs. Transaction Service 0.0.6 is healthy, Config Server serves terminal settings, and Kafka lists both terminal topics and DLQs. The Account Service timestamp compatibility fix is merged in account-service#42.
ramioooz commentedon Sep 6, 2026
Tracking update: all six native child items are now closed, including #244. The implementation and SIT infrastructure are complete, but the story remains open intentionally for the final controlled acceptance: a positive-balance transfer, duplicate terminal-event delivery proof, and malformed-event DLQ proof.
ramioooz commentedon Sep 6, 2026
2026-09-07 SIT update: the merged terminal-event rollout initially exposed a Transaction Service startup defect when multiple KafkaTemplate beans were enabled. Follow-up transaction-service PR #28 explicitly qualifies the transaction event publishers and is open for review. The rebuilt candidate is healthy in SIT and returned X-Correlation-ID logging-fix-20260907 with a matching structured HTTP request-completed record. The story remains open for positive-balance successful transfer, duplicate delivery, and malformed-event DLQ evidence.
ramioooz commentedon Sep 7, 2026
Ledger posting-command recovery is implemented for review in ledger-service #23. The Ledger consumer now has bounded retries and publishes malformed/unprocessable records to
ledger.posting.requested.v1.dlqwhile preserving valid business-failure handling throughLedgerPostingFailed.v1. The handoff entry is tracked in.github #256. Post-merge SIT verification remains required for a malformed event, DLQ publication, and partition recovery.ramioooz commentedon Sep 7, 2026
Post-merge SIT acceptance completed for the Ledger posting-command DLQ slice.\n\n- Merged implementation: ledger-service #23\n- Merged handoff design: .github #256\n- Reviewable handoff evidence: .github #257\n- Image: \n- Helm revision: 10 in \n- Deployment: ready, zero restarts; profile ; Flyway current through version 9.\n- Kafka consumer group: is Stable with one member assigned to .\n- Controlled malformed record key reached after bounded retries.\n- Source offset committed: current 1, log end 1, lag 0.\n- Read-only PostgreSQL verification: , ; no business inbox or ledger posting was created.\n- No database mutation was used during verification.\n\nThis closes the malformed-event recovery acceptance for the Ledger portion of this story. The remaining story boundary is controlled positive-balance transfer success, duplicate delivery, and end-to-end consistency evidence.
ramioooz commentedon Sep 7, 2026
Post-merge SIT acceptance completed for the Ledger posting-command DLQ slice.
digital-bank-java/ledger-service:sit-dlq-20260907digital-bank-sit1/1ready, zero restarts; profilesit; Flyway current through version 9.ledger-serviceis Stable with one member assigned toledger.posting.requested.v1-0.dlq-sit-1788788306489reachedledger.posting.requested.v1.dlqafter bounded retries.ledger_posting_command_inbox_rows=0,dlq_test_ids=0; no business inbox or ledger posting was created.This closes the malformed-event recovery acceptance for the Ledger portion of this story. The remaining story boundary is controlled positive-balance transfer success, duplicate delivery, and end-to-end consistency evidence.
Correction: the preceding comment was posted with shell-escaped Markdown rendered incorrectly. This file-backed comment is the authoritative evidence record.
ramioooz commentedon Sep 7, 2026
Account reservation timestamp rollout
The controlled SIT data exposed a stale deployment problem in the reservation event path:
AccountReservationRejected.v1decisions.occurredAtfield; both records were routed toaccount.reservation.rejected.v1.dlq.f787876.digital-bank-java/account-service:sit-account-main-20260907from merged main. The image build passed the existing verification with 65 unit-phase tests and no failures.digital-bank-sit; the Account Service deployment is healthy with one ready replica.The two historical DLQ records were not replayed or modified. A fresh authorized synthetic transfer is still required to prove the complete saga path: success, reservation rejection to
FAILED, duplicate terminal-event idempotency, and ledger-failure compensation. No credential or secret value was read or recorded.ramioooz commentedon Sep 8, 2026
SIT acceptance attempt - 2026-09-08
401with the configured authentication-failure Problem Details response; no access token was issued.ramioooz commentedon Sep 8, 2026
SIT acceptance checkpoint - 2026-09-08
Fresh read-only verification confirms the platform is healthy, but the protected transfer acceptance cannot be completed without an approved SIT Auth fixture:
authentication-required), so bypassing the Gateway does not remove the authorization requirement.alice@example.comfixture attempt returned HTTP 401; no token or business mutation was produced.The remaining acceptance boundary is unchanged: positive-balance completion, insufficient-balance rejection to
FAILED, duplicate terminal-event idempotency, and account-owned compensation. A valid approved SIT fixture for the configuredtransfer-orchestratorsubject is required to execute those scenarios end to end.ramioooz commentedon Sep 8, 2026
Root-cause update - 2026-09-08
The acceptance blocker is broader than the missing Auth credential:
No database row was inserted, updated, deleted, or replayed during this investigation. This is now the authoritative acceptance blocker alongside the missing approved
transfer-orchestratorcredential.ramioooz commentedon Sep 10, 2026
Transfer saga acceptance completed
The merged Transaction, Account, Ledger, Gateway, and SIT infrastructure work has been verified in the approved controlled local-SIT fixture. Evidence covers successful reservation and Ledger completion, insufficient-funds rejection, Ledger failure compensation with reservation release, and duplicate Ledger completion without duplicate terminal output.
MFA step-up assurance remains separately tracked under Sprint 4 #208 and is not part of this story closeout.
Closes the Sprint 3 ledger-driven transfer orchestration story.