# 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)