Repository Public
1# SP Chat — iOS / iPadOS natif23Application native (Swift 6 strict, SwiftUI, UIKit ponctuel) du chat https://chat.spboucher.ai. Cahier des charges d'origine : brief4« SP Chat Native iOS » du 2026-11-17 (reconstruction native intégrale, aucune vue web, parité avec le site, passkeys, synchronisation,5streaming, distribution TestFlight). État et limites : `docs/IMPLEMENTATION_STATUS.md` ; parité : `docs/PARITY_MATRIX.md`.67## Règles du projet89- **Aucune vue web** (WKWebView, SFSafariViewController pour l'interface) : tout écran est SwiftUI / UIKit. Un test d'interface le vérifie.10- Technologies Apple uniquement ; seule dépendance : SwiftMath (composition LaTeX CoreText), version épinglée dans `project.yml`.11- 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 le12 CLAUDE.md global), jamais depuis ce dépôt.13- Ne jamais afficher un message comme envoyé avant la confirmation du serveur ; ne jamais présenter une simulation comme fonctionnelle.14- Aucun secret dans le dépôt ni dans le binaire. Le jeton de session vit dans le Trousseau.15- Chaque fichier source commence par l'en-tête (fichier, description, auteur, contact).16- Textes d'interface en français (langue source) ; ajouter la traduction anglaise dans `Localizable.xcstrings`.1718Version 2.0 « Next Generation » (2026-11-19) : backend 1.0 (contrat `../_spchat-nextgen-shared/API-NEXTGEN.md`), système visuel V219(`../_spchat-nextgen-shared/DESIGN-SYSTEM-V2.md`, jetons et composants dans `Components/DesignSystem.swift`). Les logos des créateurs20viennent du registre partagé : `Scripts/sync-logos.py` régénère `Assets.xcassets/Logos` et `LogoRegistry.generated.swift` — ne jamais21dessiner ni retoucher un logo à la main.2223## Recettes2425`Scripts/build.sh generate|debug|release|test|uitest` · `Scripts/test-live.sh test|uitest` (serveur de dev, base `*_dev` seulement) ·26`Scripts/release.sh archive|export|upload|all` · `Scripts/asc.py GET /v1/…` (API App Store Connect). Le projet Xcode est généré par27xcodegen : après avoir ajouté un fichier, relancer `Scripts/build.sh generate`.28`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) ·29`Scripts/shots.py` (captures nommées d'un passage de tests d'interface) · `Scripts/perf.sh` (mesures, serveur local `perf-stub.py`) ·30`Scripts/sync-logos.py`. Passages en parallèle : `SPCHAT_DEV_SLOT=<nom>` (session de test distincte), `SPCHAT_SIM`, `SPCHAT_DD` (DerivedData).3132## Pièges rencontrés3334- La base de dev est partagée : une suite e2e du backend (récupération) révoque toutes les sessions → `Scripts/dev-session.sh` avant de tester.35- `#expect(a.count == 1 && a[0]…)` évalue les deux côtés : un indice hors bornes fait planter le processus de test. Utiliser `.first`.36- Assigner `composerText` déclenche l'enregistrement du brouillon : fixer `lastSavedDraft` **avant**.37- `Section("Titre") { } footer: { }` n'existe pas : `Section { } header: { } footer: { }`.38- Le droit `default-data-protection` doit correspondre au réglage de l'identifiant d'app (ici `PROTECTED_UNLESS_OPEN`).39- App Store Connect : l'API publique ne crée pas de fiche d'app (`apps` : pas de CREATE).40- L'identifiant d'app `ai.spboucher.spchat` est **partagé avec l'app macOS SP Chat** (`~/Desktop/Cluster/apple/SPChat`, profil Developer ID41 « SP Chat Developer ID »). Tout changement de capacité sur cet identifiant invalide ce profil (arrivé le 2026-11-17 avec42 DATA_PROTECTION) : prévenir la session / le projet macOS, qui doit relancer son `Scripts/provision.py` avant sa prochaine version.43 Ne jamais supprimer ce profil ; garder `3YM54G49SN.ai.spboucher.spchat` dans `webcredentials.apps` du backend.44- `Scripts/dev-session.sh` renouvelle le jeton de **sa** session : deux passages simultanés sans `SPCHAT_DEV_SLOT` distinct se déconnectent l'un l'autre.45- Un `.accessibilityIdentifier` posé sur un conteneur (VStack, List, ScrollView) s'applique à ses enfants et masque les leurs :46 le poser sur un élément, ou précéder de `.accessibilityElement(children: .contain)`.47- XCUITest : après un échec, la capture de la hiérarchie d'accessibilité d'une longue liste peut prendre de nombreuses minutes — ne pas48 viser un élément hors écran dans un défilement horizontal (toucher impossible → échec → attente).49- `ViewThatFits` dans une `HStack` avec un `Spacer` reçoit une proposition étroite et choisit sa plus petite variante : lui donner50 `.frame(maxWidth: .infinity)` (voir la puce de modèle du compositeur).51- Une fonction `static` d'une `View` est isolée au MainActor : l'appeler depuis un test non isolé plante le processus de test.52- `xcstringstool sync` ne reconnaît le catalogue que s'il s'appelle `Localizable.xcstrings` (nom de la table).53- Les suggestions de suite ne sont produites par le serveur que pour une réponse d'au moins 200 caractères.5455<!-- spb-source-governance:start -->56## Source header policy (SP Boucher)5758When creating or modifying eligible first-party source files, follow the SP Boucher Source Header59Policy. Preserve existing copyright and license notices, select the correct language-specific60template, and avoid adding identifying information to anonymous academic submission artifacts.6162- Repository policy: `.spb-source-governance.toml` (project, contact, verified rights, license).63- Add or refresh headers with `spb-header apply --repo .`; verify with `spb-header check --repo .`.64- Never hand-write a header, never add one to generated, vendored, third-party or data files.65<!-- spb-source-governance:end -->66