StillHammer
4b0f916d1c
- Nouvelle architecture modulaire avec src/api, src/core, src/utils - Séparation claire docs/ (admin, changelog, dev, security) et tests/ (unit, integration, scripts) - server.js devient un simple point d'entrée - Ajout de STRUCTURE.md documentant l'architecture - Archivage ancien-confluent/ avec générateur de lexique complet 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
192 lines
5.4 KiB
Markdown
192 lines
5.4 KiB
Markdown
# 🚀 Quick Start - Administration
|
||
|
||
Guide ultra-rapide pour démarrer avec l'interface d'administration.
|
||
|
||
---
|
||
|
||
## Étape 1 : Démarrer le serveur
|
||
|
||
```bash
|
||
cd ConfluentTranslator
|
||
npm start
|
||
```
|
||
|
||
**⚠️ IMPORTANT : Notez le token admin affiché dans les logs !**
|
||
|
||
---
|
||
|
||
## Étape 2 : Se connecter
|
||
|
||
1. Ouvrir `http://localhost:3000`
|
||
2. Coller le token admin dans le champ "API Key"
|
||
3. Cliquer "Se connecter"
|
||
|
||
---
|
||
|
||
## Étape 3 : Accéder à l'admin
|
||
|
||
1. Cliquer sur le bouton **🔐 Admin** (en haut à droite)
|
||
2. Ou aller directement sur `http://localhost:3000/admin.html`
|
||
|
||
---
|
||
|
||
## Étape 4 : Créer des tokens
|
||
|
||
### Pour un utilisateur standard
|
||
|
||
1. **Nom** : "User - Jean"
|
||
2. **Rôle** : User
|
||
3. Cliquer "Créer le token"
|
||
4. **COPIER LE TOKEN AFFICHÉ** (il ne sera plus affiché)
|
||
5. Envoyer le token à l'utilisateur
|
||
|
||
### Pour une application
|
||
|
||
1. **Nom** : "Frontend Production"
|
||
2. **Rôle** : User
|
||
3. Cliquer "Créer le token"
|
||
4. **COPIER LE TOKEN**
|
||
5. Ajouter dans les variables d'environnement de l'app
|
||
|
||
### Pour un autre admin
|
||
|
||
1. **Nom** : "Admin Backup"
|
||
2. **Rôle** : Admin
|
||
3. Cliquer "Créer le token"
|
||
4. **COPIER LE TOKEN**
|
||
5. Sauvegarder dans un gestionnaire de mots de passe
|
||
|
||
---
|
||
|
||
## Étape 5 : Gérer les tokens
|
||
|
||
### Désactiver temporairement
|
||
**Use case :** Bloquer un utilisateur temporairement
|
||
1. Trouver le token dans la liste
|
||
2. Cliquer "Désactiver"
|
||
|
||
### Supprimer définitivement
|
||
**Use case :** Révoquer l'accès définitivement
|
||
1. Trouver le token dans la liste
|
||
2. Cliquer "Supprimer" (rouge)
|
||
3. Confirmer
|
||
|
||
---
|
||
|
||
## 🔑 Où est mon token admin ?
|
||
|
||
### Logs du serveur
|
||
```
|
||
🔑 Admin token created: c32b04be-2e68-4e15-8362-xxxxx
|
||
⚠️ SAVE THIS TOKEN - It will not be shown again!
|
||
```
|
||
|
||
### Fichier tokens.json
|
||
```bash
|
||
# Windows
|
||
type data\tokens.json
|
||
|
||
# Linux/Mac
|
||
cat data/tokens.json
|
||
```
|
||
|
||
### Recréer un token admin (si perdu)
|
||
```bash
|
||
del data\tokens.json # Windows
|
||
rm data/tokens.json # Linux/Mac
|
||
npm start # Redémarrer le serveur
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 Interface admin - Vue d'ensemble
|
||
|
||
```
|
||
┌─────────────────────────────────────────────┐
|
||
│ 🔐 Administration │
|
||
│ Gestion des tokens API │
|
||
└─────────────────────────────────────────────┘
|
||
|
||
┌─────────┬─────────┬─────────┬────────────┐
|
||
│ Total │ Actifs │ Admins │ Req. (24h) │
|
||
│ 5 │ 4 │ 2 │ 1,234 │
|
||
└─────────┴─────────┴─────────┴────────────┘
|
||
|
||
┌─────────────────────────────────────────────┐
|
||
│ ➕ Créer un nouveau token │
|
||
│ │
|
||
│ Nom: [________________] │
|
||
│ Rôle: [User ▼] │
|
||
│ [Créer le token] │
|
||
└─────────────────────────────────────────────┘
|
||
|
||
┌─────────────────────────────────────────────┐
|
||
│ 📋 Tokens existants │
|
||
│ │
|
||
│ c32b04be-2e68-4e15-8362-xxxxx │
|
||
│ 🏷️ ADMIN Nom: Admin Principal │
|
||
│ 📅 Créé: 02/12/2025 │
|
||
│ [Désactiver] [Supprimer] │
|
||
│ │
|
||
│ a7f3c9d1-1234-5678-90ab-xxxxx │
|
||
│ 🏷️ USER Nom: Frontend Prod │
|
||
│ 📅 Créé: 02/12/2025 │
|
||
│ [Désactiver] [Supprimer] │
|
||
└─────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## ⚡ Commandes rapides
|
||
|
||
```bash
|
||
# Démarrer le serveur
|
||
cd ConfluentTranslator && npm start
|
||
|
||
# Extraire le token admin
|
||
cat data/tokens.json | grep -o '"[^"]*"' | head -1
|
||
|
||
# Créer un token user (API)
|
||
curl -X POST http://localhost:3000/api/admin/tokens \
|
||
-H "x-api-key: VOTRE_TOKEN_ADMIN" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"name":"User Test","role":"user"}'
|
||
|
||
# Lister tous les tokens (API)
|
||
curl -H "x-api-key: VOTRE_TOKEN_ADMIN" \
|
||
http://localhost:3000/api/admin/tokens
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ Checklist
|
||
|
||
- [ ] Serveur démarré
|
||
- [ ] Token admin noté et sauvegardé
|
||
- [ ] Connecté à l'interface
|
||
- [ ] Accès au panneau admin
|
||
- [ ] Token user de test créé
|
||
- [ ] Documentation lue (`ADMIN_GUIDE.md`)
|
||
|
||
---
|
||
|
||
## 🎯 Prochaines étapes
|
||
|
||
1. **Lire la doc complète** : `ADMIN_GUIDE.md`
|
||
2. **Créer des tokens** pour vos applications/utilisateurs
|
||
3. **Configurer les backups** de `data/tokens.json`
|
||
4. **Mettre en place HTTPS** (production)
|
||
5. **Tester la sécurité** : `testsAPI/test-all.bat`
|
||
|
||
---
|
||
|
||
## 🆘 Besoin d'aide ?
|
||
|
||
- **Guide complet** : Voir `ADMIN_GUIDE.md`
|
||
- **Tests** : Voir `testsAPI/README.md`
|
||
- **Sécurité** : Voir `README_SECURITY.md`
|
||
|
||
---
|
||
|
||
**C'est tout ! En 5 étapes, vous maîtrisez l'administration de ConfluentTranslator.** 🎉
|