Spécifications

Ce qui se passe derrière les écrans, écrit avant d'être codé

Qui a le droit de faire quoi, ce qui se passe quand une affaire est gagnée, quel e-mail part et quand : ce sont les règles qui font un logiciel, et elles ne se voient pas sur une maquette.

Les spécifications les décrivent une à une, avec leurs cas d'exemple, pour que vous les validiez avant leur développement.

Conception

Droits par rôle

RôleAffairesChantiers
DirectriceToutTout
CommercialVoir, créerVoir
ConducteurVoirVoir, modifier

Ce que décrivent les spécifications

Les règles, une à une, avec leurs exemples

Les traitements, en diagramme

Chaque traitement est dessiné étape par étape, avec ses décisions et leurs branches. Chaque branche doit être prise par un cas d'exemple : une branche sans cas est une question à vous poser.

Ces cas deviennent les tests automatisés du traitement.

Conception

Gagner une affaire

Étapes

L'affaire passe à « Gagnée »

Un chantier est ouvert avec son contact

L'organisation a-t-elle un contrat d'entretien ?

Non : proposer un contrat · 2 casOui : aucun cas

Les tâches automatiques

Ce qui se lance tout seul : chaque nuit, à une date, ou à la réception d'un message d'un autre logiciel. Pour chacune, ce qu'elle traite, et ce qui se passe si elle est relancée deux fois : jamais de relance envoyée en double.

Conception

Tâches automatiques

Déclencheurs

Relances du matin

Chaque jour à 7 h · les affaires en retard

Rejouable

Renouvellement des contrats

Le 1er du mois · les contrats à échéance

Rejouable

Paiement reçu

Message du service de paiement

Rejouable

L'API, validée avant d'être codée

Si votre logiciel échange avec un autre, le contrat de l'API est écrit et publié dans le format standard OpenAPI : ce qu'on peut lire, ce qu'on peut envoyer, et les erreurs possibles.

Vous, ou votre partenaire, le validez avant son développement : les deux côtés peuvent avancer en même temps.

Conception

API · OpenAPI

Chantiers

GET /api/chantiers

Les chantiers d'un client

200

GET /api/chantiers/{id}

Un chantier et son avancement

200404

Paiements

POST /api/paiements

La confirmation d'un paiement

204

Les e-mails, tels qu'ils partiront

Chaque e-mail de l'application se lit rendu, avec votre logo et vos couleurs : son objet, son contenu, ses boutons et ce qu'ils font. Vous validez le texte exact, pas une intention.

Conception

E-mails · Espace client

4 e-mails

Bienvenue dans votre espace client

Réinitialiser votre mot de passe

Votre chantier avance

Votre contrat d'entretien arrive à échéance

Questions fréquentes

Faut-il tout spécifier avant de commencer ?
Non. Le socle pose les droits et les écrans communs ; les règles de chaque lot s'écrivent au moment de le concevoir, pendant que le lot précédent est développé.
Comment valider une règle sans être développeur ?
Par ses exemples : telle situation, tel résultat. Vous dites si le résultat est le bon, et un cas oublié se repère à la branche qu'aucun exemple ne prend.
Que deviennent les spécifications après le développement ?
Elles restent la référence : chaque cas d'exemple est un test automatisé, rejoué à chaque livraison. Une règle validée qui cesserait d'être respectée se verrait.

Ce que vous aimeriez écrire avant de développer

Dites-nous ce qui vous manque pour valider vos règles : vos besoins orientent les prochains outils de la plateforme.