notes

README.md

@@ -162,6 +162,23 @@ Qu'est-ce que tu sais sur SAFTCO ?
 
 La memoire peut contenir des clients, projets, taches, notes et depots Git associes a un projet.
 
+### Architecture de la memoire
+
+L'assistant utilise une architecture en deux niveaux :
+
+- les ecritures passent par des actions controlees (`ajouter_client`, `ajouter_tache`, `terminer_tache`, etc.) ;
+- les lectures et analyses passent par un routeur LLM qui peut generer une requete SQL readonly sur le schema SQLite.
+
+Ce choix evite de coder une action specifique pour chaque question possible. Par exemple, `quel client a le plus de taches ?`, `quelles sont mes taches a faire ?` ou `cette tache est pour quel client ?` peuvent etre resolus en lisant la base plutot qu'en ajoutant des routes rigides.
+
+Le routeur recoit le dernier message, l'historique recent, le schema de la base et un extrait de la memoire. Il decide entre :
+
+- executer une action d'ecriture autorisee ;
+- lancer une lecture SQL readonly ;
+- demander une clarification si la cible est ambigue.
+
+Les requetes SQL generees sont limitees a des `SELECT` et passent par une validation readonly dans `memory.py`.
+
 ## Notes
 
 - Groq Orpheus TTS doit etre accepte dans la console Groq pour fonctionner :