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
../SPNotesCoreest 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 (branchenative-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
../SPNotesCorebranchenext(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 dansTests/CoreTestSupport/faite parbuild.sh generate(ne jamais lier le produitSPNotesTestSupport: typesSPNotesAPIen double, lesas?échouent). - Invalidation :
app.feed.<portée>(App/ChangeFeed.swift), jamais de compteur global ; widgets rechargés parapp.widgets. - Blocs 3.0 : cartes dans
Editor/(BlockCard*), détail viaBlockDetails(ordre :.platformPencil + voix,.featuresSPNotesFeatures,.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, graineSPNOTES_LIVE_SEED=1, captureshosted-*).
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 (
-allowProvisioningUpdatesseul) ; identifiants d'app créés par l'API (Scripts/asc.py), fiche d'app créée parfetch('/iris/v1/apps')depuis un onglet Safari connecté (sans en-tête X-CSRF). - Éditeur : chaque paragraphe du text storage se termine par un
\nqui 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 deLineBox= paragraphe créé par un saut de ligne (le moteur lui donne un nouvel id / un nouvel élément de liste). NSTextStorageDelegaten'est pas annoté MainActor :nonisolated(unsafe)+MainActor.assumeIsolated.SPNotesStoreetSPNotesAPIdéfinissent tous deuxSearchHitetTombstone: 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
purgepar page d'un dossier) ; PATCH répond 404 sur une page en corbeille ; un rejeu idempotent ne renvoie pasx-existing.