SPB Git

Repository Public

FEATURE_MATRIX.md 17.3 KB

# Matrice de parité — chat.spboucher.ai (backend 1.0 « Next Generation ») ↔ SP Chat (macOS natif 2.0.0)

La version 2.0.0 est une mise à niveau de la 1.0.0 : tout ce que décrit la matrice d'origine (plus bas) est conservé. La première partie couvre les ajouts du backend 1.0 (contrat API-NEXTGEN.md, système visuel DESIGN-SYSTEM-V2.md).

Légende — ✓ fait · ◐ fait avec un écart documenté · ✗ non fait (justifié) · + propre à macOS. « Vérifié » : U test unitaire du cœur, H test hébergé dans l'app, I test d'intégration contre le serveur de développement (vrai backend 1.0, vrais modèles), X test d'interface (XCUITest), V contrôle visuel sur l'app lancée (captures docs/img/v2/), — compilé seulement.

# 2.0 — Modèles, catalogue, fournisseurs

Fonction Native Vérifié Notes
Champs route / creator / logo / status: catalog / categories / catalog / lastUsedAt, décodage tolérant ✓ U I Valeurs inconnues conservées, ligne malformée ignorée sans faire échouer le catalogue
Catalogue OpenRouter (routes=all, ≈ 450 modèles), cache local, rafraîchi sur l'événement model ✓ U H I Cache SQLite (models.v2) ; identifiants or:… partout
Identité : logo du fabricant + nom exact + badge « OPENROUTER » (plus de pastille de couleur) ✓ H V 44 logos monochromes + 26 couleur générés par Scripts/sync-logos.py ; fabricant sans logo → monogramme neutre
Route local (MacLustr AI) : badge « LOCAL », section du sélecteur, filtre et catégorie de l'Explorateur, faits locaux (quantification, licence, révision, servi par), coût « local · 0 $ », fournisseur local (test, clé) ✓ U H I Tour réel sur local:maclustr-qwen3 ; pose / révocation de la clé locale sur transport scripté seulement ; rendu contrôlé hors écran, pas dans l'app lancée
Sélecteur : favoris, récents, vérifiés, OpenRouter, recherche instantanée, glyphes, contexte, prix, « catalogue · non testé » ✓ H X V ⇧⌘M ; liste paresseuse
Dock des favoris (PATCH /api/models {dock}) ✓ H I V Barre compacte au-dessus du compositeur ; ajout / retrait / ordre par menu contextuel (pas de glisser pour réordonner)
Explorateur : recherche, filtres (fabricant, route, capacités, catégories, prix, contexte, gratuit, poids ouverts, favoris), tri ✓ U H X V Règle de chaque catégorie affichée (texte du serveur)
Comparaison de 2 à 4 modèles (tableau) → Arena ✓ H V
Live Model Intelligence (/api/models/detail) : faits, prix, mesuré sur ce compte, points de terminaison, bancs tiers, jumeaux ✓ U H I V Chaque bloc porte sa source ; bloc absent si le serveur ne l'envoie pas. Code status des points de terminaison non affiché (non défini par le contrat)
Banc d'essai local (résultats par test), masquer, favori, défaut, actualiser le registre ✓ H Repris de la 1.0 dans la fiche
Réglages → Fournisseurs : état, test, pose / rotation / révocation des clés OpenRouter et Tavily, ré-authentification rejouée ◐ U H I (lecture, test) V Pose / révocation couvertes par transport scripté uniquement : jamais exercées contre un serveur (clés du serveur de développement préservées)
Changement de modèle en cours de conversation, « régénérer avec un autre modèle » (catalogue complet) ✓ H I
Avis d'incompatibilité (applied.ignored), modèle réellement utilisé, routing.servedBy ✓ U H I V
« Modèle suggéré » (route-suggest, consultatif) ✓ I Pastille discrète au-dessus du compositeur ; ne change jamais le modèle seule. Non contrôlée visuellement

# 2.0 — Conversation

Fonction Native Vérifié Notes
Compositeur V2 : capsule flottante, plateau de pièces jointes, outils par tour (toolNames), bascule Recherche web (settings.webSearch), puce de modèle, effort / avancé, dictée ✓ H I X V
Commandes / (prompts à {{variables}}, profils, modèles, outils) et @ (modèle) ✓ U H X V Navigation clavier ↑ ↓ ⏎ ⇥ esc depuis le champ de texte
Animations : hauteur du compositeur, surbrillance au dépôt, présence Lumen, Model Morphing, Conversation Flow, panneaux ◐ V (statique) Implémentées et désactivées sous « Réduire les animations » ; jugées sur captures, pas sur enregistrement vidéo ni à 120 Hz mesuré
Cartes de sources (citation), outils en une ligne (séries repliées), blocs de code V2 ✓ U H I V Cartes sans favicon (rien n'est téléchargé)
Smart Follow-Ups (followups, réglage assistant.followUps) ✓ U H I V Un clic envoie la suite
Coût « facturé » / « estimé » (exactCost), détails de réponse ✓ U H I V
Panneau Contexte (/context) : mesuré, estimation étiquetée, fichiers, outils, coût ✓ U H I V
Chronologie + relecture (/timeline) ✓ U H I V Événements image décodés comme file (aucun exemple réel)
Response Lens (cinq lentilles, étapes, sources, stockage, coût) ◐ U H I (résumé) V Lentille verify : affichage contrôlé sur une lentille réelle stockée, exécution non lancée depuis l'app ; pas de reprise après coupure du flux
Branches : arbre (/tree), nom de branche, bifurcation avec nom, variantes ✓ U H I V
Recherche avancée : modèle, fournisseur, dates, projet, auteur, type de fichier, favoris, sémantique ✓ U I Popover non contrôlé visuellement
Bibliothèque de prompts : variables, insertion rapide ✓ U H
Instructions permanentes (instructions), réglage des suites ✓ — Écran non exercé contre le serveur
Artefacts : Markdown, LaTeX, tableaux CSV / TSV, code, JSON (plan repliable), SVG natifs ; HTML / React / Mermaid : source + navigateur ◐ — Politique 1.0 conservée (aucun moteur web) ; aperçus JSON / CSV / LaTeX compilés, non exercés

# 2.0 — Espace de travail et synchronisation

Fonction Native Vérifié Notes
Arena : toutes routes, colonnes en streaming, premier jeton / durée / jetons / coût, préférer, juge, adopter, historique ◐ U H I V Pas de pièces jointes ni de prompt système dans l'écran
Export d'Arena (/api/compare/export, Markdown / JSON) ✓ H I Panneau d'enregistrement non exercé
Cost Intelligence : par route, facturé vs estimé, par conversation, par modèle, budget + alerte, périodes ◐ U H I V Filtre par fournisseur seulement (pas par route ni projet)
Constellation (/api/constellation) : graphe natif, mise en page hors fil principal, survol, ouverture, légende basis ◐ U H I V Gestes (déplacement, zoom, survol) non exercés ; pas de tabulation entre nœuds (liste accessible à côté)
Centre de commandes ⌘K : actions, conversations, modèles, projets, prompts, outils / web, Arena, réglages ✓ H X
Synchronisation : flux GET /api/events, rattrapage GET /api/sync à l'activation, resync, reconnexion progressive ✓ U H I Conversations, conversation ouverte, modèles / favoris / dock, réglages, projets, prompts, profils, mémoire, fournisseurs
Brouillons hors ligne conservés puis poussés (le plus récent gagne) ◐ U H Arbitrage testé ; retour de réseau réel non exercé

# 2.0 — Propre à macOS

Fonction État Vérifié
Glisser-déposer de fichiers / texte sur la fenêtre et sur l'icône du Dock + —
Menus et raccourcis des nouveautés (⇧⌘M, ⇧⌘I, ⌥⌘I / T / L / B, ⌥⌘E / A / G) + X (⇧⌘M, ⌥⌘A, ⌥⌘G, ⌥⌘T)
Chat rapide avec le compositeur V2 + —
Notifications de fin de génération, onglets de fenêtres, Coup d'œil, plein écran + — (inchangés depuis la 1.0)

# Matrice d'origine — web 0.3.0 ↔ SP Chat 1.0.0

Audit fait sur le dépôt chat-spboucher-ai (commit 7c9e3f3, puis 52ec509 après l'ajout du fichier d'association Apple) : 271 fichiers, 54 routes d'API lues une à une. Le backend est conservé tel quel ; l'app native est un second client du même serveur, donc l'historique, les brouillons, les fichiers, la mémoire et les réglages sont partagés avec le site.

Légende — ✓ reproduit · ◐ reproduit avec un écart documenté · ✗ non reproduit (justifié) · + propre à macOS. « Vérifié » indique comment le point a été contrôlé : U test unitaire du cœur, H test hébergé dans l'app, I test d'intégration contre le serveur de développement (vrai backend, vrais modèles), V contrôle visuel sur l'app lancée, — compilé seulement (voir docs/TEST_REPORT.md, section « Non vérifié »).

# Accès et sécurité

Fonction web Native Vérifié Notes
Connexion par passkey (WebAuthn, vérification utilisateur obligatoire) ✓ U H I · Touch ID réel : voir TEST_REPORT AuthenticationServices (Touch ID / trousseau iCloud / appareil à proximité / clé de sécurité). Même cérémonie serveur, même origine https://chat.spboucher.ai
Première passkey par code à usage unique (bootstrap), codes de récupération ✓ U H I Écran d'accueil → « Première connexion sur ce Mac »
Session serveur révocable, rotation du jeton après chaque vérification ✓ U I Jeton dans le trousseau du Mac (jamais dans UserDefaults ni sur disque en clair)
Ré-authentification pour les opérations sensibles (403 reauth_required) ✓ U I Demandée une fois puis la requête est rejouée
Gestion des passkeys (ajouter, renommer, révoquer), des appareils, journal de sécurité ✓ I (lecture, codes, révocation) Réglages → Sécurité
/lock, déconnexion ✓ H I Révoque sur le serveur, efface le cache local et les fichiers
Session terminée ailleurs → retour à l'écran de connexion ✓ H I
Transition 0.2 → 0.3 (ancien cookie) ✗ Fermée côté serveur ; sans objet pour un nouveau client
CSRF (en-tête Origin exact sur chaque mutation) ✓ U I

# Conversation

Fonction web Native Vérifié Notes
Envoi, streaming SSE en temps réel ✓ U H I V Mise à l'écran plafonnée à ~30 images/s quel que soit le débit de jetons
Générations détachées : reprise après coupure (after=<index>), run disparu → rechargement ✓ U H I Chien de garde de silence 45 s, reconnexion avec recul exponentiel
Clé d'idempotence : un message, une génération, même après plusieurs tentatives ✓ U
Arrêt explicite (le serveur annule, le texte partiel est conservé) ✓ H I ⌘.
Régénérer (aussi avec un autre modèle), reprendre une réponse incomplète ✓ H I
Modifier un message et renvoyer ✓ H I
Versions d'un tour (◀ 1/2 ▶), branche vers une nouvelle conversation ✓ H I
Approbation d'appels d'outils en attente ✓ H
États de fin : complète · arrêtée · incomplète · échec ✓ U V
Markdown, tableaux, listes de tâches, citations ✓ U H V Rendu SwiftUI natif (swift-markdown pour l'analyse)
Blocs de code avec coloration et copie ✓ U V Tokeniseur natif (~40 langages)
Formules LaTeX en ligne et en bloc ✓ U H V CoreText via SwiftMath ; TeX non composable → affiché tel quel
Raisonnement (repliable), appels d'outils (entrée / sortie), citations, images générées ✓ H V
Puces jetons / coût / latence / TTFT, paramètres appliqués et ignorés ✓ V Détail dans l'inspecteur (⌥⌘I)
Brouillons côté serveur, repris sur tout appareil ✓ I
Lecture à voix haute (TTS), dictée (STT) ◐ — Implémentés (lecteur natif, micro demandé à la première dictée) ; pas d'essai audio réel
Artefacts HTML / React / Mermaid en aperçu vivant ◐ — Écart volontaire : aucun moteur web embarqué. Source colorée, copie, enregistrement, « Ouvrir dans le navigateur » ; aperçu natif pour SVG et Markdown
Sélection de texte ◐ V Par bloc (paragraphe, code, cellule) ; « Copier la réponse » copie tout (texte + RTF)

# Conversations, recherche, organisation

Fonction web Native Vérifié Notes
Liste, épinglées d'abord, groupes par date ✓ H V
Filtres toutes / favoris / épinglées / archives ✓ U I
Renommer, épingler, favori, archiver, déplacer vers un projet, supprimer (confirmation) ✓ H I
Recherche titres + texte des messages (plein texte + sémantique) ✓ H I ⌘F ; extraits surlignés, clic → message mis en évidence
Export conversation Markdown / JSON (avec ou sans versions) ✓ U I Généré localement : fonctionne hors ligne
Mode hors ligne (page /offline du PWA) ✓ + U H Cache SQLite : liste, fils complets déjà ouverts, recherche plein texte locale

# Modèles

Fonction web Native Vérifié Notes
Seuls les modèles vérifiés et disponibles sont sélectionnables ✓ U H
Sélecteur par fournisseur, recherche, favoris, défaut ✓ H V ⇧⌘M
Routage manuel / auto / rapide / qualité / économie ✓ U H
Effort de raisonnement (niveaux acceptés par le modèle), outils on/off ✓ H
Profils d'usage (presets) ✓ H
Laboratoire de modèles (statut, capacités, prix, banc d'essai, masquer, favori, défaut, actualiser le registre) ◐ — Onglets « rapport de benchmark » et « routage » (fichiers Markdown du banc) non repris
Fournisseurs OpenAI, Anthropic, xAI ✓ I (Anthropic) L'app ne connaît aucune clé d'API : elles restent sur le serveur

# Espace de travail

Fonction web Native Vérifié Notes
Projets (instructions, modèle par défaut, notes, conversations, fichiers, export) ◐ — Onglets mémoire / artefacts du projet et téléversement depuis le projet non repris (faits depuis Fichiers et Mémoire)
Bibliothèque de prompts ✓ — « Utiliser » pré-remplit une nouvelle conversation, n'envoie jamais
Profils d'usage (création, édition) ✓ —
Fichiers (bibliothèque, indexation, aperçu, ré-indexation, suppression, quota) ◐ — Aperçu Quick Look de l'original au lieu du texte extrait ; téléversement toujours rattaché à un projet
Pièces jointes dans le compositeur (PDF, DOCX, XLSX, CSV, texte, images, audio) ✓ U H I Type vérifié sur les octets réels avant l'envoi ; HEIC → JPEG ; photos réduites à 2048 px
Mémoire (approuver, désactiver, éditer, ajouter, exporter) ✓ —
Utilisation (coûts, limites, par modèle, par type) ◐ — Swift Charts ; plage personnalisée, vue par projet et courbe 12 mois non reprises
Comparer 2–6 modèles, juge, préférée, historique ◐ — « Adopter dans la conversation d'origine », images jointes et prompt système non repris
Recherche approfondie (suivi, reprise, exports MD / DOCX / JSON) ◐ — Sélecteur de projet et impression PDF non repris
Images (génération, galerie) ◐ — Édition d'image et choix du modèle d'image non repris
Réglages mémoire, dépenses, intégrations ✓ —
Export complet, suppression totale (phrase + passkey récente) ✓ —

# Propre à macOS

Fonction État Vérifié
NavigationSplitView, barre d'outils native, inspecteur, feuilles et popovers, clair / sombre automatique, plein écran + V
Fenêtres multiples (une conversation par fenêtre, état partagé), restauration des fenêtres + H · restauration : —
Barre de menus complète et raccourcis (⌘N, ⌘F, ⌘K, ⌘,, ⌘⏎, ⌘., ⇧⌘R, ⇧⌘M, ⌥⌘I, ⌥⌘1…9…) + V (menus)
Palette de commandes ⌘K (commandes, modèles, conversations, recherche floue) + H
Chat rapide (panneau flottant, ⇧⌘Espace, raccourci global ⌥⌘Espace optionnel) + —
Icône de barre des menus optionnelle + —
Glisser-déposer et collage enrichi (fichiers, images) dans le compositeur + —
Copie enrichie (Markdown + RTF) + H
Export PDF natif paginé (CoreText, texte sélectionnable) + H
Liens profonds spchat://c/<id> et spchat://new?text=… (jamais d'action destructive ni d'envoi) + H
Notifications de fin de réponse (optionnelles, permission demandée à l'activation) + —
Taille du texte (⌘+ / ⌘-), VoiceOver : libellés sur tous les boutons-icônes + — (audit VoiceOver non fait)

# Écarts assumés (récapitulatif)

  1. Aperçus vivants d'artefacts HTML / React / Mermaid : exclus par la règle « aucun WebView ». Remplacés par la source colorée et l'ouverture dans le navigateur.
  2. Sélection continue sur plusieurs blocs : limite de Text SwiftUI ; compensée par la copie de la réponse entière.
  3. Sous-fonctions secondaires de Comparer, Recherche, Images, Projets, Utilisation et du laboratoire de modèles (listées ci-dessus).
  4. Enregistrement d'une clé de sécurité matérielle : la connexion par clé de sécurité est proposée, l'enregistrement se fait pour la clé de plateforme du Mac.
  5. Interface en français uniquement (comme le site).
Files main
Menu

Theme