SMS Orchestrator — Testing Strategy

Status: populated Owner: Platform Engineering + QA Last updated: 2026-04-18

1. Coverage targets

Layer	Target	Tool
Domain aggregates	95%	Vitest
Value objects	100%	Vitest
Domain services	90%	Vitest
Application use cases	90% (branch)	Vitest
Integration (HTTP + NATS + PG + Redis)	All critical paths	Testcontainers
Mutation on aggregates	≥ 75%	Stryker
Mutation on VOs	≥ 85%	Stryker

SmsMessage state machine: every transition path + illegal transitions rejected.
PhoneNumber: accepts valid E.164, rejects malformed, normalizes.
SegmentCalculator: GSM-7 vs UCS-2 boundary cases (160/153; 70/67).
RetryPolicy: backoff sequence, DLQ threshold.
IdempotencyResolver: hit, miss, conflict (different body).

test/integration/tenant-isolation.spec.ts — RLS rejects cross-tenant reads.
test/integration/outbox.spec.ts — not currently used; replaced by direct publish. (Placeholder per template; mark N/A with note.)
test/integration/inbox.spec.ts — sms.outbound.request consumer dedupes redelivery via Redis SET NX.
test/integration/submit-happy-path.spec.ts — POST returns 202; row persisted; NATS message published; idempotency key stored.
test/integration/submit-idempotency.spec.ts — repeat with same Idempotency-Key → same response, no new row.
test/integration/pipeline-retry.spec.ts — routing-engine errors → retry chain → DLQ after 3 attempts.
test/integration/validation-failure.spec.ts — invalid phone → FAILED + DLQ, no retry.
test/integration/redis-outage.spec.ts — Redis down → SET NX fails; service should fail closed on submit path and fail open only on pipeline idempotency (documented behavior).

Pact consumer of routing-engine gRPC — SelectRoute request/response schemas.
Schema conformance for produced events against registry (sms.outbound.request.v1, smpp.operator.*.v1, sms.events.status.v1).
OpenAPI diff gate in CI (no breaking changes without major version bump).

test/e2e/send-sms.e2e.spec.ts — Kong → orchestrator → NATS → stubbed downstream → status transitions observed.