# 📗 Engineering Handbook ## Introduction Ce handbook définit les standards d'ingénierie appliqués à l'ensemble de nos projets logiciels. Il sert de **référence commune** pour tous les développeurs, qu'ils interviennent sur le frontend, le backend ou le devops. L'objectif n'est pas de sur-documenter, mais de : * Clarifier la manière dont nous construisons les logiciels * Garantir une qualité constante entre les projets * Faciliter la collaboration et la maintenance * Accélérer l'onboarding des nouveaux développeurs --- ## Portée du Handbook Ce document couvre : * Les standards de développement frontend * Les standards de développement backend * Les standards de développement devops * Les conventions communes (outils, workflow, qualité) Il ne remplace pas la documentation projet spécifique, mais fournit un **socle commun obligatoire**. --- ## Philosophie Générale Nos standards reposent sur des principes simples : * Utiliser les **conventions natives des frameworks** avant d'introduire des abstractions * Favoriser un code lisible et explicite * Privilégier des structures simples et évolutives * Éviter la complexité inutile * Construire des systèmes faciles à maintenir par une autre équipe --- ## Structure du Handbook Le handbook est organisé en documents distincts : ### 📘 Standards de Développement Frontend * Basés sur Next.js et l'écosystème React * Organisation du code, conventions, bonnes pratiques UI * Gestion de l'état, des erreurs et des performances ### 📕 Standards de Développement Backend * Basés sur NestJS * Organisation par modules, services et controllers * Sécurité, gestion des données et exploitation ### 📗 Standards de Développement Devops * Basés sur les standards devops (voir la page devops) Chaque document doit être lu et appliqué indépendamment, selon le périmètre du projet. --- ## Application des Standards Ces standards sont : * Applicables à tous les nouveaux projets * Progressivement appliqués aux projets existants * Utilisés comme référence lors des code reviews Toute dérogation doit être **justifiée techniquement** et documentée. --- ## Responsabilité La qualité du code est une responsabilité collective. Chaque développeur est tenu de : * Respecter ces standards * Signaler les incohérences ou points d'amélioration * Contribuer à l'évolution du handbook lorsque nécessaire --- ## Évolution du Handbook Ce document est vivant. Il évolue en fonction : * Des retours terrain * Des contraintes projets * De l'évolution des frameworks et outils Les modifications doivent être discutées et validées avant adoption.