Étude de cas · Cockpit opérateur
Ana Concierge OS
Un cockpit local-first pour le suivi de dossiers, dans lequel un assistant peut rédiger, citer et proposer, et une personne approuve chaque action.
- Rôle
- Seul développeur
- Technologies
- TypeScript, React, Fastify, PostgreSQL, zod, Vitest
- Statut
- Socle local fonctionnel ; actions sortantes volontairement hors périmètre
- Couches
- Interfaces, systèmes, modèles, données et évaluation
- Construit par moi
- Une personne, ou un modèle externe
- OpérateurUne personne
- Serveur AnaConstruit par moi
- ModèleVia un exécuteur borné
- Opérateur vers serveur Ana : Pose une question sur un dossier
- Serveur Ana : Reconstruit le contexte depuis PostgreSQL
- Serveur Ana : Récupère les passages dans le périmètre
- Serveur Ana vers modèle : Prompt et passages ; pas de shell, pas d’outils généraux
- Modèle : Rédige une réponse
- Modèle vers serveur Ana : JSON conforme au schéma : réponse, citations, action proposée
- Serveur Ana : Rejette les citations non récupérées et les actions hors périmètre
- Serveur Ana : Hache la proposition et la met en file
- Serveur Ana vers opérateur : Réponse avec sources ; proposition en attente de validation
- Opérateur : Approuve ou rejette
- Opérateur vers serveur Ana : Décision
- Serveur Ana : L’enregistre dans la piste d’audit
La frontière appartient à l’architecture
Le travail de conciergerie est un flux de dossiers : des personnes, des demandes, des relances, des documents, et les connaissances nécessaires pour bien répondre. Un assistant peut aider sur tout cela, à condition de ne jamais inventer de source et de ne jamais agir seul.
Ana Concierge OS est ma tentative d’inscrire cette frontière dans l’architecture plutôt que dans un prompt. Il tourne en local, garde son état dans PostgreSQL et traite le modèle comme un outil de rédaction dont le serveur vérifie la sortie et qu’une personne approuve.
Six décisions qui gardent l’assistant honnête
- 01 · Systèmes
Des dossiers avec des règles et un historique
Dossiers, relations, tâches et relances vivent dans PostgreSQL derrière une API Fastify typée, avec des règles de dossier déterministes, des files de travail quotidiennes et une piste d’audit.
J’ai construit l’API Fastify sur Node.js, avec une validation zod des paramètres de route, des chaînes de requête et des corps de requête. Les routes /v1/* exigent un jeton bearer.
- 02 · Systèmes
Un contexte reconstruit côté serveur
Chaque tour de l’assistant part d’un état canonique reconstruit depuis la base de données, et non de ce dont la conversation se souvenait par hasard.
- 03 · Données
Une récupération bornée
Les sources de connaissances sont normalisées, découpées et relues avant d’être activées. La recherche utilise le plein texte de PostgreSQL, filtré par espace de travail, dossier, état de relecture, date et classification, et chaque récupération laisse une trace.
- 04 · Modèles
Un modèle tenu en laisse courte
L’exécuteur local lance le client du modèle sans shell, passe le prompt sur l’entrée standard, désactive les outils généraux, exige un JSON conforme au schéma et s’arrête en cas de délai dépassé.
- 05 · Systèmes
Citations vérifiées, validation humaine
Le serveur rejette toute citation d’un passage qui n’a pas été récupéré, et toute action hors du périmètre de la conversation. Les propositions sont hachées et attendent dans une file de validation qu’une personne décide.
- 06 · Données
Des imports qui restent locaux
Les imports de documents sont locaux, bornés, vérifiés par hachage et mis en attente jusqu’à relecture, sans aucun appel au modèle.
Un cockpit qui montre son incertitude
Une interface React responsive avec une vue du jour des priorités, ainsi que les dossiers, relations, connaissances, imports, validations et un assistant persistant. Les réponses de l’assistant montrent leurs citations, leur incertitude et les actions suggérées au lieu de les cacher.
Un mode de découverte synthétique permet d’explorer tout le produit sans aucune donnée opérationnelle.
Des tests là où se trouve la frontière
Les tests unitaires et d’intégration couvrent les validations, la sûreté de l’assistant, la récupération de connaissances, la confidentialité et l’acceptation des imports de documents, ainsi que l’isolation de l’exécuteur du modèle. Des scripts de smoke test exercent l’API et l’assistant de bout en bout.
Ce que c’est, et ce que ce n’est pas
Statut. Un socle local fonctionnel pour le suivi de dossiers ; je ne cite aucun chiffre d’usage ou d’adoption.
Périmètre. Les connecteurs sortants vers la messagerie, l’e-mail et les calendriers, ainsi que toute action autonome, en sont volontairement exclus. La récupération est une recherche lexicale PostgreSQL ; les embeddings pourront venir plus tard.
