Cahier des charges d’une application métier : la trame à recopier
Un cahier des charges d’application métier n’a pas à décrire le logiciel. Il doit permettre à deux prestataires de chiffrer la même chose. Voici ce qu’il doit contenir pour cela, ce qu’il vaut mieux ne pas y écrire, et une trame à recopier.
Quand je reçois un cahier des charges, je cherche trois nombres : combien de parcours, combien de règles, combien de logiciels à connecter. Un document de quarante pages peut n’en contenir aucun. Une page bien écrite peut contenir les trois.
À quoi sert ce document
Un chiffrage est une liste d’hypothèses. Ce que le document ne dit pas, le prestataire le suppose ou le couvre par une marge. Deux réponses très éloignées ne veulent donc pas dire que l’une est fausse : chacun a comblé les trous à sa façon. Axopen fait le même constat : une estimation vaut ce que vaut le cahier des charges.
Les prestataires ne sont pas d’accord sur le volume. 5000.dev estime qu’une page suffit pour une estimation sérieuse. The Coding Machine propose une structure en quatre parties, jusqu’à la solution technique. Chacun décrit un moment différent : une page pour situer un ordre de grandeur et savoir si l’on peut travailler ensemble, davantage pour un prix ferme.
Dans les deux cas, l’objectif doit pouvoir se constater. « La consolidation hebdomadaire ne demande plus de recollage à la main » se vérifie à la recette. « Gagner en efficacité » ne se vérifie jamais.
Les utilisateurs et leurs parcours
Listez des profils, pas des noms : qui saisit, qui valide, qui consulte, qui administre, et combien de personnes pour chacun. Chaque profil ajoute des droits à contrôler et des cas à tester. C’est l’un des premiers leviers du prix.
Décrivez ensuite les parcours : une action complète, du début au résultat. « Gérer les interventions » ne se chiffre pas. Ceci se chiffre, dans cet exemple fictif : « Le technicien clôture une intervention depuis sa tablette, avec une photo. Le responsable la valide. Le soir, les interventions validées partent vers la comptabilité dans un fichier. »
Joignez cinq cas réels, dont le plus pénible de l’année : l’annulation tardive, la correction d’une facture déjà validée, le dossier qui change de service. Le cas courant se chiffre facilement. Ce sont les cas rares qui font l’écart entre deux devis.
Marquez ensuite chaque parcours : indispensable au premier jour, ou plus tard. Ce tri pèse sur le budget plus que tout le reste du document.
Les données et les règles
- L’origine. Tableur, ancien logiciel, saisie, import d’un partenaire.
- Les droits. Qui crée, qui modifie, qui consulte seulement.
- La reprise. Combien d’années, dans quel état. Joignez un extrait réel anonymisé. Odyssée ne chiffre d’ailleurs la reprise qu’après avoir lu le fichier : son prix dépend de l’état des données plus que de leur volume.
- Les données personnelles. Lesquelles, et pour combien de temps. La CNIL rappelle qu’elles ne se conservent pas indéfiniment et que la durée dépend de la finalité.
Une règle se chiffre si elle tient en trois temps : la phrase, un exemple avec des nombres, l’exception. C’est ainsi que j’écris celles de mes propres produits, comme ekyde. Cas fictif : « Remise de 5 % au-delà de 1 000 € HT. Une commande de 1 200 € HT est facturée 1 140 € HT. Jamais sur les pièces détachées. »
Ces règles dorment souvent dans une tête ou dans une formule de tableur. Si vous n’en connaissez pas une, écrivez « à trancher ». Une question ouverte se chiffre mieux qu’une règle inventée.
Les volumes et les contraintes
- Les volumes. Utilisateurs en même temps, lignes de la plus grosse liste, documents par mois, pics de clôture ou de saison. Une grille de 200 lignes et une grille de 200 000 lignes ne se construisent pas pareil.
- Les logiciels à connecter. Lequel, dans quel sens, API documentée ou simple export, qui donne l’accès. C’est la ligne la plus risquée d’un devis : Axopen note qu’un même connecteur peut prendre 2 jours comme 20.
- Les conditions d’usage. Poste de travail ou tablette, réseau, langues, clavier. Sur RXM onWeb, l’encodage hospitalier belge sur lequel j’ai travaillé trois ans, le français, le néerlandais et la navigation au clavier faisaient partie du besoin, pas des options. L’accessibilité se décide ici aussi.
- Les contraintes réelles. Hébergement imposé, certification HDS pour des données de santé hébergées par un tiers, date légale. N’écrivez que celles que vous refuseriez de lever.
- L’enveloppe et la date. Dites-les, avec la raison de la date. Une fourchette permet de proposer un périmètre au lieu de le deviner.
Ce qu’il ne faut pas écrire
- La solution à la place du besoin. « Un bouton vert en haut à droite » ferme des options que vous n’avez pas regardées. Écrivez ce que la personne doit accomplir.
- Une technologie sans raison. « En Angular » a du sens si votre équipe le maintient déjà. Sinon, demandez au prestataire de proposer et de justifier. Je le dis alors qu’Angular est mon métier.
- Les mots qui ne se chiffrent pas. « Intuitif », « rapide », « évolutif », « gérer », « etc. » Préférez « la liste des dossiers s’affiche en moins de deux secondes » : cela se teste.
- « Comme l’ancien logiciel ». Personne ne chiffre un comportement qu’il n’a pas vu. Joignez des captures, et dites ce qui doit changer.
- Ce qui viendra « à terme ». Mettez-le dans une liste à part, hors chiffrage. Vous ne le payez pas, et personne ne ferme la porte.
- Des pages sur l’histoire de l’entreprise. Trois lignes suffisent.
La trame à recopier
Copiez ces rubriques dans un document et remplissez ce que vous savez. Une rubrique vide reste utile : elle dit ce qu’il faudra trancher.
- Contexte : votre activité en trois lignes, le problème, ce que vous utilisez aujourd’hui.
- Objectif : ce qui doit changer, et comment vous le constaterez.
- Utilisateurs : profil, nombre, ce que chacun voit et modifie.
- Parcours : qui, quoi, résultat attendu ; premier lot ou plus tard.
- Données : origine, droits, reprise, extrait joint, données personnelles et durée de conservation.
- Règles : phrase, exemple chiffré, exception, ou « à trancher ».
- Volumes : utilisateurs simultanés, lignes, documents, pics.
- Connexions : logiciel, sens, API ou export, contact technique.
- Contraintes : appareils, réseau, langues, accessibilité, hébergement, sécurité.
- Hors périmètre : ce que la première version ne fera pas.
- Validation : qui décide, qui teste, avec quels cas réels, sous quel délai.
- Après la livraison : hébergement, maintenance, formation, et qui prend quoi.
- Cadre : enveloppe, date et sa raison, forfait ou régie si vous avez une préférence.
Une fois le document envoyé
Un bon prestataire revient avec des questions. Un prix ferme sans aucune question, sur un document forcément incomplet, doit vous alerter : quelqu’un a supposé à votre place. Demandez que les hypothèses soient écrites dans le devis, avec les autres points à vérifier.
Le document ne vit pas pareil selon le contrat. The Coding Machine le décrit figé à la signature d’un forfait, évolutif en régie. Dans mes devis, le périmètre est fixé et toute demande supplémentaire passe par un avenant chiffré avant d’être réalisée. Gardez une version datée : elle servira de référence à la recette.
Vous n’avez pas besoin d’un document complet pour m’écrire. Je développe des applications web métier, et une trame à moitié remplie me suffit pour commencer. Envoyez-la telle quelle : réponse sous 48 heures, avec ce qui manque pour chiffrer.
Questions fréquentes
Un cahier des charges est-il obligatoire pour développer une application métier ?
Non, c’est un outil de travail. Pour situer un ordre de grandeur, une page décrivant les utilisateurs, le problème et le résultat attendu suffit. Un prix ferme demande davantage : parcours, règles, données et volumes écrits, car le forfait dépend de ce périmètre.
Qui doit rédiger le cahier des charges ?
La personne qui connaît le mieux le métier, avec celles qui utiliseront l’outil. Un responsable technique relit les connexions et l’hébergement, et un décideur tranche les désaccords. Un prestataire peut aider à compléter, mais il ne peut pas deviner vos règles.
Faut-il indiquer son budget dans un cahier des charges ?
Oui, au moins une enveloppe. Elle permet au prestataire de proposer un périmètre adapté plutôt que de le deviner, et d’écarter vite ce qui n’y tient pas. Elle n’oblige personne à la dépenser : demandez un chiffrage par lot.
Quelle différence entre cahier des charges et spécifications fonctionnelles ?
Le cahier des charges dit ce dont vous avez besoin et dans quel cadre. Les spécifications décrivent comment l’application y répond : écrans, champs, messages, cas d’erreur. Elles sont en général produites pendant le cadrage, avec le prestataire.
Que faire si je ne connais pas toutes les règles du métier ?
Écrivez-les comme questions ouvertes, en notant qui peut répondre. Une règle marquée « à trancher » se chiffre et se planifie. Une règle devinée se découvre fausse en recette, au moment où la corriger coûte le plus cher.
Développeuse indépendante à Angers. Huit ans de projets pour l’hôpital, les services de secours, l’aéronautique et l’assurance (CNP, Sodifrance), et trois applications publiées sur l’App Store et Google Play : VetSafe, Equio et Ellyo.