SP Chat — iOS / iPadOS natif
Application native (Swift 6 strict, SwiftUI, UIKit ponctuel) du chat https://chat.spboucher.ai. Cahier des charges d'origine : brief
« SP Chat Native iOS » du 2026-11-17 (reconstruction native intégrale, aucune vue web, parité avec le site, passkeys, synchronisation,
streaming, distribution TestFlight). État et limites : docs/IMPLEMENTATION_STATUS.md ; parité : docs/PARITY_MATRIX.md.
Règles du projet
- Aucune vue web (WKWebView, SFSafariViewController pour l'interface) : tout écran est SwiftUI / UIKit. Un test d'interface le vérifie.
- Technologies Apple uniquement ; seule dépendance : SwiftMath (composition LaTeX CoreText), version épinglée dans
project.yml. - Le backend est partagé avec le web et le Mac : ne pas le modifier sans nécessité ; il se modifie sur son nœud (M4M64c, voir le CLAUDE.md global), jamais depuis ce dépôt.
- Ne jamais afficher un message comme envoyé avant la confirmation du serveur ; ne jamais présenter une simulation comme fonctionnelle.
- Aucun secret dans le dépôt ni dans le binaire. Le jeton de session vit dans le Trousseau.
- Chaque fichier source commence par l'en-tête (fichier, description, auteur, contact).
- Textes d'interface en français (langue source) ; ajouter la traduction anglaise dans
Localizable.xcstrings.
Version 2.0 « Next Generation » (2026-11-19) : backend 1.0 (contrat ../_spchat-nextgen-shared/API-NEXTGEN.md), système visuel V2
(../_spchat-nextgen-shared/DESIGN-SYSTEM-V2.md, jetons et composants dans Components/DesignSystem.swift). Les logos des créateurs
viennent du registre partagé : Scripts/sync-logos.py régénère Assets.xcassets/Logos et LogoRegistry.generated.swift — ne jamais
dessiner ni retoucher un logo à la main.
Recettes
Scripts/build.sh generate|debug|release|test|uitest · Scripts/test-live.sh test|uitest (serveur de dev, base *_dev seulement) ·
Scripts/release.sh archive|export|upload|all · Scripts/asc.py GET /v1/… (API App Store Connect). Le projet Xcode est généré par
xcodegen : après avoir ajouté un fichier, relancer Scripts/build.sh generate.
Scripts/sim.sh phone|pad light|dark capture.png [spchat://…] (lance l'app connectée au serveur de dev, lien passé sans invite système) ·
Scripts/shots.py (captures nommées d'un passage de tests d'interface) · Scripts/perf.sh (mesures, serveur local perf-stub.py) ·
Scripts/sync-logos.py. Passages en parallèle : SPCHAT_DEV_SLOT=<nom> (session de test distincte), SPCHAT_SIM, SPCHAT_DD (DerivedData).
Pièges rencontrés
- La base de dev est partagée : une suite e2e du backend (récupération) révoque toutes les sessions →
Scripts/dev-session.shavant de tester. #expect(a.count == 1 && a[0]…)évalue les deux côtés : un indice hors bornes fait planter le processus de test. Utiliser.first.- Assigner
composerTextdéclenche l'enregistrement du brouillon : fixerlastSavedDraftavant. Section("Titre") { } footer: { }n'existe pas :Section { } header: { } footer: { }.- Le droit
default-data-protectiondoit correspondre au réglage de l'identifiant d'app (iciPROTECTED_UNLESS_OPEN). - App Store Connect : l'API publique ne crée pas de fiche d'app (
apps: pas de CREATE). - L'identifiant d'app
ai.spboucher.spchatest partagé avec l'app macOS SP Chat (~/Desktop/Cluster/apple/SPChat, profil Developer ID « SP Chat Developer ID »). Tout changement de capacité sur cet identifiant invalide ce profil (arrivé le 2026-11-17 avec DATA_PROTECTION) : prévenir la session / le projet macOS, qui doit relancer sonScripts/provision.pyavant sa prochaine version. Ne jamais supprimer ce profil ; garder3YM54G49SN.ai.spboucher.spchatdanswebcredentials.appsdu backend. Scripts/dev-session.shrenouvelle le jeton de sa session : deux passages simultanés sansSPCHAT_DEV_SLOTdistinct se déconnectent l'un l'autre.- Un
.accessibilityIdentifierposé sur un conteneur (VStack, List, ScrollView) s'applique à ses enfants et masque les leurs : le poser sur un élément, ou précéder de.accessibilityElement(children: .contain). - XCUITest : après un échec, la capture de la hiérarchie d'accessibilité d'une longue liste peut prendre de nombreuses minutes — ne pas viser un élément hors écran dans un défilement horizontal (toucher impossible → échec → attente).
ViewThatFitsdans uneHStackavec unSpacerreçoit une proposition étroite et choisit sa plus petite variante : lui donner.frame(maxWidth: .infinity)(voir la puce de modèle du compositeur).- Une fonction
staticd'uneViewest isolée au MainActor : l'appeler depuis un test non isolé plante le processus de test. xcstringstool syncne reconnaît le catalogue que s'il s'appelleLocalizable.xcstrings(nom de la table).- Les suggestions de suite ne sont produites par le serveur que pour une réponse d'au moins 200 caractères.