É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
Fig. 1 · Un tour de l’assistant, de la question à la piste d’audit
  • Construit par moi
  • Une personne, ou un modèle externe
  • OpérateurUne personne
  • Serveur AnaConstruit par moi
  • ModèleVia un exécuteur borné
  1. Opérateur vers serveur Ana : Pose une question sur un dossier
  2. Serveur Ana : Reconstruit le contexte depuis PostgreSQL
  3. Serveur Ana : Récupère les passages dans le périmètre
  4. Serveur Ana vers modèle : Prompt et passages ; pas de shell, pas d’outils généraux
  5. Modèle : Rédige une réponse
  6. Modèle vers serveur Ana : JSON conforme au schéma : réponse, citations, action proposée
  7. Serveur Ana : Rejette les citations non récupérées et les actions hors périmètre
  8. Serveur Ana : Hache la proposition et la met en file
  9. Serveur Ana vers opérateur : Réponse avec sources ; proposition en attente de validation
  10. Opérateur : Approuve ou rejette
  11. Opérateur vers serveur Ana : Décision
  12. Serveur Ana : L’enregistre dans la piste d’audit
Contexte

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.

Ce que j’ai construit

Six décisions qui gardent l’assistant honnête

  1. 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.

  2. 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.

  3. 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.

  4. 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é.

  5. 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.

  6. 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.

Interface

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.

Vérification

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.

Statut et périmètre

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.