confluent/ConfluentTranslator/QUICKSTART_ADMIN.md

🚀 Quick Start - Administration

Guide ultra-rapide pour démarrer avec l'interface d'administration.

---

Étape 1 : Démarrer le serveur

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

# Windows
type data\tokens.json

# Linux/Mac
cat data/tokens.json

Recréer un token admin (si perdu)

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

# 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. 🎉