SPB Git

Repository Public

README.md 51.4 KB 821 lines markdown

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[![drive.spboucher.ai](https://img.shields.io/website?url=https%3A%2F%2Fdrive.spboucher.ai&label=drive.spboucher.ai&style=for-the-badge&up_message=en%20ligne&down_message=hors%20ligne)](https://drive.spboucher.ai)22![version](https://img.shields.io/badge/version-2.0.0%20%282%29%20%C2%B7%20branche%20next-blue?style=for-the-badge)23![plateforme](https://img.shields.io/badge/plateforme-iOS%20%C2%B7%20iPadOS%2018.0%2B-000000?style=for-the-badge&logo=apple&logoColor=white)24![langue](https://img.shields.io/badge/langues-fran%C3%A7ais%20%C2%B7%20anglais%20partiel-8A2BE2?style=for-the-badge)25![licence](https://img.shields.io/badge/licence-tous%20droits%20r%C3%A9serv%C3%A9s-lightgrey?style=for-the-badge)26![author](https://img.shields.io/badge/author-Simon--Pierre%20Boucher-0A66C2?style=for-the-badge)2728![Swift](https://img.shields.io/badge/Swift-6.0%20%C2%B7%20concurrence%20stricte-F05138?style=flat-square&logo=swift&logoColor=white)29![SwiftUI](https://img.shields.io/badge/SwiftUI-%2B%20UIKit%20ponctuel-0D96F6?style=flat-square&logo=swift&logoColor=white)30![File Provider](https://img.shields.io/badge/File%20Provider-extension%20r%C3%A9pliqu%C3%A9e-4f46e5?style=flat-square&logo=apple&logoColor=white)31![Share Extension](https://img.shields.io/badge/Share%20Extension-Envoyer%20vers%20SP%20Drive-8b3dea?style=flat-square)32![SQLite](https://img.shields.io/badge/SQLite-miroir%20local%20%C2%B7%20sch%C3%A9ma%20v1-003B57?style=flat-square&logo=sqlite&logoColor=white)33![URLSession](https://img.shields.io/badge/URLSession-arri%C3%A8re--plan-555555?style=flat-square)34![Passkeys](https://img.shields.io/badge/AuthenticationServices-passkeys-3423A6?style=flat-square&logo=webauthn&logoColor=white)35![QuickLook](https://img.shields.io/badge/QuickLook-aper%C3%A7u%20%2B%20annotations-555555?style=flat-square)36![PDFKit](https://img.shields.io/badge/PDFKit-num%C3%A9riseur-555555?style=flat-square)37![Swift Package](https://img.shields.io/badge/Swift%20Package-SPDriveKit%20%28Core%20%2B%20Sync%29-F05138?style=flat-square&logo=swift&logoColor=white)38![XcodeGen](https://img.shields.io/badge/XcodeGen-project.yml-1575F9?style=flat-square&logo=xcode&logoColor=white)39![dépendances](https://img.shields.io/badge/d%C3%A9pendances%20externes-0-success?style=flat-square)4041[![commits](https://git.spboucher.ai/badge/sp-drive-ios/commits.svg?style=flat-square)](https://git.spboucher.ai/sp-drive-ios/commits)42[![last commit](https://git.spboucher.ai/badge/sp-drive-ios/last-commit.svg?style=flat-square)](https://git.spboucher.ai/sp-drive-ios/commits)43[![activity](https://git.spboucher.ai/badge/sp-drive-ios/activity.svg?style=flat-square)](https://git.spboucher.ai/sp-drive-ios/insights)44[![language](https://git.spboucher.ai/badge/sp-drive-ios/language.svg?style=flat-square)](https://git.spboucher.ai/sp-drive-ios)45[![languages](https://git.spboucher.ai/badge/sp-drive-ios/languages.svg?style=flat-square)](https://git.spboucher.ai/sp-drive-ios/insights)46[![size](https://git.spboucher.ai/badge/sp-drive-ios/size.svg?style=flat-square)](https://git.spboucher.ai/sp-drive-ios)47[![branches](https://git.spboucher.ai/badge/sp-drive-ios/branches.svg?style=flat-square)](https://git.spboucher.ai/sp-drive-ios/branches)48[![tags](https://git.spboucher.ai/badge/sp-drive-ios/tags.svg?style=flat-square)](https://git.spboucher.ai/sp-drive-ios/tags)49[![clones](https://git.spboucher.ai/badge/sp-drive-ios/clones.svg?style=flat-square)](https://git.spboucher.ai/sp-drive-ios)5051![fichiers Swift](https://img.shields.io/badge/fichiers%20Swift-97-informational?style=flat-square)52![lignes Swift](https://img.shields.io/badge/lignes%20Swift-18%20462-informational?style=flat-square)53![cibles](https://img.shields.io/badge/cibles-app%20%2B%203%20extensions%20%2B%202%20tests-informational?style=flat-square)54![opérations API](https://img.shields.io/badge/op%C3%A9rations%20API-52-blue?style=flat-square)55![tables locales](https://img.shields.io/badge/tables%20SQLite-8-blue?style=flat-square)56![sections](https://img.shields.io/badge/sections-9-blue?style=flat-square)57![tests moteur](https://img.shields.io/badge/tests%20moteur-40-brightgreen?style=flat-square)58![tests hébergés](https://img.shields.io/badge/tests%20h%C3%A9berg%C3%A9s-10-brightgreen?style=flat-square)59![tests d'interface](https://img.shields.io/badge/tests%20d'interface-15%20%C2%B7%20iPhone%20%2B%20iPad-brightgreen?style=flat-square)60![blocs](https://img.shields.io/badge/envoi-blocs%20de%208%20Mio%20%2B%20SHA--256-informational?style=flat-square)6162![bundle](https://img.shields.io/badge/bundle-ai.spboucher.spdrive.ios-555555?style=flat-square&logo=apple&logoColor=white)63![groupe d'apps](https://img.shields.io/badge/groupe-group.ai.spboucher.spdrive.ios-555555?style=flat-square)64![signature](https://img.shields.io/badge/signature-automatique%20%C2%B7%20compte%20Xcode-34C759?style=flat-square)65![TestFlight](https://img.shields.io/badge/TestFlight-1.0.0%20%281%29%20%C2%B7%202026--11--18-0D96F6?style=flat-square&logo=apple&logoColor=white)66![App Store Connect](https://img.shields.io/badge/App%20Store%20Connect-6836524538-0D96F6?style=flat-square)67![backend](https://img.shields.io/badge/backend-m5ma%3A8660%20%C2%B7%20MacLustr%20Tunnel-8A2BE2?style=flat-square)6869</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
Files main
Menu

Theme