Repository Public
1<!--2SP Chat iOS3File: docs/PARITY_MATRIX.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Matrice de parité — SP Chat web ↔ SP Chat iOS / iPadOS 2.0 « Next Generation »89Backend visé : `chat-spboucher-ai` 1.0 (contrat `_spchat-nextgen-shared/API-NEXTGEN.md`, additif par rapport à la 0.3).10L'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,11aucune donnée dupliquée. La section « 1.0 » ci-dessous reprend l'audit de la version 1 ; la section « 2.0 » couvre ce que12la version 2 ajoute.1314État : ✅ opérationnel et testé · 🟡 opérationnel, vérification partielle · ⛔ non porté1516## 2.0 — Next Generation1718| Fonction | iOS / iPadOS | Où | Vérifié par |19|---|---|---|---|20| 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` |21| 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 |22| 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 |23| Système visuel V2 « Graphite & Iris · Lumen » (jetons, matériaux, typographie Dynamic Type, animations signature) | ✅ | `Components/DesignSystem.swift`, `Theme.swift` | captures `docs/img/v2/` |24| 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 |25| 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 |26| 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` |27| 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 |28| 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) |29| 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…` |30| Cartes de sources (`citation`), ligne d'appel d'outil, suggestions de suite (`followups`, réglage `assistant.followUps`) | ✅ | `SourceCards`, `ToolCallLine`, `FollowUpChips` | idem + UI |31| 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` |32| 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 |33| 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 |34| Chronologie + relecture | ✅ | `TimelineSheet`, `TimelineReplay` | `TimelineTests`, live, UI |35| Branches : arbre (`/tree`), nommer, bifurquer avec libellé, versions | ✅ | `BranchesSheet`, `ChatView` (alerte) | `TreeAndContextTests`, live |36| Inspecteur de contexte (`/context`, estimation étiquetée) | ✅ | `ContextSheet` | `TreeAndContextTests`, live, UI |37| Recherche avancée (modèle, route, dates, projet, type de fichier, favoris, rôle, sémantique) | ✅ | `SearchView`, `SearchFilters` | `SearchFiltersTests`, live |38| 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 |39| Coûts : par route, facturé / estimé, par conversation, budget + alerte | ✅ | `UsageView` | `CostIntelligenceTests`, live, UI |40| Prompts : variables `{{…}}`, favoris, insertion rapide (`/`) | ✅ | `PromptStore`, `PromptLibraryView`, `PromptVariablesSheet` | `promptVariablesAreFoundAndFilled`, live |41| Projets : édition (instructions, modèle par défaut, couleur), suppression | ✅ | `ProjectsView` | `ProjectPatchTests`, live |42| Instructions permanentes (`instructions`) | ✅ | `InstructionsView`, `AccountSettings` | `accountSettingsAreAppliedAfterTheServerConfirms` |43| 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 |44| 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`) |45| 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 |46| Modèle suggéré (`/api/models/route-suggest`), jamais appliqué seul | ✅ | `ChatComposer` | live `providersModelDetailAndRouteSuggestionDecode` |47| 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 |48| Extension de partage | ⛔ | `docs/SHARE_EXTENSION.md` | conception seulement : exige une capacité sur l'identifiant d'app partagé — en attente d'accord |4950## 1.0 — socle (inchangé, toujours vérifié)5152| Fonction du site | iOS / iPadOS | Où | Vérifié par |53|---|---|---|---|54| 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 |55| Enrôlement par code de démarrage / récupération | 🟡 | `SignInView` → `AuthStore.enroll` | idem (formulaire testé en UI test) |56| Ré-authentification des opérations sensibles (403 `reauth_required`) | ✅ | `HTTPClient.perform` | test `aSensitiveOperationIsReplayedOnceAfterReauthentication` |57| Session persistante, rotation, expiration, révocation | ✅ | `HTTPClient`, `KeychainSessionTokenStore`, `AuthStore` | tests HTTPClient (4) + test live « jeton inconnu » |58| Déconnexion (révocation serveur + effacement local) | ✅ | `AuthStore.signOut`, `AppEnvironment.wipeLocalData` | `signOutWipesEveryLocalTrace` |59| 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 |60| Sessions : liste, fermer une / toutes les autres | ✅ | `SecurityView` | test live + UI |61| Codes de récupération (génération) | 🟡 | `SecurityView` | derrière ré-authentification |62| Liste des conversations, sections par date | ✅ | `ConversationList`, `ConversationListStore` | UI tests iPhone + iPad |63| Filtres (toutes / favoris / épinglées / archives / projet), filtre par titre | ✅ | `ConversationList` | unitaires + UI |64| Renommer, épingler, favori, archiver, déplacer vers un projet, supprimer (confirmation) | ✅ | `ConversationList`, `ChatView` (menu) | test live `aFullConversationLifecycle`, UI test (suppression) |65| Recherche globale (plein texte + sémantique) | ✅ | `SearchView` | UI test (retrouve un message serveur) |66| Envoi, streaming SSE, états fin : complet / arrêté / incomplet / erreur | ✅ | `ChatSession`, `StreamReducer` | 6 tests reducer, 9 tests session, tests live |67| Arrêt d'une génération (annulation serveur réelle) | ✅ | `ChatSession.stop` | test live `stopReallyEndsTheGenerationOnTheServer` |68| Reprise après coupure (réattachement, sans doublon) | ✅ | `ChatSession.followLoop` | `aDroppedConnectionReattaches…`, `aRunStillAliveOnTheServerIsFollowed…` |69| 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) |70| Approbation d'appels d'outils | 🟡 | `ChatBubble`, `ChatSession.resolveToolCalls` | implémenté ; aucun outil du serveur n'est en mode « approbation » aujourd'hui |71| Sélecteur de modèle, routage, profils (presets), effort, outils on/off | ✅ | `ModelSheet`, `TurnOptionsSheet`, `Preferences` | UI test + live |72| 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) |73| Raisonnement (repliable), cartes d'outils, citations, images générées | ✅ | `ChatBubble` | reducer + rendu |74| Jetons / coût / latence par réponse, détails (paramètres réellement envoyés) | ✅ | `ChatBubble`, `MessageDetailsSheet` | UI |75| 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) |76| Aperçu des fichiers (Quick Look), bibliothèque de fichiers | ✅ | `ChatView`, `FilesView` | live (octets identiques) |77| 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) |78| Dictée (STT) | 🟡 | `VoiceRecorder` | implémentée ; le micro n'existe pas en simulateur — à valider sur appareil |79| Lecture à voix haute (TTS) | 🟡 | `SpeechPlayer` | idem (appel serveur testé indirectement) |80| Brouillons serveur (suivent le compte) | ✅ | `ChatSession` | test live `draftsFollowTheAccount` |81| Prompts enregistrés | ✅ | `PromptLibraryView` | test live |82| Mémoire (liste, ajouter, activer / désactiver, supprimer) | ✅ | `MemoryView` | test live |83| Projets (filtrer, créer, classer une conversation) | ✅ | `ConversationList`, `ModelCatalog` | édition : voir 2.0 |84| Dépenses : limites jour / mois, graphique, par modèle | ✅ | `UsageView` (Swift Charts) | décodage testé sur données réelles |85| Export conversation (MD / JSON), export complet | ✅ | `ChatView`, `DataView` | test live (MD) |86| 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 |87| Laboratoire des modèles (banc d'essai, `/models`) | ⛔ | — | administration : reste sur le web |88| Suppression complète des données | ⛔ volontaire | — | reste sur le web, derrière sa phrase de confirmation |89| Journal de sécurité (`auth_events`) | ⛔ | — | web |9091## Propre à iOS (sans équivalent web)9293| Fonction | Où |94|---|---|95| Lecture hors ligne des conversations déjà téléchargées (SQLite chiffré par iOS) | `LocalStore` |96| Boîte d'envoi : message écrit hors ligne, marqué « non envoyé », posté une seule fois au retour du réseau | `ChatSession`, `AppEnvironment.flushOutbox` |97| 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` |98| iPad : barre latérale persistante, Split View / Slide Over, glisser-déposer, raccourcis clavier (⌘N, ⌘⇧F, ⌘L, ⌘., ⌘⇧C, ⌘R, ⌘,) | `MainView`, `SPChatApp.commands` |99| Liens profonds `spchat://c/<id>`, `spchat://new?text=`, liens universels `https://chat.spboucher.ai/c/<id>` | `AppEnvironment.handle(url:)` |100| Raccourcis Siri / Shortcuts : « Nouvelle conversation », « Demander à SP Chat » | `SystemIntegration.swift` |101| Retours haptiques, notification locale « réponse prête », rafraîchissement en arrière-plan | `Haptics`, `AppEnvironment`, `BackgroundSync` |102