Flow Docs

pr-draft-architecture-hardening

1 min read

PR Draft: Architecture Hardening & Scaling

Summary

Implementa i primi passi di hardening architetturale: event bus PoC, Redis adapter per realtime, allineamento porta notification-service, tracing base OTel.

Scope

  • PoC event bus con Redis Streams e due consumatori (social, notification) per EventCreated/EventCancelled.
  • Realtime-service: abilitazione redis-adapter Socket.IO e sticky sessions docs.
  • Allineamento porta notification-service a 3004 in env/compose/gateway.
  • Aggiunta trace-id OTel minimo (gateway + user-service) e /ready endpoint separato.

Out of Scope

  • Migrazione completa a Kafka.
  • Gateway replacement (Kong/Traefik).
  • CDC Mongo→Postgres (trattata in issue dedicata).
  • Feature store AI.

Testing

  • Unit/integration sui consumer Streams.
  • Smoke test websocket con due istanze e Redis adapter.
  • Curl health/ready e rotte notification via gateway.
  • Verifica trace-id propagato end-to-end su una request di esempio.

Rollback

  • Toggle env per disabilitare bus/adapter.
  • Ripristino porta notification a configurazione precedente (env).
  • Disabilitare OTel exporter mantenendo app funzionale.

Follow-ups

  • Estendere eventi coperti, introdurre DLQ e metriche lag.
  • Promuovere OTel su tutti i servizi e WS tracing.
  • Roadmap CDC e gateway managed.

Graph View