veza/docs/adr/ADR-005-rest.md

ADR-005: REST pour Communication Inter-Services

Date: 2025-01-01 (révisé 2026-03-04)
Status: Accepted (révisé)
Source: ORIGIN_MASTER_ARCHITECTURE.md

Contexte

Avec 3 services (API, Chat, Stream), la complexité de gRPC n'est pas justifiée. REST est suffisant et simplifie le développement.

Décision

REST (JSON over HTTP/2) pour toutes les communications : inter-services et clients externes.

Conséquences

Positives:

• Simplicité de développement et debugging
• Outillage universel (curl, Postman, navigateur)
• OpenAPI pour documentation et génération de clients
• Un seul protocole à maîtriser

Négatives:

• Overhead JSON vs protobuf (acceptable pour 3 services)

Alternatives rejetées

• gRPC: surengineering pour 3 services, debugging difficile
• GraphQL: trop complexe pour inter-service
• Message Queue pure: latence, complexité