SPB Git

Repository Public

14 entries at the root
History

Latest commit Settings in a real window for screenshots, Core block-id list, final test report (Features wired, Release compiles unsigned, live server runs) 9ae055f

NameLast commitUpdated
App SPNotesFeatures wired: router, gated sidebar screens (brief, databases, canvas, graph,...
Components SPNotesFeatures wired: router, gated sidebar screens (brief, databases, canvas, graph,...
docs Settings in a real window for screenshots, Core block-id list, final test report (Features...
Editor SPNotesFeatures wired: router, gated sidebar screens (brief, databases, canvas, graph,...
Features SPNotesFeatures wired: router, gated sidebar screens (brief, databases, canvas, graph,...
Resources SPNotesFeatures wired: router, gated sidebar screens (brief, databases, canvas, graph,...
Scripts Debug products outside ~/Desktop (a sandboxed test host loading a package framework from the...
SPNotes.xcodeproj SPNotesFeatures wired: router, gated sidebar screens (brief, databases, canvas, graph,...
Tests SPNotesFeatures wired: router, gated sidebar screens (brief, databases, canvas, graph,...
.gitignore Editor engine (TextKit 2): codec, styler, layout fragments, commands, completion, pasteboard;...
Package.resolved Editor engine (TextKit 2): codec, styler, layout fragments, commands, completion, pasteboard;...
Package.swift Adopt SPNotesCore 2.0 safely: typed store open with a blocking error screen, store v1→v2...
project.yml SPNotesFeatures wired: router, gated sidebar screens (brief, databases, canvas, graph,...
README.md docs: legendary README — icon, logo, live spbgit badges, author
README.md View source
Logo SP Notes



Icône SP Notes

# 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

note.spboucher.ai version plateforme licence author

Swift SwiftUI AppKit TextKit 2 SPNotesCore SwiftMath SQLite XcodeGen Passkeys WebKit

commits last commit activity language languages size branches tags clones

fichiers Swift lignes Swift moteur d'édition tests éditeur tests hébergés tests d'interface scripts documents versions

bundle signature notarisation bac à sable runtime durci cible architectures Xcode


# Sommaire


# 🎯 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é
Fenêtre principale de SP Notes : bibliothèque, liste des notes et éditeur

# 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://
Panneau de l'assistant à droite de l'éditeur
Rendu de tous les types de blocs, clair et sombre (rendu hors écran produit par les tests)
Rendu de l'éditeur, apparence claire Rendu de l'éditeur, apparence sombre

# 🏗 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
  • DocumentCodec convertit dans les deux sens, sans perte.
  • Styler dé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 (NSTextView sur TextKit 2) : toute commande passe par la primitive replace(_:with:) (une étape d'annulation).
  • applyRemote applique 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).

text
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).

bash
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
Écran d'accueil du premier lancement
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.

  1. Ouvrir SPNotes-1.0.2.dmg.
  2. Glisser SP Notes dans Applications.
  3. 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-enrollment sur 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

# 👤 Auteur

Simon-Pierre Boucher — conception, développement, exploitation

www.spboucher.ai · git.spboucher.ai · contact@spboucher.ai

# 📄 Licence

© 2026 Simon-Pierre Boucher. Logiciel privé. Tous droits réservés.

Clone sp-notes-macos

Anonymous clone and fetch. Pushing requires the owner's personal access token.

Snapshot of main

Files main
Menu

Theme