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 |