ObsiViewer/ROADMAP.md

🗺️ Roadmap du Projet

Vision

ObsiViewer offre une expérience de consultation en lecture seule d’une voûte Obsidian depuis le navigateur, avec rendu Markdown avancé, graphe interactif et recherche compatible Obsidian. La vision est d’être un viewer fiable, performant et portable, facilement auto‑hébergeable, couvrant 100% des usages de lecture/visualisation d’un vault de taille moyenne à grande, sans exiger Obsidian ni plugins côté client.

Statut Actuel

Version actuelle : 0.0.0 (développement) Date de mise à jour : 2025-10-02

✅ Complété

• Rendu Markdown riche via MarkdownIt + plugins (tables, footnotes, callouts, task-lists, code highlight)
• Wikilinks complets ([[note]], alias, #heading, #^block) + preview au survol
• Graphe interactif (d3-force), options d’affichage et filtres (tags, attachments, orphans)
• Assistant de requêtes et moteur de recherche compatible Obsidian (parser, evaluator, index)
• Favoris (bookmarks) compatibles Obsidian avec persistance .obsidian/bookmarks.json (serveur & FS Access)
• API Express (lecture vault, bookmarks, graph config, SSE événements vault, résolution d’attachements)
• UI responsive, dark/light theme, sidebars redimensionnables
• Tests unitaires présents (wikilinks parser, markdown service, bookmarks core, search parser)

🚧 En Cours

• Accessibilité et navigation clavier avancée (tree bookmarks, résultats recherche)
• Améliorations UX des modals (création/édition bookmarks, import/export)
• Optimisations pour très grands vaults (>5000 notes)

📅 Phases de Développement

Phase 1 : Solidification - Court Terme (0-3 mois)

Priorité : HAUTE

Fonctionnalités

• Zoom/Pan du graphe (d3-zoom)

  • Intégrer d3-zoom dans src/components/graph-view/graph-view.component.ts
  • Maintenir compatibilité drag & drop nœuds
  • Estimation : 2-3j

• Modals d’édition bookmarks

  • Créer un BookmarkEditorModal (ajout/édition groupes et fichiers)
  • Valider les champs, support du parent selector, déplacement entre groupes
  • Estimation : 2j

• Import/Export UI

  • ImportModal (dry-run + merge/replace), ExportModal (filename + download)
  • Intégrer services existants bookmarks.service.ts
  • Estimation : 2j

• Assistant de requêtes – complétion propriétés YAML

  • Suggestions basées sur index de propriétés (si dispo) dans search-assistant.service.ts
  • Estimation : 1-2j

Améliorations Techniques

• Virtualisation listes (tree bookmarks, résultats recherche)

  • Étudier cdk-virtual-scroll-viewport pour grandes listes
  • Estimation : 2j

• Optimisation graphe pour vaults larges

  • Filtrer profondeur par défaut, options de sampling
  • Estimation : 2j

• Renforcer sanitization du rendu Markdown

  • Audit des transformations HTML dans MarkdownService
  • Estimation : 1j

Corrections

• TODO édition inline dans src/components/bookmark-item/bookmark-item.component.ts (ligne commentée « TODO: Open edit modal »)

  • Remplacer le console.log par ouverture réelle du modal
  • Estimation : 0.5j

• Conflits bookmarks/graph – UX

  • Ajouter feedback visuel (toast succès/erreur) après save
  • Estimation : 0.5-1j

• Z-index du menu contextuel (bookmarks)

  • Ajuster SCSS pour superposer correctement
  • Estimation : 0.5j

Phase 2 : Parité+ - Moyen Terme (3-6 mois)

Priorité : MOYENNE

Fonctionnalités

• Export graphe (PNG/SVG)

  • Ajout bouton export + rendu offscreen
  • Estimation : 2j

• Groupes de couleurs avancés

  • UI améliorée (palette, alpha, réordonnage drag)
  • Estimation : 2j

• Recherche – scoring et tri avancés

  • Pondération configurable (titre, path, tags, contenu)
  • Estimation : 2j

Améliorations Techniques

• Cache index recherche/graph sur IndexedDB

  • Restauration rapide au chargement
  • Estimation : 2-3j

• E2E tests (Playwright/Cypress)

  • Flux: connect vault → créer/modifier favoris → save/reload → conflit
  • Estimation : 3-4j

Corrections

• Résilience API (timeouts/retries/backoff)
  • Wrapper HttpClient + messages d’erreurs clairs
  • Estimation : 1j

Phase 3 : Extensibilité - Long Terme (6-12 mois)

Priorité : BASSE

Fonctionnalités

• Mode PWA hors-ligne (avec FS Access API quand supporté)

  • Mise en cache assets, index et dernières notes
  • Estimation : 5-7j

• Connecteurs de stockage optionnels

  • WebDAV/Dropbox (via repository pattern) – lecture seule
  • Estimation : 5-10j (recherche + PoC)

• Mini-map du graphe / overview

  • Améliorer navigation sur grandes topologies
  • Estimation : 2-3j

Améliorations Techniques

• Observabilité
  • Logs structurés, métriques (Web Vitals), tracing léger
  • Estimation : 2-3j

🎯 Objectifs par Catégorie

Performance

• 60fps stables avec 2000+ nœuds
• Temps de rendu initial <300ms pour 1000 nœuds

Sécurité

• Sanitization renforcée + tests XSS ciblés
• Politique d’upload/serve d’attachements documentée

Expérience Utilisateur

• Navigation clavier complète (ARIA tree, listes résultats)
• Feedback systématique (toasts, spinners, états vides)

Documentation

• Guides de contribution et styleguide UI
• Schémas d’architecture (séquence, composants)

Tests

• Couverture 80% sur core (bookmarks, search, markdown)
• E2E de la chaîne bookmarks (connect → CRUD → save → conflit)

💡 Idées Futures (Backlog)

• Suggestions de liens connexes basées sur graphe (similarité simple)
• Intégration de l'éditeur Excalidraw pour visualiser et editer les fichier .excalidraw
• Colorisation des nœuds par tags dominants (auto)
• Timeline view par dates de création/modification
• Export PDF/HTML d’une note avec graph contextuel

🚫 Hors Scope

• Édition de contenu Markdown (éditeur complet) – le projet vise la lecture/visualisation
• Synchronisation multi-utilisateur temps réel – non prioritaire

📊 Métriques de Succès

• Métrique 1 : TTI < 2s sur vault 1000 notes (desktop, réseau moyen)
• Métrique 2 : 60fps moyenne pendant interactions graphe (>95% frames)
• Métrique 3 : Couverture tests unitaires ≥ 80% sur modules core
• Métrique 4 : 0 erreurs critiques Lighthouse (Perf > 85, Access > 90)

🤝 Contributions

Les contributions sont bienvenues. Ouvrez une issue avant une PR pour discuter du scope. Respectez les conventions (commits, lint, style), fournissez des captures pour changements UI.

📝 Notes

• Firefox/Safari n’offrent pas FS Access API : privilégier le mode serveur (server/index.mjs).
• Les endpoints serveur sont décrits dans README.md (section API).
• Les TODO/FIXME identifiés : bookmark-item (édition modal), styles (z-index), zoom/pan graphe.