Audit du système existant (2026-11-18)
Ce qui a été inspecté avant d'écrire l'app, et ce qui en découle. « Vérifié » = lu dans le code ou observé sur le serveur.
Backend SP Drive (dépôt spbgit sp-drive.git, production sur m5ma:8660, https://drive.spboucher.ai)
| Sujet | Constat vérifié |
|---|---|
| Pile | Fastify 5 + PostgreSQL 17 + worker (antivirus ClamAV, aperçus), SPA React servie par l'API, PM2 via mld. |
| 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. Ce n'est pas du chiffrement de bout en bout : le serveur détient les clés. L'app ne prétend pas autre chose. |
| 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. |
| Versions | file_versions numérotées ; restaurer crée une nouvelle version ; la version courante ne se supprime pas. |
| 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. |
| Téléchargement | GET /files/:id/content avec Range, If-Range et ETag = SHA-256. |
| Authentification | Passkeys WebAuthn uniquement (RP drive.spboucher.ai), comptes sur invitation. Web : cookie de session + en-tête CSRF. |
| 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. |
| Liens de dépôt | « Portails » : le déposant n'obtient qu'un jeton de soumission (envoyer ses fichiers, lire l'état de sa soumission). Quarantaine → antivirus → placement dans le dossier cible. Limites réévaluées à chaque bloc. |
| Partage entre comptes | N'existe pas côté serveur. L'onglet « Partagés » de l'app liste donc les liens que l'on a créés, pas des éléments « partagés avec moi ». |
| Recherche | Par nom (insensible aux accents), type, favoris, dates, taille. Pas de plein texte. |
Ce qui manquait pour un client natif, et qui a été ajouté
Ajouts faits par la session qui construit SP Drive macOS (branche native-clients, en production le 2026-11-18, commit 7bd8972, migration 002_native_clients, 75 tests d'intégration côté serveur). L'app iOS n'a rien modifié sur le serveur.
| Besoin | Ajout |
|---|---|
| Passkeys natives | /.well-known/apple-app-site-association (webcredentials, App ID 3YM54G49SN.ai.spboucher.spdrive.ios inclus). |
| 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. |
| Connexion de secours | Liaison par code (`/auth/device/start |
| Synchronisation incrémentale | Colonne rev monotone par propriétaire + pierres tombales ; GET /sync/changes?since=, GET /sync/cursor, POST /sync/items. |
| 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. |
SP Drive macOS et SPDriveCore
L'app macOS native n'existait pas au début de ce travail ; une autre session l'a construite en parallèle (~/Desktop/Cluster/apple/SPDrive, dépôt sp-drive-macos.git, commit 67b2ce7 : paquets SPDriveCore et SPDriveSync).
État de la réutilisation, sans l'embellir : l'app iOS ne lie pas encore ces paquets. Pour ne pas attendre, la couche iOS a été écrite derrière le protocole DriveRemote (Core/API/DriveRemote.swift), contre le même contrat serveur. Les deux implémentations parlent donc la même API mais ne partagent pas de code aujourd'hui. Le point de raccord prévu est un adaptateur DriveRemote → APIClient de SPDriveCore ; il reste à écrire (voir README, « Reste à faire »).
Matrice de parité
✔ = présent et vérifié ; ◐ = présent, vérification partielle ; ✘ = absent ; — = sans objet.
| Fonction | Web | macOS (autre session) | iPhone | iPad |
|---|---|---|---|---|
| Parcourir dossiers et fichiers | ✔ | ✔ | ✔ | ✔ |
| Liste / grille, tri, filtres | ✔ | ✔ | ✔ | ✔ |
| Créer, renommer, déplacer, dupliquer | ✔ | ✔ | ✔ | ✔ |
| Envoi résumable par blocs + SHA-256 | ✔ | ✔ | ✔ | ✔ |
Téléchargement avec reprise (Range) + vérification |
✔ (navigateur) | ✔ | ✔ | ✔ |
| Transferts en arrière-plan (URLSession background) | — | — | ◐ (jamais observé sur appareil réel) | ◐ |
| Hors ligne : fichiers et dossiers gardés, modifications différées | ✘ | ✔ | ✔ | ✔ |
| Synchronisation incrémentale bidirectionnelle | — | ✔ | ✔ | ✔ |
| Conflits sans écrasement + interface de résolution | ✘ (versions seulement) | ✔ | ✔ | ✔ |
| Intégration au système de fichiers | — | ◐ Finder (en attente d'activation) | ✔ app Fichiers (simulateur) | ✔ app Fichiers (simulateur) |
| Aperçus | ✔ pdf.js etc. | ✔ | ✔ QuickLook | ✔ |
| Modification depuis l'app | ✘ | ◐ | ✔ annotations QuickLook, éditeur de texte | ✔ |
| Liens de partage (création, réglages, rotation, révocation, journal) | ✔ | ✔ | ✔ | ✔ |
| Liens de dépôt (création, limites, soumissions) | ✔ | ✔ | ✔ | ✔ |
| Formulaire de dépôt personnalisé (champs, consentement, marque) | ✔ | ? | ✘ (réglages essentiels seulement) | ✘ |
| Versions : liste, téléchargement, restauration, suppression | ✔ | ✔ | ✔ | ✔ |
| Corbeille : restaurer, purger, vider | ✔ | ✔ | ✔ | ✔ |
| Recherche serveur | ✔ | ✔ | ✔ | ✔ |
| Recherche hors ligne (index local) | ✘ | ✔ | ✔ | ✔ |
| Favoris, récents | ✔ | ✔ | ✔ | ✔ |
| Tags | ✔ | ? | ✘ | ✘ |
| Doublons | ✔ | ? | ✘ | ✘ |
| Passkey | ✔ | ✔ | ◐ (code + AASA en production ; jamais exécuté sur un appareil réel) | ◐ |
| Verrou biométrique de l'app | — | ? | ◐ (jamais exécuté sur un appareil réel) | ◐ |
| Import Photos / appareil photo / numériseur / feuille de partage | ◐ (navigateur) | — | ◐ (sélecteurs système : non pilotables en test) | ◐ |
| Glisser-déposer, clavier matériel, multifenêtre | ✔ (bureau) | ✔ | — | ◐ (non testé automatiquement) |
| Administration (utilisateurs, quotas, invitations), TOTP, codes de récupération, création de compte | ✔ | ? | ✘ (reste sur le web) | ✘ |
| Notifications | dans l'app | ? | locales (conflit, échec, quota, dépôt reçu) ; pas de push APNs | idem |
« ? » : fonction de l'app macOS que cette session n'a pas vérifiée.