SPB Git

Repository Public

CLAUDE.md 4.9 KB

# 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.sh avant 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 composerText déclenche l'enregistrement du brouillon : fixer lastSavedDraft avant.
  • Section("Titre") { } footer: { } n'existe pas : Section { } header: { } footer: { }.
  • Le droit default-data-protection doit correspondre au réglage de l'identifiant d'app (ici PROTECTED_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.spchat est 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 son Scripts/provision.py avant sa prochaine version. Ne jamais supprimer ce profil ; garder 3YM54G49SN.ai.spboucher.spchat dans webcredentials.apps du backend.
  • 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.
  • Un .accessibilityIdentifier posé 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).
  • ViewThatFits dans une HStack avec un Spacer reç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 static d'une View est isolée au MainActor : l'appeler depuis un test non isolé plante le processus de test.
  • xcstringstool sync ne reconnaît le catalogue que s'il s'appelle Localizable.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.
Files main
Menu

Theme