Repository Public
1<!--2SP Drive iOS3File: docs/AUDIT.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Audit du système existant (2026-11-18)89Ce 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.1011## Backend SP Drive (dépôt spbgit `sp-drive.git`, production sur m5ma:8660, https://drive.spboucher.ai)1213| Sujet | Constat vérifié |14|---|---|15| Pile | Fastify 5 + PostgreSQL 17 + worker (antivirus ClamAV, aperçus), SPA React servie par l'API, PM2 via `mld`. |16| 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. |17| 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. |18| Versions | `file_versions` numérotées ; restaurer crée une nouvelle version ; la version courante ne se supprime pas. |19| 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. |20| Téléchargement | `GET /files/:id/content` avec `Range`, `If-Range` et `ETag` = SHA-256. |21| Authentification | Passkeys WebAuthn uniquement (RP `drive.spboucher.ai`), comptes sur invitation. Web : cookie de session + en-tête CSRF. |22| 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. |23| 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. |24| 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 ». |25| Recherche | Par nom (insensible aux accents), type, favoris, dates, taille. Pas de plein texte. |2627### Ce qui manquait pour un client natif, et qui a été ajouté2829Ajouts 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.3031| Besoin | Ajout |32|---|---|33| Passkeys natives | `/.well-known/apple-app-site-association` (`webcredentials`, App ID `3YM54G49SN.ai.spboucher.spdrive.ios` inclus). |34| 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. |35| Connexion de secours | Liaison par code (`/auth/device/start|poll`, approbation dans un navigateur sur `/appareil`). |36| Synchronisation incrémentale | Colonne `rev` monotone par propriétaire + pierres tombales ; `GET /sync/changes?since=`, `GET /sync/cursor`, `POST /sync/items`. |37| 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. |3839## SP Drive macOS et `SPDriveCore`4041L'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`).4243**É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 »).4445## Matrice de parité4647✔ = présent et vérifié ; ◐ = présent, vérification partielle ; ✘ = absent ; — = sans objet.4849| Fonction | Web | macOS (autre session) | iPhone | iPad |50|---|---|---|---|---|51| Parcourir dossiers et fichiers | ✔ | ✔ | ✔ | ✔ |52| Liste / grille, tri, filtres | ✔ | ✔ | ✔ | ✔ |53| Créer, renommer, déplacer, dupliquer | ✔ | ✔ | ✔ | ✔ |54| Envoi résumable par blocs + SHA-256 | ✔ | ✔ | ✔ | ✔ |55| Téléchargement avec reprise (`Range`) + vérification | ✔ (navigateur) | ✔ | ✔ | ✔ |56| Transferts en arrière-plan (URLSession background) | — | — | ◐ (jamais observé sur appareil réel) | ◐ |57| Hors ligne : fichiers et dossiers gardés, modifications différées | ✘ | ✔ | ✔ | ✔ |58| Synchronisation incrémentale bidirectionnelle | — | ✔ | ✔ | ✔ |59| Conflits sans écrasement + interface de résolution | ✘ (versions seulement) | ✔ | ✔ | ✔ |60| Intégration au système de fichiers | — | ◐ Finder (en attente d'activation) | ✔ app Fichiers (simulateur) | ✔ app Fichiers (simulateur) |61| Aperçus | ✔ pdf.js etc. | ✔ | ✔ QuickLook | ✔ |62| Modification depuis l'app | ✘ | ◐ | ✔ annotations QuickLook, éditeur de texte | ✔ |63| Liens de partage (création, réglages, rotation, révocation, journal) | ✔ | ✔ | ✔ | ✔ |64| Liens de dépôt (création, limites, soumissions) | ✔ | ✔ | ✔ | ✔ |65| Formulaire de dépôt personnalisé (champs, consentement, marque) | ✔ | ? | ✘ (réglages essentiels seulement) | ✘ |66| Versions : liste, téléchargement, restauration, suppression | ✔ | ✔ | ✔ | ✔ |67| Corbeille : restaurer, purger, vider | ✔ | ✔ | ✔ | ✔ |68| Recherche serveur | ✔ | ✔ | ✔ | ✔ |69| Recherche hors ligne (index local) | ✘ | ✔ | ✔ | ✔ |70| Favoris, récents | ✔ | ✔ | ✔ | ✔ |71| Tags | ✔ | ? | ✘ | ✘ |72| Doublons | ✔ | ? | ✘ | ✘ |73| Passkey | ✔ | ✔ | ◐ (code + AASA en production ; jamais exécuté sur un appareil réel) | ◐ |74| Verrou biométrique de l'app | — | ? | ◐ (jamais exécuté sur un appareil réel) | ◐ |75| Import Photos / appareil photo / numériseur / feuille de partage | ◐ (navigateur) | — | ◐ (sélecteurs système : non pilotables en test) | ◐ |76| Glisser-déposer, clavier matériel, multifenêtre | ✔ (bureau) | ✔ | — | ◐ (non testé automatiquement) |77| Administration (utilisateurs, quotas, invitations), TOTP, codes de récupération, création de compte | ✔ | ? | ✘ (reste sur le web) | ✘ |78| Notifications | dans l'app | ? | locales (conflit, échec, quota, dépôt reçu) ; pas de push APNs | idem |7980« ? » : fonction de l'app macOS que cette session n'a pas vérifiée.81