Hiérarchie App → Environnement → Instances

Tout dans Wakastart s'organise autour de l'App.

textCopier
App "Exemple"
├── Architecture (le "blueprint" — ce que tu décris une fois)
│   ├── Repositories       (les dépôts Git)
│   ├── Services           (ServiceDefinitions)
│   ├── Dépendances        (DatabaseDefinitions, StorageBucketDefinitions)
│   └── URLs               (HttpRoutes, sous-domaines, domaines custom)
│
├── Builds                 (images Docker construites à partir du code)
│
└── Environments            (instances concrètes — dev, staging, prod...)
    ├── exemple-dev
    │   ├── ServiceInstances    (une par ServiceDefinition)
    │   ├── DatabaseInstances    (une par DatabaseDefinition)
    │   ├── StorageBucketInstances
    │   ├── Deployments
    │   ├── Variables & secrets
    │   ├── URLs réelles
    │   └── Monitoring
    └── exemple-prod
        └── ... idem

Pourquoi cette séparation Architecture vs Environnement ?

L'Architecture décrit ton app une fois : "j'ai un backend Node.js, une base PostgreSQL, un bucket S3".

Les Environnements instancient cette architecture autant de fois que tu veux : dev, staging, preprod, prod, branche-de-test...

Chaque environnement a ses propres :

• bases de données (chacune sa BDD isolée),
• buckets de stockage,
• URLs (app.dev.exemple.com en dev, app.exemple.com en prod),
• variables de configuration,
• secrets,
• déploiements.

Tu peux donc tester en dev sans toucher à la prod.