Repository Public
1<!--2SP Drive iOS3File: README.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7<div align="center">89<img src="docs/brand/logo.svg" alt="SP Drive logo" width="560">1011<br><br>1213<img src="docs/brand/icon.png" alt="SP Drive icon" width="112" height="112">1415# SP Drive pour iPhone et iPad1617**Client natif (Swift 6, SwiftUI, UIKit là où il le faut) de [SP Drive](https://drive.spboucher.ai), le stockage documentaire privé hébergé sur le cluster MacLustr : explorateur, emplacement dans l'app Fichiers, hors ligne, synchronisation et conflits sans écrasement. Aucune vue web.**1819**Author: [Simon-Pierre Boucher](https://www.spboucher.ai)**2021[](https://drive.spboucher.ai)2223242526272829303132333435363738394041[](https://git.spboucher.ai/sp-drive-ios/commits)42[](https://git.spboucher.ai/sp-drive-ios/commits)43[](https://git.spboucher.ai/sp-drive-ios/insights)44[](https://git.spboucher.ai/sp-drive-ios)45[](https://git.spboucher.ai/sp-drive-ios/insights)46[](https://git.spboucher.ai/sp-drive-ios)47[](https://git.spboucher.ai/sp-drive-ios/branches)48[](https://git.spboucher.ai/sp-drive-ios/tags)49[](https://git.spboucher.ai/sp-drive-ios)5051525354555657585960616263646566676869</div>7071---7273## Sommaire7475- [SP Drive Next (2.0)](#-sp-drive-next-20--branche-next)76- [Aperçu](#-aperçu)77- [Fonctions](#-fonctions)78- [Architecture](#-architecture)79- [Décisions qui comptent](#-décisions-qui-comptent)80- [Pile technique](#-pile-technique)81- [Arborescence du dépôt](#-arborescence-du-dépôt)82- [Construire et tester](#-construire-et-tester)83- [Configuration](#-configuration)84- [API consommée](#-api-consommée)85- [Écrans](#-écrans)86- [Modèle de données local](#-modèle-de-données-local)87- [Sécurité et confidentialité](#-sécurité-et-confidentialité)88- [Tests](#-tests)89- [Publication](#-publication)90- [Backend](#-backend)91- [Parité web, macOS, iPhone, iPad](#-parité-web-macos-iphone-ipad)92- [Pièges connus](#-pièges-connus)93- [Reste à faire et limites connues](#-reste-à-faire-et-limites-connues)94- [Auteur](#-auteur)95- [Licence](#-licence)9697---9899## 🚀 SP Drive Next (2.0) — branche `next`100101Mise à niveau majeure, pas une réécriture : File Provider, moteur, authentification, signature et identifiants sont ceux de la1021.0. **La 2.0 n'est ni archivée ni envoyée à Apple** : la version publiée sur TestFlight reste la 1.0.0 (1). Tout ce qui suit a été103vérifié **sur simulateur seulement** (aucun appareil réel), contre un serveur 2.0 jetable, jamais la production ; l'IA a été104exercée contre un **faux** point d'accès compatible OpenAI (aucun vrai modèle).105106| Document | Contenu |107|---|---|108| [`docs/next/PHASE2-iOS.md`](docs/next/PHASE2-iOS.md) | écrans 2.0, ce qui dépend de `GET /meta`, ce que le paquet partagé ne couvre pas, anglais : ce qui reste en français |109| [`docs/next/DELIVERY-CHECKLIST.md`](docs/next/DELIVERY-CHECKLIST.md) | **ce qu'il faut créer dans le portail développeur et App Store Connect, et les vérifications avant l'archive** |110| [`docs/next/PHASE1-iOS.md`](docs/next/PHASE1-iOS.md) | moteur 2.0, design, iPad, conflits, numériseur, annotation, partage, widgets |111| [`docs/next/AUDIT-iOS.md`](docs/next/AUDIT-iOS.md) | audit de la 1.0, mesures, ce que prouvent les tests, arrière-plan : ce qu'iOS ne garantit pas |112| [`docs/TESTS.md`](docs/TESTS.md) | suites, mesures, « construit, non vérifié » |113| [`docs/next/shots/`](docs/next/shots/) | captures des simulateurs |114115**Phase 1** : moteur de synchronisation 2.0 (Wi-Fi seulement, données réduites, économie d'énergie, batterie, parallélisme116adaptatif, priorités, reprise après arrêt brutal, épinglage cohérent), design iPhone (cartes, feuille d'actions, pastille de117transferts, zooms), iPad (inspecteur, fenêtres, raccourcis), conflits côte à côte, numériseur avec OCR sur l'appareil, annotation118PDF enregistrée comme nouvelle version, extension de partage durcie, cinq widgets.119120**Phase 2** (paquet partagé `SPDriveNext` du dépôt macOS, lié en paquet local `../SPDrive`) : flux d'évènements du serveur branché121sur le moteur (repli sur l'interrogation), recherche dans le contenu avec passages surlignés et recherche par le sens, SP Drive AI122(interroger un document, un dossier ou tout le Drive ; réponse en flux, passages cités numérotés qui ouvrent le fichier ; choix du123modèle qui distingue son créateur de la route qui le sert ; consentement aux fournisseurs externes ; suggestions de rangement à124confirmer une à une), étiquettes, collections intelligentes avec constructeur de règle, activité, versions (chronologie,125restauration, comparaison : texte ligne à ligne, images et PDF côte à côte, simple constat sinon), centre de stockage (par type,126par dossier, croissance, doublons — jamais de suppression automatique), membres et rôles, « Partagés avec moi » selon le rôle,127appareils connectés, vue d'infrastructure pour les administrateurs, code QR d'un lien, limite de débit. **Chaque écran ou128commande 2.0 n'existe que si le serveur annonce la fonction** : devant un serveur 1.0, l'app se présente comme la 1.0.129130Cibles : app, File Provider, partage, **widgets** (`ai.spboucher.spdrive.ios.widgets`), tests unitaires et d'interface. Le reste131de ce README décrit l'architecture d'origine et reste exact pour ce qui n'a pas changé.132133---134135## 📖 Aperçu136137**SP Drive pour iPhone et iPad** est le client natif de [SP Drive](https://drive.spboucher.ai), le stockage documentaire138privé hébergé sur le cluster MacLustr. Aucune vue web : chaque écran est natif, les transferts et la synchronisation sont139écrits en Swift. L'app apporte ce que le site ne peut pas offrir sur un téléphone : SP Drive comme **emplacement de l'app140Fichiers**, des fichiers et dossiers **gardés hors ligne**, des modifications faites sans réseau puis rejouées, et une141résolution de conflits qui n'écrase jamais rien.142143| | |144|---|---|145| Identifiants | `ai.spboucher.spdrive.ios` (+ `.fileprovider`, `.share`) · groupe d'apps `group.ai.spboucher.spdrive.ios` · équipe `3YM54G49SN` |146| Cible | iOS / iPadOS 18.0 et plus, iPhone + iPad |147| Version | 1.0.0 (1) — sur TestFlight depuis le 2026-11-18 (build `VALID`, test interne) |148| Fiche App Store Connect | `6836524538` (SKU `spdrive-ios-001`) |149| Langue | français seulement (l'anglais reste à faire) |150| Code | 66 fichiers Swift, 11 312 lignes, aucune dépendance externe |151152Documents du dépôt : état réel, fonction par fonction — [`docs/TESTS.md`](docs/TESTS.md) ; audit du système existant et153matrice de parité — [`docs/AUDIT.md`](docs/AUDIT.md).154155### Famille SP Drive156157| Dépôt | Rôle | Plateforme |158|---|---|---|159| [sp-drive](https://git.spboucher.ai/sp-drive) | Backend (Fastify, PostgreSQL, worker) + site web, `drive.spboucher.ai` | web |160| [sp-drive-macos](https://git.spboucher.ai/sp-drive-macos) | Client natif macOS (File Provider Finder, paquets `SPDriveCore` / `SPDriveSync`) | macOS |161| **[sp-drive-ios](https://git.spboucher.ai/sp-drive-ios)** | **Client natif iPhone et iPad (ce dépôt)** | iOS / iPadOS |162163---164165## ✨ Fonctions166167| Domaine | Ce qui est construit |168|---|---|169| Explorateur | Mon Drive, Récents, Favoris, Partagés, Hors ligne, Transferts, Corbeille, Recherche, Paramètres. Liste ou grille, tri, filtres par type, sélection multiple, menus contextuels, balayages, glisser-déposer, retours haptiques. iPhone : barre d'onglets. iPad : barre latérale + colonnes, raccourcis clavier. |170| App Fichiers | Extension File Provider répliquée : SP Drive est un emplacement de Fichiers ; listage paginé, téléchargement à la demande vérifié, création, renommage, déplacement, corbeille, suppression, envoi des modifications, vignettes. |171| Hors ligne | Fichiers et dossiers « gardés hors ligne » dans Application Support (jamais purgés par le système) ; un dossier gardé suit ce qu'on y ajoute. Créer, renommer, déplacer, supprimer, ajouter et modifier hors ligne : tout est journalisé et rejoué à la reconnexion, y compris après un redémarrage. |172| Synchronisation | Flux de changements incrémental du serveur (révisions, pas de dates), journal persistant des opérations locales, identifiants stables, comparaison par version et empreinte SHA-256. |173| Conflits | Une nouvelle version nomme toujours la version dont elle part ; si le serveur a avancé, rien n'est écrasé : conflit affiché, trois choix (garder les deux, garder la mienne, garder celle du serveur). Dans Fichiers, l'édition en conflit devient une copie « (conflit …) ». |174| Transferts | File persistante, priorités, parallélisme selon le réseau (Wi-Fi, cellulaire, mode données réduites), pause, reprise, annulation, nouvel essai avec délai croissant. Envoi par blocs de 8 Mio avec empreinte par bloc et vérification finale par le serveur ; téléchargement repris par `Range` et vérifié avant d'être installé. URLSession en arrière-plan, relance de l'app prise en charge. |175| Import | Fichiers, Photos (sélecteur système, aucun accès global à la photothèque), appareil photo, numériseur de documents (PDF assemblé avec PDFKit), feuille de partage (extension : jusqu'à 50 fichiers, 50 images, 10 vidéos), glisser-déposer. |176| Aperçu et édition | QuickLook (images, PDF, vidéo, audio, texte, bureautique) avec annotations enregistrées comme nouvelle version ; éditeur de texte natif ; « Ouvrir dans une autre app ». |177| Partage | Liens de partage (lecture seule ou téléchargement, mot de passe, expiration, plafonds, usage unique, rotation, révocation, journal d'accès) et liens de dépôt (dossier cible, limites, mot de passe, expiration, pause, soumissions reçues). Toutes les règles sont appliquées par le serveur. |178| Versions | Liste, téléchargement d'une version, restauration (crée une nouvelle version), suppression. |179| Compte et sécurité | Connexion par clé d'accès (passkey) native, liaison par code en secours, session d'appareil dans le trousseau (groupe partagé avec les extensions), verrou Face ID / Touch ID optionnel, appareils connectés, déconnexion. |180| Stockage | Quota MacLustr, espace hors ligne, cache, transferts en attente, fichiers volumineux ; « Retirer de cet appareil » ne touche jamais au Drive. |181| Notifications | Locales : conflit, transfert interrompu, espace insuffisant, dépôt reçu, transferts terminés en arrière-plan. Désactivables une à une. |182183### Raccourcis clavier (iPad, clavier matériel)184185| Raccourci | Action |186|---|---|187| <kbd>⇧</kbd><kbd>⌘</kbd><kbd>N</kbd> | Nouveau dossier |188| <kbd>⌘</kbd><kbd>O</kbd> | Importer des fichiers… |189| <kbd>⌘</kbd><kbd>R</kbd> | Synchroniser maintenant |190| <kbd>⌘</kbd><kbd>F</kbd> | Rechercher |191| <kbd>⌘</kbd><kbd>1</kbd> / <kbd>⌘</kbd><kbd>2</kbd> | Afficher en liste / en grille |192| <kbd>⌘</kbd><kbd>S</kbd> | Enregistrer (éditeur de texte) |193194---195196## 🧭 Architecture197198`Core/` et `Sync/` sont compilés dans l'app **et** dans les deux extensions ; `Package.swift` les expose aussi comme199bibliothèque (`SPDriveKit`) pour les tester sur le Mac en quelques secondes.200201**Trois processus, trois responsabilités** : l'app a sa base (`Application Support/SPDrive/drive.sqlite`) et son moteur ;202l'extension File Provider a **sa propre base** dans le conteneur du groupe (aucune base n'est ouverte par deux203processus) ; l'extension de partage n'a pas d'état. Le seul élément partagé est le jeton de session, dans le trousseau.204205```mermaid206flowchart TB207 subgraph Device["iPhone / iPad"]208 subgraph AppProc["App SP Drive"]209 UI["Features (SwiftUI)<br/>9 sections + recherche"]210 ENG["SyncEngine (acteur)<br/>changements, journal, conflits"]211 TQ["TransferQueue<br/>UploadManager · DownloadManager"]212 DB1[("drive.sqlite<br/>Application Support")]213 end214 subgraph FP["Extension File Provider"]215 FPE["FileProviderExtension<br/>Enumerator · Item · Manager"]216 DB2[("base du domaine<br/>conteneur du groupe")]217 end218 subgraph SH["Extension de partage"]219 SVC["ShareViewController<br/>sans état"]220 end221 KC["Trousseau partagé<br/>jeton de session d'appareil"]222 FILES["App Fichiers / apps tierces"]223 end224 subgraph Cluster["MacLustr"]225 TUN["MacLustr Tunnel<br/>Caddy + WireGuard"]226 API["sp-drive · API /api/v1<br/>m5ma:8660"]227 PG[("PostgreSQL 17")]228 OBJ["objets chiffrés au repos"]229 end230 UI --> ENG --> TQ231 ENG --> DB1232 FILES --> FPE --> DB2233 SVC -. "ShareInbox" .-> ENG234 AppProc --> KC235 FP --> KC236 SH --> KC237 TQ -- "HTTPS · Bearer" --> TUN238 FPE -- "HTTPS · Bearer" --> TUN239 TUN --> API --> PG240 API --> OBJ241```242243### Envoi résumable d'un fichier244245```mermaid246sequenceDiagram247 autonumber248 participant U as UploadManager249 participant S as API sp-drive250 U->>S: POST /uploads (nom, taille, baseVersionId)251 S-->>U: identifiant d'envoi252 loop blocs de 8 Mio253 U->>U: découpe + SHA-256 du bloc (IntegrityVerifier)254 U->>S: PATCH /uploads/:id?offset= (X-Chunk-SHA256)255 S-->>U: nouveau décalage256 Note over U,S: bloc coupé → le serveur renvoie le décalage réel, reprise à cet endroit257 end258 U->>S: POST /uploads/:id/complete (SHA-256 du fichier)259 alt le serveur a avancé260 S-->>U: 409 version_conflict261 U->>S: PATCH /uploads/:id/options {asNewFile} — copie de conflit, sans renvoyer les octets262 else version acceptée263 S-->>U: élément mis à jour (nouvelle version)264 end265```266267### Synchronisation hors ligne puis reconnexion268269```mermaid270sequenceDiagram271 autonumber272 participant A as App (hors ligne)273 participant J as Journal ops (SQLite)274 participant S as API sp-drive275 A->>J: créer / renommer / déplacer / modifier (appliqué tout de suite en local)276 Note over A,J: redémarrage possible — le journal est persistant277 A->>S: retour du réseau — rejouer les opérations dans l'ordre278 S-->>A: confirmations ou 409 (conflit affiché, rien d'écrasé)279 A->>S: GET /sync/changes?since=rev280 S-->>A: éléments modifiés + pierres tombales281 A->>J: miroir local à jour282```283284---285286## 🧱 Décisions qui comptent287288- **Deux mécanismes de conservation, distincts.** Les copies « gardées hors ligne » par l'app vivent dans Application289 Support et sont à elle. Les fichiers matérialisés par l'app Fichiers appartiennent au système, qui peut les évincer ;290 l'extension ne promet rien de plus.291- **Suppression.** Supprimer = corbeille du Drive (restaurable), y compris depuis Fichiers. La suppression définitive292 n'existe que depuis la corbeille, avec confirmation et serveur joignable. Libérer de l'espace local est une autre293 action, qui ne touche jamais au Drive.294- **Rien d'écrasé en silence.** Une copie locale modifiée et pas encore envoyée n'est jamais remplacée ni supprimée par295 une synchronisation, un nettoyage de cache ou un désépinglage.296- **Arrière-plan.** iOS décide quand les transferts en arrière-plan tournent ; l'app les reprend là où ils en sont, sans297 promettre de continuité.298- **Chiffrement.** TLS en transit, chiffrement au repos côté serveur, protection des fichiers iOS sur l'appareil. Ce299 n'est pas du chiffrement de bout en bout et l'app le dit.300- **Un seul contrat serveur.** La couche iOS est écrite derrière le protocole `DriveRemote`301 (`Core/API/DriveRemote.swift`) ; c'est le point de raccord prévu avec `SPDriveCore` de l'app macOS.302303---304305## 🧰 Pile technique306307| Couche | Technologie | Version | Rôle |308|---|---|---|---|309| Langage | Swift | 6.0, `SWIFT_STRICT_CONCURRENCY: complete` | tout le code |310| Interface | SwiftUI (+ UIKit ponctuel) | système | tous les écrans |311| Cible | iOS / iPadOS | 18.0 et plus, familles `1,2` | iPhone + iPad ; ni Catalyst, ni « Designed for iPad » sur Mac, ni visionOS |312| Système de fichiers | FileProvider (extension répliquée) | système | emplacement SP Drive dans Fichiers |313| Partage entrant | extension de partage (UIKit) | système | « Envoyer vers SP Drive » |314| Persistance | SQLite 3 (enveloppe `Core/Persistence/SQLite.swift`) | `user_version = 1` | miroir, journal, transferts, conflits |315| Réseau | URLSession (dont session d'arrière-plan) | système | API, blocs, `Range` |316| Authentification | AuthenticationServices | système | passkeys WebAuthn |317| Verrou | LocalAuthentication | système | Face ID / Touch ID |318| Session | Trousseau, groupe partagé | système | jeton `Bearer` d'appareil |319| Aperçu | QuickLook, PDFKit | système | aperçus, annotations, numériseur |320| Arrière-plan | BackgroundTasks (`fetch`, `processing`) | système | rafraîchissement et synchronisation |321| Paquet | Swift Package Manager | tools 6.0 ; iOS 18, macOS 15 | `SPDriveKit` (Core + Sync) pour les tests Mac |322| Projet | XcodeGen | `project.yml` | génère `SPDrive.xcodeproj` (non versionné) |323| Tests | Swift Testing + XCUITest | — | moteur, hébergés, interface |324325---326327## 📁 Arborescence du dépôt328329```330sp-drive-ios/331├── project.yml XcodeGen : app, extension File Provider, extension de partage, tests unitaires et d'interface332├── Package.swift paquet SPDriveKit (Core + Sync) pour les tests sur le Mac333├── App/ (7) point d'entrée, modèle d'app, passkeys, verrou, tâches d'arrière-plan, notifications334├── Core/ (12) API (client HTTP, modèles), base locale SQLite, trousseau, réseau — sans interface, compatible extensions335├── Sync/ (12) moteur : tirage des changements, journal, transferts, conflits, intégrité, fichiers locaux336├── FileProviderExtension/ (4) emplacement SP Drive dans l'app Fichiers337├── ShareExtension/ (1) « Envoyer vers SP Drive » depuis la feuille de partage338├── Features/ (22) écrans SwiftUI par domaine : Account, Home, MyDrive, Offline, Recent, Search, Settings, Shared, Transfers, Trash339├── Components/ (1) identité visuelle et vues réutilisables340├── Resources/ Info.plist, droits, PrivacyInfo, Assets.xcassets (icône claire / sombre / teintée)341├── KitTests/ (2) tests d'intégration de Core + Sync (sur le Mac, contre un vrai backend)342├── Tests/ (3) tests hébergés dans l'app (File Provider, WebAuthn)343├── UITests/ (1) tests d'interface (simulateur)344├── Design/ sources SVG de l'icône (claire, sombre, teintée) et de la marque345├── Scripts/ build.sh, release.sh, test-server.sh, asc.py, ExportOptions.plist346└── docs/ AUDIT.md, TESTS.md, brand/ (logo.svg, icon.png)347```348349Lignes Swift par dossier : App 762 · Core 1 575 · Sync 1 962 · Features 5 106 · Components 135 ·350FileProviderExtension 495 · ShareExtension 207 · KitTests 521 · Tests 217 · UITests 313.351352<details>353<summary><b>Les 12 fichiers du moteur <code>Sync/</code></b></summary>354355| Fichier | Rôle |356|---|---|357| `SyncEngine.swift` | acteur central : tirage du flux de changements, rejeu du journal |358| `MirrorSync.swift` | tirage incrémental du flux de changements vers une base ; partagé par l'app et l'extension File Provider |359| `ChangeDetector.swift` | ce qu'un changement venu du serveur implique pour les copies locales (comparaison par empreinte et version, jamais par date) |360| `ConflictResolver.swift` | garder les deux / la mienne / celle du serveur |361| `TransferQueue.swift` | file persistante, priorités, parallélisme selon le réseau |362| `UploadManager.swift` | envoi par blocs de 8 Mio |363| `DownloadManager.swift` | téléchargement repris par `Range` |364| `DirectTransfer.swift` | envoi et téléchargement directs pour les extensions : bloc par bloc, vérifiés, reprenables |365| `BackgroundSession.swift` | URLSession d'arrière-plan, relance de l'app |366| `IntegrityVerifier.swift` | SHA-256 de fichiers et de tranches, lus en flux (un gros fichier n'est jamais chargé en mémoire) |367| `LocalFiles.swift` | emplacements des contenus : Application Support (hors ligne, en attente d'envoi), Caches (copies ouvertes une fois) ; noms assainis |368| `ShareInbox.swift` | relais extension de partage → app : ce que l'extension n'a pas pu envoyer attend dans le conteneur du groupe |369370</details>371372---373374## 🚀 Construire et tester375376Prérequis : Xcode, [XcodeGen](https://github.com/yonaskolb/XcodeGen), un accès SSH au nœud qui héberge le backend377jetable.378379```bash380Scripts/test-server.sh up # backend jetable sur m5ma:8663 (clone, base et données à part) + tunnel + identifiants de test381Scripts/build.sh core # tests d'intégration Core + Sync sur le Mac382Scripts/build.sh debug # build simulateur (SPDRIVE_SIM="SPDrive iPad" pour la tablette)383Scripts/build.sh release # build Release pour simulateur générique384Scripts/build.sh test # tests hébergés dans l'app (dont le File Provider par le système de fichiers)385Scripts/build.sh uitest # tests d'interface ; captures dans build/shots/386Scripts/build.sh device # build signé pour un appareil réel387Scripts/release.sh archive|export|validate|upload388Scripts/test-server.sh down389```390391- Le projet Xcode est généré par `xcodegen` (`project.yml`) ; `Scripts/build.sh generate` crée aussi les392 `Info-Debug.plist` (réseau local autorisé pour joindre le backend de test par tunnel — jamais en Release,393 `release.sh` le vérifie). `SPDrive.xcodeproj` et les `Info-Debug.plist` ne sont pas versionnés.394- Simulateurs dédiés : « SPDrive iPhone » (défaut) et « SPDrive iPad » ; `SPDRIVE_SIM` choisit.395- `Scripts/test-server.sh` : `up` (clone ou rafraîchit le backend, base et données neuves, démarrage, tunnel,396 identifiants), `creds` (deux comptes neufs avec jeton d'appareil), `tunnel` (rouvre le tunnel), `down`.397 Il ne touche jamais à la production ni au banc d'essai de la session macOS.398- Les tests du simulateur utilisent le second compte de test (les tests du moteur remplissent le premier de centaines399 de dossiers).400- Incrémenter `CURRENT_PROJECT_VERSION` avant chaque envoi à App Store Connect.401402> Le test File Provider par le système de fichiers exige que l'emplacement SP Drive ait été ouvert une fois dans Fichiers403> sur le simulateur (iOS laisse un nouvel emplacement désactivé jusque-là). Lancer d'abord :404> `Scripts/build.sh uitest -only-testing:SPDriveUITests/DriveUITests/testFilesAppShowsSPDriveLocation`.405406---407408## 🔧 Configuration409410Rien de secret ne vit dans le dépôt. Noms seulement :411412| Nom | Où | Rôle |413|---|---|---|414| `SPDriveAppGroup`, `SPDriveKeychainGroup` | `Info.plist` | groupe d'apps et groupe de trousseau partagés avec les extensions |415| `SPDRIVE_SIM` | `Scripts/build.sh` | simulateur utilisé |416| `SPDRIVE_TEST_NODE`, `SPDRIVE_BACKEND_REF` | `Scripts/test-server.sh` | nœud du backend jetable (défaut `m5ma`), branche du backend (défaut `native-clients`) |417| `SPDRIVE_TEST_URL`, `SPDRIVE_TEST_TOKEN`, `SPDRIVE_TEST_TOKEN_B` | `~/.config/spdrive-ios-test/credentials.env` (hors dépôt) | adresse et jetons des deux comptes de test |418| `SPDRIVE_BASE_URL`, `SPDRIVE_RESET` | environnement du lanceur de tests | l'app démarre connectée au backend de test, depuis un état local propre |419| `ASC_KEY_ID`, `ASC_ISSUER_ID` | `Scripts/release.sh` | clé d'API App Store Connect (fichier `.p8` hors dépôt) |420421Réglages du bundle : domaine associé `webcredentials:drive.spboucher.ai`, tâches d'arrière-plan422`ai.spboucher.spdrive.ios.refresh` et `ai.spboucher.spdrive.ios.sync`, modes `fetch` et `processing`, ATS strict en423Release.424425---426427## 🔌 API consommée428429L'app appelle **52 opérations** (méthode + chemin) de l'API « clients natifs » du backend430[sp-drive](https://git.spboucher.ai/sp-drive), sous `/api/v1`, avec un jeton `Bearer` d'appareil. Code :431`Core/API/DriveAPI.swift`, `DriveAPI+Sharing.swift`, `DriveAPI+Account.swift`.432433<details>434<summary><b>Tableau des routes</b></summary>435436| Domaine | Méthode et chemin |437|---|---|438| Authentification | `GET /auth/state` · `POST /auth/login/options` · `POST /auth/login/verify` · `POST /auth/reauth/options` · `POST /auth/reauth/verify` · `POST /auth/device/start` · `POST /auth/device/poll` · `POST /auth/logout` |439| Compte | `GET /account/passkeys` · `POST /account/passkeys/options` · `POST /account/passkeys/verify` · `GET /account/sessions` · `DELETE /account/sessions/:id` |440| Synchronisation | `GET /sync/changes` · `GET /sync/cursor` · `POST /sync/items` |441| Arborescence | `GET /folders/:id/children` · `POST /folders` · `PATCH /folders/:id` · `GET /files/:id` · `PATCH /files/:id` · `POST /move` · `POST /copy` · `GET /search` |442| Corbeille | `POST /trash` · `POST /restore` · `POST /purge` |443| Contenu | `GET /files/:id/content` (`Range`, `If-Range`, `ETag` = SHA-256) · `GET /files/:id/preview/thumb` |444| Versions | `POST /files/:id/versions/:v/restore` · `DELETE /files/:id/versions/:v` |445| Envois | `POST /uploads` · `GET /uploads/:id` · `PATCH /uploads/:id?offset=` · `PATCH /uploads/:id/options` · `POST /uploads/:id/complete` · `DELETE /uploads/:id` |446| Liens de partage | `GET /shares` · `POST /shares` · `PATCH /shares/:id` · `DELETE /shares/:id` · `POST /shares/:id/rotate` · `GET /shares/:id/events` |447| Liens de dépôt | `GET /requests` · `POST /requests` · `PATCH /requests/:id` · `DELETE /requests/:id` · `POST /requests/:id/rotate` · `GET /requests/:id/submissions` · `GET /submissions/:id` |448| Notifications | `GET /notifications` · `POST /notifications/read` |449450</details>451452---453454## 📱 Écrans455456Les 9 sections de la navigation (`Features/Home/RootView.swift`) : barre d'onglets sur iPhone, barre latérale sur iPad.457458| Section | Fichier | Contenu |459|---|---|---|460| Mon Drive | `Features/MyDrive/FolderScreen.swift` (+ `ItemViews`, `ItemActions`, `ItemDetailsView`, `FolderPicker`, `Importers`, `Thumbnails`, `FilePreview`) | explorateur, détails et versions, import, aperçu, éditeur de texte |461| Récents | `Features/Recent/RecentScreen.swift` | fichiers récents |462| Partagés | `Features/Shared/SharedScreen.swift` (+ `ShareLinkEditor`, `DepositLinkEditor`) | liens de partage et de dépôt que l'on a créés |463| Favoris | `Features/Recent/RecentScreen.swift` (`FavoritesScreen`) | éléments marqués d'une étoile |464| Hors ligne | `Features/Offline/OfflineScreen.swift` | fichiers et dossiers gardés hors ligne |465| Transferts | `Features/Transfers/TransfersScreen.swift` | file, pause, reprise, annulation |466| Corbeille | `Features/Trash/TrashScreen.swift` | restaurer, purger, vider |467| Conflits et problèmes | `Features/Settings/ProblemsScreen.swift` | résolution des conflits |468| Paramètres | `Features/Settings/SettingsScreen.swift`, `StorageScreen.swift`, `Features/Account/AccountScreen.swift` | stockage, compte, appareils, verrou, notifications |469470Hors section : connexion (`Features/Account/SignInView.swift` — passkey ou liaison par code) et recherche471(`Features/Search/SearchScreen.swift`).472473> L'onglet « Partagés » liste les liens que l'on a créés : le partage entre comptes n'existe pas côté serveur.474475---476477## 💾 Modèle de données local478479`Core/Persistence/DriveStore.swift` crée **8 tables** (migration unique, `PRAGMA user_version = 1`). L'extension File480Provider utilise le même schéma dans sa propre base.481482| Table | Clé | Rôle |483|---|---|---|484| `items` | `id` | miroir des fichiers et dossiers du serveur : parent, nom, clé de nom, taille, SHA-256, version, `rev`, corbeille, favori, état d'analyse, vignette, extension |485| `local_state` | `item_id` | état local d'un élément : épinglé, emplacement, empreinte et version de base, taille locale, modifié (`dirty`), dates |486| `ops` | `id` auto | journal des opérations faites hors ligne : type, cible, nom, état, essais, code d'erreur |487| `transfers` | `id` | file des transferts : sens, taille, progression, état, priorité, identifiant d'envoi, chemin local, empreinte |488| `conflicts` | `id` auto | conflits détectés : élément, nom, raison, envoi concerné |489| `tombstones` | `id` | suppressions connues, par révision |490| `recent_searches` | `text` | recherches récentes |491| `meta` | `key` | curseur de synchronisation et autres valeurs |492493```mermaid494erDiagram495 items ||--o| local_state : "copie locale"496 items ||--o{ ops : "opérations en attente"497 items ||--o{ transfers : "transferts"498 items ||--o{ conflicts : "conflits"499 ops ||--o{ transfers : "op_id"500 items {501 TEXT id PK502 INTEGER is_folder503 TEXT parent_id504 TEXT name505 TEXT sha256506 TEXT version_id507 INTEGER rev508 REAL trashed_at509 INTEGER starred510 }511 local_state {512 TEXT item_id PK513 INTEGER pinned514 TEXT base_sha515 TEXT base_version_id516 INTEGER dirty517 }518 ops {519 INTEGER id PK520 TEXT kind521 TEXT item_id522 TEXT state523 INTEGER attempts524 }525 transfers {526 TEXT id PK527 TEXT kind528 TEXT item_id529 INTEGER op_id530 TEXT state531 INTEGER priority532 TEXT upload_id533 }534 conflicts {535 INTEGER id PK536 TEXT item_id537 TEXT reason538 TEXT upload_id539 }540```541542Index : `items_parent`, `items_name`, `items_updated`, `items_rev`, `transfers_state`, `tombstones_rev`.543544---545546## 🔒 Sécurité et confidentialité547548- **Connexion** : passkey native (domaine associé `webcredentials:drive.spboucher.ai`) ; en secours, liaison par code549 approuvée dans un navigateur.550- **Session d'appareil** : jeton `Bearer` rangé dans le trousseau, dans un groupe partagé avec les deux extensions ;551 révocable depuis la liste des appareils connectés.552- **Verrou** Face ID / Touch ID optionnel.553- **Chiffrement** : TLS en transit, chiffrement au repos côté serveur, protection des fichiers iOS sur l'appareil.554 **Ce n'est pas du chiffrement de bout en bout** : le serveur détient les clés, et l'app ne prétend pas autre chose.555- **Intégrité** : chaque bloc envoyé porte son SHA-256, le serveur vérifie celui du fichier entier ; un téléchargement556 est vérifié avant d'être installé — un fichier partiel de bonne taille mais au contenu faux n'est jamais installé.557- **Photos** : sélecteur système, aucun accès global à la photothèque.558- **Release** : `release.sh archive` refuse une archive qui contiendrait un commutateur de test ou qui autoriserait le559 réseau local ; il affiche les droits de l'app et de chaque extension.560- **Isolation** : aucune base n'est ouverte par deux processus.561562| Autorisation | Texte affiché |563|---|---|564| Face ID | « SP Drive utilise Face ID pour déverrouiller tes fichiers sur cet appareil. » |565| Appareil photo | « SP Drive utilise l'appareil photo pour prendre une photo ou numériser un document et l'envoyer dans ton Drive. » |566567Chaque cible (app, File Provider, partage) embarque son `PrivacyInfo.xcprivacy`.568569---570571## 🧪 Tests572573« Vérifié » = commande exécutée, résultat observé. Aucun résultat n'est simulé : les tests parlent à un **vrai backend574SP Drive** (clone jetable de la branche `native-clients`, PostgreSQL réel, m5ma:8663), jamais à un double.575576| Suite | Commande | Où | Résultat (2026-11-18) |577|---|---|---|---|578| Moteur (Core + Sync) | `Scripts/build.sh core` | Mac, 2 à 3 « appareils » simulés (base et stockage séparés) | **12 / 12** |579| Tests hébergés dans l'app | `Scripts/build.sh test` | simulateur iPhone | **6 / 6** (1 File Provider + 5 unitaires) |580| Interface iPhone | `Scripts/build.sh uitest` | « SPDrive iPhone » (iPhone 17 Pro, iOS 27.2) | **4 / 4** |581| Interface iPad | `SPDRIVE_SIM="SPDrive iPad" Scripts/build.sh uitest` | « SPDrive iPad » (iPad Pro 11 po) | **4 / 4** (3 dans la suite complète ; le test Fichiers relancé seul après correction du test) |582| Build Release + signature | `Scripts/release.sh archive` | appareil générique | archive produite, droits vérifiés |583| Validation Apple | `Scripts/release.sh export` puis `validate` | App Store Connect | « VERIFY SUCCEEDED with no errors » |584| Envoi TestFlight | `Scripts/release.sh upload` | App Store Connect | 1.0.0 (1) `VALID`, en test interne |585586<details>587<summary><b>Les 12 tests du moteur — <code>KitTests/SyncTests.swift</code></b></summary>5885891. Session d'appareil et dossier racine.5902. Créer, renommer, déplacer, mettre en favori, corbeille, restauration : visibles tout de suite en local, puis sur le591 serveur et sur un deuxième appareil.5923. Noms : doublon refusé, nom invalide refusé (`../…`), nom libre choisi à la création.5934. Envoi puis téléchargement sur un autre appareil, empreinte SHA-256 identique, copie réutilisée sans nouveau transfert.5945. **Fichier de 20 Mio en trois blocs**, deuxième bloc coupé deux fois : reprise au décalage du serveur ; téléchargement595 coupé puis repris ; reprise `Range` à partir d'un fichier partiel de 11 Mo.5966. **Intégrité** : un fichier partiel de bonne taille mais au contenu faux n'est jamais installé ; le vrai contenu est597 récupéré.5987. **Hors ligne + redémarrage + reconnexion** : fichier gardé hors ligne modifié, dossier créé, fichier ajouté dedans,599 dossier renommé, le tout sans réseau ; nouvelle instance du moteur sur le même stockage ; retour du réseau ; tout est600 sur le serveur, l'ancienne version reste dans l'historique.6018. **Conflits** : même fichier modifié hors ligne ici et en ligne ailleurs, trois fois ; rien n'est écrasé ; « garder les602 deux » (copie « (conflit …) »), « garder la mienne » (3 versions sur le serveur), « garder celle du serveur ».6039. Modifié ici, supprimé définitivement ailleurs : la modification est conservée, puis renvoyée comme nouveau fichier.60410. Dossier gardé hors ligne : nouveaux fichiers et nouvelles versions récupérés seuls ; lecture hors ligne ; libérer605 l'espace ne supprime rien sur le Drive.60611. Annulation d'un envoi jamais parti, cache vidé sans toucher au Drive, pause et reprise d'un téléchargement.60712. Recherche locale hors ligne (accents, type, extension, taille, caractères `%` et `_` littéraux) et recherche serveur.608609</details>610611**File Provider — `Tests/FileProviderTests.swift`.** Par le système de fichiers du domaine, avec coordination de612fichiers, comme le fait une app tierce ; chaque effet est vérifié sur le serveur par un second client : domaine613enregistré, listage, **téléchargement à la demande** (contenu identique), **document créé par une autre app** envoyé,614**modification** devenue nouvelle version (l'ancienne dans l'historique), renommage, changement distant visible,615suppression = corbeille du Drive. `Tests/WebAuthnTests.swift` ajoute 5 tests unitaires (base64url, options d'assertion et d'enregistrement lues du JSON du serveur, forme de la réponse d'assertion, noms de fichiers qui ne sortent jamais de leur dossier).616617**Interface — `UITests/DriveUITests.swift`** (4 tests) :618619| Test | Parcours |620|---|---|621| `testSignedOutShowsPasskeyAndDeviceLink` | écran de connexion ; liaison par code (le code vient du vrai serveur) |622| `testExplorerEndToEnd` | première synchronisation, création d'un dossier (vérifiée sur le serveur), ouverture dans QuickLook, renommage, favori, « garder hors ligne », grille, lien de partage réel, relance de l'app (l'état local et l'épinglage survivent), écrans Hors ligne, Favoris, Partagés, Transferts, Paramètres |623| `testTrashRestoreAndSearch` | corbeille (vérifiée sur le serveur), restauration, recherche insensible aux accents |624| `testFilesAppShowsSPDriveLocation` | **app Fichiers** : SP Drive figure dans les emplacements ; son contenu est listé par l'extension |625626Captures : `build/shots/<simulateur>/`.627628### Scénario de validation du cahier des charges (15 étapes)629630| # | Étape | État |631|---|---|---|632| 1 | Installer sur un iPhone | **Non fait** : aucun iPhone n'était branché. Build disponible sur TestFlight. |633| 2 | Se connecter | Passkey : **non vérifié sur appareil**. Code écrit, association de domaine en production, encodage testé. Liaison par code : vérifiée jusqu'à l'affichage du code réel. |634| 3 | SP Drive dans Fichiers | Vérifié sur simulateurs iPhone et iPad. |635| 4 | Ouvrir un dossier distant | Vérifié (app et Fichiers). |636| 5 | Télécharger un fichier | Vérifié (app ; à la demande dans Fichiers). |637| 6 | Marquer hors ligne | Vérifié. |638| 7 | Mode avion | **Non vérifié sur appareil.** Équivalent testé : réseau coupé au niveau des requêtes dans les tests du moteur. |639| 8–10 | Ouvrir, modifier, enregistrer hors ligne | Moteur : vérifié. Édition par QuickLook ou par une app tierce via Fichiers hors ligne : **non vérifié sur appareil**. |640| 11–12 | Redémarrer, modifications conservées | Moteur : vérifié par relance sur le même stockage. Redémarrage réel d'un iPhone : **non fait**. |641| 13–15 | Reconnexion, synchronisation, aucune perte | Moteur : vérifié. Appareil réel : **non fait**. |642643---644645## 📦 Publication646647Distribution **TestFlight** (App Store Connect).648649```bash650# incrémenter CURRENT_PROJECT_VERSION dans project.yml, puis :651Scripts/release.sh archive # archive Release, affiche les droits, contrôle « aucun commutateur de test, ATS strict »652Scripts/release.sh export # IPA (Scripts/ExportOptions.plist)653Scripts/release.sh validate # validation par Apple654Scripts/release.sh upload # envoi à TestFlight655```656657| Élément | Valeur |658|---|---|659| Équipe | `3YM54G49SN` |660| Signature | automatique ; **l'archive est signée avec le compte Apple ID configuré dans Xcode** (les groupes d'apps ne se provisionnent pas avec une clé d'API App Store Connect) |661| Clé d'API App Store Connect | utilisée pour l'export, la validation et l'envoi ; le fichier reste hors dépôt |662| Fiche | `6836524538`, SKU `spdrive-ios-001` |663| État | 1.0.0 (1) `VALID`, test interne TestFlight (2026-11-18) |664665---666667## 🛰 Backend668669L'app ne modifie rien sur le serveur. Elle utilise l'API « clients natifs » de670[sp-drive](https://git.spboucher.ai/sp-drive) (branche `native-clients`, en production depuis le 2026-11-18), écrite par671la session qui construit SP Drive macOS. Toute évolution du serveur passe par le dépôt `sp-drive` sur son nœud (m5ma,672port 8660, PM2 via l'orchestrateur `mld`, exposition par le MacLustr Tunnel), pas par ce projet.673674<details>675<summary><b>Ce que l'audit du backend a établi (2026-11-18)</b></summary>676677| Sujet | Constat vérifié |678|---|---|679| Pile | Fastify 5 + PostgreSQL 17 + worker (antivirus ClamAV, aperçus), SPA React servie par l'API, PM2 via `mld`. |680| Stockage | Objets chiffrés au repos (AES-256-GCM par blocs, clé par objet enveloppée par une clé maîtresse sur le nœud). TLS jusqu'à la passerelle, WireGuard ensuite. Pas de chiffrement de bout en bout. |681| Arborescence | `folders` / `files` par propriétaire, identifiants UUID stables, unicité des noms par dossier (NFC + minuscules), corbeille logique (`trashed_at`, `trash_root`), purge définitive séparée. |682| Versions | `file_versions` numérotées ; restaurer crée une nouvelle version ; la version courante ne se supprime pas. |683| Envoi | Protocole résumable : `POST /uploads` → `PATCH /uploads/:id?offset=` (blocs ≤ 16 Mio, `X-Chunk-SHA256`) → `POST /uploads/:id/complete` (SHA-256 du fichier vérifié par le serveur). Décalage refusé = le serveur renvoie le décalage réel. |684| Téléchargement | `GET /files/:id/content` avec `Range`, `If-Range` et `ETag` = SHA-256. |685| Authentification | Passkeys WebAuthn uniquement (RP `drive.spboucher.ai`), comptes sur invitation. Web : cookie de session + en-tête CSRF. |686| Partage | Liens de partage (fichier ou dossier, lecture seule ou téléchargement, mot de passe, expiration, plafonds, usage unique, rotation, révocation immédiate, journal d'accès). Jeton montré une seule fois. |687| Liens de dépôt | « Portails » : le déposant n'obtient qu'un jeton de soumission. Quarantaine → antivirus → placement dans le dossier cible. Limites réévaluées à chaque bloc. |688| Partage entre comptes | **N'existe pas** côté serveur. |689| Recherche | Par nom (insensible aux accents), type, favoris, dates, taille. Pas de plein texte. |690691Ajouts faits pour les clients natifs (branche `native-clients`, migration `002_native_clients`) :692693| Besoin | Ajout |694|---|---|695| Passkeys natives | `/.well-known/apple-app-site-association` (`webcredentials`, App ID de l'app iOS inclus). |696| Session d'appareil | `POST /auth/login/verify` avec `client: {kind: "native"}` → jeton `Bearer`, jamais tourné, durée glissante (400 jours repoussés à chaque usage, fermé après 90 jours de silence), révocable dans la liste des sessions. |697| Connexion de secours | Liaison par code (`/auth/device/start`, `/auth/device/poll`, approbation dans un navigateur sur `/appareil`). |698| Synchronisation incrémentale | Colonne `rev` monotone par propriétaire + pierres tombales ; `GET /sync/changes?since=`, `GET /sync/cursor`, `POST /sync/items`. |699| Conflits | `baseVersionId` à la création d'un envoi → `409 version_conflict` ; `PATCH /uploads/:id/options {asNewFile}` transforme l'envoi refusé en copie de conflit sans renvoyer les octets. |700701</details>702703**`SPDriveCore` (app macOS) — état de la réutilisation, sans l'embellir.** L'app iOS ne lie pas encore les paquets704`SPDriveCore` / `SPDriveSync` de [sp-drive-macos](https://git.spboucher.ai/sp-drive-macos). Les deux implémentations705parlent la même API mais ne partagent pas de code aujourd'hui. Le point de raccord prévu est un adaptateur706`DriveRemote` → `APIClient` de `SPDriveCore` ; il reste à écrire.707708---709710## 📊 Parité web, macOS, iPhone, iPad711712✔ = présent et vérifié ; ◐ = présent, vérification partielle ; ✘ = absent ; — = sans objet ; ? = fonction de l'app713macOS non vérifiée par cette session. Source : [`docs/AUDIT.md`](docs/AUDIT.md).714715<details>716<summary><b>Matrice complète</b></summary>717718| Fonction | Web | macOS | iPhone | iPad |719|---|---|---|---|---|720| Parcourir dossiers et fichiers | ✔ | ✔ | ✔ | ✔ |721| Liste / grille, tri, filtres | ✔ | ✔ | ✔ | ✔ |722| Créer, renommer, déplacer, dupliquer | ✔ | ✔ | ✔ | ✔ |723| Envoi résumable par blocs + SHA-256 | ✔ | ✔ | ✔ | ✔ |724| Téléchargement avec reprise (`Range`) + vérification | ✔ (navigateur) | ✔ | ✔ | ✔ |725| Transferts en arrière-plan (URLSession background) | — | — | ◐ (jamais observé sur appareil réel) | ◐ |726| Hors ligne : fichiers et dossiers gardés, modifications différées | ✘ | ✔ | ✔ | ✔ |727| Synchronisation incrémentale bidirectionnelle | — | ✔ | ✔ | ✔ |728| Conflits sans écrasement + interface de résolution | ✘ (versions seulement) | ✔ | ✔ | ✔ |729| Intégration au système de fichiers | — | ◐ Finder | ✔ app Fichiers (simulateur) | ✔ app Fichiers (simulateur) |730| Aperçus | ✔ pdf.js etc. | ✔ | ✔ QuickLook | ✔ |731| Modification depuis l'app | ✘ | ◐ | ✔ annotations QuickLook, éditeur de texte | ✔ |732| Liens de partage (création, réglages, rotation, révocation, journal) | ✔ | ✔ | ✔ | ✔ |733| Liens de dépôt (création, limites, soumissions) | ✔ | ✔ | ✔ | ✔ |734| Formulaire de dépôt personnalisé (champs, consentement, marque) | ✔ | ? | ✘ (réglages essentiels seulement) | ✘ |735| Versions : liste, téléchargement, restauration, suppression | ✔ | ✔ | ✔ | ✔ |736| Corbeille : restaurer, purger, vider | ✔ | ✔ | ✔ | ✔ |737| Recherche serveur | ✔ | ✔ | ✔ | ✔ |738| Recherche hors ligne (index local) | ✘ | ✔ | ✔ | ✔ |739| Favoris, récents | ✔ | ✔ | ✔ | ✔ |740| Tags | ✔ | ? | ✘ | ✘ |741| Doublons | ✔ | ? | ✘ | ✘ |742| Passkey | ✔ | ✔ | ◐ (code + AASA en production ; jamais exécuté sur un appareil réel) | ◐ |743| Verrou biométrique de l'app | — | ? | ◐ (jamais exécuté sur un appareil réel) | ◐ |744| Import Photos / appareil photo / numériseur / feuille de partage | ◐ (navigateur) | — | ◐ (sélecteurs système : non pilotables en test) | ◐ |745| Glisser-déposer, clavier matériel, multifenêtre | ✔ (bureau) | ✔ | — | ◐ (non testé automatiquement) |746| Administration (utilisateurs, quotas, invitations), TOTP, codes de récupération, création de compte | ✔ | ? | ✘ (reste sur le web) | ✘ |747| Notifications | dans l'app | ? | locales ; pas de push APNs | idem |748749</details>750751---752753## 🩺 Pièges connus754755- **Première utilisation dans Fichiers** : iOS demande une fois « Activer SP Drive ? » à l'ouverture de l'emplacement.756 Tant que ce n'est pas fait, l'extension répond « La synchronisation n'est pas activée » (erreur -2011) et rien n'est757 listé. Les tests appuient sur « Activer ».758- **Groupes d'apps et signature** : l'archive doit être signée avec le compte Apple ID de Xcode ; la clé d'API759 App Store Connect ne peut pas provisionner un groupe d'apps.760- **Tests d'interface lents** (10 min pour le parcours complet) : avec un menu contextuel ouvert, l'app n'est jamais761 « au repos » pour XCTest, qui attend 60 s à chaque fois. Cause non élucidée (probablement l'animation du menu système).762- **Compte de test vidé** par chaque test d'interface (corbeille puis purge) : ne jamais pointer ces tests vers la763 production (`Scripts/build.sh` n'utilise que le backend jetable).764- **Backend de test injoignable** : `Scripts/build.sh test` s'arrête avec « test backend unreachable » →765 `Scripts/test-server.sh up` (ou `tunnel` si seul le tunnel est tombé).766- **pnpm sur le nœud de test** : `pnpm install` peut sortir en erreur sur le script de build ignoré d'esbuild ;767 `test-server.sh` le tolère (tsx fonctionne sans).768- **Tunnel SSH** : il utilise sa propre connexion (pas de `ControlMaster` partagé, qui fermerait la redirection à son769 expiration).770- **`Info-Debug.plist`** : générés, non versionnés ; `release.sh` refuse une archive Release où le réseau local serait771 autorisé.772773---774775## 🚧 Reste à faire et limites connues776777### Construit, non vérifié778779- **Tout ce qui demande un appareil réel** : passkey + Face ID, verrou biométrique, mode avion, redémarrage, transferts780 pendant que l'app est suspendue ou tuée (URLSession background), comportement de Fichiers hors ligne (file d'attente du781 système), mémoire de l'extension sur de très gros fichiers.782- **Sélecteurs système** (non pilotables par les tests) : import Photos, appareil photo, numériseur, sélecteur Fichiers,783 extension de partage (compile et s'installe ; jamais exécutée de bout en bout).784- **Écrans** exercés seulement en partie par les tests : détails et versions d'un fichier, liens de dépôt (création,785 soumissions), conflits et problèmes, stockage, compte et appareils, éditeur de texte, sélection multiple, déplacement786 par sélecteur de dossier.787- **iPad** : glisser-déposer entre apps, clavier matériel, multifenêtre ; le test File Provider par le système de788 fichiers n'a été exécuté que sur le simulateur iPhone.789- **Performance** : aucun profilage Instruments ; jamais essayé avec des milliers de fichiers (les listes sont paginées790 côté base et paresseuses côté interface, sans mesure).791- **Notifications** : jamais observées (l'autorisation système n'est pas accordée dans les tests).792793### Non fait794795- Liaison du paquet `SPDriveCore` de l'app macOS.796- Tags, doublons, administration, formulaire de dépôt personnalisé, création de compte par invitation, TOTP et codes de797 récupération : restent sur le web.798- Notifications push (APNs) ; l'app sonde le serveur quand iOS lui donne la main.799- Anglais (interface en français seulement).800- Glisser un dossier entier depuis une autre app fonctionne par code mais n'a pas été essayé.801802---803804## 👤 Auteur805806<div align="center">807<img src="docs/brand/icon.png" width="64" height="64" alt="">808<br>809810**Simon-Pierre Boucher** — conception, développement, exploitation811<br>812[www.spboucher.ai](https://www.spboucher.ai) · [git.spboucher.ai](https://git.spboucher.ai) · contact@spboucher.ai813814</div>815816---817818## 📄 Licence819820Logiciel privé. Tous droits réservés © 2026 Simon-Pierre Boucher.821