Architecture
Vue d'ensemble du monorepo Vantablvck, du modèle de données et du pipeline d'une requête.
Vantablvck est un monorepo géré avec Nx sur le runtime Bun. Chaque application et chaque package a une responsabilité unique, avec des interfaces explicites entre eux plutôt qu'un couplage fort.
Cette section décrit l'ossature technique du projet, de la vue macro jusqu'au chemin exact que suit une requête.
Dans cette section
- Vue d'ensemble : les applications, les packages, et les décisions pensées pour l'échelle.
- Modèle de données : les tables métier et leurs relations.
- Pipeline d'une requête : les macros de sécurité Elysia et le typage de bout en bout.
- Structure du projet : l'arborescence du monorepo, dossier par dossier.
Principe directeur
L'architecture sépare trois plans. Le plan synchrone (l'API Elysia répond vite), le plan asynchrone (un worker traite le travail lourd via une file de jobs), et le plan de stockage (PostgreSQL pour les données, un stockage objet compatible S3 pour les médias). Ce découpage est ce qui permet au projet de rester hébergeable en solo tout en pouvant scaler chaque plan séparément le jour venu.
Le socle actuel comprend le schéma métier, les packages partagés et l'authentification. La couche API typée (Eden Treaty), le worker asynchrone et les modules métier (posts, feed, modération) sont conçus mais pas encore construits. Chaque page le précise là où c'est le cas.