Cahier des charges d’une application : ce que c’est et pourquoi vous l’approuvez

Le cahier des charges d'une page que vous approuvez d'abord : illustration de l'article du blog Deployflix

Le cahier des charges d’une application est un court plan écrit de l’application avant que quiconque ne la crée : qui va l’utiliser, les écrans que voit chacun, les informations qu’elle conserve, les services auxquels elle se connecte, ce qui est laissé de côté pour l’instant et le coût maximal de la génération. Vous le lisez, le questionnez et le modifiez, et c’est seulement quand il décrit l’application que vous voulez vraiment que vous l’approuvez.

Vous l’approuvez d’abord parce qu’un cahier des charges est l’endroit où une erreur coûte le moins cher à trouver. Déplacer une ligne sur une page ne coûte rien. Découvrir après la création que les professeurs voient le numéro de téléphone de tous les parents, ou que les frais ne peuvent pas être payés en plusieurs fois, oblige à tout reconstruire.

Qu’est-ce qu’une spécification logicielle, en termes simples ?

En informatique, une spécification (dans les gros projets, on parle souvent de cahier des charges, ou de SRS, pour software requirements specification) est l’accord entre la personne qui a besoin de l’application et celle qui la crée. Elle dit ce que l’application doit faire, pas comment le code le fait. Pour un commerce, un club ou une école, une page suffit généralement, à condition qu’elle soit précise et rédigée simplement.

Le test d’un cahier des charges est simple : deux créateurs différents pourraient-ils le lire et réaliser à peu près la même application ? Si la page dit les élèves peuvent voir leurs résultats, c’est un souhait. Si elle dit un élève se connecte avec un numéro de téléphone et voit les notes de ses propres contrôles, par matière, à côté de la moyenne du groupe, c’est une exigence que quelqu’un peut réaliser et que vous pouvez vérifier.

Que contient le cahier des charges d’une page d’une application ?

Prenons un centre de soutien scolaire qui veut une application pour les cours, les présences et les frais. Un cahier des charges d’une page utile comporte ces parties :

Partie du cahier des chargesCe qu’elle ditExemple pour un centre de soutien scolaire
Qui l’utiliseChaque type de personne qui se connecte, et ce qu’elle peut fairePropriétaire, professeurs, élèves et parents ; seul le propriétaire voit les totaux des frais
Écrans par rôleLes pages que voit chaque rôle et ce qu’il y faitProfesseur : cours du jour, appel, saisie des notes de contrôle. Parent : présences, notes, frais dus
Données conservéesLes données que l’application stocke et ce que contient chacuneÉlèves, cours, présences par séance, contrôles et notes, échéances de frais et reçus
IntégrationsLes services extérieurs auxquels elle se connecte, et commentPaiement des frais en ligne via une passerelle de paiement, avec un reçu pour chaque échéance
Laissé de côté pour l’instantCe que cette version ne fera pasPas de détection des conflits d’emploi du temps ; pas d’import des données de l’an dernier
Plafond de coûtLe coût maximal de la générationUn montant maximal affiché avant l’approbation, pas une estimation après coup

Les écrans par rôle sont la partie que l’on survole, et c’est la plus importante. Une application est en réalité plusieurs applications qui partagent les mêmes données : la vue du propriétaire, celle du professeur et celle du parent. C’est en lisant les écrans rôle par rôle que vous remarquez qu’un professeur peut faire l’appel mais que personne ne peut y corriger une erreur.

La ligne laissé de côté pour l’instant est tout aussi importante. Elle vous dit ce que vous n’obtenez pas, ce qui est la source habituelle de déception après une création. Une liste d’exclusions courte et honnête est le signe d’un bon cahier des charges, pas d’un cahier des charges faible.

Quand vous décrivez une application à Deployflix, le cahier des charges qu’il rédige suit ce modèle : qui utilise l’application, ses écrans, les données conservées, ce qui est laissé de côté pour l’instant et le coût maximal de la génération, dans la langue dans laquelle vous avez écrit. Si un point de votre description n’est pas clair, il pose la question avant de planifier. Comment ça marche montre la place du cahier des charges parmi les étapes.

Comment lire un cahier des charges et le questionner ?

Ne lisez pas un cahier des charges comme un contrat, de haut en bas. Lisez-le comme une journée de votre activité.

  1. Parcourez une vraie journée dans la peau de chaque rôle. Sur quoi appuie-t-il, que voit-il, que saisit-il ? Faites ensuite de même pour chaque autre rôle.
  2. Suivez une donnée du début à la fin. Choisissez un seul élève, une seule commande ou une seule réservation. Qui la crée, qui la modifie, qui peut la supprimer, et où aboutit-elle ?
  3. Cherchez les cas qui tournent mal. Une réservation annulée, un remboursement, une saisie erronée, un paiement qui échoue, un membre qui part. Si le cahier des charges ne décrit que les cas où tout va bien, demandez ce qui se passe quand ce n’est pas le cas.
  4. Vérifiez chaque chiffre et chaque mot que vous imprimeriez. Les formats de facture, les échéances de frais, les lignes de taxe et les numéros de reçu doivent correspondre à votre façon de travailler actuelle. Si vos factures doivent faire apparaître une taxe comme la GST, la TVA ou la taxe sur les ventes, vérifiez les détails avec votre comptable.
  5. Interrogez tout ce qui est vague. Des mots comme gérer, suivre, simple et rapports cachent des décisions. Demandez : quel rapport, montrant quoi, pour qui ?

Quelles lacunes rechercher avant d’approuver ?

La plupart des cahiers des charges qui posent problème ne sont pas faux ; ils sont incomplets. Voici les lacunes les plus fréquentes.

Qui peut voir quoi

Les rôles sont faciles à nommer et faciles à laisser flous. Vérifiez ce que chaque rôle peut voir, pas seulement ce qu’il peut faire. Un professeur peut-il voir les frais ? Un parent peut-il voir les notes d’un autre enfant ? Un employé peut-il télécharger la liste des clients ? Si l’application conserve des informations personnelles, décidez dès maintenant qui peut les voir.

Modifier, annuler et revenir en arrière

Chaque donnée devra un jour être corrigée. Vérifiez que le cahier des charges indique qui peut modifier ou annuler une saisie, et si l’ancienne valeur est conservée.

Argent

Si l’application accepte les paiements, le cahier des charges doit en présenter les étapes : les moyens proposés aux clients (cartes et moyens de paiement locaux), ce qu’ils paient, la possibilité de payer une partie du montant, ce qu’ils reçoivent ensuite et ce qui se passe si le paiement n’est pas effectué ou échoue. Les règles de remboursement relèvent de vos choix commerciaux : mettez-les par écrit. Les passerelles prélèvent généralement un pourcentage par transaction, auquel s’ajoutent des frais fixes dans de nombreux pays. Consultez donc la page des tarifs de votre passerelle. Les applications Deployflix acceptent les paiements via une passerelle comme Razorpay ou Cashfree ; des passerelles internationales seront bientôt disponibles. Notre page des intégrations présente les connexions disponibles aujourd’hui.

Messages et rappels

Si vous attendez des rappels, dites comment ils doivent parvenir aux gens : par e-mail, dans l’application ou autrement. Si le cahier des charges ne mentionne aucun canal, partez du principe qu’il n’y en a pas.

Vos données existantes

Les tableurs et les anciens registres doivent souvent être transférés dans la nouvelle application. Demandez si leur import fait partie du cahier des charges ou figure dans la liste laissé de côté.

Appareils et langues

Vos clients l’utiliseront-ils sur un téléphone, sur l’ordinateur du comptoir ou sur les deux ? Faut-il aussi la proposer en espagnol, en arabe, en français ou dans une autre langue, en plus de l’anglais ? Ces choix déterminent les écrans : prenez donc vos décisions avant la création. Deployflix rédige les textes de votre application dans la langue de votre choix et est lui-même disponible en 41 langues.

Pourquoi approuver le cahier des charges avant toute création ?

Parce que modifier une phrase coûte moins cher que modifier une application. Avant la création, ajouter un rôle de parent ou une échéance de frais, c’est corriger une page. Après la création, la même modification peut toucher des écrans, des données et des droits d’accès déjà terminés.

Approuver vous donne aussi une référence pour vérifier l’application terminée. Une fois la création finie, ouvrez le cahier des charges et cochez point par point : chaque rôle, chaque écran, chaque donnée. Tout ce qui manque est une remarque légitime à formuler.

Le cahier des charges fixe aussi le coût avant que vous vous engagiez. Lorsque le coût maximal d’une génération y est inscrit, vous prenez votre décision en connaissant ce montant. Sur Deployflix, ce plafond est affiché avant votre validation, et vous ne payez que les ressources réellement utilisées pour la génération, comme l’explique la page des tarifs.

Comment les modifications sont-elles planifiées une fois l’application créée ?

Une application est rarement terminée. Un nouveau cours, un deuxième site, une nouvelle façon d’encaisser les frais : chacun mérite le même soin que la première création.

Planifiez une modification comme un petit cahier des charges à part entière : ce qui change, quels rôles et quels écrans sont concernés, quelles données sont ajoutées ou modifiées, ce qui reste identique, et ce que cela peut coûter. Lisez-le avec les mêmes questions et approuvez-le avant le début du travail. Conservez la version précédente, pour pouvoir revenir à une version qui fonctionnait si la modification tourne mal.

C’est ainsi que Deployflix gère les modifications : vous dites ce qu’il faut changer, il planifie la modification comme la version suivante, et rien n’est créé tant qu’elle n’est pas approuvée. Chaque version précédente est conservée. Dans une organisation, seules les personnes dont le rôle le permet peuvent approuver, comme le décrit la page sécurité.

Un modèle de cahier des charges que vous pouvez utiliser

Si vous rédigez votre propre cahier des charges, copiez ces titres et remplissez chacun avec des phrases simples :

  • L’application en une phrase : à qui elle s’adresse et ce qu’elle fait.
  • Rôles : chaque type d’utilisateur et ce qu’il peut voir et faire.
  • Écrans par rôle : pour chaque rôle, les écrans et ce qui se passe sur chacun.
  • Données conservées : chaque type de donnée et les informations qu’elle contient.
  • Intégrations : paiements, votre domaine, boutiques d’applications, emplacement du code, et tout autre service auquel elle se connecte.
  • Règles : frais, limites, échéances, annulations et remboursements.
  • Laissé de côté pour l’instant : ce que cette version ne fera pas.
  • Plafond de coût et approbation : le coût maximal, et qui donne son feu vert.

Pour des exemples concrets de rôles, d’écrans et de données, consultez un système de gestion des groupes pour centre de soutien scolaireEN ou une application de prise de rendez-vous pour cliniqueEN. Un fondateur qui teste une idée peut faire un cahier des charges encore plus court, avec un seul rôle, quelques écrans et une liste ferme de ce qui est laissé de côté, comme pour une application web MVP pour startupEN.

Questions

Quelle est la différence entre le cahier des charges d’une application et un document d’exigences ?

Surtout la longueur et le formalisme. Le document d’exigences d’un gros projet peut compter de nombreuses pages d’exigences numérotées. Le cahier des charges d’une application pour une petite entreprise couvre les mêmes points (qui l’utilise, ce qu’elle fait, ce qu’elle conserve) sur une page, en termes simples.

Qui doit rédiger le cahier des charges de l’application ?

La personne qui connaît l’activité fournit le contenu : les rôles, le travail quotidien et les règles. Un créateur peut en faire un cahier des charges structuré, mais vous seul pouvez dire s’il est juste.

Puis-je modifier le cahier des charges après l’avoir approuvé ?

Oui. Traitez-le comme une modification : décrivez ce qui change, lisez le plan mis à jour et approuvez-le à nouveau. Conservez la version précédente pour pouvoir comparer ou revenir en arrière.

Quelle longueur doit faire le cahier des charges d’une application ?

Assez long pour que rien d’important ne soit laissé au hasard, assez court pour que vous le lisiez en entier. Pour la plupart des applications de petites entreprises, une page suffit ; s’il est beaucoup plus long, envisagez de créer l’application par étapes.

Décrivez votre application

Écrivez votre besoin avec vos propres mots. Deployflix rédige un plan d’une page avec son coût, et ne crée qu’après votre approbation.