Files
cameleer-server/.planning/phases/01-ingestion-pipeline-api-foundation/01-VALIDATION.md
hsiegeln da09e5fda7 fix(01): revise plans based on checker feedback
- Remove AbstractClickHouseIT and application-test.yml from Plan 01-01,
  move to Plan 01-03 Task 1 (reduces 01-01 from 15 to 13 files)
- Change Plan 01-02 Task 1 tdd="true" to tdd="false" (compile-only verify)
- Add DiagramRepository and MetricsRepository flush key_links to Plan 01-02
- Update VALIDATION.md: INGST-06 TTL maps to HealthControllerIT#ttlConfigured*
  instead of non-existent ClickHouseTtlIT

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 11:40:20 +01:00

3.8 KiB

phase, slug, status, nyquist_compliant, wave_0_complete, created
phase slug status nyquist_compliant wave_0_complete created
1 ingestion-pipeline-api-foundation draft false false 2026-03-11

Phase 1 — Validation Strategy

Per-phase validation contract for feedback sampling during execution.


Test Infrastructure

Property Value
Framework JUnit 5 (Spring Boot managed) + Testcontainers 2.0.2
Config file cameleer3-server-app/src/test/resources/application-test.yml (Wave 0)
Quick run command mvn test -pl cameleer3-server-core -Dtest=WriteBufferTest -q
Full suite command mvn verify
Estimated runtime ~30 seconds

Sampling Rate

  • After every task commit: Run mvn test -pl cameleer3-server-core -q
  • After every plan wave: Run mvn verify
  • Before /gsd:verify-work: Full suite must be green
  • Max feedback latency: 30 seconds

Per-Task Verification Map

Task ID Plan Wave Requirement Test Type Automated Command File Exists Status
1-01-01 01 1 INGST-04 unit mvn test -pl cameleer3-server-core -Dtest=WriteBufferTest -q no W0 pending
1-01-02 01 1 INGST-01 integration mvn test -pl cameleer3-server-app -Dtest=ExecutionControllerIT -q no W0 pending
1-01-03 01 1 INGST-05 integration mvn test -pl cameleer3-server-app -Dtest=BackpressureIT -q no W0 pending
1-01-04 01 1 INGST-06 integration mvn test -pl cameleer3-server-app -Dtest=HealthControllerIT#ttlConfigured* -q no W0 pending
1-02-01 02 1 INGST-01 integration mvn test -pl cameleer3-server-app -Dtest=ExecutionControllerIT -q no W0 pending
1-02-02 02 1 INGST-02 integration mvn test -pl cameleer3-server-app -Dtest=DiagramControllerIT -q no W0 pending
1-02-03 02 1 INGST-03 integration mvn test -pl cameleer3-server-app -Dtest=MetricsControllerIT -q no W0 pending
1-02-04 02 1 API-02 integration mvn test -pl cameleer3-server-app -Dtest=OpenApiIT -q no W0 pending
1-02-05 02 1 API-03 integration mvn test -pl cameleer3-server-app -Dtest=HealthControllerIT -q no W0 pending
1-02-06 02 1 API-04 integration mvn test -pl cameleer3-server-app -Dtest=ProtocolVersionIT -q no W0 pending
1-02-07 02 1 API-05 unit mvn test -pl cameleer3-server-app -Dtest=ForwardCompatIT -q no W0 pending

Status: pending / green / red / flaky


Wave 0 Requirements

  • cameleer3-server-app/src/test/resources/application-test.yml — test ClickHouse config
  • cameleer3-server-core/src/test/java/.../WriteBufferTest.java — buffer unit tests
  • cameleer3-server-app/src/test/java/.../AbstractClickHouseIT.java — shared Testcontainers base class
  • cameleer3-server-app/src/test/java/.../ExecutionControllerIT.java — ingestion integration test
  • Docker available on test machine for Testcontainers

If none: "Existing infrastructure covers all phase requirements."


Manual-Only Verifications

Behavior Requirement Why Manual Test Instructions
ClickHouse TTL removes data after 30 days INGST-06 Cannot fast-forward time in ClickHouse Verify TTL clause in CREATE TABLE DDL; automated test in HealthControllerIT asserts DDL contains TTL

Validation Sign-Off

  • All tasks have <automated> verify or Wave 0 dependencies
  • Sampling continuity: no 3 consecutive tasks without automated verify
  • Wave 0 covers all MISSING references
  • No watch-mode flags
  • Feedback latency < 30s
  • nyquist_compliant: true set in frontmatter

Approval: pending