Guides pratiques¶
Les guides pratiques répondent à une question concrète : « comment faire X ? ». Ils supposent que vous savez déjà ce que vous voulez accomplir. Pas d'introduction, pas de contexte superflu — directement à l'action.
Diátaxis — mode tâche : vous avez un objectif précis. Le guide vous amène au résultat le plus directement possible.
Contribuer au projet¶
| Guide | Quand l'utiliser |
|---|---|
| Workflow contribution et PR | Ouvrir une Pull Request, conventions de commit, rebase |
| Passer la QA avant merge | Checklist des 7 gates QA, sécurité, clippy, tests |
Ajouter des fonctionnalités¶
| Guide | Quand l'utiliser |
|---|---|
| Ajouter une route web | Nouvelle page SSR avec template Askama |
| Ajouter un service métier | Nouveau service avec CRUD, anti-IDOR, tests |
| Ajouter une migration DB | Nouvelle table, colonne, index, contrainte |
| Implémenter des webhooks | Événements sortants avec signature HMAC, retry |
| Implémenter un endpoint API REST | Endpoint JSON v1, DTO, pagination, rate limiting |