serv_benchmark/QUICKSTART_DOCKER.md

🚀 Démarrage Rapide - Docker

Guide ultra-rapide pour lancer Linux BenchTools avec le module Périphériques dans Docker.

⚡ En 3 commandes

# 1. Cloner et entrer dans le dépôt
git clone <votre-repo> && cd serv_benchmark

# 2. Lancer Docker Compose
docker-compose up -d --build

# 3. Accéder à l'interface
# Frontend : http://localhost:8087
# API Docs : http://localhost:8007/docs

C'est tout ! Le module périphériques est activé par défaut.

📍 URLs importantes

Service	URL	Description
Frontend principal	http://localhost:8087	Dashboard benchmarks
Module Périphériques	http://localhost:8087/peripherals.html	Inventaire périphériques
API Backend	http://localhost:8007	API REST
API Docs (Swagger)	http://localhost:8007/docs	Documentation interactive
Stats Périphériques	http://localhost:8007/api/peripherals/statistics/summary	Statistiques JSON

🔍 Vérifier que tout fonctionne

# Healthcheck backend
curl http://localhost:8007/api/health
# ✅ {"status":"ok"}

# Stats périphériques
curl http://localhost:8007/api/peripherals/statistics/summary
# ✅ {"total_peripherals":0,"en_pret":0,"disponible":0,...}

# Logs backend
docker-compose logs backend | tail -20
# Vous devriez voir :
# ✅ Main database initialized
# ✅ Peripherals database initialized
# ✅ Peripherals upload directories created

📂 Fichiers créés automatiquement

Après le premier démarrage, vous aurez :

serv_benchmark/
├── backend/data/
│   ├── data.db              # ✅ Créé automatiquement
│   └── peripherals.db       # ✅ Créé automatiquement
│
└── uploads/
    └── peripherals/         # ✅ Créé automatiquement
        ├── photos/
        ├── documents/
        └── locations/

🎯 Premiers pas

1. Ajouter votre premier périphérique

Via l'interface web :

1. Aller sur http://localhost:8087/peripherals.html
2. Cliquer sur "Ajouter un périphérique"
3. Remplir le formulaire
4. Enregistrer

Via l'API (curl) :

curl -X POST http://localhost:8007/api/peripherals \
  -H "Content-Type: application/json" \
  -d '{
    "nom": "Logitech MX Master 3",
    "type_principal": "USB",
    "sous_type": "Souris",
    "marque": "Logitech",
    "modele": "MX Master 3",
    "prix": 99.99,
    "etat": "Neuf",
    "rating": 5.0,
    "quantite_totale": 1,
    "quantite_disponible": 1
  }'

2. Importer un périphérique USB

Méthode automatique :

# Sur votre machine, récupérer les infos USB
lsusb -v > /tmp/usb_info.txt

# Uploader via l'API
curl -X POST http://localhost:8007/api/peripherals/import/usb \
  -F "lsusb_output=@/tmp/usb_info.txt"

Méthode via interface :

1. Exécuter lsusb -v dans un terminal
2. Copier toute la sortie
3. Sur http://localhost:8087/peripherals.html
4. Cliquer "Importer USB"
5. Coller la sortie
6. Valider

3. Créer une localisation

curl -X POST http://localhost:8007/api/locations \
  -H "Content-Type: application/json" \
  -d '{
    "nom": "Bureau",
    "type": "piece",
    "description": "Bureau principal"
  }'

🛠️ Personnalisation

Modifier les types de périphériques

Éditer config/peripheral_types.yaml et redémarrer :

nano config/peripheral_types.yaml
docker-compose restart backend

Ajuster la compression d'images

Éditer config/image_processing.yaml :

image_processing:
  compression:
    quality: 85  # 1-100 (défaut: 85)

docker-compose restart backend

Désactiver le module périphériques

Dans .env :

PERIPHERALS_MODULE_ENABLED=false

docker-compose restart backend

🐛 Problèmes courants

Le module ne se charge pas

# Vérifier les logs
docker-compose logs backend | grep -i peripheral

# Forcer la recréation de la DB
docker-compose exec backend rm /app/data/peripherals.db
docker-compose restart backend

Erreur Pillow/QRCode

# Rebuild complet
docker-compose down
docker-compose build --no-cache backend
docker-compose up -d

Permissions uploads

# Vérifier les permissions
docker-compose exec backend ls -la /app/uploads/

# Les créer manuellement si besoin
mkdir -p uploads/peripherals/{photos,documents,locations/images,locations/qrcodes}
chmod -R 755 uploads/

📊 Commandes utiles

# Voir tous les conteneurs
docker-compose ps

# Logs en temps réel
docker-compose logs -f

# Redémarrer un service
docker-compose restart backend

# Arrêter tout
docker-compose down

# Rebuild et redémarrer
docker-compose up -d --build

# Shell dans le backend
docker-compose exec backend /bin/bash

# Taille des bases de données
docker-compose exec backend du -h /app/data/*.db

# Backup rapide
docker-compose exec backend tar -czf /tmp/backup.tar.gz /app/data/
docker cp linux_benchtools_backend:/tmp/backup.tar.gz ./backup.tar.gz

📚 Documentation complète

• Module Périphériques : README_PERIPHERALS.md
• Déploiement Docker : DOCKER_DEPLOYMENT.md
• README principal : README.md
• Changelog : CHANGELOG.md

🎉 Prochaines étapes

1. ✅ Ajouter vos périphériques
2. ✅ Créer vos localisations
3. ✅ Importer vos périphériques USB
4. ✅ Uploader photos et documents
5. ✅ Générer des QR codes pour les localisations
6. ✅ Gérer les prêts de matériel

---

Besoin d'aide ? Consultez la documentation complète ou ouvrez une issue.