Infra It Cache Generator

Naming & Packaging

• *IT suffix mandatory.
• Keep under infra/cache/**.

Implementation Rules

• Use shared Testcontainers base (BaseIntegrationTest) with @ServiceConnection redis.
• Use unique key prefix per test (it:{class}:{uuid}:...).
• Cleanup by prefix or test-owned keys.
• Validate TTL/expiry with Awaitility; avoid fixed long sleeps.
• Verify error mapping behavior for connection interruption where relevant.

Template Blueprint

1. Integration Surface

• Redis via Testcontainers, wired through shared test base.
• Cache client under test + optional key factory/helper.

2. Required Annotations

• Use the project's infra integration-test base annotation/style.
• Ensure test context exposes Redis connection from container (for example via @ServiceConnection).

3. Code Flow

• Arrange: start from clean key namespace, prepare test inputs with unique key prefix.
• Act: execute cache operation sequence (set/get/delete or target API).
• Assert: validate value semantics, TTL window behavior, and failure mapping if applicable.
• Cleanup: remove test-owned keys by prefix.

Tests

• IT-only gate:
  • mvn -pl persimmon-scaffold/persimmon-scaffold-infra -Pit clean verify
  • -Pit means Maven -P it (profile id is it).

Common Mistakes

Integration

• Called by: scaffold-router, infra-integration-test-generator
• Pairs with: infra cache implementations

Phase Commit Gate

• mvn -pl persimmon-scaffold/persimmon-scaffold-infra clean test
• mvn -pl persimmon-scaffold/persimmon-scaffold-infra -Pit clean verify