Principes d'Ingénierie

Standards techniques et règles de l'art appliqués sur le projet Codexia.

1. Qualité du Code

• SOLID & Design Patterns : Application des principes de conception orientée objet pour un code découplé et testable.
• Typage strict : Utilisation systématique du typage fort de PHP 8.x pour réduire les erreurs à l'exécution.
• Clean Code : Priorité à la lisibilité. Le code doit être sa propre documentation (nommage explicite, fonctions courtes).

2. Sécurité par conception (Security by Design)

• Audit permanent : Chaque fonctionnalité commence par une analyse des risques (voir inputs/legacy/todo.md pour l'historique des corrections de sécurité).
• Protection des données : Hachage systématique des secrets, protection CSRF, validation stricte des entrées et rate limiting.
• Moindre privilège : Configuration fine des rôles (Voters) et des accès système.

3. Workflow de développement

• GitFlow : Utilisation stricte de master pour la production, develop pour l'intégration et des branches éphémères pour les tickets.
• Lien Ticketing-Code : Chaque commit/branche porte un identifiant lisible (ex: CDX-110-description).
• Revue de code : Même en solo, utilisation de l'IA et de l'auto-revue pour valider les changements avant merge.

4. Excellence Opérationnelle

• Automatisation : Utilisation de scripts pour les tâches répétitives (migrations, sync de doc).
• Observabilité : Mise en place de logs structurés pour faciliter le debug en production.
• Performance : Optimisation des requêtes SQL et mise en cache stratégique (HTTP Cache, ETag).