Portail adhérents : la trame de cahier des charges

La plupart des cahiers des charges de portail adhérents échouent de la même façon. Quatre-vingts pages, écrites seul sur trois week-ends, exhaustives sur les écrans et muettes sur les données. Trois prestataires les lisent et chiffrent trois projets différents. Le document a fait l'inverse de son travail — parce que son travail n'a jamais été de décrire le logiciel.

À quoi sert réellement un cahier des charges

Il existe pour rendre deux devis comparables. C'est tout. Ce qui aide un prestataire à chiffrer le même périmètre que son concurrent y a sa place ; ce qui décrit comment il doit construire appartient au prestataire. Jugées à ce critère, vingt pages serrées valent mieux que quatre-vingts pages exhaustives, à chaque fois.

Un second usage, moins évident : l'écrire oblige votre organisation à répondre aux questions qu'elle évite. Qui a le droit de voir le chiffre d'affaires d'un autre adhérent ? Que devient un adhérent qui sort en cours d'exercice ? Ces réponses valent plus que le document lui-même, et c'est la raison pour laquelle un cahier des charges ne devrait jamais être écrit par une seule personne.

La trame, section par section

1. 1

   Contexte et objectifs

   Qui vous êtes, combien de sociétés associées et de fournisseurs référencés, ce qui porte le processus aujourd'hui et ce qui casse. Puis trois à cinq objectifs, chacun assorti d'un moyen de savoir s'il est atteint. Pas des slogans : ramener la campagne de déclarations de six semaines à deux, cesser de ressaisir des chiffres, donner à l'adhérent l'accès à son propre historique.

2. 2

   Périmètre fonctionnel par acteur

   Une section par acteur, décrivant ce qu'il vient faire. C'est le cœur du document, et la section développée plus bas.

3. 3

   Rôles et droits

   Une grille : pour chaque rôle, ce qu'il peut consulter, créer, modifier, valider. Nommez explicitement les cas sensibles — un adhérent ne voit jamais les déclarations d'un autre, un fournisseur ne voit que ses propres contrats, l'équipe permanente voit tout mais ne signe rien.

4. 4

   Parcours critiques

   Trois à six enchaînements décrits en phrases simples, du début à la fin : déclarer son CA trimestriel, déposer une candidature au référencement, retrouver le contrat de l'an dernier, mener l'arrêté annuel. Incluez les chemins d'échec — la déclaration en retard, le fichier rejeté, le montant contesté.

5. 5

   Données et reprise

   Ce qui existe, où, dans quel état, et ce qui doit être repris. Nombre d'adhérents, de fournisseurs, de contrats, de documents, d'années d'historique. Dites honnêtement ce qui est sale : doublons, sociétés renommées, documents sans métadonnées. C'est la section qui permet à un prestataire de savoir si vous avez regardé.

6. 6

   Exigences non fonctionnelles

   Disponibilité, volumétrie, données personnelles, hébergement, sauvegarde, navigateurs, langues. Détaillées plus bas, parce que c'est là qu'un groupement a de vrais besoins spécifiques.

7. 7

   Réversibilité et propriété du code

   À qui appartient le code source, ce qui est remis et à quel moment, sous quelle forme les données peuvent être exportées, ce qui se passe si la relation s'arrête. Écrivez-le comme une exigence, pas comme un espoir formulé pendant la négociation.

8. 8

   Modalités de recette

   Qui teste, sur quelles données, contre quelle liste, et ce que déclenche un test en échec. Précisez que la recette se fait sur des données réelles et non sur des échantillons, et que la recette définitive suppose un cycle complet en conditions de production.

9. 9

   Planning et jalons

   Vos dates intangibles — fenêtres de déclaration, arrêté annuel, assemblée générale — et les lots que vous souhaitez voir livrés autour d'elles. Donnez des contraintes, pas un diagramme de Gantt : le séquencement fait partie de ce que vous achetez.

10. 10

    Critères de sélection

    Annoncez comment vous déciderez, avec des pondérations. Un prestataire qui sait que la compréhension du métier pèse 40 % et le prix 25 % écrit une proposition différente, et plus utile.

Décrire le périmètre par acteur, pas par écran

L'erreur la plus répandue consiste à lister des fonctionnalités : un espace actualités, un espace documentaire, un formulaire. Une liste de fonctionnalités ne se discute pas, parce que rien n'y dit à quoi elle sert. Une description par acteur, si : elle énonce qui fait quoi, et tout prestataire qui mérite d'être retenu revient avec des questions sur les bords.

Les exigences non fonctionnelles qui comptent vraiment ici

Les cahiers des charges génériques recopient un paragraphe sur la performance et passent à la suite. Pour un groupement, quatre points méritent de vraies phrases.

• La disponibilité pendant les fenêtres de déclaration. Le trafic n'est pas réparti sur l'année : quarante de vos soixante adhérents déclarent dans les quarante-huit heures qui précèdent l'échéance. Dites-le, et dites ce que coûterait une indisponibilité ces deux jours-là — c'est ce qui dimensionne l'hébergement.
• La volumétrie, en chiffres. Nombre de comptes, de lignes de déclaration par campagne, de documents stockés et leur taille moyenne, années d'historique conservées en ligne. Un prestataire qui ne reçoit aucun chiffre retiendra les plus petits.
• Les données personnelles. Les contacts de vos adhérents sont des données personnelles : durées de conservation, qui peut exporter une liste, obligations du sous-traitant, registre des traitements. Demandez un contrat de sous-traitance dans la réponse, pas après la signature.
• L'hébergement et la reprise après incident. Où les données résident physiquement, à quelle fréquence elles sont sauvegardées, combien de données vous acceptez de perdre en cas d'incident et combien de temps vous acceptez d'être à l'arrêt. Deux chiffres, et c'est à vous de les fixer, pas au prestataire.

Ce qu'il ne faut surtout pas y mettre

Trois choses ruinent un cahier des charges par ailleurs bon, et les trois partent d'une vraie volonté d'aider.

Les solutions techniques imposées, d'abord. Nommer la base de données, le framework ou l'architecture avant que quiconque ait compris le processus élimine des prestataires pour de mauvaises raisons et vous prive de votre seul levier si le choix se révèle mauvais. Décrivez plutôt des contraintes — une authentification unique existante, un format d'export comptable, une exigence d'hébergement — et laissez les réponses argumenter le reste.

Les écrans dessinés à l'avance, ensuite. Des maquettes détaillées donnent une impression de précision ; elles sont surtout le moyen le plus rapide de figer une solution avant d'avoir compris le problème. Elles déplacent aussi la responsabilité : un prestataire qui construit vos écrans exactement comme vous les avez dessinés ne peut plus répondre de leur ergonomie. Un croquis pour illustrer une intention est utile. Une spécification écran par écran est une décision de conception que vous prenez sans avoir les éléments pour la prendre.

La fausse exhaustivité, enfin. Trois cents exigences numérotées, pour la plupart recopiées de la fiche produit d'un progiciel, produisent un document que personne ne lit jusqu'au bout et un périmètre que personne ne sait chiffrer. Pire : elles enfouissent les quinze exigences qui comptent vraiment. Et l'omission qui coûte le plus de temps, pour finir : refuser d'annoncer une enveloppe budgétaire. La taire ne vous fait pas gagner un meilleur prix, elle vous vaut trois devis qui visent trois projets différents.

Les questions à trancher avant d'écrire une ligne

• Quel processus unique, s'il s'améliorait, justifierait à lui seul le projet ?
• Qui, nommément, est habilité à arbitrer un désaccord fonctionnel — et est-il disponible toutes les semaines ?
• Que voit un adhérent des autres adhérents ? La réponse est une décision de gouvernance, pas une décision technique.
• Quelles sont nos dates intangibles, et de combien de mois de marge disposons-nous réellement ?
• Que faisons-nous de quinze ans d'historique : nous le reprenons, nous l'archivons, ou nous le laissons où il est ?
• Avec quels outils le portail doit-il dialoguer, et qui contrôle chacun d'eux ?
• Que se passe-t-il le jour où un adhérent conteste un montant : qui répond, avec quelles pièces ?
• Quelle est notre enveloppe, et à quoi renoncerions-nous en premier si les devis la dépassaient ?

Comparer les réponses

Notez d'abord la compréhension du métier : non pas les promesses, mais les questions posées. Un prestataire qui revient en demandant si votre bonus de croissance se mesure à périmètre constant a lu le document ; celui qui renvoie un prix par email ne l'a pas lu. Exigez ensuite un prix par lot plutôt qu'un montant unique, demandez qui fera réellement le travail — des noms, pas une plaquette de compétences — et demandez une référence comparable par la taille et par le processus, pas par le secteur d'activité.

Un cahier des charges n'est pas un document de conception, c'est un document de décision. Il doit être assez précis pour que deux devis soient comparables, et assez ouvert pour qu'un prestataire qui connaît le domaine puisse apporter ce à quoi vous n'aviez pas pensé. Cet équilibre est plus facile à tenir qu'il n'y paraît : il vient du fait d'écrire le document avec les deux ou trois personnes qui font tourner le processus, plutôt qu'à leur sujet. Vingt pages écrites ainsi vous mèneront plus loin que quatre-vingts écrites seul — et vous saurez déjà, avant le premier devis, quelles parties de votre propre processus personne ne sait expliquer.