SPB Git

Repository Public

FEATURE_MATRIX.md 17.3 KB 190 lines markdown

1<!--2SP Chat — native macOS3File: docs/FEATURE_MATRIX.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Matrice de parité — chat.spboucher.ai (backend 1.0 « Next Generation ») ↔ SP Chat (macOS natif 2.0.0)89La 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é.10La première partie couvre les ajouts du backend 1.0 (contrat `API-NEXTGEN.md`, système visuel `DESIGN-SYSTEM-V2.md`).1112Légende — **✓** fait · **◐** fait avec un écart documenté · **✗** non fait (justifié) · **+** propre à macOS.13« Vérifié » : `U` test unitaire du cœur, `H` test hébergé dans l'app, `I` test d'intégration contre le serveur de14développement (vrai backend 1.0, vrais modèles), `X` test d'interface (XCUITest), `V` contrôle visuel sur l'app lancée15(captures `docs/img/v2/`), `—` compilé seulement.1617## 2.0 — Modèles, catalogue, fournisseurs1819| Fonction | Native | Vérifié | Notes |20|---|---|---|---|21| 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 |22| 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 |23| 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 |24| 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 |25| Sélecteur : favoris, récents, vérifiés, OpenRouter, recherche instantanée, glyphes, contexte, prix, « catalogue · non testé » | ✓ | H X V | ⇧⌘M ; liste paresseuse |26| 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) |27| 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) |28| Comparaison de 2 à 4 modèles (tableau) → Arena | ✓ | H V | |29| 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) |30| Banc d'essai local (résultats par test), masquer, favori, défaut, actualiser le registre | ✓ | H | Repris de la 1.0 dans la fiche |31| 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) |32| Changement de modèle en cours de conversation, « régénérer avec un autre modèle » (catalogue complet) | ✓ | H I | |33| Avis d'incompatibilité (`applied.ignored`), modèle réellement utilisé, `routing.servedBy` | ✓ | U H I V | |34| « 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 |3536## 2.0 — Conversation3738| Fonction | Native | Vérifié | Notes |39|---|---|---|---|40| 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 | |41| Commandes `/` (prompts à `{{variables}}`, profils, modèles, outils) et `@` (modèle) | ✓ | U H X V | Navigation clavier ↑ ↓ ⏎ ⇥ esc depuis le champ de texte |42| 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é** |43| 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é) |44| Smart Follow-Ups (`followups`, réglage `assistant.followUps`) | ✓ | U H I V | Un clic envoie la suite |45| Coût « facturé » / « estimé » (`exactCost`), détails de réponse | ✓ | U H I V | |46| Panneau Contexte (`/context`) : mesuré, estimation étiquetée, fichiers, outils, coût | ✓ | U H I V | |47| Chronologie + relecture (`/timeline`) | ✓ | U H I V | Événements `image` décodés comme `file` (aucun exemple réel) |48| 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 |49| Branches : arbre (`/tree`), nom de branche, bifurcation avec nom, variantes | ✓ | U H I V | |50| Recherche avancée : modèle, fournisseur, dates, projet, auteur, type de fichier, favoris, sémantique | ✓ | U I | Popover non contrôlé visuellement |51| Bibliothèque de prompts : variables, insertion rapide | ✓ | U H | |52| Instructions permanentes (`instructions`), réglage des suites | ✓ | — | Écran non exercé contre le serveur |53| 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 |5455## 2.0 — Espace de travail et synchronisation5657| Fonction | Native | Vérifié | Notes |58|---|---|---|---|59| 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 |60| Export d'Arena (`/api/compare/export`, Markdown / JSON) | ✓ | H I | Panneau d'enregistrement non exercé |61| 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) |62| 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é) |63| Centre de commandes ⌘K : actions, conversations, modèles, projets, prompts, outils / web, Arena, réglages | ✓ | H X | |64| 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 |65| 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é** |6667## 2.0 — Propre à macOS6869| Fonction | État | Vérifié |70|---|---|---|71| Glisser-déposer de fichiers / texte sur la fenêtre et sur l'icône du Dock | + | — |72| Menus et raccourcis des nouveautés (⇧⌘M, ⇧⌘I, ⌥⌘I / T / L / B, ⌥⌘E / A / G) | + | X (⇧⌘M, ⌥⌘A, ⌥⌘G, ⌥⌘T) |73| Chat rapide avec le compositeur V2 | + | — |74| Notifications de fin de génération, onglets de fenêtres, Coup d'œil, plein écran | + | — (inchangés depuis la 1.0) |7576---7778# Matrice d'origine — web 0.3.0 ↔ SP Chat 1.0.07980Audit fait sur le dépôt `chat-spboucher-ai` (commit `7c9e3f3`, puis `52ec509` après l'ajout du fichier d'association Apple) : 271 fichiers,8154 routes d'API lues une à une. Le backend est **conservé tel quel** ; l'app native est un second client du même serveur, donc82l'historique, les brouillons, les fichiers, la mémoire et les réglages sont partagés avec le site.8384Légende — **✓** reproduit · **◐** reproduit avec un écart documenté · **✗** non reproduit (justifié) · **+** propre à macOS.85« Vérifié » indique *comment* le point a été contrôlé : `U` test unitaire du cœur, `H` test hébergé dans l'app, `I` test86d'intégration contre le serveur de développement (vrai backend, vrais modèles), `V` contrôle visuel sur l'app lancée,87`—` compilé seulement (voir docs/TEST_REPORT.md, section « Non vérifié »).8889## Accès et sécurité9091| Fonction web | Native | Vérifié | Notes |92|---|---|---|---|93| 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` |94| 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 » |95| 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) |96| Ré-authentification pour les opérations sensibles (`403 reauth_required`) | ✓ | U I | Demandée une fois puis la requête est rejouée |97| Gestion des passkeys (ajouter, renommer, révoquer), des appareils, journal de sécurité | ✓ | I (lecture, codes, révocation) | Réglages → Sécurité |98| `/lock`, déconnexion | ✓ | H I | Révoque sur le serveur, efface le cache local et les fichiers |99| Session terminée ailleurs → retour à l'écran de connexion | ✓ | H I | |100| Transition 0.2 → 0.3 (ancien cookie) | ✗ | | Fermée côté serveur ; sans objet pour un nouveau client |101| CSRF (en-tête `Origin` exact sur chaque mutation) | ✓ | U I | |102103## Conversation104105| Fonction web | Native | Vérifié | Notes |106|---|---|---|---|107| 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 |108| 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 |109| Clé d'idempotence : un message, une génération, même après plusieurs tentatives | ✓ | U | |110| Arrêt explicite (le serveur annule, le texte partiel est conservé) | ✓ | H I | ⌘. |111| Régénérer (aussi avec un autre modèle), reprendre une réponse incomplète | ✓ | H I | |112| Modifier un message et renvoyer | ✓ | H I | |113| Versions d'un tour (◀ 1/2 ▶), branche vers une nouvelle conversation | ✓ | H I | |114| Approbation d'appels d'outils en attente | ✓ | H | |115| États de fin : complète · arrêtée · incomplète · échec | ✓ | U V | |116| Markdown, tableaux, listes de tâches, citations | ✓ | U H V | Rendu SwiftUI natif (swift-markdown pour l'analyse) |117| Blocs de code avec coloration et copie | ✓ | U V | Tokeniseur natif (~40 langages) |118| Formules LaTeX en ligne et en bloc | ✓ | U H V | CoreText via SwiftMath ; TeX non composable → affiché tel quel |119| Raisonnement (repliable), appels d'outils (entrée / sortie), citations, images générées | ✓ | H V | |120| Puces jetons / coût / latence / TTFT, paramètres appliqués et ignorés | ✓ | V | Détail dans l'inspecteur (⌥⌘I) |121| Brouillons côté serveur, repris sur tout appareil | ✓ | I | |122| 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 |123| 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 |124| Sélection de texte | ◐ | V | Par bloc (paragraphe, code, cellule) ; « Copier la réponse » copie tout (texte + RTF) |125126## Conversations, recherche, organisation127128| Fonction web | Native | Vérifié | Notes |129|---|---|---|---|130| Liste, épinglées d'abord, groupes par date | ✓ | H V | |131| Filtres toutes / favoris / épinglées / archives | ✓ | U I | |132| Renommer, épingler, favori, archiver, déplacer vers un projet, supprimer (confirmation) | ✓ | H I | |133| Recherche titres + texte des messages (plein texte + sémantique) | ✓ | H I | ⌘F ; extraits surlignés, clic → message mis en évidence |134| Export conversation Markdown / JSON (avec ou sans versions) | ✓ | U I | Généré localement : fonctionne hors ligne |135| Mode hors ligne (page `/offline` du PWA) | ✓ + | U H | Cache SQLite : liste, fils complets déjà ouverts, recherche plein texte locale |136137## Modèles138139| Fonction web | Native | Vérifié | Notes |140|---|---|---|---|141| Seuls les modèles vérifiés et disponibles sont sélectionnables | ✓ | U H | |142| Sélecteur par fournisseur, recherche, favoris, défaut | ✓ | H V | ⇧⌘M |143| Routage manuel / auto / rapide / qualité / économie | ✓ | U H | |144| Effort de raisonnement (niveaux acceptés par le modèle), outils on/off | ✓ | H | |145| Profils d'usage (presets) | ✓ | H | |146| 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 |147| Fournisseurs OpenAI, Anthropic, xAI | ✓ | I (Anthropic) | L'app ne connaît aucune clé d'API : elles restent sur le serveur |148149## Espace de travail150151| Fonction web | Native | Vérifié | Notes |152|---|---|---|---|153| 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) |154| Bibliothèque de prompts | ✓ | — | « Utiliser » pré-remplit une nouvelle conversation, n'envoie jamais |155| Profils d'usage (création, édition) | ✓ | — | |156| 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 |157| 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 |158| Mémoire (approuver, désactiver, éditer, ajouter, exporter) | ✓ | — | |159| Utilisation (coûts, limites, par modèle, par type) | ◐ | — | Swift Charts ; plage personnalisée, vue par projet et courbe 12 mois non reprises |160| 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 |161| Recherche approfondie (suivi, reprise, exports MD / DOCX / JSON) | ◐ | — | Sélecteur de projet et impression PDF non repris |162| Images (génération, galerie) | ◐ | — | Édition d'image et choix du modèle d'image non repris |163| Réglages mémoire, dépenses, intégrations | ✓ | — | |164| Export complet, suppression totale (phrase + passkey récente) | ✓ | — | |165166## Propre à macOS167168| Fonction | État | Vérifié |169|---|---|---|170| `NavigationSplitView`, barre d'outils native, inspecteur, feuilles et popovers, clair / sombre automatique, plein écran | + | V |171| Fenêtres multiples (une conversation par fenêtre, état partagé), restauration des fenêtres | + | H · restauration : — |172| Barre de menus complète et raccourcis (⌘N, ⌘F, ⌘K, ⌘,, ⌘⏎, ⌘., ⇧⌘R, ⇧⌘M, ⌥⌘I, ⌥⌘1…9…) | + | V (menus) |173| Palette de commandes ⌘K (commandes, modèles, conversations, recherche floue) | + | H |174| Chat rapide (panneau flottant, ⇧⌘Espace, raccourci global ⌥⌘Espace optionnel) | + | — |175| Icône de barre des menus optionnelle | + | — |176| Glisser-déposer et collage enrichi (fichiers, images) dans le compositeur | + | — |177| Copie enrichie (Markdown + RTF) | + | H |178| Export PDF natif paginé (CoreText, texte sélectionnable) | + | H |179| Liens profonds `spchat://c/<id>` et `spchat://new?text=…` (jamais d'action destructive ni d'envoi) | + | H |180| Notifications de fin de réponse (optionnelles, permission demandée à l'activation) | + | — |181| Taille du texte (⌘+ / ⌘-), VoiceOver : libellés sur tous les boutons-icônes | + | — (audit VoiceOver non fait) |182183## Écarts assumés (récapitulatif)1841851. **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.1862. **Sélection continue sur plusieurs blocs** : limite de `Text` SwiftUI ; compensée par la copie de la réponse entière.1873. **Sous-fonctions secondaires** de Comparer, Recherche, Images, Projets, Utilisation et du laboratoire de modèles (listées ci-dessus).1884. **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.1895. **Interface en français uniquement** (comme le site).190
Files main
Menu

Theme