💡 [REQUEST] - Documenter le routage et le retour arrière après la bascule complète vers NestJS #135

Description

Écart relevé en croisant la Release Note 9.28.0, les tickets et PR documentaires, la branche main et le contenu du site public.

La page d’installation ne décrit pas l’architecture de routage de la console après la bascule complète des API vers NestJS, ni la procédure de retour arrière. La PR ouverte #131 corrige déjà l’IAM et annonce les endpoints V1 retirés et le Swagger maintenu : ce ticket porte sur le complément d’exploitation, pas sur une réécriture de cette PR.

En 9.28.0, aucun repli applicatif automatique ne doit envoyer les requêtes vers l’ancien serveur Fastify. Le serveur historique et le proxy restent présents pour les besoins techniques et un retour arrière explicite ; leur retrait définitif est un chantier ultérieur.

Contenu documentaire attendu

• Présenter le chemin client → proxy → NestJS et distinguer le trafic applicatif des probes techniques encore admises pour le serveur historique.
• Expliquer le comportement des routes inconnues et des anciens accès Swagger à partir de la configuration livrée, en renvoyant aux informations API de doc: documenter la bascule complète de l'API Console vers NestJS #131.
• Fournir ou référencer une procédure d’exploitation actuelle : configuration et versions concernées, prérequis, vérification du routage sans trafic applicatif legacy, décision et étapes du retour arrière explicite, contrôles après intervention.
• Vérifier les instructions contre les manifests et le chart réellement déployés ; ne pas reprendre sans validation une ancienne consigne consistant à commenter une route nginx, puisque le fallback legacy est désormais fermé.
• Distinguer la bascule de trafic du retrait futur des composants historiques, sans annoncer leur suppression dans cette version.

Pages concernées

• https://cloud-pi-native.fr/installation/installation
• https://cloud-pi-native.fr/platform/iam

Références

• 💡 [REQUEST] - Fermer les chemins de trafic applicatif vers le legacy après les bascules nginx console#2927
• 💡 [REQUEST] - Retirer server et nginx-strangler, puis renommer server-nestjs en backend console#2895 (retrait ultérieur, hors périmètre)
• doc: documenter la bascule complète de l'API Console vers NestJS #131 (complémentarité)

Définition du fini

• L’architecture explique la bascule complète, l’absence de fallback applicatif et le maintien technique des composants historiques.
• Les contrôles d’exploitation et la procédure de retour arrière sont validés sur la configuration de déploiement concernée, avec prérequis et limites explicites.
• Le guide d’installation donne accès à cette procédure et aux explications API de doc: documenter la bascule complète de l'API Console vers NestJS #131 sans duplication.
• Le contenu publié est relu ; la suppression du serveur historique n’est pas présentée comme livrée en 9.28.0.