sepehr
ddb67ba9e5
- Unified localStorage key to 'theme-preference' across all components
- Fixed header.tsx using wrong localStorage key ('theme' instead of 'theme-preference')
- Added localStorage hybrid persistence for instant theme changes
- Removed router.refresh() which was causing stale data revert
- Replaced Blue theme with Sepia
- Consolidated auth() calls to prevent race conditions
- Updated UserSettingsData types to include all themes
259 lines
6.4 KiB
Markdown
259 lines
6.4 KiB
Markdown
# Guide d'Installation Rapide - Workflows N8N
|
|
|
|
## 🚀 Installation en 5 minutes
|
|
|
|
### Prérequis
|
|
|
|
- ✅ N8N installé et en cours d'exécution (http://localhost:5678)
|
|
- ✅ Keep Notes en cours d'exécution (http://localhost:3000)
|
|
- ✅ Clé API OpenAI (optionnel mais recommandé)
|
|
|
|
---
|
|
|
|
## 📥 Étape 1: Importer les Workflows
|
|
|
|
### Option A: Import individuel (recommandé pour commencer)
|
|
|
|
1. Ouvrez N8N dans votre navigateur: http://localhost:5678
|
|
2. Cliquez sur **"Import from File"** dans le menu supérieur
|
|
3. Sélectionnez un des fichiers JSON:
|
|
- `n8n-workflow-create-note.json`
|
|
- `n8n-workflow-search-summary.json`
|
|
- `n8n-workflow-notebook-management.json`
|
|
- `n8n-workflow-reminder-notifications.json`
|
|
- `n8n-workflow-label-management.json`
|
|
- `n8n-workflow-email-integration.json`
|
|
4. Le workflow apparaîtra dans l'éditeur
|
|
|
|
### Option B: Import en masse (avancé)
|
|
|
|
Utilisez le script PowerShell fourni:
|
|
|
|
```powershell
|
|
.\import-workflows.ps1
|
|
```
|
|
|
|
---
|
|
|
|
## ⚙️ Étape 2: Configurer les Variables d'Environnement
|
|
|
|
Dans N8N, allez dans **Settings** → **Variables** et ajoutez:
|
|
|
|
```bash
|
|
KEEP_NOTES_API_URL=http://localhost:3000
|
|
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/XXX
|
|
EMAIL_ADDRESS=votre_email@gmail.com
|
|
EMAIL_PASSWORD=votre_app_password
|
|
OPENAI_API_KEY=sk-proj-XXX
|
|
```
|
|
|
|
---
|
|
|
|
## 🔌 Étape 3: Configurer les Connexions
|
|
|
|
### 3.1 Connexion Keep Notes API
|
|
|
|
Les workflows utilisent déjà l'URL `http://localhost:3000/api` par défaut.
|
|
|
|
Si Keep Notes est sur une autre URL:
|
|
|
|
1. Ouvrez un workflow
|
|
2. Cherchez les noeuds "Keep Notes - Create Note", "Get All Notes", etc.
|
|
3. Modifiez l'URL dans le champ "URL"
|
|
|
|
### 3.2 Connexion Slack
|
|
|
|
Pour les notifications Slack:
|
|
|
|
1. Créez un Incoming Webhook sur Slack
|
|
2. Copiez l'URL du webhook
|
|
3. Dans le workflow "Reminder Notifications", modifiez le noeud "Send Notification"
|
|
4. Remplacez l'URL du webhook
|
|
|
|
### 3.3 Connexion Email (IMAP)
|
|
|
|
Pour le workflow "Email to Note":
|
|
|
|
1. Activez l'accès IMAP pour votre email (ex: Gmail)
|
|
2. Si 2FA activé, générez un "App Password"
|
|
3. Configurez le noeud "Email Trigger":
|
|
- Host: `imap.gmail.com` (pour Gmail)
|
|
- Email: votre adresse
|
|
- Password: votre mot de passe/app password
|
|
|
|
### 3.4 Connexion OpenAI (Optionnel)
|
|
|
|
Pour la classification et les résumés:
|
|
|
|
1. Allez dans **Credentials** → **Add Credential**
|
|
2. Sélectionnez **OpenAI API**
|
|
3. Entrez votre clé API
|
|
4. Dans chaque workflow avec noeud "AI Classifier", "AI Summarizer" ou "AI Suggest Labels":
|
|
- Sélectionnez les crédtentiels OpenAI créés
|
|
|
|
---
|
|
|
|
## ▶️ Étape 4: Activer les Workflows
|
|
|
|
Pour chaque workflow importé:
|
|
|
|
1. Cliquez sur le bouton **"Activate"** (icône play en haut à droite)
|
|
2. Le workflow deviendra actif et s'exécutera selon son déclencheur
|
|
|
|
---
|
|
|
|
## 🧪 Étape 5: Tester
|
|
|
|
### Tester "Create Note with Classification"
|
|
|
|
1. Activez le workflow
|
|
2. Utilisez le MCP Trigger ou envoyez une requête POST
|
|
3. Vérifiez qu'une note est créée dans Keep Notes
|
|
|
|
```bash
|
|
curl -X POST http://localhost:5678/webhook/keep-notes-create \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"content": "Meeting with client next week to discuss project timeline",
|
|
"color": "blue"
|
|
}'
|
|
```
|
|
|
|
### Tester "Reminder Notifications"
|
|
|
|
1. Activez le workflow
|
|
2. Créez une note avec un rappel dans les 30 prochaines minutes
|
|
3. Attendez le déclenchement automatique
|
|
4. Vérifiez les notifications Slack/Email
|
|
|
|
---
|
|
|
|
## 🎯 Workflows par ordre de priorité
|
|
|
|
### Débutant (Commencez par ceux-ci)
|
|
|
|
1. **Notebook Manager** - Plus simple, aucune dépendance externe
|
|
2. **Label Manager** - Gestion de base avec option IA
|
|
3. **Create Note with Classification** - Fonctionnalité principale
|
|
|
|
### Intermédiaire
|
|
|
|
4. **Search & Summary** - Requiert OpenAI pour les résumés
|
|
5. **Reminder Notifications** - Requiert Slack/Email configuré
|
|
|
|
### Avancé
|
|
|
|
6. **Email to Note** - Plus complexe, requiert configuration IMAP
|
|
|
|
---
|
|
|
|
## 📊 Vue d'ensemble des Dépendances
|
|
|
|
| Workflow | Keep Notes | OpenAI | Slack | Email (IMAP) |
|
|
|-----------|-------------|---------|-------|---------------|
|
|
| Create Note | ✅ | ⭐ | - | - |
|
|
| Search & Summary | ✅ | ✅ | - | - |
|
|
| Notebook Manager | ✅ | - | - | - |
|
|
| Reminder Notifications | ✅ | - | ✅ | ⭐ |
|
|
| Label Manager | ✅ | ⭐ | - | - |
|
|
| Email to Note | ✅ | ✅ | ⭐ | ✅ |
|
|
|
|
Légende:
|
|
- ✅ = Requis
|
|
- ⭐ = Optionnel (pour fonctionnalités avancées)
|
|
- - = Non requis
|
|
|
|
---
|
|
|
|
## 🔧 Personnalisation Rapide
|
|
|
|
### Modifier l'URL de l'API Keep Notes
|
|
|
|
Dans tous les fichiers JSON, recherchez:
|
|
|
|
```json
|
|
"url": "http://localhost:3000/api/..."
|
|
```
|
|
|
|
Remplacez par votre URL réelle:
|
|
|
|
```json
|
|
"url": "https://votre-domaine.com/api/..."
|
|
```
|
|
|
|
### Désactiver les notifications d'un workflow
|
|
|
|
1. Ouvrez le workflow
|
|
2. Supprimez ou désactivez les noeuds de notification
|
|
3. Sauvegardez et réactivez
|
|
|
|
---
|
|
|
|
## 📈 Monitoring
|
|
|
|
### Voir les exécutions
|
|
|
|
1. Allez dans **Executions** dans le menu latéral
|
|
2. Filtrez par workflow
|
|
3. Cliquez sur une exécution pour voir les détails
|
|
4. Les données d'entrée/sortie sont visibles pour chaque noeud
|
|
|
|
### Activer les logs détaillés
|
|
|
|
Dans **Settings** → **Executions**, cochez:
|
|
|
|
- ✅ Save data for failed executions
|
|
- ✅ Save data for successful executions
|
|
|
|
---
|
|
|
|
## 🆘 Support et Dépannage
|
|
|
|
### Erreurs courantes
|
|
|
|
**"Connection refused to localhost:3000"**
|
|
- → Vérifiez que Keep Notes est démarré
|
|
|
|
**"AI classification failed"**
|
|
- → Vérifiez votre clé OpenAI API
|
|
|
|
**"Email trigger not working"**
|
|
- → Activez l'accès IMAP ou utilisez un App Password
|
|
|
|
**"Slack notification failed"**
|
|
- → Vérifiez l'URL du webhook Slack
|
|
|
|
### Obtenir de l'aide
|
|
|
|
1. Consultez [N8N-WORKFLOWS.md](./N8N-WORKFLOWS.md) pour la documentation détaillée
|
|
2. Vérifiez les logs d'exécution dans N8N
|
|
3. Testez chaque workflow individuellement
|
|
|
|
---
|
|
|
|
## 🎉 Prochaines étapes
|
|
|
|
Une fois les workflows configurés:
|
|
|
|
1. ✅ Explorez les workflows en mode test
|
|
2. ✅ Adaptez les prompts IA selon vos besoins
|
|
3. ✅ Créez des workflows personnalisés basés sur les exemples
|
|
4. ✅ Intégrez avec d'autres services (Notion, Google Drive, etc.)
|
|
|
|
---
|
|
|
|
## 📚 Ressources utiles
|
|
|
|
- [Documentation N8N](https://docs.n8n.io)
|
|
- [Guide MCP Protocol](https://modelcontextprotocol.io)
|
|
- [Documentation Keep Notes](./README.md)
|
|
- [Documentation complète des workflows](./N8N-WORKFLOWS.md)
|
|
|
|
---
|
|
|
|
**Temps estimé:** 5-10 minutes par workflow
|
|
|
|
**Difficulté:** Variable de ⭐ à ⭐⭐⭐
|
|
|
|
**Support:** [Issues GitHub](https://github.com/votre-repo/issues)
|