SPB Git

Repository Public

SP_BROWSER_2.md 9.0 KB

# SP Browser 2.0 — SP Search, SP Identity, SP Sync

Ce document décrit ce que la version 2.0 ajoute à l'application macOS, ce qui est partagé avec l'application iOS, et le service qui les relie. Le backend a son propre dépôt (sp-browser-backend, spbgit) et sa propre documentation (README.md, docs/SECURITY.md, docs/OPERATIONS.md).

# Vue d'ensemble

text
 SP Browser macOS ─┐                       ┌─ Tavily (recherche web, images des pages)
                   ├── HTTPS ── browser.spboucher.ai ──┼─ Wikimedia Commons (images libres)
 SP Browser iOS  ──┘      (sp-browser-backend)         └─ oEmbed YouTube / Vimeo / Dailymotion
                           │
                           ├─ SP Search    POST /api/search
                           ├─ SP Identity  clés d'accès WebAuthn, sessions, appareils
                           └─ SP Sync      flux de changements chiffré de bout en bout
Dossier Contenu Plateformes
SPBrowser/Core/SPSearch modèles, SearchClient, adresse interne spsearch://, surlignage macOS + iOS, paquet SwiftPM SPBrowserCore
SPBrowser/Core/Backend client HTTP JSON commun, erreurs stables idem
SPBrowser/Core/Identity AccountService, protocole PasskeyAuthorizer, JSON WebAuthn idem
SPBrowser/Core/Sync SyncCrypto, SyncDatabase (miroir + file d'attente), SyncEngine, ponts historique/signets, SyncedLibrary, SyncCoordinator idem
SPBrowser/Shared SwiftUI multiplateforme : page de résultats, images, vidéos, écran de compte, BrowserServices, authentificateur système macOS + iOS
SPBrowser/Features, SPBrowser/App, Core/BrowserEngine application macOS (AppKit + SwiftUI) macOS
Mobile/ application iPhone / iPad iOS

# SP Search dans le navigateur

  • Moteur par défaut : SearchEngine.spSearch (spsearch://results?q=%s). Une requête tapée dans la barre d'adresse n'est plus envoyée à DuckDuckGo ; les autres moteurs restent accessibles par leur raccourci (g …, w …) ou comme moteur par défaut choisi dans les réglages. Migration des réglages v2 → v3 : seul l'ancien défaut duckduckgo est remplacé, un choix délibéré est conservé.
  • Page de résultats native : l'onglet charge dans son WKWebView un document vide servi par SearchPlaceholderHandler pour l'adresse spsearch://…, et l'application dessine SearchResultsView (SwiftUI) par-dessus. La page de résultats est ainsi une vraie entrée de l'historique précédent/suivant de l'onglet et se restaure avec la session, sans aucun code de navigation parallèle.
  • Qui peut ouvrir une page de recherche : l'utilisateur (barre d'adresse, page de résultats, précédent/suivant, session restaurée). Le contenu web ne peut pas y naviguer (testé).
  • Trois modes : Tout · Images · Vidéos, filtre de date, filtre de plateforme vidéo, grille ou liste pour les vidéos, résumé par IA (fourni par le fournisseur, étiqueté comme tel), pagination par « Plus de résultats » et chargement à l'approche de la fin.
  • Suggestions : uniquement depuis l'historique de recherche de l'utilisateur, l'historique de navigation, les signets et les onglets. Le fournisseur n'offre ni autocomplétion, ni recherches associées, ni correction orthographique : l'application n'en invente pas. « Lié à vos recherches » liste d'anciennes requêtes partageant un terme.
  • Ce qui quitte l'appareil : la requête et les filtres, vers browser.spboucher.ai. Les vignettes et favicons sont chargés directement depuis leurs sites (sans cookies, cache en mémoire seulement).

# Limites dues au fournisseur (vérifiées dans sa documentation le 2026-11-18)

Sujet Réalité Conséquence dans l'app
Pagination aucun décalage possible, 20 résultats par appel pages suivantes = résultats d'autres domaines
Images pas de recherche d'images dédiée images des pages trouvées + Wikimedia Commons ; dimensions mesurées à l'affichage quand elles ne sont pas fournies
Vidéos aucune recherche vidéo seules les pages de lecture confirmées par l'oEmbed de YouTube, Vimeo ou Dailymotion sont affichées ; durée et date absentes pour YouTube sans clé YouTube Data API

# SP Identity

  • Compte créé et ouvert par clé d'accès (WebAuthn/FIDO2) via AuthenticationServices : Touch ID sur Mac, Face ID / Touch ID sur iPhone et iPad, code de l'appareil quand le système le propose. Aucun mot de passe, aucun protocole biométrique maison : l'application ne reçoit qu'une signature.
  • Domaine de confiance : browser.spboucher.ai (droit com.apple.developer.associated-domains = webcredentials:browser.spboucher.ai, fichier d'association servi par le backend).
  • Création de compte sur code d'invitation (node scripts/invite.ts create sur le nœud du backend).
  • Écran Compte (identique sur les deux plateformes) : compte, appareils enregistrés, sessions actives, clés d'accès (ajout, retrait après confirmation), dernière synchronisation, retrait d'appareil, déconnexion, déconnexion partout, nouvelle clé de récupération, effacement des données synchronisées, suppression du compte.
  • Secrets dans le trousseau uniquement : jeton de session, clé privée de l'appareil, clé de compte.

# SP Sync

Collections : history, bookmarks, favorites, tabs, closed, reading, searches, prefs.

  1. Miroir local (sync.sqlite) : copie en clair, sur l'appareil, de tout ce qui se synchronise ; chaque modification locale y est marquée « à envoyer ». C'est aussi la file d'attente hors ligne.
  2. Chiffrement : chaque enregistrement est scellé (ChaCha20-Poly1305) avec une clé dérivée de la clé de compte ; l'identifiant envoyé au serveur est un HMAC (une URL ou une requête n'y apparaît jamais). Le serveur ne reçoit jamais la clé de compte.
  3. Cycle : tirer tout ce qui suit le curseur → fusionner → pousser ce qui est marqué. Le serveur refuse une écriture faite sur une version périmée (contrôle optimiste) et renvoie la version gagnante ; le client fusionne puis renvoie si nécessaire.
  4. Fusion : historique et recherches = faits des deux appareils (dernière visite, plus grand compteur) ; le reste = dernière modification gagne ; une suppression distante l'emporte sauf modification locale postérieure.
  5. Suppressions : pierres tombales propagées, puis oubliées localement une fois confirmées.
  6. Nouvel appareil : il se connecte avec une clé d'accès, publie une clé publique et attend. Un appareil déjà synchronisé affiche la demande avec un code à comparer (dérivé de cette clé publique), puis scelle la clé de compte pour lui (HPKE). Autre voie : la clé de récupération, montrée une seule fois à la création.
  7. Planification : peu après un changement local (regroupé), au retour au premier plan, toutes les 5 minutes tant que l'app est active ; reprise après échec à 5 s, 15 s, 1 min, 5 min, 15 min. Rien ne tourne en arrière-plan, déconnecté, ou synchronisation désactivée.

Une fenêtre privée n'écrit ni historique ni historique de recherche, n'apparaît pas dans les onglets publiés, et sa base d'historique est en mémoire : rien de ce qu'elle fait ne peut atteindre le miroir, donc le serveur. Les ponts fonctionnent par comparaison avec la base du profil ordinaire (et non par notifications), ce qui rend la fuite structurellement impossible plutôt que simplement évitée. Tests : testPrivateBrowsingNeverReachesTheSyncMirror, testSearchHistoryIsRecordedInRegularWindowsOnly.

# Ce que le serveur voit

Le nom des collections, des identifiants opaques, la taille et la date des enregistrements, le nom et le modèle des appareils. Détail et limites (pas de rotation de clé au retrait d'un appareil) : docs/SECURITY.md du backend.

# Tests

Suite Commande Ce qu'elle exerce
Cœur, unitaires swift test classification URL/requête, décodage des trois modes, chiffrement, enveloppes, clé de récupération, miroir, règles de fusion, ponts
Cœur, intégration scripts/test-backend.sh up puis swift test avec les variables affichées deux à trois « appareils » contre un vrai serveur local : création de compte, enrôlement, synchro complète, doublons, conflits, hors ligne, révocation, récupération, effacement. Seul l'authentificateur est logiciel (signatures ES256 réelles).
Recherche réelle SPB_LIVE_SEARCH=1 swift test --filter LiveSearchTests web, images et vidéos par la production (quelques crédits)
Application macOS scripts/test.sh app recherche native dans de vrais WKWebView, précédent/suivant, refus de navigation depuis une page, isolement privé, commandes
Backend npm test, npm run test:live (sur le nœud) normalisation, cache, plafond, erreurs, WebAuthn, synchro, administration

Les réponses du fournisseur ne sont simulées que pour vérifier la normalisation ; l'intégration réelle a ses propres tests, jamais remplacés par des simulations.

Files main
Menu

Theme