SPB Git

Repository Public

TESTS.md 16.9 KB

# État des tests

# SP Drive 2.0, phase 2 — exécution finale du 2026-11-19

« Vérifié » = commande exécutée, résultat observé. Simulateur seulement (iOS 27.0, « SPDrive iPhone » et « SPDrive iPad ») ; backend jetable m5ma:8663 sur la branche next au commit 0073557 (celui qui est en production), jamais la production ; paquet partagé SPDriveNext au commit c6c11d2 du dépôt macOS. Aucun vrai modèle de langage : le fournisseur maclustr du banc d'essai est le faux point d'accès scripts/fake-llm.mjs du backend.

Code de l'app testé : commit 66cddfb. Les commits suivants ne touchent que le banc des tests moteur (KitTests/Harness.swift, Scripts/test-server.sh) et la documentation ; l'app et ses extensions sont identiques.

Suite Commande Résultat
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)
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.
Tests hébergés iPhone Scripts/build.sh test 10 / 10 (dont le File Provider par le système de fichiers)
Interface iPad, en une fois SPDRIVE_SIM="SPDrive iPad" Scripts/build.sh uitest 15 / 15
Tests hébergés iPad SPDRIVE_SIM="SPDrive iPad" Scripts/build.sh test 10 / 10
Build Release (simulateur générique) Scripts/build.sh release réussi
Version xcodebuild -showBuildSettings (Release) MARKETING_VERSION = 2.0.0, CURRENT_PROJECT_VERSION = 2

Les 15 tests d'interface : DriveUITests 4 (1.0), NextUITests 5 (phase 1), Next2UITests 3 (écrans 2.0, dont « un serveur 1.0 ne montre aucune commande 2.0 »), SystemUITests 2 (widget posé sur l'écran d'accueil ; extension de partage depuis Photos), LaunchPerfTests 1. Le test de partage depuis Photos a été ignoré sur iPad lors d'une exécution précédente (menu de Photos différent) et a réussi lors de l'exécution finale.

# Mesures de l'exécution finale (Debug, simulateur ; comparatives seulement)

Mesure iPhone iPad
Lancement à froid → première image (5 lancements, app connectée) 0,746 s 0,769 s
Dossier de 1 000 éléments : lecture du miroir 3,3 ms 3,2 ms
Dossier de 1 000 éléments : rendu de l'explorateur 236,0 ms 232,8 ms

Ré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 la phase 1 lançait l'app déconnectée ; celle-ci la lance connectée (pour ne pas perturber l'emplacement Fichiers).

# Construit, non vérifié (phase 2)

  • Tout appareil réel (voir next/DELIVERY-CHECKLIST.md §3).
  • 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é).
  • 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é.
  • Rôle « modification » dans un dossier partagé (création, renommage, corbeille, envoi) : construit, non testé. Lecteur et déposant : testés.
  • 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.
  • Plafond d'envois en attente d'un partage (413), 503 du flux d'évènements : gérés, non provoqués.
  • Anglais : 638 chaînes ; ce qui reste en français est listé dans next/PHASE2-iOS.md §5.

# État des tests de la phase 1 (2026-11-19, backend 1.0)

# SP Drive Next (2.0), phase 1 — 2026-11-19, branche next

« Vérifié » = commande exécutée ce jour-là, résultat observé. Simulateur seulement : aucun appareil réel n'était branché. Backend : instance jetable m5ma:8663 (branche native-clients, 7bd8972), jamais la production. Détail de ce que chaque test prouve : next/AUDIT-iOS.md §3 ; captures : next/shots/.

Suite Commande Où main (1.0) relancé avant tout changement next
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)
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)
Tests hébergés, iPad SPDRIVE_SIM="SPDrive iPad" Scripts/build.sh test simulateur « SPDrive iPad » non relancé 10 / 10
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
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.

Ordre à respecter : le test hébergé du File Provider exige que l'emplacement SP Drive ait été ouvert une fois dans Fichiers après la dernière remise à zéro. LaunchPerfTests remet l'app à zéro : lancé juste avant build.sh test, il fait échouer ce test (NSFileProviderErrorDomain -2001, observé le 2026-11-19) ; relancer testFilesAppShowsSPDriveLocation puis build.sh test (10 / 10 observé ensuite).

# Mesures (Debug, simulateur, Mac occupé par d'autres travaux : elles comparent les deux versions entre elles, rien de plus)

Mesure Méthode main next
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
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
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)

# Construit en phase 1, non vérifié (appareil réel nécessaire, sauf mention)

  • 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.
  • Apple Pencil : le trait du test d'interface est fait au doigt simulé.
  • 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é.
  • 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.
  • 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.
  • 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.
  • 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).
  • 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.
  • Anglais : partiel (170 chaînes) ; les captures « anglais » le montrent.

# État des tests de la version 1.0 (2026-11-18)

« 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.

# Suites exécutées

Suite Commande Où Résultat
Moteur (Core + Sync) Scripts/build.sh core Mac, 2 à 3 « appareils » simulés (base et stockage séparés) 12 / 12
Tests hébergés dans l'app Scripts/build.sh test simulateur iPhone 6 / 6 (1 File Provider + 5 unitaires)
Interface iPhone Scripts/build.sh uitest simulateur « SPDrive iPhone » (iPhone 17 Pro, iOS 27.2) 4 / 4
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)
Build Release + signature Scripts/release.sh archive appareil générique archive produite, droits vérifiés
Validation Apple Scripts/release.sh export puis validate App Store Connect « VERIFY SUCCEEDED with no errors »
Envoi TestFlight Scripts/release.sh upload App Store Connect 1.0.0 (1) VALID, en test interne

# Ce que couvrent les tests

# Moteur — KitTests/SyncTests.swift

  1. Session d'appareil et dossier racine.
  2. 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.
  3. Noms : doublon refusé, nom invalide refusé (../…), nom libre choisi à la création.
  4. Envoi puis téléchargement sur un autre appareil, empreinte SHA-256 identique, copie réutilisée sans nouveau transfert.
  5. 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.
  6. Intégrité : un fichier partiel de bonne taille mais au contenu faux n'est jamais installé ; le vrai contenu est récupéré.
  7. 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.
  8. 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 ».
  9. Modifié ici, supprimé définitivement ailleurs : la modification est conservée, puis renvoyée comme nouveau fichier.
  10. 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.
  11. Annulation d'un envoi jamais parti, cache vidé sans toucher au Drive, pause et reprise d'un téléchargement.
  12. Recherche locale hors ligne (accents, type, extension, taille, caractères % et _ littéraux) et recherche serveur.

# File Provider — Tests/FileProviderTests.swift

Par 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.

# Interface — UITests/DriveUITests.swift

  • Écran de connexion ; liaison par code (le code vient du vrai serveur).
  • 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.
  • Corbeille (vérifiée sur le serveur), restauration, recherche insensible aux accents.
  • App Fichiers : SP Drive figure dans les emplacements ; son contenu est listé par l'extension.

Captures : build/shots/<simulateur>/.

# Scénario de validation du cahier des charges (15 étapes)

# Étape État
1 Installer sur un iPhone Non fait : aucun iPhone n'était branché. Build disponible sur TestFlight.
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.
3 SP Drive dans Fichiers Vérifié sur simulateurs iPhone et iPad.
4 Ouvrir un dossier distant Vérifié (app et Fichiers).
5 Télécharger un fichier Vérifié (app ; à la demande dans Fichiers).
6 Marquer hors ligne Vérifié.
7 Mode avion Non vérifié sur appareil. Équivalent testé : réseau coupé au niveau des requêtes dans les tests du moteur.
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.
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.
13–15 Reconnexion, synchronisation, aucune perte Moteur : vérifié. Appareil réel : non fait.

# Construit, non vérifié

  • 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.
  • 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).
  • É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.
  • 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.
  • 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).
  • Notifications : jamais observées (l'autorisation système n'est pas accordée dans les tests).

# Non fait

  • Liaison du paquet SPDriveCore de l'app macOS (voir docs/AUDIT.md).
  • 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.
  • Notifications push (APNs) ; l'app sonde le serveur quand iOS lui donne la main.
  • Anglais (interface en français seulement).
  • Glisser un dossier entier depuis une autre app fonctionne par code mais n'a pas été essayé.

# Limites connues

  • 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).
  • 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é.
  • 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).
Files main
Menu

Theme