[dfcoffin]

Closes #253.

What

On the local profile the Data Custodian now starts with a small, deterministic ESPI dataset, so the consent flow and every ESPI feed can be tested by hand right after scripts/local/start-all.sh.

LocalSampleDataSeedRunner:

• Runs on @Profile("local") only.
• Is idempotent.
• Builds its ids as UUID v5 of fixed sample hrefs, so the ids, and the URLs built from them, stay the same across restarts.

It seeds:

• RetailCustomer: customer / customer (ROLE_USER), owning one electricity UsagePoint. The UsagePoint has:
  • LocalTimeParameters for US Eastern;
  • an hourly kWh ReadingType;
  • a MeterReading with 2 daily IntervalBlocks of 24 hourly readings, with cost;
  • a UsageSummary and an ElectricPowerQualitySummary.
• Customer, CustomerAccount, CustomerAgreement, ServiceLocation, Meter for one residential customer.
• ApplicationInformation for the AS-seeded third_party client, with the TP's local redirect and notification URIs.

Where the values come from

The ESPI schema values are the most common shapes across the Green Button CMD certification test feeds:

• ReadingType accumulationBehaviour 4, commodity 1, kind 12, uom 72, powerOfTenMultiplier -3, currency 840;
• daily blocks of 24 hourly readings;
• DST rules 360E2000 / B40E2000;
• mains voltage 240000.

Every identifying value is synthetic (example.com, 555-01xx, SAMPLE-… numbers). Nothing is copied from a certification record.

The issue suggested a Flyway seed instead. This PR uses a runner, which does not depend on the local profile adopting Flyway (#241), and keeps the customer password bcrypt-encoded at runtime like DevSandboxAdminSeedRunner.

Defect found by the data

open-in-view is off. The IntervalBlock, UsageSummary and CustomerAccount controllers mapped entities to DTOs outside any session, so any non-empty feed returned 500 with a LazyInitializationException on intervalReadings, costAdditionalDetailLastPeriod or notifications. These three controllers are now @Transactional(readOnly = true). The other seeded feeds were not affected.

Tests

• LocalSampleDataSeedRunnerTest (local + test profiles) runs on the Flyway-migrated, Hibernate-validated H2 schema, not a generated one. It checks:

  • each seeded feed returns its sample entries to a DataCustodian admin;
  • the customer login and its UsagePoint;
  • 2 × 24 readings;
  • idempotency.

  This is the real-data guard that DC feed (collection) endpoints return 500: a bare List is passed to JAXB instead of an Atom feed #247 asked for.

• The full DC suite passes locally: 184 tests.

• On the running stack, all nine seeded feeds return 200 with entries. smoke.sh and smoke.ps1 pass 26/26, including a new check that the IntervalBlock feed carries the sample data. Once fix(authserver,datacustodian): FB=34_35 client access token, CMD v2.14 customer scopes, FB_51 requires customerResourceURI #260 merges, the count becomes 28.

docs/LOCAL_TESTING.md gains a "Sample data" section and the customer login. The #253 blocker is removed.

🤖 Generated with Claude Code