conversations_store
diapason.server.conversations_store
¶
Magasin SQLite des conversations du chat (~/.diapason/conversations.db).
Le serveur est la source de vérité : l'historique vivait dans le localStorage du frontend, cloisonné par origine, et la fenêtre principale (tauri://localhost) et le mini-panneau (http://127.0.0.1:8000) portaient donc chacun le leur — deux historiques qui divergeaient en silence (16 sept. 2026).
Deux choix de conception, chacun né d'un défaut trouvé en revue le même jour :
-
Le curseur des clients est un numéro d'écriture (
seq), pas une heure. Un premier jet filtraitupdated_at > sincesur l'heure du CONTENU fournie par le client : une conversation poussée en retard (vue fermée puis rouverte, serveur relancé pendant la poussée) arrivait avec son vieuxupdatedAtet restait invisible à jamais aux vues dont le curseur avait déjà dépassé cette heure. Chaque écriture prend ici un numéro monotone ; un client qui demandesince=Nreçoit tout ce qui a été écrit après, quelle que soit l'heure que porte le contenu. -
La fusion se fait au grain du MESSAGE, pas de la conversation. Un dernier-écrit-gagne sur la conversation entière faisait perdre des messages dès que deux vues touchaient le même fil dans la fenêtre de synchronisation (une question envoyée depuis le mini-panneau pendant que la fenêtre principale finissait de recevoir sa réponse) : la copie la plus récente écrasait l'autre, question et réponse comprises. :func:
fusionner_conversationsfait l'union des messages par identité, et le frontend applique la MÊME règle (convSync.ts) : quel que soit l'ordre des poussées, toutes les vues convergent vers le même résultat.
Les messages restent opaques pour le serveur hors de leur identité (id,
ou role@timestamp pour les historiques d'avant l'identifiant). Une
suppression laisse une pierre tombale (deleted_at non NULL) dont title
et messages sont vidés — une suppression qui garde le texte n'est pas une
suppression.
ConversationsStore
¶
Conversations vivantes et pierres tombales, numérotées par écriture.
Toutes les vues tournent sur la même machine : les horloges sont
identiques, updatedAt / deletedAt (ms epoch) suffisent pour
départager deux versions d'un même objet. Mais l'ORDRE dans lequel le
serveur apprend les choses, lui, n'a rien à voir avec ces heures — d'où
seq.
delete(conversation_id)
¶
Pose une pierre tombale et rend son deletedAt (ms).
Idempotent, même pour un id inconnu : re-supprimer ce qui n'existe pas doit réussir, sinon deux appareils qui suppriment la même conversation verraient le second échouer pour rien. La tombale vide title et messages — une suppression qui garde le texte n'est pas une suppression.
list(since=None)
¶
Rend (vivantes, tombales, seq) écrites APRÈS le numéro since.
Sans since : tout — vivantes et toutes les tombales non purgées.
seq est le dernier numéro attribué : tout ce qui porte un numéro
inférieur ou égal est dans la réponse (ou plus vieux que since),
le client peut donc y poser son curseur.
upsert(conv)
¶
Fusionne la copie reçue avec la copie stockée. Rend ce que le client doit croire désormais.
- tombale avec
deletedAt >= conv.updatedAt: reste supprimée, rend{"deleted": True, "deletedAt": int}— une suppression qui ressuscite parce qu'un autre appareil a poussé sa vieille copie serait un mensonge (§100). - vivante : la fusion des deux (union des messages, métadonnées de
la plus récente) est stockée si elle diffère de la copie stockée,
rend
{"conversation": <copie stockée>}. Une fusion sans effet n'écrit rien et ne consomme pas de numéro : les autres vues n'ont rien à apprendre. - inconnue, ou tombale plus vieille : stockée telle quelle (la
tombale est effacée), rend
{"conversation": <telle que stockée>}.
cle_message(message)
¶
Identité d'un message : son id, sinon role@timestamp.
Les historiques d'avant l'identifiant n'en portent pas ; sans repli, deux copies du même message se seraient dupliquées à chaque fusion.
fusionner_conversations(a, b)
¶
Jointure commutative et idempotente de deux copies d'une conversation.
Les métadonnées viennent de la copie qui prime, les messages sont
l'union des deux, updatedAt le plus haut, createdAt le plus bas.
Re-fusionner le résultat avec l'une des entrées rend le résultat.
fusionner_messages(des_a, des_b)
¶
Union par identité, la version la plus complète par message, dans l'ordre du temps (puis question avant réponse, puis identité).
sans_substituts(texte)
¶
Remplace tout substitut UTF-16 isolé par U+FFFD.
JSON.stringify (bien-formé depuis ES2019) échappe un demi-surrogat
collé dans un message en \ud800 — JSON valide — que json.loads
rend en str Python porteuse d'un surrogat isolé. Stocké tel quel,
sqlite3 refusait de l'encoder en UTF-8 : 500 sur chaque poussée de la
conversation, qui ne se synchronisait plus jamais (constaté en revue le
16 sept. 2026).