Aller au contenu principal

Base de données

Toutes les données persistantes résident dans une seule base de données relationnelle, choisie par DB_URL dans backend/.env :

MoteurDB_URLRemarques
SQLite (par défaut)sqlite:///a2flow.dbFichier local, sans configuration
PostgreSQLpostgresql://user:password@host:5432/a2flowUtilisé par la pile Docker Compose

Le suffixe du pilote asynchrone (aiosqlite / asyncpg) est ajouté automatiquement. Les changements de schéma sont suivis sous forme de migrations Alembic versionnées et appliqués automatiquement au démarrage : c'est le redéploiement de l'application (un redémarrage de conteneur) qui lance les migrations en attente, si bien qu'aucune étape de migration distincte n'est nécessaire.

La base de données assure aussi la coordination d'un backend à plusieurs réplicas : une exécution d'agent détient un verrou consultatif PostgreSQL pendant toute la durée de son flux SSE, de sorte qu'une conversation n'est jamais pilotée par deux réplicas à la fois. Voir Mise à l'échelle horizontale pour ce que cela protège et la contrainte que cela impose sur le regroupement des connexions.

Ce qu'elle contient​

TableContenu
usersLes utilisateurs de l'application et les rôles qui leur sont accordés ; voir Utilisateurs et groupes
auth_sessionsLes sessions de connexion côté serveur
login_failuresLes échecs de connexion récents, comptés pour verrouiller un compte en cas de tentatives répétées ; les lignes de plus d'un jour sont supprimées
impersonation_eventsLa piste d'audit des sessions d'emprunt d'identité
agent_skillsLes définitions de compétences d'agent et le dépôt d'où chacune est clonée
mcp_serversLes serveurs MCP enregistrés et la façon de les joindre
knowledge_bases, knowledge_sources, knowledge_pagesLes bases de connaissances : les documents importés et les URL enregistrées de chacune, et les pages rédigées à partir de ceux-ci
secretsLes ensembles d'identifiants nommés, chiffrés localement ou référencés dans Vault
workflowsLes définitions de workflows et leur état dans leur cycle de vie
workflow_task_templatesLa liste de tâches conçue à l'avance pour un workflow
workflow_published_versionsLa conception figée au moment de la publication, d'après laquelle s'exécute un workflow à l'état modifié
workflow_executionsUne ligne par exécution, avec les métadonnées du workflow et de la compétence figées au lancement
workflow_tasksLes tâches individuelles d'une exécution, copiées depuis les modèles
workflow_task_tool_bindingsLes outils MCP liés à une tâche
message_metaLes informations par message des deux discussions partagées : qui a envoyé le message et quelle tâche était en cours

La suppression d'un workflow s'étend à ses modèles, mais laisse intactes ses exécutions passées : une exécution est le compte rendu de ce qui s'est passé, et non une partie de la conception dont elle est issue.