Retour au parcours
FAQ & Pièges courants
Les erreurs fréquentes et comment les éviter.
Les questions qui reviennent le plus souvent, et les pièges à éviter avant de livrer.
Les pièges courants
Évite les parenthèses, accents et espaces : ils cassent certains outils Git. Reste sur des minuscules avec des tirets, ex. feat/add-logout-button.
Le serveur logue avec Pino, pas avec console.log. ESLint signale les console.log : remplace-les par le logger ou supprime-les avant de livrer.
any est interdit (erreur ESLint). Type correctement la donnée, ou utilise unknown puis valide avec Zod si le type est vraiment inconnu.
Le projet est en ESM : on utilise import / export, jamais require() ni module.exports. Convertis en syntaxe import.
Après une modification du schéma Prisma, génère et applique la migration (db:migrate:dev). Sans elle, la prod échouera avec « column does not exist ».
On ne pousse jamais en direct sur main. On travaille sur une branche, puis on ouvre une merge request qui passe la CI avant d’être fusionnée.
Certaines librairies sont bannies (lodash, jest, tailwind, xlsx…). Demande à l’Agent l’alternative recommandée (APIs natives, Vitest, MUI, exceljs).
Questions fréquentes
Les commits locaux Replit et les commits distants ont des identifiants différents. Lance le workflow « Sync local to origin » pour aligner les deux historiques.
Le message ne respecte probablement pas le format conventionnel. Vérifie : type(scope): description, en anglais et sur une seule ligne (ex. fix(auth): handle expired token).
Ouvre le job qui a échoué et lis l'erreur (souvent un problème de lint ou un test cassé). Corrige le point signalé, puis repousse. Rien n'est livré tant que tout n'est pas vert.
Le code, les commits et les commentaires sont en anglais. Seuls les textes affichés aux utilisateurs restent en français.
Vérifie que le workflow de développement tourne et qu'il a bien été redémarré après tes changements. Un rafraîchissement forcé du navigateur aide parfois.
Lance npm run audit:dsi, ou demande simplement à l'Agent de vérifier la conformité avant de livrer.