CBSA Migration Ledger

[a2chang]

CBSA Migration Ledger

This issue tracks the COBOL→Java migration of the CICS Banking Sample
Application. Source repo (read-only):
augment-solutions/cics-banking-sample-application-cbsa.
Target stack: Java 25, Spring Boot 3.5, jOOQ 3.20, CockroachDB v24.3.

The translation rulebook is at
docs/translation-rules.md.

Bootstrap

• Phase 1 — Project bootstrap (PR Bootstrap: Spring Boot 3.5 / Java 25 / CockroachDB skeleton #1)

Programs (POC first, then dependencies-up)

• INQCUST — POC, simplest read path (PR feat(inqcust): translate INQCUST to Java #4)
• INQACC (PR feat(inqacc): translate INQACC to Java #7)
• INQACCCU (PR feat(inqaccu): translate INQACCCU to Java #8)
• CRECUST (PR feat(crecust): translate CRECUST to Java #9)
• CREACC (PR feat(creacc): translate CREACC to Java #13)
• UPDCUST (PR migrate(UPDCUST): translate customer update flow to Spring Boot #18)
• UPDACC (PR migrate(UPDACC): translate UPDACC to Java #20)
• DELCUS (PR migrate(DELCUS): translate DELCUS to Java #21)
• DELACC (PR migrate(DELACC): translate DELACC to Java #25)
• DBCRFUN (PR migrate(DBCRFUN): translate payment debit/credit flow #24)
• XFRFUN (PR migrate(XFRFUN): translate transfer flow #27)
• CRDTAGY1..5 (PR migrate(CRDTAGY): translate credit agency batch (1..5) #30, async credit agency batch)

Out of scope (not migrated)

• BNK1*, BNKMENU — BMS terminal handlers, replaced by REST + the existing React UI
• BANKDATA — replaced by Flyway seed migrations
• ABNDPROC — replaced by @ControllerAdvice

Cleanup pass (post-migration)

Final polish pass after every program PR was merged. Each PR closes one
or more cleanup-tracking issues opened from the auto-review feedback.

• PR fix(delcus): cross-validate body CommCustno vs path, single-space CommDelFailCd #38 — control baseline preservation in tests
• PR fix(delacc): cross-validate body DelAccAccno and DelAccScode on DELETE #39 — PROCTRAN audit-trail abend-code consistency
• PR fix(xfrfun): require XfrfunResult success to carry a null message #40 — sortcode end-to-end as String
• PR fix(crdtagy): emit CommSuccess=Y / CommFailCode=0 on the success path #41 — deterministic Random / Clock injection across services
• PR fix(formatters): pin Locale.ROOT on every COBOL date formatter #42 — retry-exhaustion fail code "R" → 503 unification
• PR test: cover inner PROCTRAN HWPT/XRTY catch in CRECUST and UPDCUST #43 — empty-table → 404 normalization
• PR polish(validation): replace requireNonNull with bean validation (#10, #15) #44 — Bean Validation on request DTOs (closes CRECUST: tighten CommName validation (no blank/whitespace via empty title) #10, CREACC DTOs: replace Objects.requireNonNull in record constructors with bean-validation so missing fields return 400, not 500 #15)
• PR polish(creacc): drop dead transient-failure path (#14) #45 — drop dead transient-failure path in CreaccResult (closes CREACC: review whether transient counter-lock failures should map to a CreaccResult fail code instead of 500 #14)
• PR polish: ProblemDetail in inqcust + codify rulebook (#5, #6) #46 — ProblemDetail in InqcustController + rulebook §13/§14
  codifying seven recurring patterns + translator checklist
  (closes translator: tighten error-shape consistency and overflow guards #5, translator-rules: codify recurring auto-review patterns #6)

Final state

• All 13 programs migrated and merged on main.
• All cleanup-pass tracking issues (translator: tighten error-shape consistency and overflow guards #5, translator-rules: codify recurring auto-review patterns #6, CRECUST: tighten CommName validation (no blank/whitespace via empty title) #10, CREACC: review whether transient counter-lock failures should map to a CreaccResult fail code instead of 500 #14, CREACC DTOs: replace Objects.requireNonNull in record constructors with bean-validation so missing fields return 400, not 500 #15) closed.
• ./mvnw -B verify on main — 205 tests, 0 failures, BUILD SUCCESS
  (Testcontainers CockroachDB 24.3, full integration suite + WebMvc
  slices).
• docs/translation-rules.md is the authoritative rulebook with §1–§15
  covering project layout, PIC mappings, REDEFINES, CICS idioms,
  CockroachDB/jOOQ conventions, REST contract, concurrency, error
  model, testing, sortcode/typed-properties, PR conventions, PROCTRAN
  abends, the seven recurring patterns from the PR feat(inqcust): translate INQCUST to Java #4 review, a
  translator checklist appendix, and out-of-scope.

Migration complete.

[a2chang]

All programs migrated. All cleanup-pass tracking issues closed. ./mvnw -B verify on main: 205 tests pass. Closing the ledger.