Ce qui reste à livrer côté connecteur
Évolution en préparation
Cette page décrit des travaux non livrés. État au 2026-10-11, d'après le journal
d'avancement Serveur/docs/suivi-phases.md et le plan Serveur/docs/plan-migration.md.
Elle ne reprend que ce que la source marque comme non livré ou non validé, et ne donne
aucune date que la source ne donne pas.
En bref
Le connecteur v2 sert ses fonctions principales, et depuis septembre ses écritures passent par la bibliothèque Sage, la couche historique n'appelle plus les objets métiers Sage, l'ancien outil de configuration a quitté le dépôt et un installeur unique est compilé. Restent : le retrait de la couche historique elle-même (phase 4), la recette de l'installeur (phase 5), le durcissement final avec le retrait de la version 1 (phase 6), et une série de validations sur un dossier Sage réel.
Où en est le plan
| Phase | Objet | État dans la source |
|---|---|---|
| 0 | socle de qualité et filets de sécurité | terminée |
| 1 | outil de configuration en nouvelle interface | en cours - quelques sous-lots restent ouverts |
| 2 | protocole v2 et durcissement immédiat | en cours - deux lots reportés, un sujet non livré |
| 3 | intégration en direct de la bibliothèque Sage | en cours - lectures et écritures livrées ; écritures v2 activées par défaut depuis le 2026-10-11, validations sur dossier réel attendues |
| 4 | retrait de la couche d'accès historique | à faire - préparée : la couche n'appelle plus les objets métiers Sage |
| 5 | retrait de l'ancien outil de configuration | à faire dans le journal - l'ancien outil est retiré du dépôt et l'installeur unifié compilé ; la recette reste à dérouler |
| 6 | durcissement final, dépréciation de la version 1, audit | à faire - la dépréciation de la version 1 est annoncée, retrait prévu au 1er janvier 2027 |
Livré depuis la précédente mise à jour
Pour situer ce qui suit, les lots que le journal donne comme livrés entre le 2026-09-11 et le 2026-10-11, avec leur page quand elle existe :
- Connexion par la webapp (2026-10-02) : le connecteur accepte les jetons de la plateforme d'authentification centralisée de SenSaaS en plus de sa connexion directe, qui reste toujours ouverte (décision du responsable de projet). Voir Sécurité du connecteur.
- Plateforme .NET 10, outil de configuration renommé, installeur unifié (2026-10-05) : un seul setup SenSaaS installe le connecteur, l'outil de configuration, le Report Designer et le client EasyConnect. Voir Installation.
- Droits d'affichage de la webapp v2 (2026-10-08) et simulation de la migration des droits v1 par entité (2026-10-11) : onglet Accès de l'écran Filtres et accès. Voir Filtres et accès.
- Écran d'accueil enrichi (2026-10-09 et 2026-10-10) : versions installées, état du service, dernière synchronisation avec le portail et bilan graphique. Voir Accueil.
- Médias des objets Sage (2026-10-09) : lecture, création, modification, suppression et rangement des fichiers. Voir Médias.
- Changement d'adresse EasyConnect (2026-10-10) : passage automatique vers la nouvelle plage à l'ouverture de l'outil. Voir Migrer un connecteur v1 vers la v2.
Phase 4 - retrait de la couche d'accès historique
Ce qui est fait. Une analyse préparatoire a établi ce qui est remplaçable tel quel (outillage, accès SQL, moteurs de requête et de recherche), ce qui reste SenSaaS par nature (accès distant, licence, sécurité, indicateurs, droits) et les manques à arbitrer. Puis, le 2026-08-25, les écritures, les processus documentaires et les médias ont quitté la couche historique : elle ne contient plus aucun appel aux objets métiers Sage et n'est plus qu'une bibliothèque de lectures SQL (balance, indicateurs, cadencier, tarifs, tableau de bord), de modèles et de droits.
Ce qui reste, d'après le plan :
- relocaliser dans le connecteur les moteurs restés dans la couche historique (indicateurs, tableau de bord, balance, cadencier), puis supprimer le projet historique ;
- réduire le cœur d'API en retirant ses moteurs de requête et de recherche, remplacés par ceux de la bibliothèque Sage ;
- basculer le test de connexion de l'outil de configuration sur la bibliothèque Sage : c'est aujourd'hui le seul appel aux objets métiers Sage en dehors d'elle.
Le jalon reste celui du plan : la solution ne contient plus aucune référence aux composants Sage hérités, et les tests de référence restent verts sur les moteurs déplacés.
Point de non-retour
La suppression du projet historique ne se défait que par annulation dans l'historique de code. Le plan la place après un cycle de production de la phase 3. Le risque qu'il nommait - l'ancien outil de configuration qui référençait cette couche - est levé : cet outil a quitté le dépôt le 2026-10-05.
Phase 5 - retrait de l'ancien outil de configuration
Ce qui est fait (2026-10-05) : l'ancien outil est supprimé du dépôt, le nouveau est renommé
SenSaaS.Configuration.exe, et l'installeur est réécrit en un seul setup SenSaaS qui reprend un
connecteur v1 en place (fichiers de configuration et licence repris, service repointé). Les écrans de
l'outil sont documentés dans L'outil de configuration.
Ce qui reste :
- la recette de l'installeur : il est compilé mais n'a pas encore été exécuté. La fiche de recette prévoit une machine vierge, une migration complète depuis la version 1, l'ancien installeur, la préversion v2, les mises à jour, les binaires protégés sur Sage et la désinstallation, d'abord sur machines virtuelles ;
- le resserrement des droits d'accès du dossier de données, prévu par le plan.
Phase 6 - durcissement final, dépréciation de la version 1, audit
Ce qui est fait :
- la clé de chiffrement du fichier de configuration est protégée par le système d'exploitation depuis la campagne de sécurité du 2026-07-04, et la clé de signature des jetons est propre à chaque installation depuis la phase 2 - leur migration au déploiement reste à valider sur un poste réel ;
- la dépréciation de la version 1 est annoncée (2026-09-26) : documentation v1 marquée obsolète,
en-têtes
DeprecationetSunsetsur chaque réponse des routes historiques, retrait prévu au 1er janvier 2027, date révisable. Voir Retrait de la version 1.
Ce qui reste, d'après le plan :
- sauvegarde de la configuration vers le portail, envoi chiffré - la spécification reste à écrire. L'export et l'import de la configuration livrés le 2026-09-29 restent locaux ;
- moindre privilège : comptes SQL dédiés, en lecture seule pour toutes les lectures Sage, l'écriture étant réservée à la base SenSaaS ; comptes de service non administrateurs si c'est possible ;
- retrait effectif des routes de la version 1 à l'échéance ;
- audit final : revue de l'authentification et des autorisations endpoint par endpoint, analyse des dépendances, test d'intrusion ciblé, revue des journaux ;
- performances : mesure de référence avant et après, ajustement des garde-fous de volume.
Le jalon : un rapport d'audit sans constat critique ou élevé ouvert, la sauvegarde par le portail testée en restauration, et la version 1 retirée ou son échéance actée.
Ce qui reste dans les phases en cours
Phase 3 - les écritures
Livré : lectures par la bibliothèque Sage ; ciblage du dossier par la configuration du connecteur (2026-07-11) ; écritures de la version 1 par la bibliothèque Sage, chemin nominal pour toutes les bases depuis le 2026-08-20, documents et lignes compris depuis le 2026-08-25 (gros documents par paquets, remise de pied, transformations, médias) ; écritures v2 des tiers, articles, documents par domaine et échéanciers, avec contrôle strict des corps de requête depuis le 2026-10-05.
Ce qui reste : les validations sur dossier réel listées plus bas.
Les écritures de l'API v2 sont activées par défaut depuis le 2026-10-11, à l'installation comme après une migration : l'option "Autoriser les écritures API v2" de l'écran Serveur web sert désormais à les fermer. Le code prévoyait cette ouverture une fois les écritures validées sur un dossier Sage réel ; elle précède donc ces validations.
Le risque nommé par la source
L'écriture partielle d'un document peut supprimer des lignes si le corps de la requête est incomplet. C'est le point que la source demandait de vérifier avant d'ouvrir les écritures v2, ouvertes par défaut depuis le 2026-10-11 ; le mode "lignes partielles" livré le 2026-08-25 (lignes à modifier et lignes à supprimer désignées explicitement) attend lui aussi sa validation sur dossier réel.
Phase 2 - deux lots reportés, un sujet non livré
- clients d'appels sortants résilients (portail, géocodage, téléchargements) : reporté, parce qu'il demande une réorganisation transverse ;
- jeton signé sur le service d'images : reporté, parce qu'il modifie le contrat de la version 1 et doit être coordonné avec les clients ;
- politiques d'autorisation par module : non livrées. Les droits par endpoint (onglet API de l'écran Filtres et accès, refus en 403) le sont depuis le 2026-09-29.
Côté connexion par la webapp, il reste à valider les jetons réels du serveur d'authentification de développement, et les clés publiques compilées dans le connecteur sont encore vides : le connecteur les télécharge au premier jeton puis les conserve.
Phase 1 - sous-lots encore ouverts dans l'outil de configuration
- collaborateur associé et type de filtre collaborateur dans le détail d'un utilisateur ;
- export et import par classeur dans l'écran des accès partenaires ;
- portées profil et utilisateur du cadencier, non reprises de la version précédente ;
- purge des dossiers retirés (et des autorisations et filtres associés) : comportement de la version précédente volontairement non repris, à arbitrer ;
- droits d'affichage de la webapp v2 : livrés, mais la table de correspondance des droits v1 reste à compléter avec l'équipe de la webapp (écrans de liste, onglets, cartes du tableau de bord, pilotage, fiche famille, cadencier).
Deux sous-lots de la liste précédente sont livrés : les droits par module et options, remplacés le 2026-10-08 par l'onglet Accès (décision du responsable de projet), et l'écran d'accueil.
Les validations en attente sur un dossier réel
Ces lots sont écrits et testés hors Sage ; la source les marque "validation à faire" :
| Sujet | Ce qu'il faut vérifier |
|---|---|
| écritures de la version 1 | documents par paquets, remise de pied, sous-totaux, anciens noms d'objets, échéancier |
| processus documentaires et médias v1 | transformations de documents, conversion d'un prospect en client, report des médias |
| écritures de l'API v2 | création et suppression de tiers, documents par domaine, sous-totaux, informations libres, statuts |
| lectures par critères | tri et pagination réels, filtres sur colonnes calculées |
| objets métiers Sage 12.20 | écriture et lecture des nouveaux champs |
| droits d'affichage de la webapp v2 | routes sur le connecteur démarré, migration réelle des droits v1 |
| médias des objets Sage | création, lecture et rangement sur un dossier réel |
| droits par endpoint | refus 403 d'un droit retiré à l'utilisateur, au profil ou au dossier |
| secrets et jetons | migration de la clé de signature et de la clé du fichier de configuration au déploiement |
| installeur unifié | la fiche de recette complète (voir phase 5) |
| changement d'adresse EasyConnect | un connecteur réel encore dans l'ancienne plage |
Questions fréquentes
Le connecteur v2 est-il utilisable aujourd'hui ?
Oui, sur ses fonctions principales : les lectures, l'API v2 et son catalogue d'entités, les écritures de la version 1, les chemins hérités. Ce qui reste relève de la réorganisation interne, du durcissement et de la recette.
Ces travaux changent-ils l'API v2 ?
Les phases 4 et 5 sont internes : elles ne modifient pas le contrat. La phase 6 retire les routes de la version 1, prévu au 1er janvier 2027.
Pourquoi tant de lots attendent-ils "un dossier réel" ?
Parce qu'un dossier Sage de développement ne reproduit ni le volume, ni le multi-dossier, ni les comportements des objets métiers. La source refuse de déclarer validé ce qui n'a pas été confronté - c'est la même règle que pour la connaissance interne : voir Règles pour les agents.