0.2.0-0-pre.6

docs/studies/021-UROBURAS_SERVER_REFERENCE_STACK.md

@@ -0,0 +1,169 @@
+<!-- file: docs/studies/021-UROBURAS_SERVER_REFERENCE_STACK.md -->
+<!-- version: 1 -->
+
+# Uroburas — stack serveur de référence
+
+## Statut
+
+Étude de référence pour `0.2.0-0-pre.6`.
+
+## Runtime async
+
+Référence :
+
+```text
+Tokio
+```
+
+## HTTP / Web
+
+Référence :
+
+```text
+Actix Web
+```
+
+Responsabilités initiales :
+
+- auth ;
+- compte ;
+- maps/assets metadata ;
+- Hall of Fame ;
+- rewarded grants ;
+- admin initiale ;
+- pages Web.
+
+## HTML server-side
+
+Référence :
+
+```text
+Maud
+```
+
+Objectif :
+
+- rendu HTML côté Rust ;
+- pages compte ;
+- Hall of Fame ;
+- administration ;
+- pages jeu/portail.
+
+Le JavaScript reste réservé aux interactions qui le nécessitent.
+
+## Realtime public
+
+Référence :
+
+```text
+Tokio + tokio-tungstenite
+```
+
+Utilisé pour les futurs Modes 3 puis 2.
+
+La logique de gameplay ne dépend pas directement des types Tungstenite.
+
+Le transport doit rester encapsulé derrière le protocole Uroburas afin qu'un benchmark futur puisse justifier un changement d'implémentation sans réécrire la simulation.
+
+## gRPC
+
+Référence conditionnelle :
+
+```text
+tonic
+```
+
+Utilisation envisagée :
+
+- server-to-server ;
+- worker média/replay ;
+- orchestration interne ;
+- appels typés entre services lorsque la séparation physique le justifie.
+
+gRPC n'est pas obligatoire pour le transport public client/gameplay.
+
+Le client public utilise en priorité :
+
+```text
+HTTPS + WebSocket
+```
+
+## Localization
+
+Référence :
+
+```text
+Fluent / fluent-bundle
+```
+
+Côté client :
+
+- menus ;
+- HUD ;
+- erreurs ;
+- contenu localisé ;
+- maps/assets téléchargeables.
+
+Côté serveur :
+
+- HTML ;
+- emails ;
+- messages utilisateur ;
+- administration.
+
+Les protocoles transportent des codes/identifiants métier, pas des chaînes déjà traduites.
+
+## Email
+
+Référence :
+
+```text
+Lettre
+```
+
+Cas initiaux possibles :
+
+- vérification de compte ;
+- reset password ;
+- notifications sécurité ;
+- magic link si retenu.
+
+Les contenus email utilisent Fluent.
+
+## Séparation des modèles
+
+Ne pas partager directement comme modèles métier :
+
+- types Actix ;
+- types Tungstenite ;
+- messages protobuf ;
+- types Maud.
+
+Séparation attendue :
+
+```text
+domain model
+HTTP DTO
+WebSocket protocol
+gRPC contracts
+HTML view model
+```
+
+## Performance
+
+La stack realtime doit être validée par benchmarks de charge avant gel long terme.
+
+Mesures candidates :
+
+- connexions concurrentes ;
+- mémoire/connexion ;
+- messages/s ;
+- bytes/s ;
+- p50/p95/p99 ;
+- backpressure ;
+- coût broadcast ;
+- coût interest management ;
+- reconnect/resync ;
+- CPU par tick.
+
+Le choix `tokio-tungstenite` est la référence initiale, pas une affirmation non mesurée de supériorité universelle.