Repository Public
1<!--2SP Drive iOS3File: docs/TESTS.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# État des tests89## SP Drive 2.0, phase 2 — exécution finale du 2026-11-191011« Vérifié » = commande exécutée, résultat observé. **Simulateur seulement** (iOS 27.0, « SPDrive iPhone » et « SPDrive iPad ») ;12backend jetable m5ma:8663 sur la branche `next` au commit **`0073557`** (celui qui est en production), jamais la production ;13paquet partagé `SPDriveNext` au commit **`c6c11d2`** du dépôt macOS. **Aucun vrai modèle de langage** : le fournisseur14`maclustr` du banc d'essai est le faux point d'accès `scripts/fake-llm.mjs` du backend.1516Code de l'app testé : commit **`66cddfb`**. Les commits suivants ne touchent que le banc des tests moteur17(`KitTests/Harness.swift`, `Scripts/test-server.sh`) et la documentation ; l'app et ses extensions sont identiques.1819| Suite | Commande | Résultat |20|---|---|---|21| Moteur (Mac, vrai backend) | `Scripts/build.sh core` | **40 / 40** (8 suites), deux exécutions de suite. Dans la chaîne finale lancée sur `66cddfb`, cette suite avait échoué (6 tests) : le serveur 2.0 limite chaque adresse à 900 requêtes par minute et tous les « appareils » simulés arrivaient de 127.0.0.1. Le banc donne maintenant à chaque appareil simulé sa propre adresse (`X-Forwarded-For`, serveur de test en `SPD_TRUST_PROXY`) |22| Interface iPhone, en une fois | `Scripts/build.sh uitest` | 15 tests : **13 réussis, 1 ignoré** (réservé à l'iPad), **1 échec** : `testFilesAppShowsSPDriveLocation` (le fichier du dossier n'est pas apparu dans Fichiers en 30 s après la première activation de l'emplacement). **Relancé seul aussitôt : réussi.** |23| Tests hébergés iPhone | `Scripts/build.sh test` | **10 / 10** (dont le File Provider par le système de fichiers) |24| Interface iPad, en une fois | `SPDRIVE_SIM="SPDrive iPad" Scripts/build.sh uitest` | **15 / 15** |25| Tests hébergés iPad | `SPDRIVE_SIM="SPDrive iPad" Scripts/build.sh test` | **10 / 10** |26| Build Release (simulateur générique) | `Scripts/build.sh release` | réussi |27| Version | `xcodebuild -showBuildSettings` (Release) | `MARKETING_VERSION = 2.0.0`, `CURRENT_PROJECT_VERSION = 2` |2829Les 15 tests d'interface : `DriveUITests` 4 (1.0), `NextUITests` 5 (phase 1), `Next2UITests` 3 (écrans 2.0, dont « un serveur 1.030ne montre aucune commande 2.0 »), `SystemUITests` 2 (widget posé sur l'écran d'accueil ; extension de partage depuis Photos),31`LaunchPerfTests` 1. Le test de partage depuis Photos a été ignoré sur iPad lors d'une exécution précédente (menu de Photos32différent) et a réussi lors de l'exécution finale.3334### Mesures de l'exécution finale (Debug, simulateur ; comparatives seulement)3536| Mesure | iPhone | iPad |37|---|---|---|38| Lancement à froid → première image (5 lancements, app connectée) | 0,746 s | 0,769 s |39| Dossier de 1 000 éléments : lecture du miroir | 3,3 ms | 3,2 ms |40| Dossier de 1 000 éléments : rendu de l'explorateur | 236,0 ms | 232,8 ms |4142Référence `main` (1.0), mesurée en phase 1 sur le simulateur iPhone : 0,757 s · 3,7 ms · 213,5 ms. La mesure de lancement de la43phase 1 lançait l'app déconnectée ; celle-ci la lance connectée (pour ne pas perturber l'emplacement Fichiers).4445### Construit, non vérifié (phase 2)4647- Tout appareil réel (voir `next/DELIVERY-CHECKLIST.md` §3).48- SP Drive AI avec un vrai modèle ; fournisseurs externes (le serveur de test ne les active pas : l'interrupteur de consentement est construit, son effet n'a pas été observé).49- Recherche par le sens : la commande et l'appel existent ; aucun test n'en vérifie les résultats. Le cas `503 busy` n'a pas été provoqué.50- Rôle « modification » dans un dossier partagé (création, renommage, corbeille, envoi) : construit, non testé. Lecteur et déposant : testés.51- Comparaison de versions d'images et de PDF, doublons d'images similaires, suggestions de rangement (écran), vue d'infrastructure (écran), réglage de limite de débit (écran) : construits ; leurs appels sont testés côté moteur quand c'est indiqué dans `next/AUDIT-iOS.md` §7, leurs écrans ne sont pas pilotés par un test.52- Plafond d'envois en attente d'un partage (`413`), `503` du flux d'évènements : gérés, non provoqués.53- Anglais : 638 chaînes ; ce qui reste en français est listé dans `next/PHASE2-iOS.md` §5.5455---5657# État des tests de la phase 1 (2026-11-19, backend 1.0)5859## SP Drive Next (2.0), phase 1 — 2026-11-19, branche `next`6061« Vérifié » = commande exécutée ce jour-là, résultat observé. **Simulateur seulement** : aucun appareil réel n'était branché.62Backend : instance jetable m5ma:8663 (branche `native-clients`, `7bd8972`), jamais la production. Détail de ce que chaque test63prouve : [`next/AUDIT-iOS.md`](next/AUDIT-iOS.md) §3 ; captures : [`next/shots/`](next/shots/).6465| Suite | Commande | Où | `main` (1.0) relancé avant tout changement | `next` |66|---|---|---|---|---|67| Moteur (Core + Sync + Capture) | `Scripts/build.sh core` | Mac, appareils simulés, vrai backend | 12 / 12 | **33 / 33** (6 suites : `SyncTests` 12, `EngineNextTests` 11, `PolicyLogicTests` 3, `ScanPipelineTests` 3, `ShareIntakeTests` 3, `ShareInboxTests` 1) |68| Tests hébergés dans l'app | `Scripts/build.sh test` | simulateur « SPDrive iPhone » (iOS 27.0) | 6 / 6 | **10 / 10** (File Provider par le système de fichiers, annotation PDF → nouvelle version → conflit, instantané des widgets, liens `spdrive://`, mesure 1 000 éléments, 5 unitaires) |69| Tests hébergés, iPad | `SPDRIVE_SIM="SPDrive iPad" Scripts/build.sh test` | simulateur « SPDrive iPad » | non relancé | **10 / 10** |70| Interface iPhone | `Scripts/build.sh uitest` | simulateur « SPDrive iPhone » | 3 / 4 (`testExplorerEndToEnd` échoue sur `main` à « share URL shown ») | **9 / 9** + 1 ignoré (test réservé à l'iPad) : `DriveUITests` 4, `NextUITests` 4, `LaunchPerfTests` 1 |71| Interface iPad | `SPDRIVE_SIM="SPDrive iPad" Scripts/build.sh uitest` | simulateur « SPDrive iPad » | non relancé | **10 / 10** en deux exécutions : `DriveUITests` 4 + `LaunchPerfTests` 1 dans la suite complète ; `NextUITests` 5 / 5 relancés seuls après deux corrections (pastille de transferts absente sur iPad, test de l'inspecteur passé en paysage). La suite complète n'a pas été relancée d'un seul tenant après ces corrections. |7273Ordre à respecter : le test hébergé du File Provider exige que l'emplacement SP Drive ait été ouvert une fois dans Fichiers après74la dernière remise à zéro. `LaunchPerfTests` remet l'app à zéro : lancé juste avant `build.sh test`, il fait échouer ce test75(`NSFileProviderErrorDomain -2001`, observé le 2026-11-19) ; relancer `testFilesAppShowsSPDriveLocation` puis `build.sh test`76(10 / 10 observé ensuite).7778### Mesures (Debug, simulateur, Mac occupé par d'autres travaux : elles comparent les deux versions entre elles, rien de plus)7980| Mesure | Méthode | `main` | `next` |81|---|---|---|---|82| Lancement à froid → première image | `XCTApplicationLaunchMetric`, 5 itérations, simulateur iPhone | 0,757 s (0,722–0,804) | 0,742 s (0,715–0,779) ; iPad 0,756 s |83| Lecture d'un dossier de 1 000 éléments dans le miroir SQLite | `Tests/PerfTests.swift`, médiane de 7 | 3,7 ms | 3,3 ms |84| Rendu de l'explorateur sur ce dossier (création de l'écran → première image validée) | même test, médiane de 7, simulateur iPhone | 213,5 ms | 228,0 ms (iPad : 103,2 ms) |8586### Construit en phase 1, non vérifié (appareil réel nécessaire, sauf mention)8788- Caméra du numériseur (VisionKit) : le simulateur n'a pas de caméra. Le pipeline PDF/OCR est testé avec des pages générées, l'écran de revue aussi.89- Apple Pencil : le trait du test d'interface est fait au doigt simulé.90- Widgets sur un écran d'accueil ou de verrouillage : l'extension se construit et s'embarque ; son instantané est testé ; son rendu n'a pas été regardé.91- Extension de partage depuis Safari, Photos, Mail, Fichiers : la logique (`ShareIntake`, `ShareInbox`) est testée sur le Mac avec de vrais `NSItemProvider` ; l'extension elle-même n'est pas pilotée par un test.92- Wi-Fi ↔ cellulaire, mode données réduites, mode économie d'énergie, batterie : la politique est testée (moteur, et interface avec des conditions simulées par `SPDRIVE_FAKE_CONDITIONS`) ; les signaux du vrai matériel n'ont pas été observés.93- Relance de l'app par iOS pour une session d'arrière-plan : reprise testée avec un pilote scripté, pas avec le système.94- Fenêtres multiples (⌥⌘N, « Ouvrir dans une nouvelle fenêtre »), survol au pointeur, glisser-déposer sur la barre latérale et entre apps : construits, non pilotés par un test (le simulateur les permet, aucun test ne le fait).95- VoiceOver : libellés, valeurs et actions sont posés et lus par les tests d'interface (`value` de l'élément) ; aucune écoute réelle.96- Anglais : partiel (170 chaînes) ; les captures « anglais » le montrent.9798---99100# État des tests de la version 1.0 (2026-11-18)101102103« Vérifié » = commande exécutée ce jour-là, résultat observé. Aucun résultat n'est simulé : les tests parlent à un vrai backend SP Drive (clone jetable de la branche de production `native-clients`, PostgreSQL réel, m5ma:8663), jamais à un double.104105## Suites exécutées106107| Suite | Commande | Où | Résultat |108|---|---|---|---|109| Moteur (Core + Sync) | `Scripts/build.sh core` | Mac, 2 à 3 « appareils » simulés (base et stockage séparés) | **12 / 12** |110| Tests hébergés dans l'app | `Scripts/build.sh test` | simulateur iPhone | **6 / 6** (1 File Provider + 5 unitaires) |111| Interface iPhone | `Scripts/build.sh uitest` | simulateur « SPDrive iPhone » (iPhone 17 Pro, iOS 27.2) | **4 / 4** |112| Interface iPad | `SPDRIVE_SIM="SPDrive iPad" Scripts/build.sh uitest` | simulateur « SPDrive iPad » (iPad Pro 11 po) | **4 / 4** (3 dans la suite complète ; le test Fichiers relancé seul après correction du test) |113| Build Release + signature | `Scripts/release.sh archive` | appareil générique | archive produite, droits vérifiés |114| Validation Apple | `Scripts/release.sh export` puis `validate` | App Store Connect | « VERIFY SUCCEEDED with no errors » |115| Envoi TestFlight | `Scripts/release.sh upload` | App Store Connect | 1.0.0 (1) `VALID`, en test interne |116117## Ce que couvrent les tests118119### Moteur — `KitTests/SyncTests.swift`1201. Session d'appareil et dossier racine.1212. Créer, renommer, déplacer, mettre en favori, corbeille, restauration : visibles tout de suite en local, puis sur le serveur et sur un deuxième appareil.1223. Noms : doublon refusé, nom invalide refusé (`../…`), nom libre choisi à la création.1234. Envoi puis téléchargement sur un autre appareil, empreinte SHA-256 identique, copie réutilisée sans nouveau transfert.1245. **Fichier de 20 Mio en trois blocs**, deuxième bloc coupé deux fois : reprise au décalage du serveur ; téléchargement coupé puis repris ; reprise `Range` à partir d'un fichier partiel de 11 Mo.1256. **Intégrité** : un fichier partiel de bonne taille mais au contenu faux n'est jamais installé ; le vrai contenu est récupéré.1267. **Hors ligne + redémarrage + reconnexion** : fichier gardé hors ligne modifié, dossier créé, fichier ajouté dedans, dossier renommé, le tout sans réseau ; nouvelle instance du moteur sur le même stockage (redémarrage) ; retour du réseau ; tout est sur le serveur, l'ancienne version reste dans l'historique.1278. **Conflits** : même fichier modifié hors ligne ici et en ligne ailleurs, trois fois ; rien n'est écrasé ; « garder les deux » (copie « (conflit …) »), « garder la mienne » (3 versions sur le serveur), « garder celle du serveur ».1289. Modifié ici, supprimé définitivement ailleurs : la modification est conservée, puis renvoyée comme nouveau fichier.12910. Dossier gardé hors ligne : nouveaux fichiers et nouvelles versions récupérés seuls ; lecture hors ligne ; libérer l'espace ne supprime rien sur le Drive.13011. Annulation d'un envoi jamais parti, cache vidé sans toucher au Drive, pause et reprise d'un téléchargement.13112. Recherche locale hors ligne (accents, type, extension, taille, caractères `%` et `_` littéraux) et recherche serveur.132133### File Provider — `Tests/FileProviderTests.swift`134Par le système de fichiers du domaine, avec coordination de fichiers, comme le fait une app tierce ; chaque effet est vérifié sur le serveur par un second client : domaine enregistré, listage, **téléchargement à la demande** (contenu identique), **document créé par une autre app** envoyé, **modification** devenue nouvelle version (l'ancienne dans l'historique), renommage, changement distant visible, suppression = corbeille du Drive.135136### Interface — `UITests/DriveUITests.swift`137- Écran de connexion ; liaison par code (le code vient du vrai serveur).138- Explorateur de bout en bout : première synchronisation, création d'un dossier (vérifiée sur le serveur), ouverture d'un fichier 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.139- Corbeille (vérifiée sur le serveur), restauration, recherche insensible aux accents.140- **App Fichiers** : SP Drive figure dans les emplacements ; son contenu est listé par l'extension.141142Captures : `build/shots/<simulateur>/`.143144## Scénario de validation du cahier des charges (15 étapes)145146| # | Étape | État |147|---|---|---|148| 1 | Installer sur un iPhone | **Non fait** : aucun iPhone n'était branché. Build disponible sur TestFlight. |149| 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. |150| 3 | SP Drive dans Fichiers | Vérifié sur simulateurs iPhone et iPad. |151| 4 | Ouvrir un dossier distant | Vérifié (app et Fichiers). |152| 5 | Télécharger un fichier | Vérifié (app ; à la demande dans Fichiers). |153| 6 | Marquer hors ligne | Vérifié. |154| 7 | Mode avion | **Non vérifié sur appareil.** Équivalent testé : réseau coupé au niveau des requêtes dans les tests du moteur. |155| 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**. |156| 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**. |157| 13–15 | Reconnexion, synchronisation, aucune perte | Moteur : vérifié. Appareil réel : **non fait**. |158159## Construit, non vérifié160161- **Tout ce qui demande un appareil réel** : passkey + Face ID, verrou biométrique, mode avion, redémarrage, transferts pendant que l'app est suspendue ou tuée (URLSession background), comportement de Fichiers hors ligne (file d'attente du système), mémoire de l'extension sur de très gros fichiers.162- **Sélecteurs système** (non pilotables par les tests) : import Photos, appareil photo, numériseur, sélecteur Fichiers, extension de partage (compile et s'installe ; jamais exécutée de bout en bout).163- **Écrans** exercés seulement en partie par les tests : détails et versions d'un fichier, liens de dépôt (création, soumissions), conflits et problèmes, stockage, compte et appareils, éditeur de texte, sélection multiple, déplacement par sélecteur de dossier.164- **iPad** : glisser-déposer entre apps, clavier matériel, multifenêtre ; le test File Provider par le système de fichiers n'a été exécuté que sur le simulateur iPhone.165- **Performance** : aucun profilage Instruments ; jamais essayé avec des milliers de fichiers (les listes sont paginées côté base et paresseuses côté interface, sans mesure).166- **Notifications** : jamais observées (l'autorisation système n'est pas accordée dans les tests).167168## Non fait169170- Liaison du paquet `SPDriveCore` de l'app macOS (voir `docs/AUDIT.md`).171- Tags, doublons, administration, formulaire de dépôt personnalisé, création de compte par invitation, TOTP et codes de récupération : restent sur le web.172- Notifications push (APNs) ; l'app sonde le serveur quand iOS lui donne la main.173- Anglais (interface en français seulement).174- Glisser un dossier entier depuis une autre app fonctionne par code mais n'a pas été essayé.175176## Limites connues177178- Les tests d'interface sont lents (10 min pour le parcours complet) : avec un menu contextuel ouvert, l'app n'est jamais « au repos » pour XCTest, qui attend 60 s à chaque fois. Cause non élucidée (probablement l'animation du menu du système).179- **Première utilisation dans Fichiers** : iOS demande une fois « Activer SP Drive ? » à l'ouverture de l'emplacement (consentement du système, observé sur le simulateur iPad ; les tests appuient sur « Activer »). Tant que ce n'est pas fait, l'extension répond « La synchronisation n'est pas activée » (erreur -2011) et rien n'est listé.180- Le compte de test est vidé par chaque test d'interface (corbeille puis purge) : ne jamais pointer ces tests vers la production (`Scripts/build.sh` n'utilise que le backend jetable).181