Le Cahier des Spécifications Fonctionnelles (CSF) est un document stratégique et contractuel, rédigé par ou pour le maître d’ouvrage (client, organisation, collectif), qui décrit ce que le système doit faire — indépendamment de la manière dont il sera techniquement réalisé.
Il traduit les besoins métier, les règles de gestion et les attentes utilisateurs en exigences fonctionnelles précises, testables et hiérarchisées, afin de servir de base à la conception, au développement et surtout à la recette fonctionnelle.
Le CSF inclut typiquement :
- Les objectifs du projet et le contexte d’usage,
- La cartographie des utilisateurs (rôles, profils, parcours),
- Les fonctionnalités attendues, détaillées sous forme de cas d’utilisation ou user stories (ex. : « En tant qu’apprenant, je peux télécharger mes certificats au format PDF »),
- Les règles métier (ex. : « Un document non validé ne doit pas être visible publiquement »),
- Les contraintes fonctionnelles (accès restreint, workflows de validation, notifications),
- Les exigences de contenu (types de documents, métadonnées, taxonomies),
- Les critères d’acceptation pour chaque fonctionnalité (« comment on saura que c’est bon »).
Il est indépendant des technologies : il ne mentionne ni WordPress, ni PHP, ni API — seulement ce que l’utilisateur doit pouvoir faire.
CSF vs CST : la règle d’or
| Question | Réponse dans le CSF | Réponse dans le CST |
|---|---|---|
| Quoi ? | Ce que le système doit faire | oui |
| Comment ? | non | Ce que le système va utiliser pour le faire |
| Pour qui ? | Maître d’ouvrage, formateurs, contributeurs | Développeurs, intégrateurs, DevOps |
| Langage | Compréhensible par un non-technicien | Technique, orienté code et infra |
Exemple concret
- CSF : « L’utilisateur peut s’inscrire à une formation et recevoir un email de confirmation. »
- CST : « Inscription via formulaire WordPress + plugin FluentCRM ; email envoyé via SMTP sécurisé (TLS) ; données stockées dans la table wp_users + custom field “formation_id”. »