Ordre de construction : contrat API d’abord, puis UI panel et app
UI avant contrat = backend fragile.
Navigation
Dans les projets panel/app, pages d’abord est tentant. UI prod sans contrat API fixé → rework à chaque démo.
Sur l’ordre de construction. Conception API entreprise. Hamranik.
Limite
Pas API-first à tout prix
UI avant contrat = coût caché.
UI en avance ?
Liste jolie ; backend flou → endpoints temporaires.
Pourquoi contrat API d’abord ?
API-first = contrat.
1. Une vérité
Même endpoint
Panel et app partagent le contrat.
2. Moins rework
Données réelles
UI une fois.
3. Parallèle
Front/back
OpenAPI/mock.
4. Acceptation
Fait signable
POST /orders → 201.
Séquence pratique
Ordre : workflow, modèle, contrat, mock, UI, E2E.
Checklist ordre
- Workflow avant endpoints ?
- Schema JSON ?
- Erreurs au contrat ?
- Contrat partagé ?
- Mock ?
- UI non fini sans endpoint ?
- Acceptation sur contrat ?
- Versioning ?
Conclusion : bel UI sans contrat échoue
Contrat API d’abord = livraison plus stable.
UI-first ? Revoyez le contrat.
Clôturer le contrat avant sprint UI
Chez Hamranik : workflow et contrat API d’abord.
FAQ
Zéro UI ?
Non ; contrat avant UI prod.
Vs article design API ?
Principes vs ordre.
UI existant ?
Contrat, gaps, refactor.
MVP ?
Oui.