Les 4 niveaux d'infrastructure d'Appstrate, du zéro-install au déploiement production complet.

🧩 Le modèle progressif

Appstrate détecte automatiquement les services disponibles au démarrage et adapte son comportement. Chaque composant manquant est remplacé par un fallback embarqué. Vous pouvez commencer sans aucune dépendance externe et ajouter des services au fur et à mesure.

Les adaptateurs d'infrastructure se trouvent dans apps/api/src/infra/ et sont chargés par import dynamique selon les variables d'environnement présentes.

📊 Les 4 tiers

Tier 0 — Zéro-install

Composant	Fallback
Base de données	PGlite (PostgreSQL embarqué en WASM)
Stockage	Système de fichiers local (`./data/storage/`)
File d'attente	En mémoire (BullMQ local)
Pub/Sub	EventEmitter en mémoire

Aucune dépendance externe. Idéal pour le développement et l'évaluation rapide.

cp .env.example .env && bun run dev

Tier 1 — PostgreSQL

Ajoutez DATABASE_URL pour passer à PostgreSQL. Les données deviennent persistantes et le multi-utilisateur fonctionne correctement.

Composant	Source
Base de données	PostgreSQL (`DATABASE_URL`)
Stockage	Système de fichiers local
File d'attente	En mémoire
Pub/Sub	En mémoire

bun run docker:dev:minimal

Tier 2 — PostgreSQL + Redis

Ajoutez REDIS_URL pour activer le scheduling distribué, le rate limiting et le Pub/Sub.

Composant	Source
Base de données	PostgreSQL
Stockage	Système de fichiers local
File d'attente	BullMQ (Redis)
Pub/Sub	Redis Pub/Sub

bun run docker:dev:standard

Tier 3 — Production complète

Ajoutez S3/MinIO (S3_BUCKET) et Docker (RUN_ADAPTER=docker) pour l'isolation conteneur complète.

Composant	Source
Base de données	PostgreSQL
Stockage	S3 / MinIO
File d'attente	BullMQ (Redis)
Pub/Sub	Redis Pub/Sub
Exécution des agents	Conteneurs Docker isolés

bun run docker:dev

📋 Tableau récapitulatif

Tier	Composants	Fallback en l'absence	Cas d'usage
0	Bun uniquement	PGlite + filesystem + file en mémoire	Développement, évaluation
1	+ PostgreSQL (`DATABASE_URL`)	—	Données persistantes, multi-utilisateur
2	+ Redis (`REDIS_URL`)	EventEmitter, Map, BullMQ local	Scheduling, rate limiting, distribué
3	+ S3/MinIO (`S3_BUCKET`) + Docker (`RUN_ADAPTER=docker`)	Filesystem (`./data/storage/`), sous-processus Bun	Production avec isolation conteneur

💡 Recommandation

Pour la production, utilisez le Tier 3 avec un reverse proxy TLS. Le Tier 0 est parfait pour tester Appstrate en quelques secondes sans rien installer. Les Tiers 1 et 2 conviennent aux environnements de staging ou de développement partagé.

Infrastructure progressive