CN-195 Emit single-character region in CASE_UPDATE events

[sumeetons]

Motivation and Context

Integrated Census services expect CASE_UPDATE region values to be a single
country character such as E, W, N, or S. Current sample data contains
more specific region codes such as E12000009, which the case processor was
publishing unchanged.

What has changed

Outbound CASE_UPDATE mapping

• Map the stored region to its leading character when building outbound
  CASE_UPDATE payloads.
• Preserve the complete region code on the case record.
• Preserve existing null and empty-region handling.

Automated tests

• Updated service coverage to verify the emitted and stored region values.
• Updated new-case integration coverage to use a full region code.
• Updated invalid-address integration coverage because it uses the same shared
  outbound mapper.

How to test?

cd census31-rm-case-processor
mvn -q test
mvn -o -q spotless:check

Results: 159 tests passed with 0 failures and 1 skipped. Spotless passed.

Links

• CN-195
• Related acceptance-test PR: CN-195 Verify CASE_UPDATE region after sample loading census31-rm-acceptance-tests#31

Screenshots (if appropriate):

N/A

[github-actions]

🦙 MegaLinter status: ✅ SUCCESS

Descriptor	Linter	Files	Fixed	Errors	Warnings	Elapsed time
✅ MARKDOWN	markdownlint	2		0	0	0.27s

See detailed report in MegaLinter reports

[AdamHawtin]

LGTM 👍

[Copilot]

Copilot review overview

🟢 Approval recommended

The mapping preserves null and empty values while correctly separating stored and emitted region representations.

Review effort: Lite
Findings: None

What changed in this PR

Updates outbound CASE_UPDATE events to emit only the leading region character while retaining the full region code on stored cases.

Changes:

• Added leading-character mapping for outbound regions.
• Updated unit and integration tests for full stored region codes and single-character emitted values.

File	Description
CaseFieldMapper.java	Maps outbound region values to their leading character.
CaseServiceTest.java	Verifies emitted and stored region values.
NewCaseReceiverIT.java	Tests full inbound region preservation and outbound mapping.
InvalidAddressReceiverIT.java	Updates shared mapper expectations.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[ravindra-tummuru]

LGTM