SPB Git

Repository Public

FEATURE_MATRIX.md 20.0 KB

# Matrice de parité — note.spboucher.ai ↔ SP Notes macOS 2.0.0

Légende de la colonne « État natif » : V = implémenté et vérifié par un test automatisé ou une capture (voir TEST_REPORT.md) · I = implémenté, non vérifié automatiquement (à valider à la main) · — = non fait dans cette version (écart documenté).

Colonne « Origine » : Web = existe sur le site · Amélioré = existe sur le site, fait mieux ou autrement en natif · Nouveau = n'existe pas sur le site.

# Notes et éditeur

Fonction Origine État natif Remarques
Document ProseMirror lu et réécrit sans perte (nœuds et attributs inconnus compris) Web V Aller-retour testé sur tous les types du schéma web ; les blocs sans éditeur natif sont conservés tels quels.
Paragraphes, titres 1 à 3 Web V Le schéma du site n'accepte que les niveaux 1 à 3 : H4–H6 ne sont pas proposés (ils seraient rejetés par l'éditeur web).
Gras, italique, souligné, barré, code, surligné, lien Web V Indice / exposant : affichés et conservés, pas de commande de menu.
Listes à puces, numérotées, de tâches, imbriquées ; Tab / ⇧Tab Web V
Cases à cocher cliquables Web I Bascule testée par commande ; le clic à la souris n'est pas testé automatiquement.
Citations, encadrés (callout) Web V Le type et l'icône d'un encadré existant sont conservés ; un nouvel encadré est « note 💡 » (pas de sélecteur d'icône).
Blocs de code avec coloration syntaxique Web V Colorieur natif (une douzaine de langages) ; le sélecteur de langage se fait par ```swift.
Tableaux Web V Rendu natif dans le texte ; édition dans une grille native (double-clic). Les cellules non modifiées gardent leur mise en forme ; une cellule modifiée devient du texte simple.
Séparateurs Web V
Équations LaTeX (bloc et en ligne) Web V Composition native (SwiftMath, pas de KaTeX) avec aperçu en direct.
Images et fichiers joints Web V Voir « Pièces jointes ».
Liens entre notes (@, identifiants stables) Web I Menu « @ » alimenté par la recherche locale ; ⌘-clic ou double-clic ouvre la note.
Menu « / » des blocs Web V
Raccourcis Markdown à la frappe (#, -, 1., [], >, ```, ---) Web V
Notes de bas de page, blocs repliables (details), blocs IA, vidéos Web I Affichés et conservés ; pas de commande native pour en créer.
Annuler / rétablir Web V Historique d'annulation propre à chaque note ; chaque commande est une étape.
Copier-coller structuré, collage de texte enrichi (RTF), « Coller en Markdown » Amélioré V Type de presse-papiers privé pour garder la structure ; RTF et texte brut pour les autres apps.
Glisser-déposer de fichiers et d'images dans la note Web I
Déplacer un bloc (⌃⌘↑ / ⌃⌘↓) Amélioré V Pas de poignée de glisser-déposer par bloc (écart) : le déplacement se fait au clavier ou en glissant une sélection.
Rechercher / remplacer dans la note, orthographe, correction automatique Nouveau I Barre de recherche et vérificateur du système.
Compteur de mots Web V Même calcul que le serveur.
Bases de données, graphe, espace recherche, agents, tableau de bord Web — Restent sur le site ; les pages concernées sont synchronisées sans être altérées et affichées en lecture seule.

# Organisation

Fonction Origine État natif Remarques
Arborescence de pages (sous-notes) Web V Présentée comme des dossiers : un dossier est une page marquée properties.folder (convention partagée avec l'app iOS). Le site n'a pas de table de dossiers.
Espaces (Notes, Documents, Projets, Recherche) Web V
Tags Web V
Épingler Web V
Favoris Nouveau V properties.favorite : visible dans les apps natives ; le site ne l'affiche pas encore.
Archives, corbeille, restauration, suppression définitive Web V La suppression définitive demande une clé d'accès récente côté serveur (confirmation dans « Compte »).
Dupliquer, déplacer, renommer Web V
Tri (date, titre, manuel), sélection multiple Amélioré I
Boîte de réception (captures) Web I Liste affichée quand elle n'est pas vide ; le tri des captures (transformer en tâche, référence…) reste sur le site.
Tâches et rappels Web — Le Core partagé les synchronise ; pas d'écran natif sur Mac dans cette version.

# Recherche

Fonction Origine État natif Remarques
Recherche plein texte locale (SQLite FTS5), hors ligne, mise en évidence Amélioré V Index mis à jour à chaque enregistrement. 5 000 notes : 4–5 ms.
Filtres combinés (espace, tags, période, favoris, archives) Web I
Recherche sémantique (vecteurs) Web — Reste sur le site ; l'assistant « Toutes mes notes » s'appuie dessus côté serveur.
Ouverture rapide (⌘O) et palette de commandes (⇧⌘P) Amélioré I

# Hors ligne et synchronisation

Fonction Origine État natif Remarques
Tout faire sans réseau (créer, modifier, organiser, chercher, exporter) Nouveau V Le site ne garde hors ligne qu'un brouillon de la page ouverte.
Enregistrement local durable à chaque pause de frappe (350 ms) Amélioré V SQLite WAL, synchronous=FULL ; survie à l'arrêt brutal du processus testée.
File d'envoi persistante, reprise automatique Nouveau V
Flux de changements du serveur (/api/sync) Nouveau V Ajout au backend (migration 0002).
Fusion automatique quand deux appareils modifient des blocs différents Nouveau V Fusion à trois voies par bloc de premier niveau (deux éditions dans une même liste = conflit).
Conflit explicite, les deux versions conservées, trois issues Web V
Changement distant appliqué dans l'éditeur ouvert sans déplacer le curseur Amélioré V
Création hors ligne avec identifiants stables Nouveau V
Collaboration en temps réel (CRDT) — — Non justifiée : application mono-utilisateur ; la fusion par blocs couvre le cas « deux appareils ».

# Pièces jointes

Fonction Origine État natif Remarques
Joindre images et fichiers (panneau, glisser-déposer, collage), 200 Mo, types dangereux refusés Web V Import et envoi testés (octets identiques sur le serveur) ; glisser-déposer et collage : I.
Disponibles hors ligne ; images téléchargées d'office (≤ 25 Mo) ; « Conserver hors ligne » Nouveau I
Coup d'œil (Quick Look), « Enregistrer sous… », libérer de l'espace Nouveau I
Empreinte SHA-256 Web V

# Historique

Fonction Origine État natif Remarques
Historique local (hors ligne), restauration Nouveau V 100 versions par note au plus.
Versions du serveur : lecture et restauration Web I En ligne seulement.

# Assistant IA

Fonction Origine État natif Remarques
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) Web V Flux testé sur « Résumer » ; les autres actions utilisent le même chemin : I.
Proposition affichée avant application ; jamais d'écriture silencieuse Web V
Questions sur la note, sur toutes les notes (avec citations), générales Web I Les citations sont rendues en texte ; pas de lien cliquable vers le passage.
Choix du modèle, comparateur, agents Web — Le routage reste celui du serveur. Aucune clé de fournisseur dans l'application.
Modèles locaux — — Le serveur MacLustr de modèles locaux a été démantelé ; rien à brancher.

# Compte et sécurité

Fonction Origine État natif Remarques
Connexion par clé d'accès (AuthenticationServices, domaine associé) Web I Cérémonies testées au niveau du client d'API contre le serveur de test ; la feuille Touch ID de l'app signée demande le propriétaire.
Session dans le trousseau, fin de session sans perte de données Amélioré I
Liste des clés d'accès et des appareils, déconnexion d'un appareil, ajout d'une clé sur ce Mac Web I
Utilisation sans compte (notes sur ce Mac) Nouveau V
Verrouillage local (Touch ID / mot de passe du Mac) Nouveau I Ce n'est pas un chiffrement.
Bac à sable, runtime durci, aucune vue web Nouveau V Vérifié par Scripts/verify-release.sh.
Chiffrement de bout en bout — — Non proposé, et non prétendu.

# Intégration macOS

Fonction Origine État natif Remarques
Fenêtres multiples, une fenêtre par note, restauration, plein écran, mode sombre Nouveau I Deux fenêtres sur une même note partagent un seul modèle (V).
Barre de menus complète et raccourcis Nouveau I
Note rapide (⌃⌥⌘N global, sans autorisation d'accessibilité), icône de barre des menus Nouveau I
Service macOS « Nouvelle note avec la sélection », liens spnotes:// Nouveau I
Export Markdown, texte, HTML, RTF, PDF, ZIP ; impression ; partage Amélioré V Impression et feuille de partage : I. RTF : images remplacées par leur nom.
Import Markdown, texte, RTF Web V Import DOCX / PDF / Notion : reste sur le site.
Notifications — — Aucune notification utile identifiée dans cette version.
Mise à jour automatique — — Conception dans UPDATES.md.
VoiceOver — I Libellés posés sur les contrôles ; aucun parcours VoiceOver n'a été fait.

# SP Notes 2.0 — « SP Note Next Generation » (2026-11-19, branche next)

Les tableaux ci-dessus décrivent la 1.x et restent vrais (rien n'a été retiré). Ce qui change ou s'ajoute en 2.0 :

# Format 3.0 dans l'éditeur

Fonction Origine État natif Remarques
Aller-retour octet pour octet de chaque nœud 3.0, attributs inconnus compris Web V NextNodeTests.everyNewNodeSurvivesARoundTripByteForByte.
Identifiants des éléments de liste attribués au chargement sans marquer la note modifiée Web V Test éditeur + test hébergé sur une base 1.0.2.
Cartes : mermaid, drawing, chart, queryView, bibliography, pdf, blockRef, runCode, audio, canvasLink Web V Modèle de rendu testé, dessin dans les deux apparences (captures).
Mermaid : rendu affiché si previewHash = sha256 du code, sinon source + « rendu à mettre à jour depuis le Web » Web V Le rendu lui-même est produit par le Web ; le natif ne dessine pas Mermaid.
Graphique dessiné nativement (barres, courbes, aires, secteurs, nuage) Web V CoreGraphics dans la note, Swift Charts dans la feuille.
PDF : première page (PDFKit), feuille avec lecteur et choix de la page Web V carte · I feuille Annotations affichées en liste, — pour leur création (Web / iPad).
Note vocale : durée, extrait de transcription, lecture, saut au segment Web V carte · I lecture — enregistrement au micro et demande de transcription.
Vue dynamique : carte et configuration Web V carte · I feuille — résultat de la requête affiché nativement (calculé par le serveur ; arrive avec SPNotesFeatures).
Référence à un bloc : texte résolu dans la base locale, « Référence introuvable » sinon Web V Sélecteur note → bloc I.
Code exécutable : code et dernière sortie, édition du code Web V carte · I feuille Jamais d'exécution native (aucun moteur JS embarqué).
Dessin : aperçu ou encre spn-ink-1 dessinée nativement, lecture seule Web V — édition à la souris.
Bibliographie (nombre de références citées), citation en pastille Web V Sélecteur de référence I (références lues dans la copie locale).
Lien vers un canvas : titre résolu Web V carte — ouverture du canvas (pas d'éditeur de canvas natif).
Nœud inconnu : carte neutre « Bloc non pris en charge » ; conteneur inconnu encadré ; conservé tel quel Web V Testé avec des types inventés (hologram, futureWrap).
Insertion de chaque bloc : menu « / », menu Insérer, barre, centre de commandes (une seule liste) Web V ShellTests.testTheCommandCenterHasOneRegistryForEverything.
Tâche : pastilles d'échéance et de priorité, popover d'édition Web V commande et rendu · I popover Clic sur les pastilles ou ⌃⌘D.
Encadrés : choix du type (note, info, avertissement, danger, réussite, décision ⚖️, question ❓, hypothèse 🧪) Web V Comble l'écart 1.x « pas de sélecteur de type ».
Bloc IA : marqueur « Généré par IA », sources cliquables vers le bloc Web V rendu · I clic
Section repliable (création) et note de bas de page (création) Web V Le repli lui-même reste — (le contenu est toujours affiché).
Réponses de l'assistant : sources cliquables vers le bloc (blockId) Web I Non exercé contre un modèle réel dans cette passe.
Édition des cellules d'un tableau en gardant la mise en forme Web — Inchangé depuis 1.x : une cellule modifiée redevient du texte simple.

# Coquille et écrans

Fonction Origine État natif Remarques
Destinations typées, routes (page, bloc) avec défilement et surbrillance Nouveau V spnotes://page/<id>?block=<id> ; les liens 1.x fonctionnent.
Sélection, recherche et destination propres à chaque fenêtre Amélioré V Étaient partagées entre fenêtres en 1.x.
Restauration de la fenêtre (destination, liste, note) Amélioré I SceneStorage ; pas de test automatisé d'un vrai redémarrage.
Tâches : liste par échéance, ajout rapide, priorité, terminer, hors ligne Web V Boîte d'envoi de Core ; testé contre le faux serveur et le serveur d'intégration.
Opérations refusées par le serveur : affichées, réessayer / abandonner Nouveau V
Boîte de réception : classer, convertir en tâche, archiver, supprimer, annuler Web V Hors ligne ; les suggestions IA du Web sont —.
Rétroliens et liens sortants (relations typées) dans l'inspecteur Web V Rétroliens par mention : 600 notes les plus récentes examinées.
Recherche avancée : index local + serveur ; « par le sens » sur interrupteur explicite Web V portée · I écran
Aujourd'hui, Bases de données, Graphe, Chronologie, Santé, Canvas, Demander Web — Non affichés. Fournis par SPNotesFeatures (non intégrée).
État de synchronisation : opérations refusées, actions d'une version plus récente, canvas en conflit Nouveau V refusées · I les deux autres

# macOS

Fonction Origine État natif Remarques
Capture rapide : raccourci global réglable, cible (boîte / notes / fin d'une note) Amélioré V modèle · I raccourci et panneau
Glisser-déposer et collage intelligent dans la capture Nouveau V collage · I glisser-déposer
Sélection d'une autre application par le menu Services Web I Aucune autorisation d'accessibilité.
Centre de commandes ⌘K (⇧⌘P et ⌘O conservés) Amélioré V registre · I clavier
Notes dans Spotlight (titre, extrait, tags ; retirées à la corbeille, à la suppression, à l'effacement) Nouveau V logique · I index système Tests sur un index enregistreur ; l'index réel n'a pas été interrogé.
Notification le jour d'échéance d'une tâche Nouveau V plan · I centre de notifications
Glisser une note vers le Finder (Markdown) ; ouvrir .md / .txt / .rtf Nouveau I
Coup d'œil des pièces jointes, verrouillage Touch ID Web I Inchangés depuis 1.x, non revérifiés à la main.
Écran bloquant si la base ne s'ouvre pas ; copie d'avant migration visible dans Réglages → Données Nouveau V

# Mise à jour du 2026-11-19 (soir) — bibliothèque partagée SPNotesFeatures intégrée

Les lignes « — » et « I feuille » des trois tableaux 2.0 ci-dessus sont remplacées par celles-ci.

Fonction Origine État natif Remarques
Aujourd'hui (brief du jour) Web V rendu réel DailyBriefScreen ; capture contre le serveur d'intégration. Résumé IA seulement sur clic (payant).
Bases de données : liste, puis table / tableau / liste / galerie / calendrier / chronologie Web V liste et ouverture · I vues DatabaseScreen ; une page de type base s'ouvre nativement (plus de bandeau). Limites de la bibliothèque : pas de glisser-déposer des cartes, cellules relation / fichier / IA en lecture.
Canvas : liste, création, canvas infini ; une page canvas et une carte canvasLink l'ouvrent Web V ouverture et routage · I édition CanvasScreen ; édition hors ligne et fusion côté Core. Non piloté à la souris.
Graphe (7 vues, relations typées, constats) et graphe autour d'une note Web V rendu réel · I interactions GraphScreen.
Constellation (Labs) Web V rendu réel Projection du serveur quand il l'annonce, sinon disposition locale étiquetée.
Chronologie ; chronologie et machine à remonter le temps d'une note Web V rendu réel · I restauration TimelineScreen ; feuille par note (centre de commandes).
Santé des connaissances Web V rendu réel KnowledgeHealthScreen.
Recherche (références, DOI, BibTeX) Web V rendu réel · I ajout ResearchScreen.
Demander (portées : tout, note, sélection ; citations vers le bloc) Web V contexte · I question réelle AskScreen ; aucune question posée à un modèle dans cette passe.
Choix du modèle de l'assistant Web I ModelPickerView dans le panneau Assistant ; « Auto » par défaut.
Zoom sémantique d'une note (synopsis, plan, page) Web I SemanticZoomControl + PageOutlineView ; visible sur un serveur qui annonce zoom, pour une note synchronisée.
Centre de commandes Amélioré V Celui de la bibliothèque (CommandCenterView) sur son registre unique ; le catalogue de l'app y est enregistré ; il trouve aussi les notes (⌘O).
Sections de la barre latérale selon le serveur Nouveau V Sans compte : boîte, tâches, recherche. Serveur 2.x : + bases, recherche, demander. Serveur 3.0 : ce qu'annonce /api/meta.
Feuilles de blocs : Mermaid, graphique (données vivantes), code, vue dynamique avec son résultat, référence à un bloc, citation, bibliographie, PDF avec annotations Web V rendu · I interactions Vues de la bibliothèque ; l'app écrit le nœud (une annulation).
Dessin modifiable à la souris / au trackpad Web V enregistrement hors ligne · I tracé InkEditorView ; encre et aperçu rangés sur le Mac puis envoyés par la synchronisation, pk remis à nul.
Note vocale : enregistrement au micro, lecture, transcription sur demande (payante), résumé Web V adoption du fichier hors ligne · I micro, transcription Autorisation micro demandée au premier enregistrement.
Tâches et Boîte de réception Web V Écrans de l'app conservés (hors ligne, annulation, rappels) ; les suggestions IA de la boîte (bibliothèque) ne sont — pas reprises.
Files main
Menu

Theme