feat: ESPI 4.0 Schema Compliance - Phase 26: Meter Complete Implementation

[dfcoffin]

Summary

Implements full ESPI 4.0 compliance for the Meter resource per customer.xsd specification.

Key Changes

New Shared Embeddables (domain/customer/common/):

• ElectronicAddress (customer.xsd lines 886-936)
• StreetAddress (customer.xsd lines 1285-1320)
• TelephoneNumber (customer.xsd lines 1428-1478)
• MeterMultiplier (customer.xsd MeterMultiplier type)

Meter Implementation:

• MeterEntity: Added meterMultipliers @ElementCollection
• MeterDto: Added 19 XSD-compliant fields including meterMultipliers collection
• MeterMultiplierDto: New DTO for meter multiplier embeddable
• MeterMapper: MapStruct mapper with UUID v5 generation pattern
• MeterService: Simplified to 6 CRUD methods (ESPI 4.0 pattern)
• MeterRepository: Removed 11 non-ID query methods
• Flyway V3: Added meter_multipliers collection table
• TestDataBuilders: Added createValidMeter() helper method

Refactoring:

• Extracted Organisation nested classes to standalone embeddables
• Updated all affected entities to use extracted embeddables
• Updated all affected mappers to import new embeddables
• Applied JDK 25 pattern: individual @AttributeOverride annotations

Testing:

• MeterDtoTest: 6+ XML marshalling tests
• MeterRepositoryTest: 16 comprehensive unit tests
• MeterMySQLIntegrationTest: 9 integration tests
• MeterPostgreSQLIntegrationTest: 9 integration tests
• BigDecimal assertions: Use isEqualByComparingTo() for cross-platform precision tolerance
• All 736 tests passing

Documentation:

• CLAUDE.md: Added file modification best practices (NEVER use sed/awk, ALWAYS use Edit tool with diffs)

Test Plan

• All 736 unit tests passing
• MeterRepositoryTest: 16 tests covering CRUD operations, Meter-specific fields, EndDevice inherited fields
• Integration tests: 18 tests across MySQL and PostgreSQL (9 each)
• MeterDtoTest: 6+ XML marshalling tests
• Cross-platform BigDecimal precision tolerance verified
• Flyway migration applied successfully (meter_multipliers table created)
• TestDataBuilders.createValidMeter() working in all tests

Files Changed

• 49 files changed, 3708 insertions(+), 1534 deletions(-)
• 4 new embeddable classes (domain/customer/common/)
• 1 new enum (MeterMultiplierKind)
• 3 new test files (MeterDtoTest, MeterMySQLIntegrationTest, MeterPostgreSQLIntegrationTest)
• Updated 39 existing files (entities, DTOs, mappers, services, repositories, tests)

🤖 Generated with Claude Code