SPB Git

Repository Public

AUDIT.md 7.0 KB

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

Files main
Menu

Theme