SP Browser
Navigateur web natif pour macOS, iPhone et iPad : Swift 6, SwiftUI (+ AppKit sur Mac), rendu par WebKit. Recherche SP Search intégrée, compte à clés d'accès, synchronisation SP Sync chiffrée de bout en bout — aucune télémétrie.
Author: Simon-Pierre Boucher

Nouveautés de la 3.0 « AURA »
SP Browser 3.0 fait évoluer la 2.0 sans la réécrire : même moteur, même SP Search, même compte à clés d'accès, même synchronisation chiffrée. S'y ajoutent un design system partagé par le Mac, l'iPhone et l'iPad (AURA UI), un moteur d'animation à jetons, et des surfaces nouvelles : Tab Constellation, Peek (aperçu de lien sans cookies ni scripts), Flow (le parcours entre les pages), Canvas, Command Orbit, Focus Mode avec Focus Trail, Portal (appareils et transfert d'onglets) et Ambient Home.
| Document | Contenu |
|---|---|
docs/SP_BROWSER_3.md |
ce qui est nouveau, ce qui est amélioré, vie privée, migration, limites |
docs/SP_BROWSER_3_AUDIT.md |
audit de la 2.0 avant travaux |
docs/AURA_DESIGN_SYSTEM.md |
jetons, matériaux, composants, mouvement |
docs/TEST_REPORT.md |
tests, performances mesurées, ce qui n'a pas été vérifié |

Sommaire
- Vue d'ensemble
- Captures
- Installer
- Ce qu'il fait
- Architecture
- Pile technique
- Organisation du dépôt
- Compiler et tester
- Configuration
- Raccourcis et commandes
- Écrans iOS / iPadOS
- API du backend utilisée
- Automatisation
- Données et persistance
- Sécurité
- Confidentialité
- Tests et performance
- Publication
- Identité visuelle
- Pièges connus
- Limites connues
- Documentation
- Auteur
- Licence
🎯 Vue d'ensemble
Navigateur web natif pour macOS, iPhone et iPad : Swift 6, SwiftUI (+ AppKit sur Mac), rendu par WebKit. Interface en français et en anglais.
Version 2.0 : recherche SP Search intégrée (résultats natifs Tout · Images · Vidéos), compte à clés
d'accès (Touch ID / Face ID), synchronisation SP Sync chiffrée de bout en bout (historique, signets, favoris,
onglets, liste de lecture, recherches) et application iOS native (Mobile/). Vue d'ensemble :
docs/SP_BROWSER_2.md.
SP Browser utilise le moteur WebKit du système : la compatibilité des sites est celle de WebKit. Tout le reste — fenêtres, onglets, espaces de travail, profils, signets, historique, téléchargements, bloqueur, palette de commandes — est du code natif propre au projet. SP Browser n'est pas un moteur web et n'utilise aucune API privée.
Famille SP Browser
| Dépôt | Plateforme | Rôle |
|---|---|---|
| sp-browser (ce dépôt) | macOS 14+ · iOS / iPadOS 18+ | Les deux applications natives (cibles SPBrowser et SPBrowserMobile du même projet), cœur partagé SPBrowserCore — version 2.0.0 (2) |
| sp-browser-backend | API web — browser.spboucher.ai | 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) |
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 boutSans compte, rien n'est synchronisé et SP Browser fonctionne entièrement en local, à l'exception des recherches SP Search que vous lancez (voir
docs/PRIVACY.md). Le backend a son propre dépôt et sa propre documentation (README.md,docs/SECURITY.md,docs/OPERATIONS.md).
Ce que la 2.0 change par rapport à la 1.0
| Sujet | 1.0.0 | 2.0.0 |
|---|---|---|
| Plateformes | macOS | macOS + iPhone + iPad (Mobile/) |
| Moteur par défaut | DuckDuckGo | SP Search, page de résultats native (spsearch://) |
| Compte | aucun | facultatif, clés d'accès (WebAuthn), sur code d'invitation |
| Synchronisation | aucune | SP Sync chiffré de bout en bout, 8 collections |
| Page de démarrage | 6 sections | favoris, fréquents, récents, recherches, autres appareils, liste de lecture, personnalisation, arrière-plans |
| Tests | 82 + 29 | 110 (cœur) + 35 (macOS) + 7 + 3 (iOS) |
| Chaînes localisées | 624 | 889 (macOS + iOS) |
| Identifiant du build Debug macOS | ai.spboucher.spbrowser |
ai.spboucher.spbrowser.debug (cohabite avec l'app installée) |
📸 Captures
Captures des applications réelles (docs/screenshots/ : macOS pilotée au clavier ; docs/screenshots/ios/ :
simulateurs iPhone 17 Pro et iPad Pro 13").
| Palette de commandes ⌘K | Vue scindée |
|---|---|
![]() |
![]() |
| Fenêtre privée | Informations sur la page |
|---|---|
![]() |
![]() |
Réglages (macOS)
iPhone
| Démarrage | SP Search — Tout | Images | Vidéos |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
| Onglets | Navigation privée | Compte | Réglages |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
iPad (7 captures)
| Démarrage | SP Search — Tout |
|---|---|
![]() |
![]() |
| Images | Vidéos |
|---|---|
![]() |
![]() |
| Onglets | Compte | Réglages |
|---|---|---|
![]() |
![]() |
![]() |
💿 Installer
macOS. Ouvrir dist/SPBrowser.dmg (produit par scripts/notarize.sh) et glisser SP Browser dans
Applications. L'application est signée Developer ID et notarisée par Apple (voir
docs/RELEASE.md). macOS 14 ou ultérieur ; testée sur macOS 27.0 uniquement.
| Version | Image disque | SHA-256 |
|---|---|---|
| 2.0.0 (2) | dist/SPBrowser.dmg (4,8 Mo), notarisée et agrafée — pas encore déposée sur spbgit au moment d'écrire ce README |
2b6ae7fc9247191e2308cd765c9077e09bda020edbe2a4439ccdec33da227d3f |
| 1.0.0 (1) | SPBrowser.dmg (3,6 Mo), tag v1.0.0 |
641bf0a0c900a1c218a3c5e3459b126dc440195d917e9228a2318186d559058d |
iOS / iPadOS. iOS 18 ou ultérieur. Distribution par App Store Connect / TestFlight (fiche « SP Browser », id
6836530354, groupe interne « Interne ») ; aucune soumission à la revue de l'App Store n'a été faite.
Compte (facultatif). La création d'un compte demande un code d'invitation, émis sur le nœud du backend
(node scripts/invite.ts create, dépôt sp-browser-backend).
✨ Ce qu'il fait
- Navigation : barre d'adresse et de recherche unifiée, suggestions locales, 9 moteurs et raccourcis de recherche
(
w montréal) en plus de SP Search, état HTTPS, domaine réel mis en évidence. - SP Search (2.0) : moteur par défaut, page de résultats native en trois modes — Tout · Images · Vidéos —, filtre de date, filtre de plateforme vidéo, grille ou liste, résumé par IA du fournisseur (étiqueté comme tel), « Plus de résultats » et chargement à l'approche de la fin.
- Onglets : horizontaux ou verticaux, épinglés, groupes, vue scindée, recherche, réouverture, suspension automatique des onglets inactifs, restauration de session.
- Espaces de travail et profils : chaque profil a ses propres cookies, connexions, historique et signets.
- Compte SP Identity (2.0, facultatif) : clé d'accès Touch ID / Face ID, aucun mot de passe ; appareils, sessions, clés supplémentaires, clé de récupération, suppression du compte.
- SP Sync (2.0) : historique, signets, favoris, onglets ouverts et fermés, liste de lecture, recherches et préférences, chiffrés sur l'appareil ; file d'attente hors ligne ; onglets des autres appareils.
- Navigation privée : rien d'écrit sur le disque, session séparée, jamais synchronisée, limites expliquées à l'écran.
- Confidentialité : bloqueur de traqueurs et de publicités, permissions par site, effacement par site, aucune télémétrie.
- Outils : palette de commandes ⌘K, lecteur, notes par page, informations de page (certificat, cookies), source et métadonnées, sessions nommées, raccourcis configurables.
- SP Intelligence (facultatif, désactivé par défaut) : résumé, explication, traduction, questions sur la page avec votre propre modèle — local ou par clé d'API — après validation d'un aperçu de ce qui est envoyé.
- iPhone et iPad (2.0) : barre d'adresse en bas et vue des onglets sur iPhone ; barre latérale, bande d'onglets, raccourcis clavier et fenêtres multiples sur iPad ; mêmes recherche, compte et synchronisation que sur Mac.
L'état exact de chaque fonction (terminée, implémentée mais non exercée, impossible) est dans
docs/FEATURE_MATRIX.md.
SP Search dans le navigateur
- Moteur par défaut :
SearchEngine.spSearch(spsearch://results?q=%s, raccourcis). 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éfautduckduckgoest remplacé, un choix délibéré est conservé. - Page de résultats native : l'onglet charge dans son
WKWebViewun document vide servi parSearchPlaceholderHandlerpour l'adressespsearch://…, et l'application dessineSearchResultsView(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é).
- 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).
| Limite due au fournisseur (vérifiée dans sa documentation le 2026-11-18) | 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(droitcom.apple.developer.associated-domains=webcredentials:browser.spboucher.ai, fichier d'association servi par le 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.
- 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. - 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.
- 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.
- 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.
- Suppressions : pierres tombales propagées, puis oubliées localement une fois confirmées.
- 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.
- 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.
Seul le profil par défaut se synchronise ; les autres profils restent locaux.
Moteurs de recherche intégrés (10) et leurs raccourcis
| Moteur | Raccourci | Remarque |
|---|---|---|
| SP Search | s |
par défaut ; résultats natifs via browser.spboucher.ai |
| DuckDuckGo | d |
|
g |
||
| Bing | b |
|
| Brave Search | br |
|
| Startpage | sp |
|
| Ecosia | e |
|
| Wikipedia | w |
|
| GitHub | gh |
|
| MDN Web Docs | mdn |
Des moteurs personnalisés peuvent être ajoutés. Rien n'est envoyé pendant la frappe : les suggestions viennent de l'historique de recherche, de l'historique et des signets locaux.
État par fonction — version 2.0 (matrice du 2026-11-18)
Statuts : Terminé = implémenté et vérifié · Implémenté = code complet, interface non exercée à la main · Impossible = API publique absente.
| Fonctionnalité | macOS | iOS / iPadOS | Limites |
|---|---|---|---|
| SP Search par défaut, résultats natifs | Terminé | Terminé (simulateur) | Les autres moteurs restent disponibles par raccourci ou par choix |
| Modes Tout / Images / Vidéos | Terminé | Terminé (simulateur) | Vidéos : plateformes confirmées seulement ; durée YouTube absente |
| Résumé par IA du fournisseur, filtres date / langue / région / filtrage | Terminé | Terminé | Langue et région non exercées à la main |
| Suggestions depuis l'historique de recherche, recherches liées | Terminé | Terminé | Aucune suggestion en ligne (fournisseur) |
| Page de résultats = entrée de l'historique, restaurée avec la session | Terminé | Terminé | — |
| Aperçu d'image (source, dimensions, copier, enregistrer, partager) | Implémenté | Implémenté | Non exercé à la main |
| Lecteur vidéo intégré (lecteur de la plateforme) | Implémenté | Implémenté | Non exercé à la main |
| Page de démarrage 2.0 | Terminé (essai réel partiel) | Terminé (simulateur) | Sections avec données d'autres appareils non vues à l'écran |
| Compte à clés d'accès, appareils, sessions, clés supplémentaires, récupération, suppression | Terminé (logique) / Implémenté (écran) | idem | Cérémonie Touch ID / Face ID réelle non exécutée |
| SP Sync chiffré de bout en bout (8 collections) | Terminé (logique) | Terminé (logique) | Jamais exercé entre deux machines physiques |
| Enrôlement d'un nouvel appareil avec code à comparer, clé de récupération | Terminé (logique) / Implémenté (écran) | idem | — |
| Navigation privée jamais synchronisée | Terminé | Terminé | Un signet ajouté volontairement en privé rejoint les signets ordinaires |
| Liste de lecture, favoris synchronisés, onglets des autres appareils | Terminé (logique) / Implémenté (panneaux) | Terminé (simulateur) | — |
| Interface iPhone (barre d'adresse en bas, vue des onglets, privé) | — | Terminé (simulateur) | Appareil réel non testé |
| Interface iPad (barre latérale, raccourcis clavier, fenêtres multiples) | — | Implémenté | Largement non exercé |
| Bloqueur de contenu, lecteur, profils, permissions par site | Terminé (1.0) | Non fait | — |
État par fonction — socle 1.0 (macOS), extrait de la matrice
| Fonctionnalité | Statut |
|---|---|
| Barre d'adresse unifiée URL / recherche | Terminé |
| Onglets : créer, fermer, rouvrir, dupliquer, épingler | Terminé |
| Suspension des onglets inactifs | Terminé |
| Restauration de session, y compris après plantage | Terminé |
| Vue scindée redimensionnable | Terminé |
| Navigation privée | Terminé |
| Profils à données web séparées | Terminé |
| Bloqueur de contenu, exception par site, listes à la demande | Terminé |
| Palette de commandes ⌘K | Terminé |
| Zoom mémorisé par site | Terminé |
| Localisation français / anglais | Terminé (889 / 889 en 2.0) |
| Groupes d'onglets, historique, signets, notes, sessions nommées | Terminé (logique) / Implémenté (interface) |
| Onglets verticaux, plein écran, glisser-déposer, partage, impression | Implémenté |
| SP Intelligence | Implémenté — aucun envoi réel testé |
| Accessibilité | Partiel — aucun audit VoiceOver complet |
| Arborescence d'onglets, architecture de plugins, mise à jour automatique | Non fait |
| Export HAR | Non fait, volontairement (export JSON « Resource Timing » à la place) |
| Géolocalisation, notifications, presse-papiers, lecture auto par site | Impossible |
| Extensions Chrome / Firefox / Safari | Non pris en charge |
🏗 Architecture
flowchart TB
subgraph MAC["Application macOS (cible SPBrowser)"]
V["Features (SwiftUI)<br/>BrowserWindow · Sidebar · CommandBar · StartPage<br/>Library · DeveloperTools · Intelligence · Settings"]
AD["App (AppKit)<br/>AppDelegate · menus · App Intents (3)"]
WS["BrowserWindowState<br/>perform(CommandID)"]
TAB["Core/BrowserEngine<br/>BrowserTab · ProfileContext · DownloadManager"]
V -->|observent| WS
AD --> WS
WS -->|possède| TAB
end
subgraph IOS["Application iOS / iPadOS (cible SPBrowserMobile, Mobile/)"]
MV["Features<br/>BrowserView · TabOverview · MobileStartPage<br/>AddressEditor · LibraryViews · MobileSettingsView"]
BM["Engine<br/>BrowserModel · MobileTab · MobileDownloads"]
MV -->|observent| BM
end
subgraph SH["SPBrowser/Shared (SwiftUI multiplateforme)"]
SR["SearchResultsView · SearchMediaViews · SearchPageModel"]
AV["AccountView · BrowserServices · SystemPasskeyAuthorizer"]
end
subgraph CORE["SPBrowser/Core (aussi paquet SwiftPM SPBrowserCore)"]
ST["Storage · History · Bookmarks · Tabs · Profiles"]
SEC["Security · Permissions · ContentBlocking"]
NAV["Navigation · Search · Automation · AI · Settings"]
NET["Backend · SPSearch · Identity · Sync"]
end
V --> SH
MV --> SH
WS --> CORE
BM --> CORE
SH --> CORE
TAB --> WK["WKWebView<br/>processus WebKit isolés"]
BM --> WK
ST --> SQL[("profile.sqlite<br/>par profil")]
ST --> JS[("JSON atomique")]
NET --> SY[("sync.sqlite<br/>miroir + file d'attente")]
SEC --> KC[("Trousseau")]
NET -->|HTTPS| BE["browser.spboucher.ai<br/>sp-browser-backend"]
WK --> DS[("WKWebsiteDataStore<br/>un par profil")]
SP Browser est fait de deux applications natives (Swift 6, concurrence stricte) qui partagent leur cœur : sur Mac,
AppKit pour le cycle de vie, les fenêtres et les menus et SwiftUI pour toute l'interface ; sur iPhone et iPad, une
application SwiftUI (Mobile/). Dans les deux, WebKit (WKWebView) est le moteur de rendu.
| 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 |
- Injection de dépendances : sur Mac,
AppEnvironmentconstruit tout à partir d'un dossier racine et d'unSecretStore; les tests passent un dossier temporaire et un magasin de secrets en mémoire, et les onglets ne connaissent que les protocolesEngineEnvironmentetTabHost. Sur iOS,MobileEnvironmentjoue le même rôle à partir d'un dossier de données (temporaire pour les tests,-SPBDataDir temp). - Une seule voie pour les actions (macOS) : menus, raccourcis, palette ⌘K et App Intents passent tous par
BrowserWindowState.perform(_: CommandID); l'activation est décidée parisEnabled(_:). Les menus sont construits à partir du catalogue, ils ne peuvent donc pas diverger des raccourcis affichés. - Un seul code :
Core/est compilé dans l'application macOS, dans l'application iOS et dans le paquetPackage.swift, sans duplication (BrowserEngine/, lié à l'app macOS, est exclu du paquet et de la cible iOS). La cible iOS compileMobile/+SPBrowser/Core+SPBrowser/Shared+ les deux.lproj.
Connexion par clé d'accès, puis un cycle SP Sync
sequenceDiagram
autonumber
participant U as Utilisateur
participant A as SP Browser (AccountService)
participant S as Système (AuthenticationServices)
participant B as browser.spboucher.ai
participant M as sync.sqlite (miroir)
U->>A: « Se connecter avec une clé d'accès »
A->>B: POST /api/auth/login/options
B-->>A: défi WebAuthn
A->>S: demande d'assertion (webcredentials:browser.spboucher.ai)
S-->>U: Touch ID / Face ID
S-->>A: signature seulement
A->>B: POST /api/auth/login/verify
B-->>A: jeton de session (rangé au trousseau)
A->>B: GET /api/sync/keys
alt appareil déjà enrôlé
B-->>A: enveloppe HPKE de la clé de compte
else nouvel appareil
A->>B: publie sa clé publique, attend l'approbation (code à comparer) ou la clé de récupération
end
loop à chaque cycle
A->>B: GET /api/sync/pull?since=curseur
B-->>A: enregistrements chiffrés
A->>M: déchiffre, fusionne
M-->>A: enregistrements marqués « à envoyer »
A->>B: POST /api/sync/push (ChaCha20-Poly1305, identifiants HMAC)
B-->>A: acceptés, ou version gagnante si périmé
end
Une commande, de la touche à la page
sequenceDiagram
autonumber
participant U as Utilisateur
participant M as Menu · raccourci · palette ⌘K · App Intent
participant S as BrowserWindowState
participant T as BrowserTab
participant G as URLSafety
participant W as WKWebView
U->>M: saisit une adresse ou déclenche une commande
M->>S: perform(CommandID)
S->>S: isEnabled ? AddressResolver : URL ou recherche
S->>T: charger
T->>G: verdict de navigation
alt schéma dangereux ou adresse trompeuse
G-->>T: bloqué ou confirmation demandée
else autorisé
T->>W: load
W-->>T: titre, progression, état TLS
T-->>S: état observé par les vues
end
Cycle de vie des vues web
- Un
WKWebViewpar onglet chargé, possédé parBrowserTab. Changer d'onglet ne recharge rien : la vue hôte SwiftUI (WebViewHost) rattache simplement la vue web existante. - Restauration paresseuse : à la relance, seul l'onglet sélectionné de chaque fenêtre crée sa vue web ; les autres
attendent d'être affichés (
interactionStatede WebKit conservé). - Suspension : un onglet d'arrière-plan inactif depuis N minutes (réglable, 30 par défaut, jamais les onglets
épinglés ni l'onglet visible) libère sa vue web en gardant adresse, titre et
interactionState. - Pas de cycles de rétention : le délégué WebKit (
TabCoordinator) tient l'onglet enweak; l'onglet tient son hôte enweak; les observations KVO sont invalidées danstearDownWebView(). - Plantage du processus de contenu : page dédiée avec rechargement ; les autres onglets ne sont pas touchés.
- Fenêtres ouvertes par les pages (
window.open,target=_blank) :createWebViewWithcrée un onglet avec exactement la configuration fournie par WebKit.
Profils et isolement
| Contexte | Magasin WebKit | Historique | Signets / notes | Permissions |
|---|---|---|---|---|
| Profil | WKWebsiteDataStore(forIdentifier: <UUID du profil>), persistant, distinct |
SQLite du profil | SQLite du profil | JSON du profil |
| Fenêtre privée | WKWebsiteDataStore.nonPersistent(), neuf à chaque contexte |
aucun (base en mémoire, jamais écrite) | ceux du profil parent (ajout explicite) | en mémoire |
L'identifiant du profil par défaut est aléatoire et propre à chaque dossier de données : deux dossiers (application réelle, tests, démonstration) ne partagent jamais un magasin WebKit.
Navigation privée et synchronisation
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 (macOS), testPrivateTabsLeaveNoTraceAndAreNeverPublished (iOS).
🧱 Pile technique
| Couche | Technologie | Version | Rôle |
|---|---|---|---|
| Langage | Swift (SWIFT_VERSION 6.0, swift-tools-version 6.0) |
6 | concurrence stricte complete |
| Interface | SwiftUI | macOS 14+ · iOS 18+ | toute l'interface, vues de recherche et de compte partagées (SPBrowser/Shared) |
| Application Mac | AppKit | macOS 14+ | cycle de vie, fenêtres, menus |
| Rendu | WebKit (WKWebView, WKContentRuleList, WKDownload) |
système | moteur, bloqueur (Mac), téléchargements |
| Persistance | SQLite (-lsqlite3, WAL) · JSON atomique · Trousseau |
système | profile.sqlite, sync.sqlite · réglages, sessions · clés et jetons |
| Chiffrement | CryptoKit (ChaCha20-Poly1305, HKDF-SHA256, HMAC-SHA256, HPKE Curve25519) | système | SP Sync de bout en bout, enveloppes d'appareil, clé de récupération |
| Identité | AuthenticationServices (clés d'accès WebAuthn), Associated Domains | système | SP Identity, domaine browser.spboucher.ai |
| Réseau | URLSession (BackendClient, JSON) |
système | SP Search, SP Identity, SP Sync |
| Automatisation | App Intents | système | 3 intents (Raccourcis, Spotlight) — macOS |
| Paquet | SPBrowserCore (SwiftPM, platforms: macOS 14) |
— | logique sans interface, testée par swift test |
| Projet | XcodeGen (project.yml) ; SPBrowser.xcodeproj généré |
— | 5 cibles, 2 schémas (SPBrowser, SPBrowserMobile) |
| Distribution | Developer ID · notarytool · stapler · DMG ; App Store Connect · TestFlight |
— | macOS ; iOS / iPadOS |
| Service | sp-browser-backend | — | https://browser.spboucher.ai |
| Outils constatés | Xcode 27.2, Swift 6.4.2, SDK macOS 27.2 ; simulateurs iOS 26.5 | — | d'après docs/ENVIRONMENT_AUDIT.md et docs/TEST_REPORT.md |
Aucune dépendance tierce : ni paquet SwiftPM externe, ni CocoaPods, ni Carthage.
🗂 Organisation du dépôt
SPBrowser/
App/ main.swift, AppDelegate (cycle de vie, menus), AppEnvironment (racine de composition), Intents [macOS]
Core/ logique métier sans interface — macOS + iOS + paquet SwiftPM pour `swift test`
Navigation/ AddressResolver (texte saisi → URL ou recherche)
Search/ moteurs de recherche et raccourcis (SP Search par défaut)
SPSearch/ client et modèles SP Search, adresse interne spsearch://, surlignage
Backend/ BackendClient : client HTTP JSON commun, erreurs stables, configuration (production ou remplacée)
Identity/ AccountService (compte, sessions, appareils, récupération), Passkeys (JSON WebAuthn, PasskeyAuthorizer)
Sync/ SyncCrypto, SyncDatabase (miroir + file d'attente), SyncEngine, SyncBridges, SyncCoordinator
Security/ URLSafety (verdict de navigation), signaux d'adresse trompeuse, Keychain
Storage/ SQLiteDatabase (+ migrations), JSONFileStore (écriture atomique), ProfileDatabase
History/ Bookmarks/ magasins SQLite, import/export HTML Netscape
Tabs/ modèles de session, sauvegarde + copie de secours
Profiles/ profils, journalisation respectueuse de la vie privée
Permissions/ décisions par site
ContentBlocking/ génération des règles WKContentRuleList, analyse de listes
Automation/ catalogue de commandes, raccourcis, scripts utilisateur
AI/ fournisseurs, requêtes/réponses, construction des invites
Settings/ AppSettings et sa migration
BrowserEngine/ (macOS seulement, exclu du paquet et de la cible iOS) BrowserTab, ProfileContext, DownloadManager, PageScripts
Shared/ SwiftUI multiplateforme — macOS + iOS
Search/ SearchResultsView, SearchMediaViews, SearchPageModel, SPSearchPreferencesSection
Account/ AccountView, BrowserServices, SystemPasskeyAuthorizer
Platform/ Platform.swift (ponts AppKit / UIKit)
Features/ vues SwiftUI macOS : BrowserWindow, Sidebar (+ SyncedPanels), CommandBar, StartPage, Library,
DeveloperTools, Intelligence, Settings
DesignSystem/ jetons (couleurs, rayons), composants communs
Resources/ Info.plist, entitlements (dev + Release), Assets.xcassets, en.lproj, fr.lproj (partagés avec iOS)
Tests/ CoreTests (SwiftPM), AppTests (hébergés dans l'application macOS)
Mobile/ application iPhone / iPad
App/ SPBrowserMobileApp (scènes, raccourcis clavier), MobileEnvironment
Engine/ BrowserModel (onglets d'une scène), MobileTab (WKWebView), MobileDownloads
Features/ BrowserView (iPhone + iPad), TabOverview, AddressEditor, MobileStartPage, LibraryViews, MobileSettingsView
Resources/ Info.plist, SPBrowserMobile.entitlements, Assets.xcassets
Tests/ MobileEngineTests (hébergés) UITests/ BrowserUITests (XCUITest)
Assets/Brand/ sources SVG de l'icône, concepts, rendus et script de génération
scripts/ build, test, backend de test, iOS (build, test, release), provisionnement, release, notarisation,
vérification, performance, localisation
docs/ 10 documents, captures (macOS + ios/), brand/
Package.swift paquet SPBrowserCore
project.yml définition XcodeGen| Dossier | Fichiers Swift | Lignes |
|---|---|---|
SPBrowser/Core |
30 | 5 911 |
SPBrowser/Features |
14 | 4 836 |
Mobile/ (App 2 · Engine 3 · Features 6 · Tests 1 · UITests 1) |
13 | 2 745 |
SPBrowser/Tests |
9 | 2 475 |
SPBrowser/Shared |
8 | 1 693 |
SPBrowser/App |
4 | 758 |
SPBrowser/DesignSystem |
1 | 180 |
scripts/window-shot.swift + Package.swift |
2 | 38 |
| Total | 81 | 18 636 |
Cible (project.yml) |
Type | Plateforme | Identifiant |
|---|---|---|---|
SPBrowser |
application | macOS 14.0 | ai.spboucher.spbrowser (Debug : ai.spboucher.spbrowser.debug) |
SPBrowserTests |
tests unitaires hébergés | macOS | ai.spboucher.spbrowser.tests |
SPBrowserMobile |
application (iPhone + iPad, TARGETED_DEVICE_FAMILY 1,2) |
iOS 18.0 | ai.spboucher.spbrowser |
SPBrowserMobileTests |
tests unitaires hébergés | iOS 18.0 | ai.spboucher.spbrowser.mobile.tests |
SPBrowserMobileUITests |
tests d'interface | iOS 18.0 | ai.spboucher.spbrowser.mobile.uitests |
🚀 Compiler et tester
Prérequis : Xcode 27 (Swift 6), xcodegen (brew install xcodegen).
scripts/build.sh # build Debug → build/DerivedData/Build/Products/Debug/SPBrowser.app
scripts/test.sh all # tests du cœur (swift test) + tests d'intégration de l'app macOS (xcodebuild test)
scripts/test-backend.sh up # serveur jetable pour les tests d'intégration compte/synchro (exporter les variables affichées)
scripts/ios-build.sh # build iOS pour simulateur ; scripts/ios-test.sh unit|ui
scripts/provision.py # profil Developer ID avec domaines associés (clés d'accès)
open SPBrowser.xcodeproj # le projet est généré à partir de project.yml
scripts/build-release.sh # archive Release signée Developer ID → dist/SPBrowser.app
scripts/notarize.sh # notarisation, agrafage, image disque
scripts/verify-release.sh # vérification complète de la version
scripts/perf.sh dist/SPBrowser.app # lancement et mémoire à 1, 10 et 30 onglets
scripts/check-localization.py # toutes les chaînes ont-elles leur traduction française ?
Assets/Brand/build-icons.sh # régénère les icônes à partir des SVGLancer avec un dossier de données isolé (démonstration, essais) :
open -n build/DerivedData/Build/Products/Debug/SPBrowser.app --args -SPBDataDir '~/Library/Application Support/SPB-Demo'Tests d'intégration compte / synchronisation contre un vrai serveur local, puis recherche réelle :
eval "$(scripts/test-backend.sh up)" # clone/actualise sp-browser-backend, le lance sur 127.0.0.1, affiche les export
swift test # les tests d'intégration multi-appareils s'activent avec ces variables
SPB_LIVE_SEARCH=1 swift test --filter LiveSearchTests # web, images, vidéos par la production (quelques crédits)
scripts/test-backend.sh down| Script | Usage |
|---|---|
scripts/build.sh [Debug|Release] |
compile l'app macOS et n'affiche que les erreurs, les avertissements et le résultat |
scripts/test.sh [core|app|all] |
tests du cœur (SwiftPM) et tests d'intégration dans l'application macOS (xcodebuild) |
scripts/test-backend.sh up|down |
backend jetable sur 127.0.0.1 (base temporaire, inscription ouverte, sans clé de fournisseur de recherche — jamais de données de production) ; down arrête par PID du port, jamais par nom |
scripts/ios-build.sh [simulateur] |
build Debug iOS pour simulateur (par défaut « SPBrowser iPhone », créé à partir d'un iPhone 17 Pro s'il manque ; un nom contenant « iPad » crée un iPad Pro 13") |
scripts/ios-test.sh unit|ui [simulateur] |
tests hébergés iOS (pas de réseau au-delà de localhost) ou tests d'interface (le test de recherche interroge SP Search en production) |
scripts/ios-release.sh archive|export|upload|all |
archive Release iOS, IPA App Store Connect en signature automatique, envoi TestFlight (all = archive + export ; upload est explicite) |
scripts/ios-ExportOptions.plist |
options d'export (app-store-connect, signature automatique) |
scripts/provision.py |
enregistre l'identifiant d'app, la capacité Associated Domains et le profil « SP Browser Developer ID » (idempotent, ne crée jamais de certificat) |
scripts/asc.py |
client minimal de l'API App Store Connect utilisé par provision.py et ios-release.sh |
scripts/build-release.sh |
archive Release macOS signée Developer ID avec le profil, exporte dist/SPBrowser.app |
scripts/notarize.sh |
notarise l'app, agrafe, puis construit, signe, notarise et agrafe dist/SPBrowser.dmg |
scripts/verify-release.sh |
signature, entitlements, runtime durci, Gatekeeper, ticket de notarisation |
scripts/perf.sh [app] |
lancement et mémoire à 1, 10 et 30 onglets, dossier de données vide à chaque mesure |
scripts/check-localization.py [--list] |
couverture de la traduction française (sources SPBrowser/ + Mobile/) |
scripts/window-shot.swift |
capture de la fenêtre de l'application |
⚙️ Configuration
macOS. Tout se règle dans Réglages (⌘,) : démarrage, apparence, moteur de recherche, confidentialité,
bloqueur, profils, clavier, SP Intelligence, scripts utilisateur, compte et synchronisation, options avancées. Les
données sont dans le conteneur de l'application (~/Library/Containers/ai.spboucher.spbrowser/).
iOS / iPadOS. Réglages de l'app : Recherche, Apparence, Navigation, Confidentialité, et l'écran Compte.
Réglage de build (project.yml) |
Valeur |
|---|---|
MARKETING_VERSION · CURRENT_PROJECT_VERSION |
2.0.0 · 2 |
SWIFT_VERSION · SWIFT_STRICT_CONCURRENCY |
6.0 · complete |
| Cibles de déploiement | macOS 14.0 · iOS 18.0 |
PRODUCT_BUNDLE_IDENTIFIER |
ai.spboucher.spbrowser (macOS Release et iOS) ; ai.spboucher.spbrowser.debug (macOS Debug) |
ENABLE_HARDENED_RUNTIME |
YES (macOS) |
ENABLE_USER_SCRIPT_SANDBOXING · DEAD_CODE_STRIPPING |
YES · YES |
SUPPORTS_MACCATALYST · SUPPORTS_MAC_DESIGNED_FOR_IPHONE_IPAD |
NO · NO (l'app Mac est la cible native) |
| Langue de développement | en (localisation fr complète) |
| Argument de lancement | Plateforme | Rôle |
|---|---|---|
-SPBDataDir <dossier> |
macOS · iOS | dossier de données isolé (temp sur iOS = dossier temporaire) |
-SPBBackendURL <url> |
macOS · iOS | remplace l'adresse du backend (tests, développement ; ex. http://127.0.0.1:8710) |
-SPBRelyingParty <domaine> |
macOS · iOS | domaine de confiance WebAuthn associé à l'adresse remplacée |
-SPBOpenURLs "url1,url2" |
macOS · iOS | ouvre les adresses dans des onglets (iOS : seulement avec un dossier de données jetable) |
-SPBShow tabs|settings|account|private|library |
iOS | ouvre un écran au lancement (tests d'interface et captures) |
-SPBShowSettings <section> |
macOS | ouvre une section des réglages au lancement |
-SPBPerfLog 1 |
macOS | écrit la mesure de lancement (utilisé par scripts/perf.sh) |
| Variable d'environnement (noms seulement) | Utilisée par | Rôle |
|---|---|---|
SPB_TEST_BACKEND · SPB_TEST_ORIGIN · SPB_TEST_RP · SPB_TEST_DB |
swift test |
activent les tests d'intégration contre le backend jetable (affichées par scripts/test-backend.sh up) |
SPB_TEST_BACKEND_DIR · SPB_TEST_PORT |
scripts/test-backend.sh |
dossier du clone du backend · port local (8719 par défaut) |
SPB_LIVE_SEARCH |
swift test |
active le test de recherche réelle par la production |
SIGN_IDENTITY |
scripts de publication macOS | identité de signature (par défaut la première « Developer ID Application » du trousseau) |
TEAM_ID |
scripts de publication macOS | équipe de développement |
NOTARY_PROFILE |
scripts/notarize.sh |
profil trousseau de notarytool (par défaut MacLustr-Notarize) |
ASC_KEY_ID · ASC_ISSUER_ID · ASC_KEY_PATH |
scripts/asc.py |
clé d'API App Store Connect déjà présente sur le Mac (sinon retrouvée dans l'outillage existant) |
⌨️ Raccourcis et commandes
Raccourcis essentiels (macOS) :
| ⌘T | Nouvel onglet | ⌘L | Barre d'adresse |
| ⇧⌘N | Fenêtre privée | ⌘K | Palette de commandes |
| ⇧⌘T | Rouvrir l'onglet fermé | ⇧⌘A | Rechercher dans les onglets |
| ⌘\ | Vue scindée | ⌃⌘S | Barre latérale |
| ⌘D | Ajouter un signet | ⌘Y | Historique |
| ⌘F | Rechercher dans la page | ⌥⌘R | Lecteur |
| ⌘I | Informations sur la page | ⇧⌘F | Mode Concentration |
| ⌘1…⌘9 | Aller à l'onglet | ⌘, | Réglages |
| ⌥⌘D | Ajouter à la liste de lecture (2.0) | ⌃⌘L | Afficher la liste de lecture (2.0) |
Liste complète : docs/AUTOMATION.md. Tous sont modifiables dans Réglages › Clavier ; les
conflits y sont signalés. Dans la palette : > limite aux commandes, @ aux onglets, # aux signets.
Catalogue complet des commandes macOS (SPBrowser/Core/Automation/Commands.swift)
| Catégorie | Identifiants (raccourci par défaut) |
|---|---|
| Fichier | newTab ⌘T · newWindow ⌘N · newPrivateWindow ⇧⌘N · openFile ⌘O · openLocation ⌘L · closeTab ⌘W · closeWindow ⇧⌘W · savePageAsPDF · capturePage · printPage ⌘P · sharePage · openSettings ⌘, · showAccount (2.0) |
| Édition | findInPage ⌘F · findNext ⌘G · findPrevious ⇧⌘G |
| Présentation | reload ⌘R · hardReload ⇧⌘R · stopLoading ⌘. · zoomIn ⌘= · zoomOut ⌘- · zoomReset ⌘0 · toggleSidebar ⌃⌘S · toggleTabLayout · toggleFocusMode ⇧⌘F · toggleReader ⌥⌘R · toggleFullScreen ⌃⌘F · commandPalette ⌘K · toggleSplitView ⌘\ · swapSplit |
| Historique | goBack ⌘[ · goForward ⌘] · goHome ⇧⌘H · reopenClosedTab ⇧⌘T · showHistory ⌘Y · clearHistory |
| Onglets | nextTab ⇧⌘] · previousTab ⇧⌘[ · searchTabs ⇧⌘A · duplicateTab ⇧⌘D · pinTab · newTabGroup · moveTabToNewWindow · closeOtherTabs ⌥⌘W · suspendTab · nextWorkspace ⌃⌥⌘→ · previousWorkspace ⌃⌥⌘← · showOtherDevices (2.0) · ⌘1…⌘9 |
| Signets | addBookmark ⌘D · showBookmarks ⌥⌘B · importBookmarks · exportBookmarks · addToReadingList ⌥⌘D (2.0) · showReadingList ⌃⌘L (2.0) · toggleFavorite (2.0) |
| Outils | showDownloads ⌥⌘L · showNotes · showSessions · saveSession · toggleIntelligence ⇧⌘I · pageInfo ⌘I · toggleBlockerForSite · clearSiteData · viewSource ⌥⌘U · pageMetadata · changeUserAgent · syncNow (2.0) |
Clavier matériel sur iPad / iPhone (Mobile/App/SPBrowserMobileApp.swift, calqué sur l'app Mac) :
| ⌘T | Nouvel onglet | ⇧⌘N | Nouvel onglet privé |
| ⌘W | Fermer l'onglet | ⇧⌘T | Rouvrir l'onglet fermé |
| ⌘L | Barre d'adresse | ⌘R | Recharger |
| ⌘F | Rechercher dans la page | ⌘[ · ⌘] | Précédent · Suivant |
| ⌘D | Ajouter un signet | ⌘Y | Historique |
| ⌥⌘B | Signets | ⇧⌘] · ⇧⌘[ | Onglet suivant · précédent |
| ⇧⌘\ | Tous les onglets |
📱 Écrans iOS / iPadOS
| Écran | Fichier | Contenu |
|---|---|---|
| Navigateur | Mobile/Features/BrowserView.swift |
iPhone : barre d'adresse en bas (PhoneAddressBar), barre d'outils, menu de page ; iPad : barre supérieure, bande d'onglets (PadTabStrip), barre latérale (PadSidebar) ; page d'erreur, bannières |
| Vue des onglets | Mobile/Features/TabOverview.swift |
cartes d'onglets, bascule privé, fermeture |
| Saisie d'adresse | Mobile/Features/AddressEditor.swift |
adresse ou recherche, suggestions locales |
| Page de démarrage | Mobile/Features/MobileStartPage.swift |
favoris, fréquents, récents, recherches, autres appareils, liste de lecture |
| Bibliothèque | Mobile/Features/LibraryViews.swift |
signets (+ éditeur), liste de lecture, historique, téléchargements |
| Réglages | Mobile/Features/MobileSettingsView.swift |
Recherche, Apparence, Navigation, Confidentialité |
| Résultats SP Search | SPBrowser/Shared/Search/ |
Tout · Images · Vidéos, aperçu d'image, lecteur vidéo (partagés avec macOS) |
| Compte | SPBrowser/Shared/Account/AccountView.swift |
compte, appareils, sessions, clés d'accès, récupération (partagé avec macOS) |
Comportements propres à iOS : une scène (écran d'iPhone ou fenêtre d'iPad) a ses propres onglets
(UIApplicationSupportsMultipleScenes) ; les onglets d'arrière-plan sont suspendus quand l'app passe en
arrière-plan ; l'app déclare les schémas http / https et ouvre l'adresse reçue dans un nouvel onglet ; les
téléchargements sont exposés à l'app Fichiers (UIFileSharingEnabled, LSSupportsOpeningDocumentsInPlace).
L'app iOS n'a ni bloqueur de contenu, ni lecteur, ni profils, ni permissions par site.
🔌 API du backend utilisée
Routes de sp-browser-backend appelées par le code de ce dépôt
(SPBrowser/Core/{SPSearch,Identity,Sync}), toutes sur https://browser.spboucher.ai.
| Domaine | Méthode et route | Appelant |
|---|---|---|
| SP Search | POST /api/search |
SPSearchClient |
| Inscription | POST /api/auth/register/options · POST /api/auth/register/verify |
AccountService (code d'invitation) |
| Connexion | POST /api/auth/login/options · POST /api/auth/login/verify |
AccountService |
| Récupération | POST /api/auth/recover/options · POST /api/auth/recover/verify |
AccountService (clé de récupération) |
| Confirmation | POST /api/auth/reauth/options · POST /api/auth/reauth/verify |
avant une action destructrice |
| Clés d'accès | POST /api/auth/passkeys/options · POST /api/auth/passkeys/verify · DELETE /api/auth/passkeys/{id} |
ajout / retrait d'une clé |
| Session | POST /api/auth/logout · POST /api/auth/logout-all |
déconnexion, déconnexion partout |
| Compte | GET /api/account · PATCH /api/account · DELETE /api/account |
détails, nom affiché, suppression |
| Appareils | DELETE /api/devices/{id} |
retrait d'un appareil |
| Clé de compte | GET /api/sync/keys · POST /api/sync/keys/bootstrap · GET /api/sync/keys/pending · POST /api/sync/keys/approve |
état, premier appareil, demandes en attente, approbation (enveloppe HPKE) |
| Clé de récupération | GET /api/sync/keys/recovery · PUT /api/sync/keys/recovery · POST /api/sync/keys/claim |
ouverture par la clé de récupération, renouvellement |
| Synchronisation | GET /api/sync/pull?since=…&limit=500 · POST /api/sync/push |
SyncEngine |
| Effacement | DELETE /api/sync/data (en-tête X-SP-Key-Proof) |
effacer la copie du serveur |
🤖 Automatisation
Détail : docs/AUTOMATION.md.
App Intents (app Raccourcis, Spotlight)
| Intent | Effet |
|---|---|
| Ouvrir une adresse dans SP Browser | Ouvre une adresse http(s) dans un nouvel onglet |
| Rechercher sur le web dans SP Browser | Recherche avec le moteur par défaut |
| Nouvelle fenêtre privée dans SP Browser | Ouvre une fenêtre privée |
Ils ne lisent ni contenu de page, ni historique, ni cookies, et n'agissent sur aucun site. Aucune API réseau locale n'est ouverte et aucun schéma d'URL personnalisé n'expose de commandes. Ces intents compilent et sont déclarés dans l'application ; ils n'ont pas été exercés depuis l'app Raccourcis.
Scripts utilisateur — Réglages › Scripts utilisateur. Désactivés par défaut. Chaque script déclare ses sites
(exemple.com = ce site et ses sous-domaines ; *.exemple.com = sous-domaines seulement) ; il n'existe pas de joker
« tous les sites ». Le code est injecté dans un monde JavaScript isolé, jamais en fenêtre privée. Aucune API
privilégiée n'est offerte aux scripts.
Extensions — Chrome, Firefox ou Safari : non prises en charge. La seule voie légitime serait WKWebExtension
(macOS 15.4+) ; elle n'est pas utilisée parce que la cible minimale est macOS 14 et parce que charger du code tiers
demande un modèle de permissions complet qui n'a pas été conçu ni testé. Une esquisse d'architecture de plugins (non
implémentée) figure dans docs/AUTOMATION.md.
💾 Données et persistance
| Donnée | Support | Garanties |
|---|---|---|
| Historique, signets, notes | SQLite par profil (profile.sqlite, tables history, bookmarks, notes), WAL |
Migrations ajoutées en fin de liste, suivies par PRAGMA user_version, chacune dans une transaction (testé : v1 → v2 sans perte, retour arrière si échec) ; requêtes paramétrées |
| Miroir de synchronisation et file d'attente hors ligne | sync.sqlite (tables records, meta) |
Copie en clair sur l'appareil seulement ; chaque modification locale marquée dirty jusqu'à acceptation par le serveur ; existe aussi sans compte, pour les favoris, la liste de lecture et l'historique de recherche |
| Réglages, permissions, espaces, scripts, listes, téléchargements | JSON | Écriture atomique ; champs absents d'un ancien fichier = valeur par défaut ; fichier illisible renommé .corrupt-<horodatage> ; migration des réglages v2 → v3 (moteur par défaut) |
| Session | Sessions/session.json + session.backup.json |
Écriture atomique, copie de secours de la dernière version valide, repli automatique, mise à l'écart si tout est illisible |
| Clés d'API, jeton de session, clé privée de l'appareil, clé de compte SP Sync | Trousseau | Jamais dans les réglages, journaux ou adresses |
| Données de sites | WebKit | Par profil ; effacement par site ou global |
Emplacement (macOS) : ~/Library/Containers/ai.spboucher.spbrowser/Data/Library/Application Support/SP Browser/.
Sur iOS : dossier SP Browser de l'Application Support de l'app.
Table records de sync.sqlite (SPBrowser/Core/Sync/SyncDatabase.swift) :
| Colonne | Type | Rôle |
|---|---|---|
collection · key |
TEXT (clé primaire) | collection (history, bookmarks, favorites, tabs, closed, reading, searches, prefs) et clé locale |
json |
TEXT | contenu en clair, local |
modified_at |
REAL | date de dernière modification (règle « dernière modification gagne ») |
deleted |
INTEGER | pierre tombale |
server_seq |
INTEGER | version connue du serveur (contrôle optimiste) |
dirty |
INTEGER | à envoyer (index partiel records_dirty) |
remote_id |
TEXT | identifiant opaque (HMAC) vu par le serveur |
Favoris, liste de lecture, historique de recherche, préférences et onglets des autres appareils ne vivent que dans
ce miroir ; l'historique et les signets y sont pontés depuis la base du profil (SyncBridges).
Journalisation. Log.event écrit dans le journal unifié en développement et, seulement si l'utilisateur
l'active, dans diagnostics.log (local). Les adresses sont réduites à schéma://hôte. Aucune télémétrie, aucun
envoi.
🔐 Sécurité
Détail : docs/SECURITY.md (navigateur) et docs/SECURITY.md du
backend (compte et synchronisation). Aucune de ces mesures ne garantit une protection totale contre
l'hameçonnage ou les logiciels malveillants.
Isolation (macOS). App Sandbox et Hardened Runtime activés, sans exception. Entitlements : réseau sortant,
fichiers choisis par l'utilisateur, dossier Téléchargements, caméra, micro, impression ; en Release s'y ajoutent le
domaine associé webcredentials:browser.spboucher.ai et le groupe de trousseau de l'application. Sur iOS, le seul
droit déclaré est ce même domaine associé. Le rendu des pages s'exécute dans les
processus WebKit du système. Tout JavaScript exécuté par le navigateur lui-même (texte de page, métadonnées, lecteur,
favicon) tourne dans un monde de contenu isolé.
| Cas de navigation | Comportement |
|---|---|
javascript: / vbscript: saisi ou suivi |
Jamais exécuté ; saisi dans la barre d'adresse, il est recherché comme du texte |
data: en navigation principale |
Bloqué et signalé |
file: demandé par une page web |
Bloqué ; permis seulement s'il est ouvert par l'utilisateur ou depuis un fichier local |
Schémas d'autres applications (mailto:, zoommtg:…) |
Confirmation nommant l'application avant d'ouvrir ; refusé depuis un sous-cadre |
| Adresse contenant un nom d'utilisateur ou mélangeant des alphabets | Confirmation montrant la destination réelle (réglable) |
| Fenêtres surgissantes sans clic | Bloquées par défaut, autorisables par site |
TLS. La validation des certificats est laissée à macOS. Il n'existe aucun moyen de contourner une erreur de certificat. La mise à niveau HTTPS des hôtes connus et l'avertissement de site frauduleux de WebKit sont activés.
| Capacité | Contrôle par site |
|---|---|
| Caméra, micro | Oui : demander / autoriser / refuser ; une demande venant d'un cadre tiers est refusée |
| JavaScript, fenêtres surgissantes, bloqueur de contenu | Oui |
| Géolocalisation, notifications web, lecture du presse-papiers, lecture automatique | Non — aucune API publique par site sur macOS ; non proposé plutôt que simulé |
Ces contrôles par site sont ceux de l'app macOS ; l'app iOS ne les reprend pas.
Bloqueur de contenu. Règles WKContentRuleList compilées par WebKit : blocage réseau des requêtes tierces
vers environ 130 hôtes de pistage et de publicité connus (liste intégrée), plus des listes distantes facultatives. Pas
de filtrage cosmétique, pas d'injection de script. Les listes distantes ne sont téléchargées que sur action de
l'utilisateur, en HTTPS, sans cookies.
Téléchargements. Nom de fichier nettoyé (aucun composant de chemin, caractères de contrôle et marques
bidirectionnelles supprimés), jamais d'écrasement (rapport.pdf devient rapport (2).pdf), attribut de quarantaine
posé, confirmation avant ouverture des fichiers pouvant exécuter du code. Rien ne s'ouvre automatiquement.
Secrets. Clés d'API dans le Trousseau (kSecAttrAccessibleWhenUnlockedThisDeviceOnly), envoyées uniquement dans
un en-tête HTTP, jamais affichées de nouveau, jamais journalisées. HTTP non chiffré n'est accepté que pour
localhost.
Depuis la 2.0, le jeton de session, la clé privée de l'appareil et la clé de compte SP Sync sont eux aussi au Trousseau, et nulle part ailleurs.
SP Intelligence. Désactivé par défaut ; aucun fournisseur préconfiguré. Le contenu d'une page n'est transmis qu'après une action de l'utilisateur et la validation d'un aperçu montrant le texte exact, la destination et le modèle. Défense contre l'injection d'invite : texte de la page entre des marqueurs à frontière aléatoire, marqueurs imités neutralisés — cela réduit le risque sans l'éliminer. L'assistant n'a aucun outil : il ne peut ni naviguer, ni cliquer, ni acheter, ni envoyer.
Compte et synchronisation (2.0).
| Sujet | Mesure |
|---|---|
| Authentification | Clés d'accès WebAuthn par AuthenticationServices ; aucun mot de passe ; l'application ne reçoit qu'une signature, jamais de donnée biométrique |
| Domaine de confiance | browser.spboucher.ai, lié à l'app par Associated Domains (webcredentials:) ; fichier d'association servi par le backend |
| Chiffrement des enregistrements | ChaCha20-Poly1305, clé dérivée (HKDF-SHA256) de la clé de compte ; données authentifiées liant collection, identifiant et version |
| Identifiants côté serveur | HMAC-SHA256 à clé : une URL ou une requête n'apparaît jamais en clair |
| Clé de compte | Créée sur le premier appareil ; le serveur n'en reçoit qu'un vérificateur ; transmise aux autres appareils dans une enveloppe HPKE (Curve25519, SHA-256, ChaCha20-Poly1305) après comparaison d'un code |
| Clé de récupération | Montrée une seule fois à la création ; en émettre une nouvelle invalide la précédente |
| Actions destructrices | Nouvelle confirmation par clé d'accès (/api/auth/reauth) |
| 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 |
| Limite connue | Pas de rotation de clé au retrait d'un appareil (voir docs/SECURITY.md du backend) |
| Page de recherche | Seul l'utilisateur peut ouvrir une adresse spsearch:// ; le contenu web ne peut pas y naviguer (testé sur macOS et iOS) |
Signaler un problème : contact@spboucher.ai
🕶 Confidentialité
Détail : docs/PRIVACY.md. Aucune télémétrie. Compte et synchronisation facultatifs, chiffrés de
bout en bout. Sans compte, rien n'est synchronisé et SP Browser fonctionne entièrement en local, à l'exception des
recherches SP Search que vous lancez. Les seules connexions sortantes sont celles que vous déclenchez ou, une fois
connecté, la synchronisation que vous avez activée.
| Connexion | Déclencheur | Contenu |
|---|---|---|
| Sites web | Vous naviguez | Ce que WebKit envoie normalement à un site |
SP Search (browser.spboucher.ai) |
Vous validez une recherche (Retour), changez de mode ou demandez plus de résultats | La requête et ses filtres (langue, région, date, filtrage). Le serveur interroge le fournisseur de recherche sans y joindre votre compte ni votre adresse, ne journalise pas les requêtes et garde un cache en mémoire seulement. Rien n'est envoyé pendant la frappe |
| Autre moteur de recherche | Vous l'avez choisi comme moteur par défaut ou utilisez son raccourci | La requête, directement à ce moteur |
| Vignettes des résultats | Une page de résultats images ou vidéos s'affiche | Requêtes des images vers leurs sites d'origine, sans cookies, en mémoire seulement |
| Lecteur vidéo intégré | Vous cliquez « Aperçu ici » | Le lecteur de la plateforme (YouTube sans cookies, Vimeo, Dailymotion) dans une vue non persistante |
| SP Identity | Vous créez un compte ou vous connectez | Une signature de clé d'accès, le nom et le modèle de l'appareil, une clé publique. Jamais de donnée biométrique |
| SP Sync | Vous êtes connecté et la synchronisation est activée | Historique, signets, favoris, onglets ouverts, liste de lecture, historique et préférences de recherche — chiffrés sur l'appareil avec une clé que le serveur ne reçoit jamais |
| Icônes de sites | Chargement d'une page | Requête de l'icône, sans cookies, par une session éphémère distincte |
| Listes de blocage | Vous cliquez « Mettre à jour » | Téléchargement HTTPS sans cookies |
| SP Intelligence | Vous lancez une action et validez l'aperçu | Le texte affiché dans l'aperçu, vers le fournisseur que vous avez configuré |
Navigation privée (vérifié par tests) : les pages visitées ne sont pas ajoutées à l'historique ; cookies, cache et stockage vivent en mémoire dans un magasin distinct et disparaissent à la fermeture ; une fenêtre privée ne voit pas les cookies de la session normale, et inversement ; les fenêtres privées ne sont jamais enregistrées dans une session ; les scripts utilisateur n'y tournent pas ; les recherches n'y sont pas ajoutées à l'historique de recherche ; rien de ce qui s'y passe n'est synchronisé (ni pages, ni recherches, ni onglets ouverts ou fermés ; liste de lecture et favoris y sont désactivés). Elle ne vous rend pas invisible : sites, employeur, école et fournisseur d'accès voient toujours votre activité ; les fichiers téléchargés et les signets ajoutés sont conservés — un signet ajouté volontairement depuis une fenêtre privée rejoint vos signets ordinaires et se synchronise comme eux ; une recherche SP Search y est envoyée au serveur comme en fenêtre ordinaire (elle n'y est pas journalisée).
Effacer : historique par visite, par site, par période ou en entier (l'historique de recherche part avec) ; historique de recherche entrée par entrée ou en entier ; copie synchronisée (Réglages → Compte → « Effacer les données synchronisées », le serveur seulement) ou « Supprimer le compte » ; données d'un site ; cookies un par un ; profil complet. Quand la synchronisation est active, les suppressions d'historique sont propagées aux autres appareils. Toute opération destructive demande confirmation.
✅ Tests et performance
Rapport complet : docs/TEST_REPORT.md — 2.0.0 (2), 2026-11-18, Apple M5 Max, 48 Go,
macOS 27.0, Xcode 27.2, simulateurs iOS 26.5 (iPhone 17 Pro, iPad Pro 13"). Une seule machine. Aucun appareil iOS
réel n'a été utilisé.
| Suite | Commande | Résultat |
|---|---|---|
| Cœur : unitaires + intégration contre un vrai serveur local + recherche réelle | scripts/test-backend.sh up, variables exportées, SPB_LIVE_SEARCH=1 swift test |
110 / 110 (101 unitaires, 8 d'intégration multi-appareils, 1 recherche réelle web/images/vidéos par la production) |
Application macOS (vrais WKWebView) |
scripts/test.sh app |
35 / 35 |
| Application iOS, tests hébergés (simulateur iPhone) | scripts/ios-test.sh unit |
7 / 7 |
| Application iOS, tests d'interface (simulateur iPhone) | scripts/ios-test.sh ui (xcodebuild … -scheme SPBrowserMobile test) |
3 / 3 (dont une recherche réelle Tout → Images → Vidéos → résultat → retour) ; sur iPad : 7 unitaires + 1 test d'interface |
| Backend | npm test sur le nœud |
15 / 15 ; npm run test:live réussi |
| Localisation | scripts/check-localization.py |
889 clés (macOS + iOS), 889 traductions françaises, 0 problème |
| Version macOS | scripts/verify-release.sh |
signée, notarisée, agrafée, acceptée par Gatekeeper |
| Fichier de tests | Cible | Tests |
|---|---|---|
SPBrowser/Tests/CoreTests/NavigationAndSecurityTests.swift |
swift test |
40 |
SPBrowser/Tests/CoreTests/StorageTests.swift |
swift test |
28 |
SPBrowser/Tests/CoreTests/SearchAndSyncTests.swift (2.0) |
swift test |
19 |
SPBrowser/Tests/CoreTests/AITests.swift |
swift test |
14 |
SPBrowser/Tests/CoreTests/BackendIntegrationTests.swift (2.0 ; 8 d'intégration + 1 recherche réelle) |
swift test |
9 |
SPBrowser/Tests/AppTests/EngineIntegrationTests.swift |
SPBrowserTests |
15 |
SPBrowser/Tests/AppTests/WindowAndPrivacyTests.swift |
SPBrowserTests |
14 |
SPBrowser/Tests/AppTests/SearchAndSyncAppTests.swift (2.0) |
SPBrowserTests |
6 |
Mobile/Tests/MobileEngineTests.swift (2.0) |
SPBrowserMobileTests |
7 |
Mobile/UITests/BrowserUITests.swift (2.0) |
SPBrowserMobileUITests |
3 |
| Total | 155 |
SoftwareAuthenticator.swift (CoreTests) n'est pas une suite : c'est l'authentificateur logiciel (signatures ES256
réelles) qui remplace Touch ID dans les tests d'intégration.
| Suite 2.0 | Ce qu'elle exerce |
|---|---|
| Cœur, unitaires | 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 | 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 |
| Recherche réelle | web, images et vidéos par la production (quelques crédits) |
| Application macOS | recherche native dans de vrais WKWebView, précédent/suivant, refus de navigation depuis une page, isolement privé, commandes |
| Application iOS | page de recherche native et précédent/suivant, refus depuis le contenu web, onglets privés sans trace ni publication, session restaurée paresseusement, fermeture/réouverture, suggestions locales, destinations de téléchargement sûres ; interface : trois modes de recherche, vue des onglets et mode privé, connexion par clé d'accès |
| 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.
Tests du socle 1.0 par domaine (82 unitaires, toujours exécutés)
| Domaine | Tests | Ce qui est vérifié |
|---|---|---|
| Barre d'adresse | 11 | URL explicites, hôtes nus → HTTPS, hôtes locaux → HTTP, IPv6, ports invalides, raccourcis de recherche, schémas dangereux recherchés et non chargés |
| Sécurité des URL | 8 | Verdicts par schéma, avertissements (identifiants intégrés, punycode, alphabets mélangés, IP, HTTP), domaine enregistrable |
| Téléchargements | 5 | Nettoyage des noms, unicité, niveau de risque |
| Bloqueur | 8 | JSON valide, règles tierces uniquement, exception par site, analyse des listes, HTTPS obligatoire |
| Permissions et scripts | 4 | Valeurs par défaut, persistance, zoom par site, correspondance d'hôtes sans joker universel |
| Commandes | 4 | Raccourcis par défaut sans conflit, remplacements, détection de conflits |
| SQLite et migrations | 4 | Migration v1 → v2 sans perte, retour arrière si échec, requêtes paramétrées |
| Historique | 5 | Seules les pages web sont enregistrées, regroupement des rechargements, suppression par site |
| Signets | 5 | Dossiers, tags, déplacements sans cycle, aller-retour HTML, fichiers hostiles |
| Notes | 1 | Clé sans fragment, suppression par note vide |
| Sessions | 5 | Aller-retour, repli sur la copie de secours, session corrompue mise à l'écart |
| Réglages et profils | 8 | Valeurs par défaut prudentes, ancien fichier migré, bases indépendantes par profil, journal expurgé |
| IA | 14 | Forme des requêtes Anthropic et compatibles OpenAI, clé jamais dans l'URL ni le corps, cloisonnement du contenu de page |
Tests d'intégration macOS du socle 1.0 par parcours (29)
Exécutés dans le processus de l'application, avec un dossier de données temporaire et des magasins WebKit créés puis
supprimés par chaque test. Les pages sont servies par loadSimulatedRequest / loadHTMLString : aucun serveur local.
| Parcours | Vérifié |
|---|---|
| Navigation | Titre, adresse, état de sécurité, enregistrement dans l'historique |
| Garde-fous | data: principal et file: depuis le web bloqués ; JavaScript désactivable par site ; fenêtres surgissantes |
| Erreurs | Hôte inexistant → page d'erreur ; plantage du contenu → état « planté », rechargement |
| Page | Recherche dans la page, extraction du lecteur, métadonnées, zoom mémorisé et borné |
| Bloqueur | Règles compilées par WebKit ; requête tierce vers un hôte listé réellement refusée |
| Téléchargements | Fichier enregistré, nom unique sans écrasement, contenu exact ; annulation sans fichier résiduel |
| Onglets et espaces | Création, épinglage, réouverture, duplication, groupes, vue scindée ; onglets propres à chaque espace |
| Suspension et sessions | Vue web libérée puis restaurée ; restauration paresseuse ; fenêtres privées exclues |
| Navigation privée | Magasin non persistant, aucun cookie partagé, aucun historique |
| Profils | Magasins WebKit, cookies et historiques distincts |
Vérifications manuelles 2.0 et ce qui n'a pas été vérifié
Vérifié à la main :
- macOS, build de développement : page de résultats native avec de vrais résultats (résumé, favicons, surlignage), mosaïque d'images, grille de vidéos confirmées, écran Compte en français.
- macOS, app notarisée installée dans
/Applications: lancement avec les données de la 1.0.0 (réglages migrés), feuille système de clé d'accès ouverte au nom de SP Browser puis annulée ; aucun compte créé sur le serveur. - iOS, simulateur : 15 captures dans
docs/screenshots/ios/.
Non vérifié en 2.0 :
- Cérémonie réelle de clé d'accès (Touch ID sur Mac, Face ID sur iPhone) : création de compte, connexion, confirmation avant action destructrice. Toute la chaîne est testée avec un authentificateur logiciel contre un vrai serveur ; seule la partie matérielle manque. Sur le simulateur iOS, le bouton de connexion n'a produit ni feuille système ni erreur visible en 12 s.
- Synchronisation entre deux appareils physiques (Mac ↔ Mac, Mac ↔ iPhone) : vérifiée entre instances du même code dans un seul processus de test, jamais entre machines.
- iOS sur appareil réel : Face ID, caméra/micro, retour haptique, téléchargements visibles dans Fichiers, comportement en arrière-plan.
- iOS, écrits mais non exercés : panneaux latéraux iPad, raccourcis clavier matériel, fenêtres multiples, glisser-déposer, tirer pour actualiser, recherche dans la page, page d'erreur, VoiceOver, Dynamic Type.
- macOS, écrits mais non exercés à la main : panneaux Liste de lecture et Autres appareils avec des données, aperçu d'image plein format, lecteur vidéo intégré, enregistrement d'image, personnalisation de la page de démarrage.
- Chemin YouTube Data API (durée et date des vidéos) : testé contre un faux serveur seulement, aucune clé fournie.
- Toujours valables depuis la 1.0 : invite caméra / micro par site, envoi réel SP Intelligence, dialogues d'authentification HTTP, impression, partage, éditeur de signets, glisser-déposer des onglets, onglets verticaux, plein écran, audit VoiceOver, macOS 14 à 26 et Mac Intel.
Performance — mesures de la 1.0.0 (non refaites pour la 2.0) : build Release, scripts/perf.sh dist/SPBrowser.app, dossier de données vide à chaque mesure, échantillon 20 s après le lancement.
| Onglets | Lancement → première fenêtre | Application | Processus WebKit | Total |
|---|---|---|---|---|
| 1 (page de démarrage, aucune vue web) | 439 ms | 110 Mo | 0 Mo | 110 Mo |
| 10 (9 articles Wikipédia) | 447 ms | 135 Mo | 1 022 Mo (11 processus) | 1 157 Mo |
| 30 (29 articles Wikipédia) | 816 ms | 163 Mo | 2 939 Mo (31 processus) | 3 102 Mo |
Environ 100 Mo par page chargée (coût normal d'un processus de contenu WebKit) ; l'application elle-même croît d'environ 2 Mo par onglet. Limites du protocole : une seule série, mémoire mesurée en RSS, tous les onglets chargés d'emblée (cas défavorable). Aucune comparaison avec Safari n'a été faite.
📦 Publication
Détail : docs/RELEASE.md.
scripts/provision.py # identifiant d'app, capacité Associated Domains, profil Developer ID (idempotent ; à relancer si une capacité change)
scripts/build-release.sh # archive Release signée avec le profil → dist/SPBrowser.app
scripts/notarize.sh # notarisation + agrafage de l'app, puis de l'image disque
scripts/verify-release.sh # doit finir par « RELEASE VERIFIED: signed, notarized, stapled » (code 3 = signé mais non notarisé)
scripts/ios-release.sh all # archive iOS + IPA (augmenter CURRENT_PROJECT_VERSION avant chaque envoi)
scripts/ios-release.sh upload # TestFlightmacOS — état au 2026-11-18, version 2.0.0 (2)
| Élément | État |
|---|---|
dist/SPBrowser.app 2.0.0 (2), universel arm64 + x86_64 |
Signé Developer ID Application avec le profil « SP Browser Developer ID » (droit com.apple.developer.associated-domains = webcredentials:browser.spboucher.ai), Hardened Runtime, App Sandbox, horodatage sécurisé |
| Notarisation de l'application | Acceptée par Apple, ticket agrafé |
dist/SPBrowser.dmg (4,8 Mo) |
Signé, notarisation acceptée, ticket agrafé |
| Gatekeeper | spctl --assess : « Notarized Developer ID » pour l'application et l'image disque |
| SHA-256 du DMG | 2b6ae7fc9247191e2308cd765c9077e09bda020edbe2a4439ccdec33da227d3f |
| Installation | Installée depuis l'image disque dans /Applications/SP Browser.app sur le poste de développement (la 1.0.0 est archivée dans dist/previous/). Lancement vérifié avec les données existantes de la 1.0.0 |
| Clés d'accès | Depuis l'app installée, « Se connecter avec une clé d'accès » ouvre la feuille système au nom de SP Browser (défi fourni par le serveur de production, association de domaine reconnue). La cérémonie complète avec Touch ID n'a pas été exécutée : elle demande le propriétaire |
| Publication sur spbgit | Le code 2.0.0 est sur main ; le DMG 2.0.0 n'est pas déposé sur la forge et il n'y a pas de tag v2.0.0 (seul v1.0.0 existe). docs/RELEASE.md note encore le git push comme « non fait » : il date d'avant la mise en ligne du code |
iOS / iPadOS — état au 2026-11-18, version 2.0.0 (2)
| Élément | État |
|---|---|
| Identifiant | ai.spboucher.spbrowser (le même que l'app macOS), domaines associés activés |
| Fiche App Store Connect | « SP Browser », id 6836530354, SKU spbrowser-ios-001, langue principale fr-CA |
| Archive | scripts/ios-release.sh all → 2.0.0 (2), signature automatique App Store Connect, droit webcredentials:browser.spboucher.ai présent dans l'archive (vérifié par le script, avertissement sinon) |
| Envoi | scripts/ios-release.sh upload → UPLOAD SUCCEEDED |
| TestFlight | Groupe interne « Interne » (accès à tous les builds), titulaire du compte comme testeur |
Les apps iOS ne sont pas notarisées : la distribution passe par App Store Connect / TestFlight. Aucune soumission à
la revue de l'App Store n'a été faite. ios-release.sh lit la clé d'API App Store Connect déjà présente sur le
Mac (scripts/asc.py), n'affiche rien de secret, écrit ses journaux dans build/logs/ et l'IPA dans
dist/ios-export/.
Version 1.0.0 (1) — 2026-11-17
Signée Developer ID, notarisée, agrafée ; SPBrowser.dmg (3,6 Mo) publié sur spbgit avec le tag v1.0.0 :
https://git.spboucher.ai/releases/sp-browser/v1.0.0/SPBrowser.dmg. Le fichier a été déposé par SSH dans le dossier
des versions de la forge avec son fichier .sha256, faute de jeton d'API sur le poste
(spbgit release upload sp-browser v1.0.0 dist/SPBrowser.dmg fait la même chose avec un jeton).
Ce que font les scripts
- build-release.sh : régénère le projet (
xcodegen),xcodebuild archiveen Release avec signature manuelle Developer ID,--timestamp --options=runtime, sans entitlement de débogage ; copie l'application dansdist/et vérifie la signature. Refuse de continuer sans identité Developer ID (une identité Development ou Mac App Store ne convient pas à la distribution directe). - notarize.sh : compresse l'application avec
ditto,notarytool submit --wait, n'annonce « notarized » que si le statut renvoyé estAccepted, agrafe et valide ; construit ensuite le DMG à partir de l'application agrafée, le signe, le soumet, l'agrafe. En cas de refus, récupère le journal Apple dansbuild/et sort avec un code d'erreur. - verify-release.sh :
codesign --verify --deep --strict, autorité de signature, runtime, horodatage, entitlements (présence du bac à sable, absence deget-task-allowet d'exceptions),stapler validate,spctl --assess. - provision.py : réutilise l'identifiant d'app, la capacité et le certificat Developer ID existants ; aucun certificat n'est jamais créé.
Les scripts n'affichent que le nom de l'identité ; ils ne créent, ne lisent ni ne modifient aucun identifiant.
Versionnement. MARKETING_VERSION et CURRENT_PROJECT_VERSION sont dans project.yml. Incrémenter le numéro de
build à chaque soumission (macOS comme TestFlight). L'identifiant ai.spboucher.spbrowser suit la convention des
autres applications du poste ; le changer change aussi le conteneur de données de l'application.
Avant une diffusion publique : tester le DMG sur un autre Mac (idéalement macOS 14 et un Mac Intel) ; mener les vérifications manuelles listées « Non vérifié » ; décider d'un canal de mise à jour (il n'y en a aucun — pas de Sparkle ni équivalent, par cohérence avec « aucune connexion non sollicitée »). Mac App Store : non visé (il faudrait une identité et un profil de distribution distincts).
🎨 Identité visuelle
Charte complète : docs/BRAND.md. Direction artistique : informatique de précision, verre,
navigation spatiale.
| Nom | Hex | Usage |
|---|---|---|
| Graphite 900 | #0B0E14 |
Fond de fenêtre (sombre), bas du corps de l'icône |
| Graphite 800 | #151A24 |
Barre latérale et barre d'outils (sombre) |
| Graphite 700 | #1E2533 |
Surfaces surélevées, cartes, champ d'adresse (sombre) |
| Bleu électrique | #2F6BFF |
Accent principal (thème clair), liens, focus, progression |
| Bleu électrique clair | #5B8CFF |
Accent principal (thème sombre) |
| Cyan lumineux | #22D3EE |
Signal d'activité : chargement, satellite de l'icône |
| Violet | #7C5CFF |
Accent secondaire : navigation privée, extrémité des dégradés |
Dégradé signature : #7C5CFF → #2F6BFF → #22D3EE. Sources SVG, trois concepts explorés et rendus dans
Assets/Brand/ ; Assets/Brand/build-icons.sh régénère les icônes.
🩺 Pièges connus
| Piège | Détail |
|---|---|
Notarisation en HTTP 403 — A required agreement is missing or has expired |
accord à signer par le titulaire du compte développeur ; les deux premières tentatives de la 1.0.0 ont échoué pour cette raison |
verify-release.sh sort avec le code 3 |
l'application est signée mais pas encore notarisée |
Droit webcredentials: et profil de provisionnement (macOS) |
le droit de domaine associé passe par le profil « SP Browser Developer ID » : relancer scripts/provision.py si une capacité change, puis build-release.sh |
| Build Debug macOS et app installée | le build Debug porte ai.spboucher.spbrowser.debug : c'est une autre app pour le système (trousseau, domaines associés, Launch Services) ; il cohabite avec l'app installée sans perturber son association de domaine |
| Nouvel envoi TestFlight | augmenter CURRENT_PROJECT_VERSION dans project.yml avant chaque envoi (manageAppVersionAndBuildNumber est désactivé dans les options d'export) |
ios-release.sh affiche « WARNING: associated domains entitlement missing » |
l'archive n'a pas le droit webcredentials: : les clés d'accès ne fonctionneront pas |
| Simulateur iOS : le bouton de connexion ne produit ni feuille système ni erreur | constaté en 12 s sur le simulateur ; la cérémonie de clé d'accès se valide sur appareil réel |
| Tests d'intégration compte / synchro ignorés | ils ne tournent qu'avec les variables affichées par scripts/test-backend.sh up ; le test de recherche réelle demande SPB_LIVE_SEARCH=1 (consomme quelques crédits du fournisseur) |
scripts/ios-test.sh ui consomme des crédits |
le test de recherche interroge SP Search en production |
| Port du backend de test occupé | scripts/test-backend.sh down arrête ce qui écoute sur le port de test, par PID (jamais par nom) |
| Pages suivantes de SP Search différentes | le fournisseur n'a pas de décalage : les pages suivantes sont des résultats d'autres domaines |
| Vidéos YouTube sans durée ni date | il faut une clé YouTube Data API côté backend ; chemin testé contre un faux serveur seulement |
| Requête tapée envoyée à DuckDuckGo après mise à jour | non : la migration v2 → v3 remplace l'ancien défaut duckduckgo par SP Search ; un autre moteur choisi délibérément est conservé |
| Fichier HTML local sans ses ressources | bac à sable : l'accès est limité au fichier ouvert, ses ressources voisines ne sont pas lisibles |
| Onglet restauré sans favicon | les favicons sont en mémoire seulement : une initiale s'affiche jusqu'au chargement |
| Reprise d'un téléchargement impossible | seulement si le serveur fournit des données de reprise et tant que l'onglet d'origine existe |
| Pas de compteur d'éléments bloqués | WebKit applique les règles sans rien rapporter |
| Inspecteur web absent | désactivé en Release par choix (disponible dans les builds de développement) |
| XCUITest sur macOS | non tenté : inutilisable sur le poste de développement avec Xcode 27.2 / macOS 27.0 (les tests d'interface existent côté iOS) |
| Deux dossiers de données | ne partagent jamais un magasin WebKit (identifiant de profil propre à chaque dossier) |
⚠️ Limites connues
- Extensions Chrome, Firefox et Safari non prises en charge.
- Géolocalisation, notifications web et presse-papiers non réglables par site (aucune API publique).
- Pas de mise à jour automatique.
- SP Search dépend de son fournisseur : pas de suggestions en ligne ni de recherches associées, vidéos limitées à YouTube, Vimeo et Dailymotion, durée des vidéos YouTube absente sans clé YouTube Data API.
- La cérémonie réelle de clé d'accès et la synchronisation entre deux appareils physiques restent à valider par le
propriétaire (voir
docs/TEST_REPORT.md). - L'app iOS n'a ni bloqueur de contenu, ni lecteur, ni profils (ni permissions par site) ; elle n'a été exercée que sur simulateur.
- Seul le profil par défaut se synchronise ; pas de rotation de la clé de compte au retrait d'un appareil.
- Plusieurs écrans de l'interface n'ont pas encore été exercés à la main : voir la section « Non vérifié » de
docs/TEST_REPORT.md. - macOS 14 à 26 et Mac Intel : non testés (le binaire est universel).
- Le bloqueur n'agit que sur des requêtes tierces vers des domaines listés ; il ne remplace pas un bloqueur complet.
- Le découpage du domaine enregistrable est une approximation, pas la Public Suffix List complète.
📚 Documentation
| Document | Contenu |
|---|---|
docs/SP_BROWSER_2.md |
SP Search, SP Identity, SP Sync, partage macOS/iOS, tests |
docs/ARCHITECTURE.md |
Couches, cycle de vie des vues web, profils, persistance |
docs/SECURITY.md |
Garde-fous, permissions, limites de WebKit |
docs/PRIVACY.md |
Ce qui sort du Mac, ce qui y reste, navigation privée |
docs/FEATURE_MATRIX.md |
Statut réel de chaque fonctionnalité |
docs/TEST_REPORT.md |
Résultats des tests, mesures, ce qui n'a pas été vérifié |
docs/RELEASE.md |
Signature, notarisation, vérification, TestFlight |
docs/AUTOMATION.md |
Commandes, App Intents, scripts, extensions |
docs/BRAND.md |
Identité visuelle et icône |
docs/ENVIRONMENT_AUDIT.md |
Audit du poste de développement |
Dépôt sœur : sp-browser-backend (README.md, docs/SECURITY.md,
docs/OPERATIONS.md).
👤 Auteur
Simon-Pierre Boucher — conception, développement, exploitation
www.spboucher.ai · git.spboucher.ai · contact@spboucher.ai
📄 Licence
Le dépôt ne contient pas de fichier de licence. © 2026 Simon-Pierre Boucher — tous droits réservés.


















