Skip to content

📓 Journal de Bord (Devlogs)

Bienvenue dans les coulisses techniques de L'Atelier du Bois.

Cette section documente l'évolution du projet, de l'initialisation des fondations jusqu'aux problématiques complexes de logistique et d'architecture. Chaque log retrace mes réflexions, les défis rencontrés et les choix technologiques effectués pour garantir une qualité professionnelle.

🚀 Chronologie du développement

Phase 1 : Fondations & Structure

  • Mise en place du catalogue, de la pagination et du filtrage dynamique.
  • Choix des UUID Base 62 et optimisation des types de données SQL.

Phase 2 : Qualité & Évolutions

  • Implémentation du système d'avis et calculs de moyennes.
  • Introduction des premiers tests unitaires.

Phase 3 : L'Excellence Architecturale

Phase 4 : Logique Métier Avancée

  • Découpage des commandes en expéditions (Shipments).
  • Calculs de colisage basés sur le poids et les dimensions.

Phase 5 : Robustesse & Transporteurs

  • Recherche insensible aux accents via PostgreSQL (unaccent).
  • Architecture multi-transporteurs et suivi de colis.

Phase 6 : Extensibilité & Outillage

  • Pattern Factory pour la gestion multi-transporteurs.
  • Machine à états (getNextStatus) pour les flux de commande.
  • Migration de Postman vers Bruno pour un versionnement Git-friendly de l'API.

Phase 7 : Robustesse & Documentation Métier

  • Endpoint historique des années de commandes.
  • Intégration de PHPStan pour l'analyse statique.
  • Correction de bugs dans la gestion des adresses.
  • Insight : formaliser les règles métier dans MkDocs pour une collaboration IA/frontend fiable.

Phase 8 : Génération de Features par l'IA

  • Génération itérative de features complexes avec l'IA.
  • CRUD des commentaires avec règles métier strictes (délais, statut commande).
  • Pattern : Voter + Service pour les règles d'autorisation temporelles.
  • Synthèse des bonnes pratiques de prompt pour une architecture contrainte.

Si vous souhaitez comprendre ma manière de concevoir une API robuste, je vous recommande de commencer par le Devlog #3 (Le Grand Refacto) qui détaille la structure actuelle du code source.