Files

gilles soulier c6a8e8e83d feat: Complete MVP implementation of Linux BenchTools

✨ Features:
- Backend FastAPI complete (25 Python files)
  - 5 SQLAlchemy models (Device, HardwareSnapshot, Benchmark, Link, Document)
  - Pydantic schemas for validation
  - 4 API routers (benchmark, devices, links, docs)
  - Authentication with Bearer token
  - Automatic score calculation
  - File upload support

- Frontend web interface (13 files)
  - 4 HTML pages (Dashboard, Devices, Device Detail, Settings)
  - 7 JavaScript modules
  - Monokai dark theme CSS
  - Responsive design
  - Complete CRUD operations

- Client benchmark script (500+ lines Bash)
  - Hardware auto-detection
  - CPU, RAM, Disk, Network benchmarks
  - JSON payload generation
  - Robust error handling

- Docker deployment
  - Optimized Dockerfile
  - docker-compose with 2 services
  - Persistent volumes
  - Environment variables

- Documentation & Installation
  - Automated install.sh script
  - README, QUICKSTART, DEPLOYMENT guides
  - Complete API documentation
  - Project structure documentation

📊 Stats:
- ~60 files created
- ~5000 lines of code
- Full MVP feature set implemented

🚀 Ready for production deployment!

🤖 Generated with Claude Code
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2025-12-07 14:46:10 +01:00

4.6 KiB

Raw Blame History

Linux BenchTools

Application self-hosted de benchmarking et d'inventaire matériel pour machines Linux.

🎯 Objectifs

Linux BenchTools permet de :

📊 Recenser vos machines (physiques, VM, SBC type Raspberry Pi)
🔍 Collecter automatiquement les informations matérielles (CPU, RAM, GPU, stockage, réseau)
⚡ Exécuter des benchmarks standardisés (CPU, mémoire, disque, réseau, GPU)
📈 Calculer des scores comparables entre machines
🏆 Afficher un classement dans un dashboard web
📝 Gérer la documentation (notices PDF, factures, liens constructeurs)

🚀 Installation rapide

# Cloner le dépôt
git clone https://gitea.maison43.duckdns.org/gilles/linux-benchtools.git
cd linux-benchtools

# Lancer l'installation automatique
./install.sh

# Ou avec Docker directement
docker compose up -d

L'application sera accessible sur :

Backend API : http://localhost:8007
Frontend UI : http://localhost:8087

📦 Prérequis

Docker + Docker Compose
Système Linux (Debian/Ubuntu recommandé)

🔧 Utilisation

1. Exécuter un benchmark sur une machine

Sur la machine à benchmarker, exécutez :

curl -s https://gitea.maison43.duckdns.org/gilles/linux-benchtools/raw/branch/main/scripts/bench.sh \
  | bash -s -- \
    --server http://<IP_SERVEUR>:8007/api/benchmark \
    --token "VOTRE_TOKEN_API" \
    --device "nom-machine"

Le token API est généré automatiquement lors de l'installation et disponible dans le fichier .env.

2. Consulter le dashboard

Ouvrez votre navigateur sur http://<IP_SERVEUR>:8087 pour :

Voir le classement des machines par score global
Consulter les détails matériels de chaque machine
Visualiser l'historique des benchmarks
Uploader des documents (PDF, images)
Ajouter des liens constructeurs

📚 Documentation

Vision fonctionnelle - Objectifs et fonctionnalités
Modèle de données - Schéma SQLite
API Backend - Endpoints REST
Script client - bench.sh
WebUI Design - Interface utilisateur
Architecture - Backend FastAPI
Installation - Guide d'installation
Tests - Stratégie de tests
Roadmap - Évolutions futures
Structure - Arborescence du projet

🏗️ Architecture

┌─────────────────┐
│  Machine Linux  │
│   (bench.sh)    │
└────────┬────────┘
         │ POST JSON
         ↓
┌─────────────────┐      ┌──────────────┐
│  Backend API    │◄─────┤   Frontend   │
│  FastAPI + SQL  │      │  HTML/CSS/JS │
└─────────────────┘      └──────────────┘

🛠️ Stack technique

Backend : Python 3.11+, FastAPI, SQLAlchemy, SQLite
Frontend : HTML5, CSS3, JavaScript (Vanilla)
Script client : Bash
Outils benchmark : sysbench, fio, iperf3, glmark2
Déploiement : Docker, docker-compose

📊 Scores calculés

Pour chaque machine, l'application calcule :

Score CPU (sysbench) : événements/seconde
Score Mémoire (sysbench) : throughput MiB/s
Score Disque (fio) : read/write MB/s, IOPS
Score Réseau (iperf3) : débit up/down, latence
Score GPU (glmark2) : score graphique (optionnel)
Score Global : moyenne pondérée (CPU 30%, Mem 20%, Disk 25%, Net 15%, GPU 10%)

🎨 Interface

Dashboard avec style Monokai dark :

Vue d'ensemble du parc machines
Classement par score global
Détail complet de chaque machine
Historique des benchmarks
Gestion des documents

🔐 Sécurité

Authentification par token Bearer pour l'API
Token généré automatiquement à l'installation
Accès local (LAN) par défaut
Intégration possible avec reverse proxy existant

🤝 Contribution

Projet personnel self-hosted. Les suggestions et améliorations sont les bienvenues.

📝 License

Usage personnel - Gilles @ maison43

🗓️ Roadmap

✅ Phase 1 : MVP (backend + frontend + bench.sh)
⏳ Phase 2 : Améliorations UX (filtres, tri)
⏳ Phase 3 : Graphiques d'historique (Chart.js)
⏳ Phase 4 : Détection de régressions + alertes
⏳ Phase 5 : Intégrations (Home Assistant, Prometheus)

Voir roadmap détaillée.

Linux BenchTools - Benchmarking simplifié pour votre infrastructure Linux

4.6 KiB Raw Blame History