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

30 lines
907 B
Markdown

# 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é