Bienvenue dans votre Voyage Architectural

Vous voici au début d’une aventure unique : construire une architecture robuste et évolutive en utilisant le Domain-Driven Design (DDD) avec API Platform. Ce guide interactif vous accompagnera pas à pas, en s’adaptant à votre niveau et à vos besoins spécifiques.

Pourquoi ce Guide Existe-t-il ?

Avec Gyroscops, j’ai vécu les défis de l’architecture logicielle moderne :

  • Comment structurer un code qui évolue avec les besoins métier ?
  • Comment gérer la complexité croissante sans perdre en maintenabilité ?
  • Comment choisir les bons patterns au bon moment ?

L’architecture logicielle est un domaine où les compromis sont permanents et où chaque choix mérite d’être remis en question. Ce guide est le fruit de cette expérience, transformée en parcours interactif qui s’adapte à votre contexte.

Le Contexte de l’Évolution du Métier

L’arrivée de la GenAI et de la programmation agentique transforme progressivement le métier de développeur. Cette évolution change la façon dont nous concevons et développons des logiciels.

La nouvelle réalité : Ceux qui maîtrisent l’architecture métier et savent orchestrer les outils IA sont plus efficaces.

Pourquoi l’Impact Mapping, l’Event Storming et l’Example Mapping deviennent-ils importants ?

  • Les IA peuvent coder, mais elles ne savent pas quoi coder
  • Les IA peuvent implémenter, mais elles ne comprennent pas comment structurer
  • Les IA peuvent générer du code, mais elles ne savent pas quand appliquer les règles

Découvrir pourquoi ces méthodes sont importantes dans l’ère de la GenAI

Votre Parcours Personnalisé

Chapitre 1 : Les Fondamentaux

Commencez par comprendre les concepts de base du DDD et de l’Event Storming. C’est votre point de départ, quel que soit votre niveau.

Chapitres 2-10 : Les Concepts Essentiels

Explorez les techniques qui transforment votre approche du développement :

  • Impact Mapping : Aligner le produit sur les objectifs business
  • Event Storming : Découvrir la complexité métier
  • Example Mapping : Détailer les règles métier
  • Architecture Événementielle : Structurer autour des événements
  • Repositories : Gérer la persistance des données

Chapitres 11-15 : Les Patterns Avancés

Plongez dans les patterns qui élèvent votre architecture :

  • Event Sourcing : Stocker l’historique complet
  • CQRS : Séparer lecture et écriture
  • Projections : Optimiser les performances

Chapitres 22-51 : Les Implémentations Concrètes

Découvrez comment implémenter ces concepts avec différents types de stockage :

  • SQL : Données relationnelles classiques
  • MongoDB : Données semi-structurées
  • ElasticSearch : Recherche et analytics
  • API : Intégrations externes
  • In-Memory : Cache haute performance
  • Temporal Workflows : Orchestration complexe
  • Multi-sources : Agrégation de données

Le Principe du “Livre dont Vous Êtes le Héros”

Ce guide fonctionne comme un “livre dont vous êtes le héros” : à la fin de chaque chapitre, vous trouvez des choix interactifs qui vous guident vers le contenu le plus pertinent pour votre situation.

Comment ça Marche ?

  1. Lisez un chapitre : Apprenez un concept ou une technique
  2. Découvrez vos options : À la fin, des choix vous sont proposés
  3. Choisissez votre prochaine étape : Selon votre contexte et vos besoins
  4. Continuez votre parcours : Chaque choix vous mène vers un nouveau chapitre

Exemple Concret

Après avoir lu le chapitre sur l’Event Storming, vous pourrez choisir :

  • Option A : Découvrir l’Example Mapping (si vous voulez détailler les règles métier)
  • Option B : Comprendre la complexité architecturale (si vous voulez choisir une architecture)
  • Option C : Voir des exemples de modèles (si vous voulez passer à l’implémentation)

Adaptation à Votre Niveau

  • Débutant : Les choix vous guident vers les concepts de base
  • Intermédiaire : Vous pouvez sauter aux patterns qui vous intéressent
  • Expert : Plongez directement dans les implémentations avancées

Contexte Gyroscops

Chaque concept est illustré par des exemples concrets tirés de l’expérience Gyroscops, dans l’écosystème User → Organization → Workflow → Cloud Resources → Billing.

Conseils pour Bien Démarrer

Si Vous Êtes Débutant

  1. Commencez par le Chapitre 1 : Les concepts de base sont essentiels
  2. Suivez l’ordre : Les chapitres s’appuient les uns sur les autres
  3. Pratiquez : Chaque concept doit être testé dans votre contexte

Si Vous Êtes Expérimenté

  1. Choisissez votre parcours : Les choix interactifs vous guideront
  2. Plongez dans les implémentations : Les chapitres 22+ sont pour vous
  3. Adaptez : Chaque pattern doit être adapté à votre contexte

Si Vous Êtes en Équipe

  1. Formez-vous ensemble : L’Event Storming est collaboratif
  2. Partagez les concepts : Chaque membre doit comprendre l’architecture
  3. Implémentez progressivement : Commencez simple, évoluez

Votre Prochaine Étape

Prêt à commencer ? Choisissez l’option A pour plonger dans les fondamentaux, ou explorez les autres options selon vos besoins.

Besoin d’aide ? Chaque chapitre contient des exemples concrets et des conseils pratiques tirés de l’expérience Gyroscops.

Envie d’approfondir ? Le guide couvre tous les aspects, des concepts de base aux implémentations avancées.

Commencez Votre Aventure

🎯 Votre Prochaine Étape

Maintenant que vous comprenez les concepts de base et que j'ai partagé mon expérience avec Gyroscops, quel est votre contexte ?

A

Je veux commencer par les fondamentaux

Vous voulez comprendre les concepts de base du DDD et de l'Event Storming

Critères d'adoption :

  • Développeur de tous niveaux
  • Besoin de comprendre les concepts de base
  • Projet à structurer
  • Équipe à former
B

Je veux voir la vue d'ensemble des chapitres

Vous voulez comprendre l'organisation complète du guide

Critères d'adoption :

  • Besoin de vue d'ensemble
  • Équipe en réflexion
  • Planification de formation
  • Architecture à définir
C

Je veux comprendre le concept du guide

Vous voulez comprendre l'ambition et la philosophie de ce guide

Critères d'adoption :

  • Besoin de contexte
  • Équipe en réflexion
  • Compréhension du projet
  • Philosophie architecturale
D

Je veux voir des exemples concrets

Vous voulez comprendre les implémentations pratiques

Critères d'adoption :

  • Développeur expérimenté
  • Besoin d'exemples pratiques
  • Implémentation à faire
  • Code à écrire

Ce guide est le fruit de l’expérience acquise avec Gyroscops, transformée en parcours interactif pour vous accompagner dans votre propre aventure architecturale.