SP Notes — macOS
Application de notes native pour macOS, cliente de note.spboucher.ai : éditeur TextKit 2 écrit sur mesure, tout fonctionne hors ligne, synchronisation par flux de changements avec fusion par blocs et conflits explicites. Aucune vue web, aucun moteur JavaScript.
Auteur : Simon-Pierre Boucher
Sommaire
- Aperçu
- Fonctions
- Architecture
- Pile technique
- Organisation du dépôt
- Compiler et lancer
- Configuration
- Écrans et intégration macOS
- Données locales
- Sécurité et confidentialité
- Tests
- Publication
- Installation
- Dépannage et pièges
- Limites connues
- Documentation
- Auteur
- Licence
🎯 Aperçu
Application de notes native pour macOS (Swift 6, SwiftUI, AppKit, TextKit 2), cliente de note.spboucher.ai. Aucune vue web, aucun moteur JavaScript : l'interface et l'éditeur sont écrits sur mesure.
| Système | macOS 15 ou plus récent · binaire universel (Apple Silicon et Intel) |
| Hors ligne | Tout fonctionne sans réseau ; chaque frappe est enregistrée sur le Mac, la synchronisation reprend seule |
| Synchronisation | MacLustr (note.spboucher.ai) : flux de changements, fusion par blocs, conflits explicites |
| Compte | Clé d'accès (passkey) — ou aucun compte : les notes restent sur le Mac |
| Sécurité | Bac à sable, runtime durci, jeton de session dans le trousseau, signé Developer ID et notarisé |
Famille
| Dépôt | Rôle | Plateforme |
|---|---|---|
| note-spboucher-ai | Application web, API, base de données, flux de synchronisation | Web / PWA — note.spboucher.ai |
| sp-notes-core | Paquet Swift partagé : modèle de document, base locale, client d'API, moteur de synchronisation | Swift |
| sp-notes-macos (ce dépôt) | SP Notes pour Mac | macOS 15+ |
| sp-notes-ios | SP Notes pour iPhone et iPad | iOS / iPadOS |
✨ Fonctions
Détail fonction par fonction, avec l'état vérifié / implémenté / non fait : docs/FEATURE_MATRIX.md.
| Domaine | Ce que fait l'application |
|---|---|
| Éditeur | Document ProseMirror lu et réécrit sans perte (nœuds et attributs inconnus compris) ; paragraphes, titres 1 à 3 ; gras, italique, souligné, barré, code, surligné, lien ; listes à puces, numérotées, de tâches, imbriquées ; citations, encadrés ; blocs de code avec coloration syntaxique native (une douzaine de langages) ; tableaux ; séparateurs ; équations LaTeX en bloc et en ligne (SwiftMath, pas de KaTeX) ; images et fichiers joints |
| Frappe | Raccourcis Markdown (#, -, 1., [], >, ```, ---) ; menu « / » des blocs ; menu « @ » des liens entre notes ; Entrée, Tab, Retour arrière structurés ; déplacement de bloc ⌃⌘↑ / ⌃⌘↓ ; annuler / rétablir avec un historique propre à chaque note |
| Presse-papiers | Copier-coller structuré (type privé), collage de texte enrichi (RTF), « Coller en Markdown » |
| Organisation | Arborescence présentée comme des dossiers, espaces (Notes, Documents, Projets, Recherche), tags, épingles, favoris, archives, corbeille, restauration, suppression définitive, dupliquer, déplacer, renommer, tri |
| Recherche | Plein texte locale (SQLite FTS5), hors ligne, avec mise en évidence ; filtres combinés ; ouverture rapide (⌘O) et palette de commandes (⇧⌘P) |
| Hors ligne | Tout faire sans réseau (créer, modifier, organiser, chercher, exporter) ; enregistrement local durable 350 ms après la dernière frappe ; file d'envoi persistante, reprise automatique |
| Synchronisation | Flux de changements du serveur (/api/sync) ; fusion automatique quand deux appareils modifient des blocs différents ; conflit explicite, les deux versions conservées, trois issues ; changement distant appliqué dans l'éditeur ouvert sans déplacer le curseur |
| Pièces jointes | Panneau, glisser-déposer, collage ; 200 Mo au plus, types dangereux refusés ; images téléchargées d'office (≤ 25 Mo) ; « Conserver hors ligne » ; Coup d'œil ; empreinte SHA-256 |
| Historique | Historique local (100 versions par note au plus) et restauration ; versions du serveur en ligne |
| Assistant IA | Actions sur la sélection ou la note : résumer, reformuler, corriger, raccourcir, développer, simplifier, expliquer, plan, points d'action, liste, tâches, tableau, continuer, traduire, consigne libre ; questions sur la note, sur toutes les notes, générales ; proposition affichée avant application, jamais d'écriture silencieuse |
| Compte | Connexion par clé d'accès, utilisation sans compte, liste des clés et des appareils, verrouillage local (Touch ID / mot de passe du Mac) |
| Export / import | Export Markdown, texte, HTML, RTF, PDF, ZIP ; impression ; partage ; import Markdown, texte, RTF |
| macOS | Fenêtres multiples, une fenêtre par note, mode sombre, barre de menus complète, note rapide (⌃⌥⌘N global), icône de barre des menus, service « Nouvelle note SP Notes avec la sélection », liens spnotes:// |
Rendu de tous les types de blocs, clair et sombre (rendu hors écran produit par les tests)
🏗 Architecture
flowchart TB
subgraph APP["SP Notes.app (SwiftUI + AppKit)"]
F["Features/<br/>vues SwiftUI"]
E["App/<br/>AppEnvironment · WindowModel · SyncMonitor"]
S["NoteSession<br/>une par note ouverte"]
C["EditorController"]
T["NoteTextView<br/>TextKit 2"]
F --> S
E --> S
S --> C --> T
end
subgraph ED["SPNotesEditor (ce dépôt, dossier Editor/)"]
K["DocumentCodec · Styler · BlockLayoutFragment"]
end
subgraph CORE["SPNotesCore (../SPNotesCore, partagé avec iOS)"]
D["SPNotesDocument"]
ST["SPNotesStore"]
A["SPNotesAPI"]
SY["SPNotesSync"]
end
T --> K
K --> D
S --> ST
E --> SY
SY --> ST
SY --> A
ST --> DB[("SQLite · WAL · FTS5")]
A -- HTTPS --> SRV["https://note.spboucher.ai"]
K --> TS["NSTextStorage"]
Éditeur natif (Editor/, paquet SPNotesEditor)
Le serveur stocke une note en JSON ProseMirror. Le module partagé SPNotesDocument l'aplatit en lignes : un
bloc de texte ou un bloc atomique, avec la chaîne de ses conteneurs (liste, élément, citation, encadré…). L'éditeur
travaille sur un NSTextStorage qui porte cette structure :
| Dans le stockage texte | Signification |
|---|---|
attribut sp.para (ParaStyle, même objet sur tout le paragraphe) |
la ligne sans son contenu : type, attributs, conteneurs. Les lignes d'un bloc de code partagent un même objet. |
attribut sp.marks (MarkSet) |
les marques brutes du passage (y compris celles que l'app ne connaît pas) |
caractère de pièce jointe + AtomAttachment |
un nœud édité d'un bloc : tableau, image, équation, fichier, mention, nœud inconnu |
\n final de chaque paragraphe, y compris le dernier |
porte les attributs du paragraphe : un paragraphe vide a un style et dessine sa puce |
DocumentCodecconvertit dans les deux sens, sans perte.Stylerdérive polices, couleurs, retraits et décorations pour les seuls paragraphes touchés. Jamais de reconstruction du document à la frappe : 3 ms par touche dans un document de 4 000 blocs.BlockLayoutFragment(NSTextLayoutFragment) dessine puces, numéros, cases à cocher, barres de citation, panneaux de code et d'encadré. Ces décorations ne sont pas des caractères : elles ne polluent ni la sélection ni le presse-papiers.NoteTextView(NSTextViewsur TextKit 2) : toute commande passe par la primitivereplace(_:with:)(une étape d'annulation).applyRemoteapplique un document venu d'ailleurs en ne remplaçant que les lignes qui diffèrent : le curseur ne bouge pas quand le changement est ailleurs.- Identifiants de blocs générés à la création (même alphabet que le site), donc stables d'un enregistrement à l'autre.
Un cycle de synchronisation
sequenceDiagram
autonumber
participant N as NoteSession
participant B as Base locale (SPNotesStore)
participant M as SyncMonitor / SyncEngine
participant S as note.spboucher.ai
N->>B: enregistrement 350 ms après la dernière frappe
N->>M: cycle demandé (2 s après une modification locale)
M->>S: créations (parents d'abord, identifiant choisi par le client)
M->>S: envoi des fichiers joints
M->>S: métadonnées, tags, puis contenu avec baseVersion
alt 409 — modifié ailleurs
M->>B: fusion à trois voies par bloc, sinon conflit enregistré (copie locale intacte)
end
M->>S: file d'actions (corbeille, restauration, suppression définitive)
M->>S: GET /api/sync?since=curseur, jusqu'à épuisement
M->>B: application atomique, jamais par-dessus un contenu local modifié
M->>S: téléchargement des images
L'application déclenche un cycle au lancement, 2 s après une modification locale, au retour du réseau, au retour au premier plan et toutes les 75 s quand elle est active.
Conflits
| Situation | Résultat |
|---|---|
| Le serveur a la même chose que ce Mac | adopté, rien à faire |
| Deux appareils ont modifié des blocs différents | fusion à trois voies (base / local / serveur), renvoyée au serveur |
| Même bloc modifié des deux côtés, ou modification contre suppression | conflit enregistré : la copie locale reste intacte, la copie du serveur est gardée à côté ; bandeau dans la note, comparaison côte à côte, trois issues (la mienne / celle du serveur / les deux). Le serveur conserve les deux dans son historique quel que soit le choix. |
| Frappe non encore enregistrée au moment où un changement distant arrive | même fusion dans NoteSession ; si elle est impossible, la copie distante est versée dans l'historique local avant d'être remplacée, et un bandeau le dit |
| Suppression définitive ailleurs d'une note ouverte ici | la note passe en lecture seule avec « Enregistrer comme nouvelle note » |
Il n'y a nulle part de « dernier qui écrit gagne » silencieux. Détail : docs/ARCHITECTURE.md.
🧱 Pile technique
| Couche | Technologie | Version | Rôle |
|---|---|---|---|
| Langage | Swift, concurrence stricte complète | 6.0 (SWIFT_VERSION) |
isolation MainActor par défaut dans l'application |
| Interface | SwiftUI + AppKit | — | vues, fenêtres, menus |
| Éditeur | TextKit 2 (NSTextView, NSTextLayoutFragment) |
— | paquet SwiftPM SPNotesEditor, AppKit pur, testable sans interface |
| Core partagé | SPNotesCore (paquet local ../SPNotesCore) |
commit b06b1ed |
modèle de document, base locale SQLite/FTS5, client d'API, moteur de synchronisation |
| Mathématiques | SwiftMath | 1.7.3 (exacte) | composition LaTeX |
| Stockage | SQLite du système | — | WAL, synchronous=FULL, FTS5 |
| Connexion | AuthenticationServices | — | clés d'accès du domaine note.spboucher.ai |
| Verrouillage | LocalAuthentication | — | Touch ID ou mot de passe du Mac |
| Raccourci global | RegisterEventHotKey (Carbon) |
— | sans autorisation d'accessibilité |
| Projet | XcodeGen (project.yml) |
— | génère SPNotes.xcodeproj |
| Cible | macOS | 15.0 minimum | binaire universel (arm64, x86_64) |
🗂 Organisation du dépôt
105 fichiers suivis, dont 44 fichiers Swift (6 577 lignes).
sp-notes-macos/
├── App/ # 8 fichiers · point d'entrée, environnement, fenêtre principale, menus, synchronisation, verrouillage
├── Editor/ # 12 fichiers · moteur d'édition natif (paquet SwiftPM « SPNotesEditor », AppKit pur)
│ ├── DocumentCodec.swift EditorAttributes.swift Styler.swift SyntaxHighlighter.swift
│ ├── BlockLayoutFragment.swift NoteFragment.swift AtomAttachment.swift MathRenderer.swift
│ └── NoteTextView.swift EditorCommands.swift Completion.swift ExportComposer.swift
├── Components/ # 2 fichiers · pont SwiftUI de l'éditeur, système visuel
├── Features/ # 16 fichiers · Home (bibliothèque), Notes, Attachments, AI, History, Search, Settings, Account
├── Resources/ # Info.plist, entitlements (Release et Debug), Assets.xcassets
├── Tests/
│ ├── EditorTests/ # SwiftPM, Swift Testing — 31 tests
│ ├── AppTests/ # hébergés dans l'app, XCTest — 13 tests
│ └── UITests/ # XCUITest — 2 tests
├── Scripts/ # build, tests, signature, notarisation, profil de provisionnement, icônes, captures
├── docs/ # audit du site, matrice de parité, architecture, sécurité, installation, mises à jour, tests, notes de version
│ ├── img/ # captures réelles de l'application
│ └── brand/ # logo et icône du README
├── Package.swift # manifeste de SPNotesEditor
├── project.yml # définition XcodeGen : app, tests hébergés, tests d'interface
└── SPNotes.xcodeproj🚀 Compiler et lancer
Prérequis : cloner sp-notes-core à côté de ce dépôt sous le nom
SPNotesCore (le projet et le paquet référencent ../SPNotesCore), XcodeGen, et rsvg-convert pour régénérer les
icônes (brew install librsvg).
Scripts/build.sh debug # génère le projet Xcode (XcodeGen) et compile en Debug
SPN_ONLY=Document swift test --scratch-path build/spm # tests du moteur d'édition (sans interface)
Scripts/integration-test.sh # tests hébergés dans l'app (base locale réelle)
Scripts/integration-test.sh --server # + synchronisation contre le backend de DÉVELOPPEMENT (tunnel SSH)
Scripts/run-dev.sh [--local] [--shot f.png] # lance le build Debug en arrière-plan, sans prendre le clavier
Scripts/build.sh ui-test # XCUITest (envoie de vraies frappes : Mac inoccupé)
python3 Scripts/provision.py # App ID + Associated Domains + profil Developer ID (idempotent)
Scripts/release.sh # archive Release signée → dist/SP Notes.app
Scripts/verify-release.sh # signature, runtime durci, bac à sable, aucune vue web, aucun secret
Scripts/notarize.sh # notarisation Apple, agrafage, DMG signé et notariséTous les scripts
| Script | Rôle |
|---|---|
Scripts/build.sh generate|debug|core-test|app-test|ui-test|run |
point d'entrée de développement |
Scripts/integration-test.sh [--server] |
tests hébergés ; avec --server, tests de synchronisation de bout en bout contre le backend de développement |
Scripts/dev-session.sh |
ouvre un tunnel SSH vers le backend de développement et obtient une session pour sa base jetable (eval "$(Scripts/dev-session.sh)") |
Scripts/run-dev.sh |
lance le build Debug avec une session de développement, en arrière-plan ; capture optionnelle |
Scripts/shot.sh · Scripts/window-shot.swift |
capture la fenêtre du build Debug en PNG |
Scripts/make-icon.sh |
rend les sources vectorielles de l'icône dans le catalogue d'assets (clair et sombre, toutes les tailles macOS) |
Scripts/check-headers.sh |
échoue si un fichier source n'a pas l'en-tête d'auteur |
Scripts/provision.py · Scripts/asc.py |
identifiant d'application, capacité Associated Domains et profil Developer ID par l'API App Store Connect (idempotent ; aucun certificat créé) |
Scripts/release.sh |
archive Release signée avec l'identité Developer ID existante |
Scripts/verify-release.sh |
contrôle l'application signée (code de sortie ≠ 0 si un contrôle échoue) |
Scripts/notarize.sh |
notarise et agrafe l'application, puis construit, signe, notarise et agrafe le DMG |
⚙️ Configuration
Aucun secret dans le dépôt. Les scripts de publication utilisent l'identité Developer ID, la clé d'API App Store Connect
et le profil notarytool déjà présents sur le Mac ; ils n'en créent, n'en affichent et n'en modifient aucun.
| Nom | Où | Rôle |
|---|---|---|
SPNOTES_SERVER, SPNOTES_SESSION_TOKEN |
builds Debug uniquement | serveur et session de développement, exportés par Scripts/dev-session.sh ; acceptés seulement pour un serveur en boucle locale |
SPNOTES_IT_SERVER, SPNOTES_IT_TOKEN |
tests hébergés | serveur de développement des tests de synchronisation |
NOTARY_PROFILE |
Scripts/notarize.sh |
profil du trousseau créé au préalable avec xcrun notarytool store-credentials |
SPN_ONLY |
swift test |
hérité de SPNotesCore : ne compiler qu'un module du Core |
Réglage de project.yml |
Valeur |
|---|---|
MARKETING_VERSION · CURRENT_PROJECT_VERSION |
1.0.2 · 3 |
PRODUCT_BUNDLE_IDENTIFIER |
ai.spboucher.spnotes (Release) · ai.spboucher.spnotes.debug (Debug) |
deploymentTarget |
macOS 15.0 |
SWIFT_STRICT_CONCURRENCY |
complete |
ENABLE_HARDENED_RUNTIME |
YES |
| Signature Release | manuelle, Developer ID Application, profil « SP Notes Developer ID », --timestamp |
| Signature Debug | locale (-), sans profil : aucun droit restreint (pas d'Associated Domains) |
Droits de la version publiée (Resources/SPNotes.entitlements) : bac à sable, réseau
sortant, fichiers choisis par l'utilisateur (lecture / écriture), impression, webcredentials:note.spboucher.ai, groupe
de trousseau de l'application.
🖥 Écrans et intégration macOS
| Écran | Source |
|---|---|
| Écran d'accueil du premier lancement (« Se connecter avec ma clé d'accès » / « Continuer sans compte ») | Features/Account/WelcomeView.swift |
| Barre latérale : bibliothèque, espaces, dossiers, archives, corbeille, état de synchronisation | Features/Home/SidebarView.swift |
| Liste des notes | Features/Notes/NoteListView.swift |
| Note : éditeur, barre d'outils, bandeaux | Features/Notes/NoteDetailView.swift |
| Inspecteur | Features/Notes/InspectorPanel.swift |
| Éditeurs de blocs atomiques | Features/Notes/AtomEditors.swift |
| Assistant | Features/AI/AssistantPanel.swift |
| Historique et conflits | Features/History/HistoryAndConflicts.swift |
| Palette de commandes et ouverture rapide | Features/Search/CommandPalette.swift |
| Compte | Features/Account/AccountSheet.swift |
| Réglages (⌘,) : apparence, police et taille du texte, orthographe, note rapide, verrouillage local, stockage | Features/Settings/SettingsView.swift |
| Intégration | Détail |
|---|---|
| Schéma d'URL | spnotes:// |
| Service macOS | « Nouvelle note SP Notes avec la sélection » |
| Note rapide | ⌃⌥⌘N global, icône de barre des menus |
| Catégorie | public.app-category.productivity |
| Langue de développement | français |
🗃 Données locales
~/Library/Containers/ai.spboucher.spnotes/Data/Library/Application Support/SPNotes/ :
| Élément | Contenu |
|---|---|
notes-note.spboucher.ai.sqlite |
notes, index plein texte, file d'envoi, historique local — un fichier SQLite par serveur, mode WAL, synchronous=FULL : une écriture confirmée survit à une coupure de courant |
files-note.spboucher.ai/ |
pièces jointes (<id>.<ext>), référencées par chemin relatif |
| Trousseau | jeton de session |
NoteSession enregistre 350 ms après la dernière frappe, à la perte de focus de l'application, à la fermeture, et avant
de quitter (applicationShouldTerminate attend l'écriture et un point de contrôle). Un instantané d'historique local
est pris avant une salve de modifications (au plus toutes les dix minutes) et à chaque ⌘S.
Pour tout récupérer hors de l'application : Fichier → Exporter toute la bibliothèque (ZIP de fichiers Markdown et des
pièces jointes). Le schéma de la base est celui de sp-notes-core.
🔒 Sécurité et confidentialité
| Sujet | Ce qui est fait |
|---|---|
| Bac à sable | App Sandbox actif. Droits : réseau sortant, fichiers choisis par l'utilisateur (lecture / écriture), impression. Pas de serveur, pas de caméra, pas de micro, pas d'accès large au disque. |
| Runtime durci | Actif, sans aucune exception (pas de JIT, pas de mémoire exécutable non signée, validation des bibliothèques). |
| Signature | Developer ID Application, horodatage sécurisé, profil Developer ID embarqué, notarisation Apple, ticket agrafé. |
| Code web | Aucun : ni WebKit ni JavaScriptCore ne sont liés ; aucune ressource HTML / JS / CSS dans le paquet (Scripts/verify-release.sh). |
| Connexion | Clés d'accès du domaine note.spboucher.ai par AuthenticationServices (droit webcredentials:note.spboucher.ai, fichier apple-app-site-association du serveur). L'application ne voit jamais de donnée biométrique ni de clé privée. |
| Session | Jeton opaque du serveur, gardé dans le trousseau de macOS (jamais dans un fichier ni dans les préférences), envoyé explicitement dans l'en-tête Cookie. Pas de pot à cookies, pas de cache HTTP, pas de suivi de redirection. |
| Transport | HTTPS vers le serveur de production ; TLS validé par le système, jamais affaibli. Un autre serveur n'est accepté que dans un build de développement, et seulement en boucle locale. |
| Actions sensibles | La suppression définitive et la gestion des appareils demandent au serveur une clé d'accès vérifiée depuis moins de cinq minutes ; l'application déclenche la vérification, elle ne la contourne pas. |
| Données locales | Notes, index et fichiers dans le conteneur de l'application. Non chiffrés par l'application : leur protection est celle du compte macOS et de FileVault. |
| Verrouillage local | Optionnel : Touch ID ou mot de passe du Mac à l'ouverture ou après inactivité. C'est un écran de verrouillage, pas un chiffrement, et il est indépendant de la session du serveur. |
| Fin de session | Une session expirée ou révoquée n'efface rien : les notes restent lisibles et modifiables, l'envoi reprend après reconnexion. La déconnexion volontaire propose de garder ou d'effacer la copie locale, et avertit s'il reste des modifications non envoyées. |
| Pièces jointes | 200 Mo au plus ; programmes, scripts, pages web et images disque refusés ; noms nettoyés ; les chemins venus de la base sont réduits à leur dernier composant avant tout accès disque. |
| Liens | Seuls http, https et mailto s'ouvrent ; un lien javascript: ou file: d'un document est refusé avec un message. |
| Assistant | Rien n'est envoyé sans une action explicite ; seul le texte concerné part (la sélection, ou la note), et le panneau le dit. Aucune clé de fournisseur n'est dans l'application : les modèles sont ceux du serveur. |
| Journaux | Aucun contenu de note, aucun jeton, aucune charge WebAuthn dans les journaux. |
| Raccourci global | RegisterEventHotKey (Carbon) : aucune autorisation d'accessibilité ni de surveillance du clavier. |
Ce que l'application ne prétend pas : pas de chiffrement de bout en bout (le serveur lit les notes pour la recherche
et l'assistant) ; les fichiers ouverts avec Coup d'œil sont copiés sous leur vrai nom dans le dossier temporaire du
conteneur ; une copie de note exportée sort du contrôle de l'application. Détail : docs/SECURITY.md.
🧪 Tests
46 tests dans ce dépôt ; ce qui a été exécuté, avec les résultats, et ce qui ne l'a pas été :
docs/TEST_REPORT.md.
| Suite | Cadre | Tests | Vérifie |
|---|---|---|---|
CodecTests |
Swift Testing | 4 | aller-retour JSON ⇄ texte sans aucune différence sur tous les types du schéma web ; idem après une frappe annulée |
TypingTests |
Swift Testing | 10 | Entrée, raccourcis Markdown, sortie de liste, Tab / ⇧Tab, Retour arrière structuré, bloc de code, ⇧Entrée |
CommandTests |
Swift Testing | 8 | marques, liens, titres / listes / citation / code, case à cocher, annuler / rétablir une étape par commande, déplacement de blocs, édition de tableau |
RemoteAndPasteboardTests |
Swift Testing | 6 | changement distant sans déplacement du curseur, copier-coller structuré, document de 4 000 blocs |
CompletionTests |
Swift Testing | 2 | menu « / » : filtre, insertion, annulation |
| Rendu hors écran | Swift Testing | 1 | tous les types de blocs, clair et sombre (docs/img/editor-light.png, editor-dark.png) |
LocalTests (hébergés) |
XCTest | 7 | enregistrement automatique, arrêt brutal, organisation, historique local, exports, deux fenêtres sur une note, bibliothèque de 5 000 notes |
SyncTests (hébergés, --server) |
XCTest | 6 | scénario hors ligne de bout en bout, changement d'un autre appareil, fusion et conflit, image jointe hors ligne, corbeille dans les deux sens, assistant en flux |
SPNotesUITests |
XCUITest | 2 | écrits et compilés, non exécutés (ils envoient de vraies frappes au Mac) |
Mesures prises dans les tests (rapport du 2026-11-18, MacBook Apple Silicon, macOS 27.0, Xcode 27.2, Swift 6.4) :
| Mesure | Résultat |
|---|---|
| Document de 4 000 blocs | chargement 95 ms · 3,3 ms par frappe · sérialisation 32 ms |
| Bibliothèque de 5 000 notes | barre latérale + liste 2–3 ms · recherche FTS 4–5 ms |
Le serveur de test est l'instance de développement du backend (base jetable, par tunnel SSH). Aucune donnée de production ne sert aux tests.
Ce qui n'a PAS été vérifié automatiquement
| Sujet | Comment le valider |
|---|---|
| Connexion par clé d'accès dans l'app signée (feuille Touch ID, association de domaine côté macOS) | lancer /Applications/SP Notes.app → « Se connecter avec ma clé d'accès » |
| Redémarrage réel du Mac au milieu du scénario hors ligne, coupure réseau physique | refaire le scénario à la main avec un vrai redémarrage et le Wi-Fi coupé |
| Tests d'interface XCUITest | Scripts/build.sh ui-test, Mac inoccupé |
| Interactions à la souris : clic sur une case, double-clic sur un tableau, glisser-déposer de fichiers | à la main |
| Fenêtres : restauration au lancement, plein écran, plusieurs fenêtres à l'écran | à la main |
Note rapide, Service macOS, liens spnotes://, barre des menus, Coup d'œil, impression, feuille de partage, verrouillage Touch ID |
à la main |
| Assistant : actions autres que « Résumer », questions sur la note / sur toutes les notes | à la main |
| Historique du serveur dans l'app ; liste des clés d'accès et des appareils | à la main, connecté |
| Suppression définitive poussée au serveur | supprimer définitivement, puis « Confirmer avec ma clé d'accès » dans Compte |
| VoiceOver | à la main |
| Autre Mac, Mac Intel, macOS 15 / 26 | installer le DMG ailleurs (la tranche x86_64 du binaire universel n'a jamais été exécutée) |
📦 Publication
Chaîne reproductible : release.sh → verify-release.sh → notarize.sh.
flowchart LR
P["provision.py<br/>App ID · Associated Domains · profil Developer ID"] --> R["release.sh<br/>archive Release signée → dist/SP Notes.app"]
R --> V["verify-release.sh<br/>signature · runtime durci · bac à sable · aucune vue web · aucun secret"]
V --> N["notarize.sh<br/>notarisation · agrafage · DMG signé et notarisé"]
N --> D["dist/SPNotes-x.y.z.dmg"]
| Version | Date | Contenu |
|---|---|---|
| 1.0.2 (3) | 2026-11-18 | Écran d'accueil au premier lancement (« Se connecter avec ma clé d'accès » / « Continuer sans compte »), état de synchronisation plus clair, avertissement quand l'application n'est pas lancée depuis le dossier Applications. Core inchangé (b06b1ed). |
| 1.0.1 (2) | 2026-11-18 | Même application, reconstruite sur le Core commité (b06b1ed) dont le moteur de synchronisation a reçu vingt correctifs, plusieurs touchant à la sûreté des données : la 1.0.1 remplace la 1.0.0. |
| 1.0.0 (1) | 2026-11-18 | Première version (DMG de 9,4 Mo). |
Les trois versions sont signées Developer ID, notarisées par Apple (application et image disque : Accepted, ticket
agrafé) et étiquetées v1.0.0, v1.0.1, v1.0.2. Empreintes SHA-256 des DMG, numéros de soumission et correctifs
détaillés : docs/RELEASE_NOTES.md.
Mises à jour : aucune mise à jour automatique n'est livrée ; une nouvelle version s'installe en remplaçant
l'application par celle d'un nouveau DMG, les données (conteneur, trousseau) sont conservées. La clé
SPNotesUpdateFeedURL (vide) est réservée dans Info.plist. Conception retenue pour la suite (flux signé, Sparkle 2) :
docs/UPDATES.md.
💿 Installation
Configuration requise : macOS 15 ou plus récent, Mac Apple Silicon ou Intel.
- Ouvrir
SPNotes-1.0.2.dmg. - Glisser SP Notes dans Applications.
- Lancer SP Notes depuis
/Applications.
Vérification manuelle : spctl -a -vv "/Applications/SP Notes.app" doit répondre
accepted · source=Notarized Developer ID.
- Sans compte : rien à faire. Les notes sont enregistrées sur le Mac.
- Avec synchronisation : au premier lancement, « Se connecter avec ma clé d'accès » (ou, plus tard, l'état en bas de
la barre latérale). macOS propose la clé d'accès de
note.spboucher.ai(Touch ID, trousseau iCloud, ou un appareil proche). Les notes du serveur arrivent, celles créées sans compte sont envoyées. - Pas encore de clé d'accès sur ce Mac ? Une clé synchronisée par le trousseau iCloud fonctionne telle quelle ;
sinon, une fois connecté, « Ajouter une clé d'accès sur ce Mac ». La toute première clé d'un compte se crée depuis le
serveur (
pnpm auth:open-enrollmentsur le nœud, voir note-spboucher-ai). - Désinstaller : mettre l'application à la corbeille. Pour effacer aussi les données locales : Compte → Se déconnecter → « effacer la copie locale », ou supprimer le dossier du conteneur.
Détail : docs/INSTALL.md.
🧯 Dépannage et pièges
| Symptôme ou piège | Explication |
|---|---|
| macOS refuse la clé d'accès | Lancer l'application depuis /Applications : macOS associe l'application au domaine d'après son emplacement enregistré ; une copie lancée depuis le Bureau peut être refusée. La 1.0.2 affiche un avertissement dans ce cas. |
| Une copie de développement masque l'application installée | Le build Debug a un identifiant distinct (ai.spboucher.spnotes.debug) précisément pour cela : macOS résout l'association de domaine des clés d'accès par identifiant d'application. |
| Le build Debug ne peut pas se connecter par clé d'accès | Il est signé localement sans profil, donc sans le droit Associated Domains. Utiliser Scripts/run-dev.sh (session de développement, sans Touch ID). |
| Les tests d'interface perturbent le Mac | Scripts/build.sh ui-test envoie de vraies frappes : Mac inoccupé. |
| Le lot de tests d'interface ne se charge pas | Il est signé ad hoc : le runtime durci est désactivé pour cette cible (la validation des bibliothèques le refuserait). |
Scripts/make-icon.sh échoue |
Il lui faut rsvg-convert (brew install librsvg) et les sources vectorielles de l'icône (Resources/icon/*.svg), qui ne sont pas suivies dans ce dépôt. |
Scripts/notarize.sh échoue d'emblée |
Le profil notarytool du trousseau doit exister (NOTARY_PROFILE) ; le script ne crée aucun identifiant. « notarized » n'est affiché que si Apple a répondu Accepted. |
Scripts/release.sh échoue d'emblée |
Aucune identité Developer ID Application dans le trousseau : le script n'en crée pas. |
| Pièces jointes peu lisibles en fenêtre sombre sur un système clair | Corrigé : les pièces jointes suivent l'apparence de la vue de texte (révélé par le rendu hors écran). |
| Une session expirée | Rien n'est effacé : les notes restent lisibles et modifiables, l'envoi reprend après reconnexion. |
Le compilateur ne trouve pas SPNotesCore |
Le dépôt sp-notes-core doit être cloné à côté sous le nom SPNotesCore. |
🚧 Limites connues
Tirées de docs/RELEASE_NOTES.md, docs/FEATURE_MATRIX.md et
docs/TEST_REPORT.md.
- Pas de poignée de glisser-déposer par bloc (déplacement au clavier : ⌃⌘↑ / ⌃⌘↓).
- Titres limités aux niveaux 1 à 3 (limite du schéma du site).
- Une cellule de tableau modifiée perd sa mise en forme interne ; les autres la gardent.
- Deux modifications simultanées dans une même liste, sur deux appareils, donnent un conflit à trancher (la fusion travaille par bloc de premier niveau).
- Bases de données, graphe, espace recherche, agents, tableau de bord, recherche sémantique : sur le site uniquement ; les pages concernées sont synchronisées sans être altérées et affichées en lecture seule.
- Tâches et rappels : le Core partagé les synchronise ; pas d'écran natif sur Mac dans cette version.
- Import DOCX / PDF / Notion : reste sur le site.
- Indice / exposant, notes de bas de page, blocs repliables, blocs IA, vidéos : affichés et conservés, pas de commande native pour en créer.
- Pas de mise à jour automatique, pas de chiffrement de bout en bout, pas de notifications.
- Le site n'affiche pas encore les favoris ni la marque « dossier » posés par les apps natives (ils sont conservés).
- La feuille Touch ID de l'application signée reste à valider par le propriétaire ; aucun parcours VoiceOver n'a été fait ; aucun autre Mac n'a été essayé.
Écarts du serveur relevés pendant les tests et laissés tels quels : GET /api/tags compte mal les pages par tag ; un
identifiant mal formé rend une erreur 500 au lieu de 400 ; la suppression définitive d'une page détache ses pièces
jointes sans les supprimer.
📚 Documentation
docs/AUDIT.md— ce qui existe réellement sur le site, et les ajouts au backend.docs/FEATURE_MATRIX.md— parité fonction par fonction, avec l'état vérifié / non vérifié.docs/ARCHITECTURE.md— éditeur, persistance, synchronisation, conflits.docs/SECURITY.md·docs/INSTALL.md·docs/UPDATES.mddocs/TEST_REPORT.md— ce qui a été exécuté, avec les résultats, et ce qui ne l'a pas été.docs/RELEASE_NOTES.md— notes de version 1.0.0, 1.0.1 et 1.0.2.
👤 Auteur
Simon-Pierre Boucher — conception, développement, exploitation
📄 Licence
© 2026 Simon-Pierre Boucher. Logiciel privé. Tous droits réservés.