Version française
La documentation technique de Balyze est rédigée en anglais. Les pages en français sont des traductions pouvant avoir un léger décalage.
Balyze — Documentation technique
Cette documentation décrit les fondations techniques, les règles métier et les décisions architecturales qui structurent Balyze.
Balyze est actuellement en phase ALPHA privée, centrée sur la validation du domaine cœur et des workflows avant ouverture à des utilisateurs externes.
Statut du projet
- Phase : ALPHA (usage privé)
- Objectif : v0 / BETA (tests externes limités)
- Approche : backend-first, orientée domaine
- Public cible : développeurs et mainteneurs du projet
Cette documentation reflète l’état actuel du projet et évoluera avec sa maturation.
Ce que couvre cette documentation
Cette documentation traite principalement de :
- l’architecture et la stack technique
- les conventions de nommage et les règles structurelles
- les concepts métier et règles de domaine
- le cycle de vie et les règles d’éditabilité
- les principes de sécurité (authentification, rôles, permissions)
L’objectif est de rendre les décisions explicites, et non de détailler chaque implémentation.
Ce que cette documentation ne couvre pas
À ce stade, la documentation ne comprend pas :
- de guides utilisateur
- de documentation UI ou captures d’écran
- de documentation d’API publique
- de guides de déploiement détaillés
Ces sujets seront introduits progressivement à mesure que le produit atteindra la BETA puis la v1.
Comment lire cette documentation
- Commencez par Architecture pour comprendre la structure du projet
- Poursuivez avec Domaine pour saisir les règles métier
- Consultez Sécurité pour les mécanismes d’accès et permissions
- Utilisez les tags pour identifier les contenus liés à une phase ou un sujet précis
Principes directeurs
- les règles métier sont définies avant l’implémentation
- la documentation explique le pourquoi, pas le comment
- la simplicité prime sur l’optimisation prématurée
- la dette technique est évitée par des décisions explicites
Contribution et évolution
Cette documentation est un artefact vivant. Elle évolue en parallèle du code et reflète les choix intentionnels faits durant le développement.
Les fonctionnalités instables ou spéculatives sont volontairement exclues.