SPB Git

Repository Public

CLAUDE.md 5.0 KB

# SP Notes — iOS / iPadOS natif

Application native (Swift 6 strict, SwiftUI, UIKit/TextKit 2) de https://note.spboucher.ai. Cahier des charges d'origine : brief « SP Notes Native iOS & iPadOS » du 2026-11-18 (reconstruction native intégrale, hors ligne d'abord, synchro MacLustr, IA). État et limites : docs/IMPLEMENTATION_STATUS.md ; parité : docs/PARITY_MATRIX.md ; audit : docs/AUDIT.md.

# Règles du projet

  • Aucune vue web (WKWebView, SFSafariViewController) : tout écran est SwiftUI / UIKit ; les liens externes s'ouvrent dans le navigateur du système.
  • Hors ligne d'abord : toute écriture passe par AppModel → base locale → synchro planifiée. Aucun écran n'attend le réseau pour enregistrer.
  • Le socle ../SPNotesCore est partagé avec SP Notes macOS (~/Desktop/Cluster/apple/SPNotes, autre session) : tout commit qui touche Store ou Sync doit être signalé à ce projet (il reconstruit). Ne pas casser l'API publique sans coordination.
  • Le backend (note-spboucher-ai) se modifie sur son nœud (M4M64c, voir le CLAUDE.md global) ; les ajouts natifs (flux /api/sync, ids client, AASA) ont été faits par la session macOS (branche native-sync, en production depuis le 2026-11-18).
  • Ne jamais présenter une simulation comme fonctionnelle ; aucun secret dans le dépôt ni dans le binaire (jeton de session au Trousseau).
  • Chaque fichier source commence par l'en-tête (fichier, description, auteur, contact). Textes d'interface en français (langue source), traduction anglaise dans Resources/Localizable.xcstrings. Conventions d'écran : docs/UI_CONVENTIONS.md.

# 2.0.0 (2) — branche next (2026-11-19, non publiée)

  • Socle ../SPNotesCore branche next (2.0, schéma v2 : un build 1.0 ne rouvre pas une base migrée). Produits liés : SPNotesCore, SPNotesDesign (3 cibles), SPNotesFeatures (app seule). Le faux serveur des tests = copie dans Tests/CoreTestSupport/ faite par build.sh generate (ne jamais lier le produit SPNotesTestSupport : types SPNotesAPI en double, les as? échouent).
  • Invalidation : app.feed.<portée> (App/ChangeFeed.swift), jamais de compteur global ; widgets rechargés par app.widgets.
  • Blocs 3.0 : cartes dans Editor/ (BlockCard*), détail via BlockDetails (ordre : .platform Pencil + voix, .features SPNotesFeatures, .inApp). Entrées d'insertion : Editor/InsertCatalog.swift.
  • Coquille : routes AppRoute + RouteCoordinator (une route = une fenêtre), onglets iPhone, sections hébergées (Features/Sections/, listées seulement si le serveur annonce la fonctionnalité), palette ⌘K.
  • Simulateurs dédiés : « SPNoteNext iPhone », « SPNoteNext iPad ». Tests réels : Scripts/test-live.sh (serveur d'intégration M4M64c:8486, jamais la prod). État exact, limites et ce qui n'a tourné que sur simulateur : docs/IMPLEMENTATION_STATUS.md.
  • Captures iOS : la création de page porte inboxAt / captureKind (Core 2.0 final) — en boîte de réception sur le serveur aussi.
  • Écrans hébergés à l'écran : Scripts/test-live.sh ui (serveur d'intégration, graine SPNOTES_LIVE_SEED=1, captures hosted-*).

# Recettes

Scripts/build.sh generate|debug|release|test|uitest|core · Scripts/test-live.sh (serveur d'intégration M4M64c:8486, jamais la prod) · Scripts/release.sh archive|export|upload|all · Scripts/asc.py GET /v1/…. Projet généré par xcodegen : après l'ajout d'un fichier, Scripts/build.sh generate. Variables de debug : SPNOTES_STORE=memory, SPNOTES_SESSION=local, SPNOTES_SEED=1, SPNOTES_BASE_URL + SPNOTES_TOKEN.

# Pièges rencontrés

  • Signature : les App Groups ne se provisionnent pas avec la clé API App Store Connect (« Authentication failed ») → l'archive est signée avec le compte Xcode (-allowProvisioningUpdates seul) ; identifiants d'app créés par l'API (Scripts/asc.py), fiche d'app créée par fetch('/iris/v1/apps') depuis un onglet Safari connecté (sans en-tête X-CSRF).
  • Éditeur : chaque paragraphe du text storage se termine par un \n qui porte son identité (.spnLine), le dernier compris ; le curseur ne dépasse jamais ce terminateur. Les sauts de ligne internes (code, hardBreak) sont des U+2028. Deux paragraphes voisins qui partagent la même instance de LineBox = paragraphe créé par un saut de ligne (le moteur lui donne un nouvel id / un nouvel élément de liste).
  • NSTextStorageDelegate n'est pas annoté MainActor : nonisolated(unsafe) + MainActor.assumeIsolated.
  • SPNotesStore et SPNotesAPI définissent tous deux SearchHit et Tombstone : qualifier (SPNotesStore.SearchHit).
  • Plusieurs agents sur le même simulateur se gênent (« Application failed preflight checks ») : un simulateur dédié par suite d'interface.
  • XCUIApplication.open(url) relance l'app ; avec une base en mémoire le lien arrive avant les données d'exemple.
  • Le serveur : la purge d'une page ne supprime qu'une ligne (une op purge par page d'un dossier) ; PATCH répond 404 sur une page en corbeille ; un rejeu idempotent ne renvoie pas x-existing.
Files main
Menu

Theme