SPB Git

Repository Public

CLAUDE.md 5.7 KB 67 lines markdown

1# SP Notes — iOS / iPadOS natif23Application native (Swift 6 strict, SwiftUI, UIKit/TextKit 2) de https://note.spboucher.ai. Cahier des charges d'origine : brief4« SP Notes Native iOS & iPadOS » du 2026-11-18 (reconstruction native intégrale, hors ligne d'abord, synchro MacLustr, IA).5État et limites : `docs/IMPLEMENTATION_STATUS.md` ; parité : `docs/PARITY_MATRIX.md` ; audit : `docs/AUDIT.md`.67## Règles du projet89- **Aucune vue web** (WKWebView, SFSafariViewController) : tout écran est SwiftUI / UIKit ; les liens externes s'ouvrent dans le navigateur du système.10- Hors ligne d'abord : toute écriture passe par `AppModel` → base locale → synchro planifiée. Aucun écran n'attend le réseau pour enregistrer.11- Le socle `../SPNotesCore` est **partagé avec SP Notes macOS** (`~/Desktop/Cluster/apple/SPNotes`, autre session) : tout commit qui touche12  Store ou Sync doit être signalé à ce projet (il reconstruit). Ne pas casser l'API publique sans coordination.13- Le backend (`note-spboucher-ai`) se modifie **sur son nœud** (M4M64c, voir le CLAUDE.md global) ; les ajouts natifs (flux `/api/sync`,14  ids client, AASA) ont été faits par la session macOS (branche `native-sync`, en production depuis le 2026-11-18).15- Ne jamais présenter une simulation comme fonctionnelle ; aucun secret dans le dépôt ni dans le binaire (jeton de session au Trousseau).16- Chaque fichier source commence par l'en-tête (fichier, description, auteur, contact). Textes d'interface en français (langue source),17  traduction anglaise dans `Resources/Localizable.xcstrings`. Conventions d'écran : `docs/UI_CONVENTIONS.md`.1819## 2.0.0 (2) — branche `next` (2026-11-19, non publiée)2021- Socle `../SPNotesCore` branche `next` (2.0, schéma v2 : **un build 1.0 ne rouvre pas une base migrée**). Produits liés : `SPNotesCore`,22  `SPNotesDesign` (3 cibles), `SPNotesFeatures` (app seule). Le faux serveur des tests = copie dans `Tests/CoreTestSupport/` faite par23  `build.sh generate` (ne jamais lier le produit `SPNotesTestSupport` : types `SPNotesAPI` en double, les `as?` échouent).24- Invalidation : `app.feed.<portée>` (`App/ChangeFeed.swift`), jamais de compteur global ; widgets rechargés par `app.widgets`.25- Blocs 3.0 : cartes dans `Editor/` (`BlockCard*`), détail via `BlockDetails` (ordre : `.platform` Pencil + voix, `.features`26  SPNotesFeatures, `.inApp`). Entrées d'insertion : `Editor/InsertCatalog.swift`.27- Coquille : routes `AppRoute` + `RouteCoordinator` (une route = une fenêtre), onglets iPhone, sections hébergées28  (`Features/Sections/`, listées seulement si le serveur annonce la fonctionnalité), palette ⌘K.29- Simulateurs dédiés : « SPNoteNext iPhone », « SPNoteNext iPad ». Tests réels : `Scripts/test-live.sh` (serveur d'intégration30  M4M64c:8486, jamais la prod). État exact, limites et ce qui n'a tourné que sur simulateur : `docs/IMPLEMENTATION_STATUS.md`.31- Captures iOS : la création de page porte `inboxAt` / `captureKind` (Core 2.0 final) — en boîte de réception sur le serveur aussi.32- Écrans hébergés à l'écran : `Scripts/test-live.sh ui` (serveur d'intégration, graine `SPNOTES_LIVE_SEED=1`, captures `hosted-*`).3334## Recettes3536`Scripts/build.sh generate|debug|release|test|uitest|core` · `Scripts/test-live.sh` (serveur d'intégration M4M64c:8486,37jamais la prod) · `Scripts/release.sh archive|export|upload|all` · `Scripts/asc.py GET /v1/…`. Projet généré par xcodegen : après38l'ajout d'un fichier, `Scripts/build.sh generate`. Variables de debug : `SPNOTES_STORE=memory`, `SPNOTES_SESSION=local`,39`SPNOTES_SEED=1`, `SPNOTES_BASE_URL` + `SPNOTES_TOKEN`.4041## Pièges rencontrés4243- Signature : les App Groups ne se provisionnent pas avec la clé API App Store Connect (« Authentication failed ») → l'archive est signée44  avec le compte Xcode (`-allowProvisioningUpdates` seul) ; identifiants d'app créés par l'API (`Scripts/asc.py`), fiche d'app créée par45  `fetch('/iris/v1/apps')` depuis un onglet Safari connecté (sans en-tête X-CSRF).46- Éditeur : chaque paragraphe du text storage se termine par un `\n` qui porte son identité (`.spnLine`), le dernier compris ; le curseur47  ne dépasse jamais ce terminateur. Les sauts de ligne internes (code, hardBreak) sont des U+2028. Deux paragraphes voisins qui partagent48  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).49- `NSTextStorageDelegate` n'est pas annoté MainActor : `nonisolated(unsafe)` + `MainActor.assumeIsolated`.50- `SPNotesStore` et `SPNotesAPI` définissent tous deux `SearchHit` et `Tombstone` : qualifier (`SPNotesStore.SearchHit`).51- Plusieurs agents sur le même simulateur se gênent (« Application failed preflight checks ») : un simulateur dédié par suite d'interface.52- `XCUIApplication.open(url)` relance l'app ; avec une base en mémoire le lien arrive avant les données d'exemple.53- 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 en54  corbeille ; un rejeu idempotent ne renvoie pas `x-existing`.5556<!-- spb-source-governance:start -->57## Source header policy (SP Boucher)5859When creating or modifying eligible first-party source files, follow the SP Boucher Source Header60Policy. Preserve existing copyright and license notices, select the correct language-specific61template, and avoid adding identifying information to anonymous academic submission artifacts.6263- Repository policy: `.spb-source-governance.toml` (project, contact, verified rights, license).64- Add or refresh headers with `spb-header apply --repo .`; verify with `spb-header check --repo .`.65- Never hand-write a header, never add one to generated, vendored, third-party or data files.66<!-- spb-source-governance:end -->67
Files main
Menu

Theme