SPB Git

Repository Public

CLAUDE.md 4.1 KB 54 lines markdown

1# SP Wallet — iOS / iPadOS natif23Application native (Swift 6 strict, SwiftUI, iOS 26+) de https://wallet.spboucher.ai : portefeuille multichaîne réel. Cahier des charges4d'origine : brief « SP Wallet Native iOS & iPadOS » du 2026-11-18. Audit : `docs/AUDIT.md` ; conventions : `docs/UI_CONVENTIONS.md` ;5parité : `docs/PARITY_MATRIX.md` (+ `docs/parity/`) ; état : `docs/IMPLEMENTATION_STATUS.md` ; distribution : `docs/DISTRIBUTION.md`.67## Règles du projet89- **Aucune vue web.** `Scripts/check-release.sh` refuse un binaire qui référencerait WebKit.10- **Aucune clé privée dans l'app.** Elle consulte, prépare et autorise ; le signataire isolé (m6ma) signe. Le seul secret conservé est11  le cookie de session, au Trousseau (cet appareil seulement).12- **Toute approbation passe par `ApprovalBinding.verify` du Core** : défi recalculé depuis l'objet affiché, objet comparé à la demande.13  Ne jamais approuver un objet que le Core ne sait pas recalculer ; ne jamais remplacer l'assertion WebAuthn par un Face ID local.14- **Jamais de transaction réelle pour tester.** Tests financiers sur la pile jetable (`../SPWalletCore/Scripts/dev-stack.sh up-fork` :15  clés aléatoires, Base = fork anvil local, passkey logicielle). La passkey logicielle (`SPWalletTestSupport`) n'est référencée que sous16  `#if DEBUG` et refuse toute origine `spboucher.ai`.17- Le Core `../SPWalletCore` est **partagé avec SP Wallet macOS** (`../SPWallet`, autre session, propriétaire du backend). Ce projet possède18  le Core : prévenir la session macOS avant tout changement cassant de son API publique.19- Le backend (`sp-wallet`) se modifie sur son nœud par la session macOS ; ne jamais déployer ni ouvrir un verrou sans l'accord explicite20  du propriétaire ; ne jamais toucher `policy.json` du signataire.21- Aucune donnée inventée, aucun succès déduit : seul `finalized` est un succès ; un pont n'est fini qu'à la confirmation de destination.22- En-tête obligatoire en tête de fichier. Interface en français (langue source), anglais dans `Resources/Localizable.xcstrings`.2324## Recettes2526`Scripts/build.sh generate|debug|release|test|uitest|core` (`SPWALLET_SIM="SPWallet iPad"` pour la tablette) ·27`Scripts/release.sh archive|check|export|upload|all` · `Scripts/asc.py GET /v1/…` · `Scripts/import-logos.py` (logos du backend).28Variables de debug : `SPWALLET_ORIGIN` (boucle locale seulement), `SPWALLET_DEV_DIR`, `SPWALLET_EPHEMERAL=1`.29Tests d'interface sur une autre pile : `TEST_RUNNER_SPWALLET_UITEST_ORIGIN=… TEST_RUNNER_SPWALLET_UITEST_DIR=… Scripts/build.sh uitest`.3031## Pièges rencontrés3233- zsh : ne jamais nommer une variable de boucle `path` (elle est liée à `PATH`).34- Un `accessibilityIdentifier` posé sur un `Label` s'applique à son image : `.accessibilityElement(children: .combine)` d'abord.35- `KeyPath` vers une propriété `@MainActor` et `inout` vers une propriété isolée dans un appel `async` : refusés en Swift 6 →36  fonctions qui renvoient la nouvelle valeur.37- Deux suites de tests qui font le « setup propriétaire » en parallèle enrôlent deux clés : une seule tâche partagée.38- `dev-stack.sh down` tue par PID de port (jamais `pkill -f`).39- `codesign … | grep -q` sous `pipefail` : tuyau cassé → lire dans une variable.40- Une archive est signée Development (`get-task-allow` vrai) ; c'est l'export qui signe Distribution : contrôler l'IPA exporté.41- Limite de débit du compte : au plus 3–4 sous-agents à la fois.4243<!-- spb-source-governance:start -->44## Source header policy (SP Boucher)4546When creating or modifying eligible first-party source files, follow the SP Boucher Source Header47Policy. Preserve existing copyright and license notices, select the correct language-specific48template, and avoid adding identifying information to anonymous academic submission artifacts.4950- Repository policy: `.spb-source-governance.toml` (project, contact, verified rights, license).51- Add or refresh headers with `spb-header apply --repo .`; verify with `spb-header check --repo .`.52- Never hand-write a header, never add one to generated, vendored, third-party or data files.53<!-- spb-source-governance:end -->54
Files main
Menu

Theme