Opérationnel en une semaine

Ta première semaine

Un objectif par jour. À la fin de la semaine, tu ouvres ta première pull request en autonomie.

1. 1

   Lundi : poste, Git et conventions

   Installe les outils, clone les projets, lance composer test et npm run dev. Apprends notre nommage de branches et de commits.
2. 2

   Mardi : architecture Laravel

   Suis le trajet d'une requête : route, FormRequest, contrôleur fin, Action, Resource.
3. 3

   Mercredi : tests Pest

   Écris un test Feature et un test Unit pour une Action existante. Lance la couverture.
4. 4

   Jeudi : front Next.js

   Structure, traductions JSON FR/EN, skeletons, formulaires validés par Zod.
5. 5

   Vendredi : première PR

   Prends un ticket étiqueté good-first-issue, déroule la checklist, demande une revue.

Les règles qui ne se discutent pas

Si tu ne retiens que ça, tes revues de code passeront du premier coup.

• Aucun texte en dur dans l'interface : tout passe par messages/fr et messages/en.
• Toute donnée entrante est validée deux fois : Zod côté Next.js, FormRequest côté Laravel.
• Un contrôleur ne contient pas de logique métier : il délègue à une Action.
• Pas de fonctionnalité sans test Pest, pas de bug corrigé sans test qui le reproduit.
• Chaque chargement a un skeleton qui a la forme du contenu final.
• TypeScript strict, pas de any, pas de @ts-ignore sans commentaire.
• Aucun secret dans le code ni dans une variable NEXT_PUBLIC_.
• Petites PR (moins de 400 lignes), CI verte avant de demander une revue.

Versions de référence

Sur un nouveau projet, on part de la colonne cible. Mise à jour : septembre 2026.

Comment lire ce guide

Chaque page suit le même ordre : un schéma pour comprendre, la règle, puis le code à copier. Les encadrés À éviter / À faire montrent les erreurs qu'on voit le plus souvent en revue.