Skip to main content

ADR 0003: MVP-grenzen — geen synchrone user → ingest

Status​

Accepted

Context​

Het platformplan vereist dat het user/webplatform nooit synchrone afhankelijkheid heeft van ingest-servers. In MVP draait alles nog op één organisatie, maar het gedrag moet het latere model niet blokkeren.

Beslissing​

  1. Browsers en publieke API’s spreken alleen met de HTTP API (server.ts / toekomstige gateway), niet met de TCP-poort van de telematics-gateway.
  2. Ingest (telematics-gateway) schrijft naar PostgreSQL en later naar Kafka/ClickHouse — geen “directe” UI-queries naar ruwe ingest-sockets.
  3. Live kaarten gebruiken Socket.io/API + DB-projecties — geen verplichte round-trip naar ingest voor reads.
  4. Coarse services / modulaire monolith zijn acceptabel in MVP/v1 zolang modulegrenzen in code helder zijn.

Gevolgen​

  • Eventuele “admin debug” naar raw TCP blijft intern tooling, geen standaard gebruikerspad.
  • Bij toevoegen van Kafka moeten producers/consumers de bestaande DB-schrijfpaden niet dupliceren zonder idempotentie.

Gerelateerd​

  • docs/telematics/adr/0001-gateway-separate-service.md
  • docs/platform/phase-1-mvp.md