96e7902f01
Publication IA: - 4 templates (magazine, brief, essay, simple) avec CSS riche - Rewrite IA (article/exercises/tutorial/reference/mixed) - Modération avec timeout 12s + fallback safe - Quotas publish_enhance par tier (basic=2, pro=15, business=100) - Détection contenu stale (hash) - Migration DB publishedContent/publishedTemplate/publishedSourceHash Fixes: - cheerio v1.2: Element -> AnyNode (domhandler), decodeEntities cast - _isShared ajouté au type Note (champ virtuel serveur) - callout colors PDF export: extraction fonction pure testable - admin/published: guard note.userId null - Cmd+S fonctionne en mode dialog (pas seulement fullPage) i18n: - 23 clés publish* traduites dans les 15 locales - Extension Web Clipper: 13 locales mise à jour Tests: - callout-colors.test.ts (6 tests) - note-visible-in-view.test.ts (5 tests) - entitlements.test.ts + byok-entitlements.test.ts: mock usageLog + unstubAllEnvs - 199/199 tests passent Tracker: user-stories.md sync avec sprint-status.yaml
16 KiB
Guide utilisateur Memento
Documentation produit illustrée du SaaS Memento — second cerveau augmenté par l’IA (notes, recherche sémantique, agents, brainstorm collaboratif, BYOK).
Sources internes : ce guide synthétise le PRD, les fonctionnalités IA, la doc brainstorm et le GUIDE technique (installation / admin).
Sommaire
- Vue d’ensemble
- Premiers pas
- Page d’accueil (marketing)
- Espace de travail
- Intelligence artificielle
- Agents autonomes
- Brainstorm radial
- Paramètres et facturation
- Administration
- Captures d’écran
- Aller plus loin
1. Vue d’ensemble
Memento est une application de prise de notes qui combine :
- Organisation : carnets, labels, grille masonry, archive, corbeille, partage.
- Recherche sémantique : trouver par idée, pas seulement par mot-clé (vecteurs + plein texte).
- IA intégrée : chat RAG sur vos notes, reformulation, tags et titres suggérés, Memory Echo.
- Agents : Scraper, Researcher, Monitor, générateur de slides/diagrammes, agents personnalisés.
- Brainstorm : canvas radial D3 en temps réel (vagues Variations / Analogies / Disruptions).
- BYOK : connecter vos propres clés API (OpenAI, Anthropic, Google, etc.) pour maîtriser les coûts.
- Modèle commercial : pack découverte IA, abonnements Pro / Business / Enterprise, facturation « host-pays » en session partagée.
Publics visés : créateurs, consultants, équipes R&D, organisations qui veulent une mémoire de travail partagée et sécurisée.
2. Premiers pas
Créer un compte
- Ouvrir l’URL de votre instance (ex.
https://votre-domaine.com). - Cliquer sur Get started ou Sign up.
- Renseigner email, nom et mot de passe.
Se connecter
En cas d’oubli : Forgot password? envoie un lien de réinitialisation par email (SMTP configuré côté serveur).
Après connexion
Vous arrivez sur l’accueil notes (/home) : sidebar (carnets, navigation), zone centrale (grille ou liste de notes), actions de création.
Les captures de l’application connectée (
10-app-*.png, etc.) nécessitent une session active. Voir Régénérer les captures.
3. Page d’accueil (marketing)
La landing publique présente la proposition de valeur avant inscription.
Hero — second cerveau amplifié
Message clé : Memento relie, analyse et développe vos idées avec 6 types d’agents IA et une recherche sémantique avancée. Exemple produit : Memory Echo qui signale un lien avec un projet passé.
Capacités IA
| Bloc | Ce que l’utilisateur y gagne |
|---|---|
| Semantic Search | Retrouver une note par le sens, pas seulement les mots exacts. |
| Contextual RAG Chat | Dialoguer avec tout votre corpus (notes + web + documents). |
| Augmented Writing | Reformulation, titres, tags et résumés en arrière-plan. |
Agents spécialisés
Six rôles mis en avant : Scraper, Researcher, Slide Gen, Monitor, Diagram Gen, et agents Custom (rôles et sources de données définis par vous).
Brainstorm — vagues de pensée
Brainstorming radial temps réel : génération par vagues, collaboration (curseurs, avatars), export sémantique vers des notes structurées.
Tarifs
| Offre | Positionnement |
|---|---|
| Basic | Découverte (notes limitées, crédits IA découverte). |
| Pro | Créateurs / consultants (BYOK OpenAI/Anthropic, agents, historique étendu). |
| Business | Équipes (collaborateurs, 13 fournisseurs BYOK, API). |
| Enterprise | SSO/SAML, agents illimités, audit, support dédié. |
BYOK — votre propre fournisseur IA
Si vous avez déjà des clés OpenAI, Anthropic ou Google, vous les connectez à Memento : pas de plafond de crédits imposé par la plateforme, facturation directe chez le fournisseur, changement de provider en un clic.
4. Espace de travail
Notes et carnets
- Types de notes : texte riche, checklist, Markdown, texte brut.
- Carnets : regroupement thématique ; labels contextuels (y compris suggérés par l’IA).
- Vues : grille masonry (drag-and-drop) ou onglets.
- Cycle de vie : archive, corbeille, historique des versions, partage avec permissions.
Recherche
Barre de recherche globale : mode plein texte et mode sémantique (embeddings). Idéal pour « retrouver cette idée sur l’architecture modulaire » sans se souvenir du titre exact.
Chat IA (/chat)
Conversations persistées, alimentées par vos notes (RAG), avec outils : recherche de notes, lecture, recherche web, scrape. Le système peut cibler un carnet ou la note ouverte (mode Copilot).
Lab (/lab)
Tableau blanc Excalidraw intégré pour schémas, mindmaps et croquis libres.
5. Intelligence artificielle
Détail technique : fonctionnalites-ia.md.
Trois fournisseurs configurables
| Tier | Usage |
|---|---|
| Tags | Tags, reformulation, suggestions de titre |
| Embeddings | Recherche sémantique, Memory Echo |
| Chat | Chat RAG, agents, brainstorm, vision |
Chacun peut pointer vers un modèle différent (OpenAI, Ollama local, Anthropic, DeepSeek, OpenRouter, etc.).
Dans l’éditeur de note
- Suggestions de titre (3 styles).
- Tags contextuels parmi les labels du carnet ou nouveaux.
- Reformulation : clarifier, raccourcir, style, grammaire, traduire.
- Description d’images (vision) pour notes illustrées.
Memory Echo
Détection proactive de liens entre notes (similarité vectorielle) avec explication en une phrase ; feedback pouce haut/bas pour affiner la sensibilité.
Quotas et pack découverte
Indicateur de consommation IA (sidebar). À l’épuisement : proposition d’upgrade ou d’ajout d’une clé BYOK — pas de blocage brutal sans issue.
6. Agents autonomes
Page Agents (/agents) : créer, planifier et suivre des agents.
| Type | Rôle |
|---|---|
| Scraper | URLs + flux RSS → synthèse et note avec images |
| Researcher | Requêtes web → note de recherche structurée |
| Monitor | Surveillance d’un carnet → tendances et insights |
| Custom | Rôle libre + sources optionnelles |
| Slide Generator | PowerPoint ou slides HTML Reveal.js |
| Diagram Gen | Diagrammes Excalidraw (mindmap, flowchart, etc.) |
Planification : manuel, horaire, quotidien, hebdomadaire, mensuel (fuseau IANA).
Résultats : notification in-app et par email selon configuration.
7. Brainstorm radial
Le brainstorm est un espace de pensée visuelle qui génère des idées par vagues successives à partir d'une idée graine, sur un canvas interactif. Il est accessible depuis la barre latérale (icône Wind) ou directement depuis n'importe quelle note via le bouton ⌁ dans la barre d'outils de l'éditeur.
Documentation technique : brainstorm-documentation.md.
Démarrer une session
Depuis le canvas vide :
- Saisir une idée, question ou sujet dans le champ de saisie en haut.
- Appuyer sur Entrée ou le bouton +.
- L'IA génère immédiatement une première vague de 3 idées.
Prompts suggérés : si vous manquez d'inspiration, des exemples de graines apparaissent sous le champ quand aucune session n'est active. Un clic sur l'un d'eux lance directement le brainstorm.
Depuis une note : cliquer sur le bouton ⌁ (Wind) dans la barre d'outils de l'éditeur. Le titre et le début du contenu de la note deviennent automatiquement la graine.
Les vagues de pensée
L'IA explore trois angles distincts, chacun représenté par une couleur sur le canvas :
| Vague | Couleur | Angle exploré |
|---|---|---|
| 1 — Variations | Orange | Déclinaisons directes de la graine |
| 2 — Analogies | Bleu | Parallèles avec d'autres domaines |
| 3 — Disruptions | Violet | Remises en question radicales |
Chaque vague produit 3 idées. Au total : jusqu'à 9 idées par session, organisées radialement autour du nœud graine central.
Naviguer sur le canvas
- Zoom : molette ou pinch sur mobile.
- Déplacer : cliquer-glisser sur le fond.
- Sélectionner une idée : cliquer sur un nœud — le panneau détail s'ouvre à droite (ou en bas sur mobile).
- Ajouter une idée manuellement : bouton + Ajouter une idée en bas à gauche, ou double-clic sur le canvas.
Vue mobile : sur petit écran, un toggle Canvas / Liste apparaît sous le champ de saisie. La vue liste regroupe les idées par vague en cartes scrollables, plus lisibles sur téléphone.
Panneau détail d'une idée
Un clic sur un nœud ouvre le panneau détail (slide depuis la droite sur desktop, bottom sheet sur mobile) qui affiche :
- Le numéro de vague et l'angle (Variation / Analogie / Disruption).
- Le titre et la description complète.
- Le score d'originalité (0–10) et l'auteur (IA ou humain).
- Le lien avec la graine : texte explicatif de la connexion logique.
- Les notes source qui ont inspiré l'idée (si la session est lancée depuis une note).
Actions disponibles dans le panneau :
| Action | Effet |
|---|---|
| ⭐ Étoile | Marque l'idée comme favorite (visible dans la vue liste) |
| Creuser | L'IA génère une vague supplémentaire à partir de cette idée |
| Créer une note | Convertit l'idée en note dans votre carnet (badge vert affiché) |
| Pas pertinent | Rejette l'idée (elle disparaît du canvas) |
Exporter la session
Le bouton Export dans la barre d'actions ouvre une modale en deux étapes :
- Bilan de session : l'IA génère automatiquement une synthèse de 4 à 6 phrases résumant les thèmes explorés et proposant une prochaine action concrète. Vous pouvez la regénérer si elle ne vous convient pas.
- Exporter en note : crée une note structurée dans votre carnet par défaut avec toutes les idées actives et la synthèse.
Fermer la modale sans cliquer sur "Exporter en note" n'exporte rien — vous pouvez consulter le bilan seul.
Gérer ses sessions
Historique des sessions : la colonne de droite (icône History) liste toutes vos sessions sous forme de boutons lettrés (première lettre de la graine). Cliquer sur un bouton charge la session.
Renommer une session : survoler le bouton de session actif fait apparaître une icône crayon. Cliquer dessus ouvre une boîte de dialogue pour modifier le titre (l'idée graine).
Collaboration en temps réel
Cliquer sur Inviter permet de générer un lien de partage. Deux modes :
- Éditeur : peut ajouter des idées, creuser, rejeter.
- Lecteur : peut consulter le canvas mais pas le modifier.
Pendant la session :
- Les curseurs des autres participants sont visibles en direct (couleur unique par personne).
- Les avatars s'affichent dans la barre d'actions avec un indicateur vert "En direct".
- Le flux Activité (bouton Activity) liste les actions récentes de chaque participant.
Modèle host-pays : l'hôte (créateur de la session) consomme le quota IA ou sa clé BYOK pour tous les participants — les invités n'ont pas besoin de compte payant.
Playback
Le Playback (barre en bas du canvas) permet de rejouer l'historique de la session étape par étape, comme un film. Utile pour retracer l'évolution des idées ou présenter le raisonnement à une équipe.
8. Paramètres et facturation
Accessible via l’icône paramètres (profil utilisateur).
| Section | Contenu |
|---|---|
| Profil | Identité, email, mot de passe |
| Apparence | Thème clair/sombre, langue (15 locales) |
| IA | Préférences utilisateur ; clés BYOK personnelles (chiffrées AES-256-GCM) |
| Facturation | Abonnement Stripe, usage, portail client |
| Données | Export / import JSON |
| MCP | Clés API pour le serveur MCP (Claude Desktop, N8N, etc.) |
BYOK côté utilisateur
Coller la clé du fournisseur choisi → validation en direct → badge « mode BYOK » ; le routeur LLM bascule automatiquement sans choix manuel à chaque requête.
Facturation host-pays
Dans une session brainstorm partagée, c’est l’hôte qui consomme le quota / la clé BYOK pour les invités — flux fluide pour les équipes.
9. Administration
Réservé aux comptes ADMIN (premier email ADMIN_EMAIL à l’inscription ou promotion manuelle).
| Zone | Rôle |
|---|---|
| Utilisateurs | Gestion des comptes et rôles |
| IA | Fournisseurs système (tags, embeddings, chat), fournisseur de secours optionnel (erreurs 429/5xx) |
| Tests IA | Valider tags et embeddings |
| Sécurité | Inscription publique on/off |
| SMTP | Emails transactionnels |
Guide déploiement et variables : GUIDE.md.
10. Captures d’écran
| Fichier | Description |
|---|---|
01-landing-hero.png |
Landing — accroche |
02-landing-features.png |
Capacités IA |
03-landing-agents.png |
Agents |
04-landing-brainstorm.png |
Brainstorm |
05-landing-pricing.png |
Tarifs |
06-landing-byok.png |
BYOK |
07-login.png |
Connexion |
08-register.png |
Inscription |
09-forgot-password.png |
Mot de passe oublié |
10-app-home.png |
Accueil (connecté) |
11-app-chat.png |
Chat IA |
12-app-agents.png |
Agents |
13-app-brainstorm.png |
Brainstorm app |
14-app-lab.png |
Lab Excalidraw |
15-settings-ai.png |
Paramètres IA / BYOK |
16-settings-billing.png |
Facturation |
17-settings-profile.png |
Profil (si capture auth) |
18-admin-dashboard.png |
Admin (si capture auth) |
Régénérer les captures
Depuis le dossier memento-note/ (Playwright y est installé) :
cd memento-note
npx playwright install chromium # une seule fois
# Pages publiques uniquement
node ../docs/guide-utilisateur/capture-screenshots.mjs
# + application connectée (recommandé pour 10–18)
MOMENTO_DOC_EMAIL=votre@email.com \
MOMENTO_DOC_PASSWORD='votre-mot-de-passe' \
node ../docs/guide-utilisateur/capture-screenshots.mjs
- URL : par défaut lue depuis
memento-note/.env→NEXTAUTH_URL(ex.http://192.168.1.83:3000). Surcharge :MOMENTO_DOC_BASE_URL. - En cas d’échec de connexion, les captures 01–09 sont quand même produites ; 10–18 sont ignorées.
11. Aller plus loin
| Document | Public | Sujet |
|---|---|---|
| GUIDE.md | Admin / DevOps | Installation, Docker, env, MCP |
| fonctionnalites-ia.md | Produit / Dev | Détail des capacités IA |
| prd.md | Produit | Vision, parcours, exigences |
| ux-design-specification.md | Design | Quotas, BYOK, RGPD |
| epics.md | Engineering | Stories commerciales V3 |
| brainstorm-documentation.md | Dev | Architecture brainstorm |
| gtm-pricing-strategy.md | Business | Tarification GTM |
Dernière mise à jour des captures : génération automatique sur instance locale. Pour une doc production, régénérer les PNG après connexion avec un compte de démonstration.