Documentation

IntroductionPremiers pasLe CanvasTypes de NodesConnexionsCalquesTemplatesHistoriqueCollaborationOrganisationsMode EmbedRaccourcis clavier

Mode Presentation

Creez des presentations interactives de votre architecture avec Architecture Stories. Slides, spotlight et navigation clavier.

Vue d'ensemble#

Le mode Presentation (Architecture Stories) vous permet de creer des parcours narratifs a travers votre architecture. Ideal pour :

  • Onboarding technique : Presenter l'architecture aux nouveaux developpeurs
  • Revues d'architecture : Guider une discussion structuree
  • Documentation vivante : Creer des walkthroughs interactifs
  • Presentations clients : Expliquer votre infrastructure

Concept#

Une presentation est composee de slides. Chaque slide :

  • Met en spotlight un ou plusieurs composants
  • Affiche un titre et une description
  • Contient des notes du presentateur (optionnelles)
  • Zoome automatiquement sur la zone concernee
┌─────────────────────────────────────────────────────────────────────────┐
│  Mode Presentation                                      [×] Quitter     │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│                         ┌─────────────┐                                 │
│      (fondu 20%)        │    API      │  ← Spotlight (100% opacite)     │
│                         │   Gateway   │                                 │
│                         └─────────────┘                                 │
│                                                                         │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │ "L'API Gateway centralise l'authentification et le rate limiting" │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                         │
│    [←]  Etape 2 / 5 : "API Gateway"  [→]           ● ● ◉ ● ●           │
└─────────────────────────────────────────────────────────────────────────┘

Creer une presentation#

Ouvrir l'editeur#

  1. Cliquez sur le bouton Presentation dans la toolbar
  2. Ou utilisez le raccourci Cmd+Shift+P (Ctrl+Shift+P sur Windows)

L'editeur de presentation s'ouvre dans un panneau lateral.

Nouvelle presentation#

  1. Cliquez sur Nouvelle presentation
  2. Donnez un nom descriptif (ex: "Onboarding Architecture API")
  3. Ajoutez une description optionnelle
  4. Cliquez sur Creer

Ajouter des slides#

Pour chaque slide :

  1. Cliquez sur + Ajouter un slide
  2. Donnez un titre au slide
  3. Selectionnez les nodes a mettre en spotlight :
    • Cliquez sur les nodes du canvas pour les selectionner
    • Ou utilisez la selection multiple
  4. Ajoutez une description explicative
  5. (Optionnel) Ajoutez des notes du presentateur

Reorganiser les slides#

  • Drag & drop : Glissez-deposez pour reordonner
  • Supprimer : Cliquez sur l'icone corbeille

Capturer la vue actuelle#

Le bouton Capturer la vue cree un slide a partir de :

  • La position et le zoom actuels du canvas
  • Les nodes actuellement selectionnes

C'est le moyen le plus rapide de construire une presentation.

Lancer une presentation#

Demarrer#

  1. Dans l'editeur, cliquez sur Lancer a cote de la presentation
  2. Ou double-cliquez sur la presentation
  3. Le mode plein ecran s'active automatiquement

Controles#

ActionClavierSouris/Tactile
Slide suivant→ ou Espace ou EntreeClic sur zone droite
Slide precedent←Clic sur zone gauche
Aller a un slideClic sur indicateur de progression—
Plein ecranFBouton plein ecran
QuitterEchapBouton ×

Indicateur de progression#

En bas de l'ecran, des points indiquent votre position dans la presentation :

  • Point plein : Slide actuel
  • Points vides : Autres slides
  • Clic sur un point : Aller directement au slide

Notes du presentateur#

Les notes ne sont pas affichees pendant la presentation. Elles sont destinees a l'orateur pour se rappeler des points cles a mentionner.

Pour les consulter pendant la presentation, utilisez un deuxieme ecran avec l'editeur ouvert.

Effet Spotlight#

Le spotlight est le coeur de l'experience de presentation :

  1. Nodes en focus : Affichage a 100% d'opacite, couleurs vives
  2. Autres nodes : Fondu a 20% d'opacite
  3. Zoom automatique : La vue s'ajuste pour montrer les nodes en focus
  4. Transition fluide : Animation entre les slides

L'effet spotlight aide l'audience a se concentrer sur la partie pertinente de l'architecture.

RaccourciAction
→Slide suivant
←Slide precedent
EspaceSlide suivant
EntreeSlide suivant
EchapQuitter la presentation
FBasculer plein ecran
HomePremier slide
EndDernier slide

Support mobile#

Les presentations sont consultables sur mobile et tablette :

  • Gestes tactiles : Pinch-to-zoom et drag-to-pan
  • Tap gauche/droite : Navigation entre slides
  • Orientation : Mode paysage recommande

Export PDF#

Exportez votre presentation en PDF :

  1. Ouvrez l'editeur de presentation
  2. Selectionnez la presentation
  3. Cliquez sur Exporter PDF

Chaque slide devient une page du PDF avec :

  • Le titre
  • La capture du canvas avec spotlight
  • La description

Ideal pour partager avec des personnes sans acces a l'application.

Bonnes pratiques#

Structure recommandee#

  1. Introduction : Vue d'ensemble complete (tous les nodes)
  2. Parcours logique : Suivre le flux de donnees ou la hierarchie
  3. Focus progressif : Du general au specifique
  4. Conclusion : Retour a la vue d'ensemble

Taille des slides#

  • 5-10 slides pour une presentation courte (5 min)
  • 15-20 slides pour une presentation complete (15 min)
  • Pas de limite technique

Annotations#

Utilisez les descriptions pour :

  • Expliquer le role du composant
  • Mentionner les technologies utilisees
  • Signaler les points d'attention
  • Poser des questions a l'audience

Cas d'usage#

Onboarding developpeur#

  1. Vue d'ensemble de l'architecture
  2. Point d'entree (API Gateway, Frontend)
  3. Services backend (un par un)
  4. Couche de donnees
  5. Infrastructure (monitoring, logs)

Revue de securite#

  1. Vue d'ensemble
  2. Points d'entree externes
  3. Composants d'authentification
  4. Flux de donnees sensibles
  5. Zones de confiance

Presentation client#

  1. Vue utilisateur (frontend, mobile)
  2. Infrastructure backend (haut niveau)
  3. Garanties (replicas, backups)
  4. Points de contact (API, webhooks)

FAQ#

Puis-je modifier une presentation en cours ?#

Oui. Fermez le mode presentation (Echap), modifiez dans l'editeur, puis relancez. Les modifications sont sauvegardees automatiquement.

Les presentations sont-elles partagees ?#

Oui. Tous les membres du projet avec acces en lecture peuvent voir et lancer les presentations. Seuls les membres avec acces en ecriture peuvent les modifier.

Puis-je copier une presentation vers un autre projet ?#

Pas directement. Recreez la presentation manuellement. Cette fonctionnalite est prevue pour une future version.

Le spotlight fonctionne-t-il avec les groupes ?#

Oui. Vous pouvez mettre en spotlight un groupe entier. Tous les nodes du groupe seront mis en evidence.

Prochaines etapes#

  • Canvas : Maitrisez les interactions du canvas
  • Collaboration : Travaillez en equipe sur vos presentations
  • Export : Exportez votre architecture