Files
cameleer-server/.planning/phases/01-ingestion-pipeline-api-foundation/01-VALIDATION.md
hsiegeln cb3ebfea7c
Some checks failed
CI / cleanup-branch (push) Has been skipped
CI / build (push) Failing after 18s
CI / docker (push) Has been skipped
CI / deploy (push) Has been skipped
CI / deploy-feature (push) Has been skipped
chore: rename cameleer3 to cameleer
Rename Java packages from com.cameleer3 to com.cameleer, module
directories from cameleer3-* to cameleer-*, and all references
throughout workflows, Dockerfiles, docs, migrations, and pom.xml.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 15:28:42 +02:00

3.7 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 cameleer-server-app/src/test/resources/application-test.yml (Wave 0)
Quick run command mvn test -pl cameleer-server-core -Dtest=WriteBufferTest -q
Full suite command mvn verify
Estimated runtime ~30 seconds

Sampling Rate

  • After every task commit: Run mvn test -pl cameleer-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 cameleer-server-core -Dtest=WriteBufferTest -q no W0 pending
1-01-02 01 1 INGST-01 integration mvn test -pl cameleer-server-app -Dtest=ExecutionControllerIT -q no W0 pending
1-01-03 01 1 INGST-05 integration mvn test -pl cameleer-server-app -Dtest=BackpressureIT -q no W0 pending
1-01-04 01 1 INGST-06 integration mvn test -pl cameleer-server-app -Dtest=HealthControllerIT#ttlConfigured* -q no W0 pending
1-02-01 02 1 INGST-01 integration mvn test -pl cameleer-server-app -Dtest=ExecutionControllerIT -q no W0 pending
1-02-02 02 1 INGST-02 integration mvn test -pl cameleer-server-app -Dtest=DiagramControllerIT -q no W0 pending
1-02-03 02 1 INGST-03 integration mvn test -pl cameleer-server-app -Dtest=MetricsControllerIT -q no W0 pending
1-02-04 02 1 API-02 integration mvn test -pl cameleer-server-app -Dtest=OpenApiIT -q no W0 pending
1-02-05 02 1 API-03 integration mvn test -pl cameleer-server-app -Dtest=HealthControllerIT -q no W0 pending
1-02-06 02 1 API-04 integration mvn test -pl cameleer-server-app -Dtest=ProtocolVersionIT -q no W0 pending
1-02-07 02 1 API-05 unit mvn test -pl cameleer-server-app -Dtest=ForwardCompatIT -q no W0 pending

Status: pending / green / red / flaky


Wave 0 Requirements

  • cameleer-server-app/src/test/resources/application-test.yml — test ClickHouse config
  • cameleer-server-core/src/test/java/.../WriteBufferTest.java — buffer unit tests
  • cameleer-server-app/src/test/java/.../AbstractClickHouseIT.java — shared Testcontainers base class
  • cameleer-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