SPB Git

Repository Public

PARITY_MATRIX.md 13.8 KB

# Matrice de parité — SP Chat web ↔ SP Chat iOS / iPadOS 2.0 « Next Generation »

Backend visé : chat-spboucher-ai 1.0 (contrat _spchat-nextgen-shared/API-NEXTGEN.md, additif par rapport à la 0.3). L'app native parle au même backend, avec la même API REST + SSE que le site et l'app macOS : aucune API parallèle, aucune donnée dupliquée. La section « 1.0 » ci-dessous reprend l'audit de la version 1 ; la section « 2.0 » couvre ce que la version 2 ajoute.

État : ✅ opérationnel et testé · 🟡 opérationnel, vérification partielle · ⛔ non porté

# 2.0 — Next Generation

Fonction iOS / iPadOS Où Vérifié par
Catalogue unifié (/api/models?routes=all) : modèles directs vérifiés + catalogue OpenRouter, ids or:… partout, décodage tolérant (fournisseur / état inconnus) ✅ AIModel, ModelCatalog, ModelsResponse CatalogueDecodingTests, CatalogueStoreTests, live theWholeCatalogueLoadsWithMakersRoutesAndLogos
Route locale MacLustr AI (route: local, ids local:…) : badge « LOCAL », section « Local (MacLustr) » dans la feuille des modèles, filtre de l'Explorateur, faits du service (quantification, licence, révision, servi par), coût « local · 0 $ », fournisseur géré comme OpenRouter ✅ AIModel (isLocal, impliedRoute, costLabel), RouteBadge, ModelSheet, ExplorerView, ModelDetailView, ProvidersView aLocalModelDecodesWithItsRouteAndServiceFacts, theLocalProviderRowDecodesLikeAManageableRoute, live aTurnWithTheLocalRouteCostsNothing, UI
Logos des créateurs (registre partagé → assets vectoriels, monogramme neutre sinon), badge de route « OPENROUTER » ✅ Scripts/sync-logos.py, LogoRegistry, ModelMark, ModelChip, RouteBadge everyRegistryLogoIsBundledAndUnknownMakersGetAMonogram, UI
Système visuel V2 « Graphite & Iris · Lumen » (jetons, matériaux, typographie Dynamic Type, animations signature) ✅ Components/DesignSystem.swift, Theme.swift captures docs/img/v2/
Compositeur signature : pièces jointes, dictée, outils du tour (toolNames), recherche web (settings.webSearch), ModelChip, effort / options avancées, commandes rapides /, mention de modèle @, lumen pendant la génération ✅ ChatComposer, TurnOptionsSheet sendOptionsCarryWebSearch…, theToolPickerBecomesAToolSubset, UI
Feuille des modèles : dock des favoris (PATCH /api/models {dock}), récents, vérifiés, catalogue OpenRouter avec recherche instantanée, glissements favori / dock / défaut ✅ ModelSheet CatalogueQueryTests, favouritesAndDock…, live dockFavourites…, UI
Explorateur de modèles : recherche, filtres (créateur, route, capacités, catégories, prix, contexte, gratuit, poids ouverts), tri, favoris, récents, comparaison 2–3 (iPhone) / 4 (iPad) ✅ ExplorerView, ModelCompareView, ModelQuery CatalogueQueryTests, UI testExplorerSearchFiltersDetailAndCompare
Live Model Intelligence (/api/models/detail) : faits, prix, banc local, mesures du compte, points de terminaison, bancs tiers avec leur source, jumeaux ✅ ModelDetailView, ModelDetail liveModelIntelligenceKeepsEveryBlockWithItsSource, live, UI
Fournisseurs et clés (test, définir / remplacer / révoquer OpenRouter et Tavily via le serveur, ré-authentification, actualiser le catalogue) 🟡 ProvidersView, ProvidersModel ProviderKeyTests, live aKeyRefusedByTheProviderChangesNothing, UI ; l'enregistrement d'une vraie clé et la révocation n'ont pas été exécutés (ils changeraient la configuration du serveur de dev)
Tour : changement de modèle en cours de conversation, « régénérer avec un autre modèle », paramètres ignorés (applied.ignored), modèle réellement utilisé + servedBy, coût « facturé » / « estimé » ✅ ChatBubble, ChatView, StreamReducer TurnAdditionsTests, live anOpenRouterTurn…, parametersTheModelDoesNotAccept…
Cartes de sources (citation), ligne d'appel d'outil, suggestions de suite (followups, réglage assistant.followUps) ✅ SourceCards, ToolCallLine, FollowUpChips idem + UI
Synchronisation : flux GET /api/events, rattrapage GET /api/sync, resync, reconnexion progressive, curseur persistant, brouillons hors ligne repoussés ✅ SyncEngine, SyncPlan, AppEnvironment.apply SyncPlanTests, SyncEngineTests, OfflineDraftTests, live theSyncFeedReportsAChangeMadeByAnotherClient
Arène (/api/compare) : 2–6 modèles, pages (iPhone) / colonnes (iPad), mesures, préférer, juge, reprise dans la conversation, export 🟡 ArenaView, ArenaSession ArenaEventTests, ArenaStateTests, ArenaSessionTests, live, UI ; juge et reprise vérifiés contre un serveur scénarisé seulement
Lentilles de réponse (5 lentilles, flux, étapes + sources pour verify, lentilles enregistrées, coût) ✅ LensSheet, LensRunner LensTests, live (une lentille réelle), UI
Chronologie + relecture ✅ TimelineSheet, TimelineReplay TimelineTests, live, UI
Branches : arbre (/tree), nommer, bifurquer avec libellé, versions ✅ BranchesSheet, ChatView (alerte) TreeAndContextTests, live
Inspecteur de contexte (/context, estimation étiquetée) ✅ ContextSheet TreeAndContextTests, live, UI
Recherche avancée (modèle, route, dates, projet, type de fichier, favoris, rôle, sémantique) ✅ SearchView, SearchFilters SearchFiltersTests, live
Centre de commandes (bouton d'en-tête, ⌘K sur iPad) 🟡 CommandCenterView, CommandCenterIndex CommandCenterIndexTests, UI (ouverture, recherche, exécution d'une commande) ; flèches / Retour au clavier matériel non exercés
Coûts : par route, facturé / estimé, par conversation, budget + alerte ✅ UsageView CostIntelligenceTests, live, UI
Prompts : variables {{…}}, favoris, insertion rapide (/) ✅ PromptStore, PromptLibraryView, PromptVariablesSheet promptVariablesAreFoundAndFilled, live
Projets : édition (instructions, modèle par défaut, couleur), suppression ✅ ProjectsView ProjectPatchTests, live
Instructions permanentes (instructions) ✅ InstructionsView, AccountSettings accountSettingsAreAppliedAfterTheServerConfirms
Recherche approfondie (/api/research/*) 🟡 ResearchView, ResearchSession ResearchTests, une recherche réelle ; l'écran d'une recherche en cours n'a pas été relu avec des données réelles
Studio d'images (/api/images) 🟡 ImageStudioView ImageStudioTests, retouche réelle ; la génération simple échoue côté serveur de dev (500, clé étrangère attachments_message_id_fkey)
Constellation (/api/constellation) : graphe natif Canvas, disposition par forces hors du fil principal, légende avec les textes basis ✅ ConstellationView, ForceLayout ForceLayoutTests, ConstellationDecodingTests, live, UI
Modèle suggéré (/api/models/route-suggest), jamais appliqué seul ✅ ChatComposer live providersModelDetailAndRouteSuggestionDecode
Actions rapides de l'écran d'accueil (nouvelle conversation, recherche, arène) 🟡 SystemIntegration QuickActionsTests ; l'appui long réel sur l'icône n'est pas automatisable
Extension de partage ⛔ docs/SHARE_EXTENSION.md conception seulement : exige une capacité sur l'identifiant d'app partagé — en attente d'accord

# 1.0 — socle (inchangé, toujours vérifié)

Fonction du site iOS / iPadOS Où Vérifié par
Connexion par passkey (Face ID / Touch ID / code) 🟡 PasskeyService, SignInView implémenté avec les API officielles ; la cérémonie réelle demande un appareil et iCloud (non exécutable en simulateur sans compte) — à valider sur TestFlight
Enrôlement par code de démarrage / récupération 🟡 SignInView → AuthStore.enroll idem (formulaire testé en UI test)
Ré-authentification des opérations sensibles (403 reauth_required) ✅ HTTPClient.perform test aSensitiveOperationIsReplayedOnceAfterReauthentication
Session persistante, rotation, expiration, révocation ✅ HTTPClient, KeychainSessionTokenStore, AuthStore tests HTTPClient (4) + test live « jeton inconnu »
Déconnexion (révocation serveur + effacement local) ✅ AuthStore.signOut, AppEnvironment.wipeLocalData signOutWipesEveryLocalTrace
Clés d'accès : liste, ajout de cet appareil, renommer, révoquer 🟡 SecurityView liste testée (UI + live) ; ajout/révocation demandent une vraie passkey
Sessions : liste, fermer une / toutes les autres ✅ SecurityView test live + UI
Codes de récupération (génération) 🟡 SecurityView derrière ré-authentification
Liste des conversations, sections par date ✅ ConversationList, ConversationListStore UI tests iPhone + iPad
Filtres (toutes / favoris / épinglées / archives / projet), filtre par titre ✅ ConversationList unitaires + UI
Renommer, épingler, favori, archiver, déplacer vers un projet, supprimer (confirmation) ✅ ConversationList, ChatView (menu) test live aFullConversationLifecycle, UI test (suppression)
Recherche globale (plein texte + sémantique) ✅ SearchView UI test (retrouve un message serveur)
Envoi, streaming SSE, états fin : complet / arrêté / incomplet / erreur ✅ ChatSession, StreamReducer 6 tests reducer, 9 tests session, tests live
Arrêt d'une génération (annulation serveur réelle) ✅ ChatSession.stop test live stopReallyEndsTheGenerationOnTheServer
Reprise après coupure (réattachement, sans doublon) ✅ ChatSession.followLoop aDroppedConnectionReattaches…, aRunStillAliveOnTheServerIsFollowed…
Régénérer, modifier un message, versions ‹ n / m ›, bifurquer vers une nouvelle conversation ✅ ChatBubble, ChatSession test live (régénération, édition, bascule de branche, fork)
Approbation d'appels d'outils 🟡 ChatBubble, ChatSession.resolveToolCalls implémenté ; aucun outil du serveur n'est en mode « approbation » aujourd'hui
Sélecteur de modèle, routage, profils (presets), effort, outils on/off ✅ ModelSheet, TurnOptionsSheet, Preferences UI test + live
Markdown, tableaux, blocs de code colorés + copie, équations LaTeX (bloc et en ligne) ✅ MarkdownParser, MarkdownRenderer, CodeBlockView, MathView 6 tests Markdown + UI test « riche » (aucune vue web)
Raisonnement (repliable), cartes d'outils, citations, images générées ✅ ChatBubble reducer + rendu
Jetons / coût / latence par réponse, détails (paramètres réellement envoyés) ✅ ChatBubble, MessageDetailsSheet UI
Pièces jointes : photothèque, appareil photo, Fichiers, glisser-déposer, coller ; progression, annulation ; réduction des photos / HEIC → JPEG ✅ AttachmentPickers, ChatComposer, ImageTools test live (fichier + image utilisés par le modèle, refus d'un format inconnu)
Aperçu des fichiers (Quick Look), bibliothèque de fichiers ✅ ChatView, FilesView live (octets identiques)
Artefacts 🟡 ArtifactSheet source colorée + partage ; pas d'aperçu exécuté (le site utilise une iframe en bac à sable : pas de vue web dans l'app)
Dictée (STT) 🟡 VoiceRecorder implémentée ; le micro n'existe pas en simulateur — à valider sur appareil
Lecture à voix haute (TTS) 🟡 SpeechPlayer idem (appel serveur testé indirectement)
Brouillons serveur (suivent le compte) ✅ ChatSession test live draftsFollowTheAccount
Prompts enregistrés ✅ PromptLibraryView test live
Mémoire (liste, ajouter, activer / désactiver, supprimer) ✅ MemoryView test live
Projets (filtrer, créer, classer une conversation) ✅ ConversationList, ModelCatalog édition : voir 2.0
Dépenses : limites jour / mois, graphique, par modèle ✅ UsageView (Swift Charts) décodage testé sur données réelles
Export conversation (MD / JSON), export complet ✅ ChatView, DataView test live (MD)
Thème clair / sombre / système, Dynamic Type, VoiceOver, réduction des animations 🟡 partout libellés d'accessibilité posés ; VoiceOver non audité à l'oreille
Laboratoire des modèles (banc d'essai, /models) ⛔ — administration : reste sur le web
Suppression complète des données ⛔ volontaire — reste sur le web, derrière sa phrase de confirmation
Journal de sécurité (auth_events) ⛔ — web

# Propre à iOS (sans équivalent web)

Fonction Où
Lecture hors ligne des conversations déjà téléchargées (SQLite chiffré par iOS) LocalStore
Boîte d'envoi : message écrit hors ligne, marqué « non envoyé », posté une seule fois au retour du réseau ChatSession, AppEnvironment.flushOutbox
Verrouillage de l'app par Face ID / Touch ID (activé par défaut après connexion), masque dans le sélecteur d'apps AppLock, LockView
iPad : barre latérale persistante, Split View / Slide Over, glisser-déposer, raccourcis clavier (⌘N, ⌘⇧F, ⌘L, ⌘., ⌘⇧C, ⌘R, ⌘,) MainView, SPChatApp.commands
Liens profonds spchat://c/<id>, spchat://new?text=, liens universels https://chat.spboucher.ai/c/<id> AppEnvironment.handle(url:)
Raccourcis Siri / Shortcuts : « Nouvelle conversation », « Demander à SP Chat » SystemIntegration.swift
Retours haptiques, notification locale « réponse prête », rafraîchissement en arrière-plan Haptics, AppEnvironment, BackgroundSync
Files main
Menu

Theme