serv_benchmark/docs/02_model_donnees.md

02 – Modèle de données (SQLite)

Objectif : définir le schéma relationnel pour SQLite, exploité par SQLAlchemy (ou équivalent).

Vue d’ensemble

Tables principales :

• devices
• hardware_snapshots
• benchmarks
• manufacturer_links
• documents

Optionnel (plus tard) :

• users (si auth interne)
• settings (config globale de l’app)

---

Table devices

Représente une machine (physique ou virtuelle).

Champs :

• id (INTEGER, PK, autoincrement)
• hostname (TEXT, non nul)
• fqdn (TEXT, nullable)
• description (TEXT, nullable)
• asset_tag (TEXT, nullable) – identifiant interne/inventaire
• location (TEXT, nullable)
• owner (TEXT, nullable)
• tags (TEXT, nullable) – liste séparée par virgules ou JSON
• created_at (DATETIME, non nul)
• updated_at (DATETIME, non nul)

Contraintes :

• hostname peut être utilisé comme identifiant logique si device_identifier n’est pas fourni par le client.
• Index recommandé : idx_devices_hostname.

---

Table hardware_snapshots

Snapshot détaillé de la configuration matérielle et OS au moment d’un bench.

Champs :

• id (INTEGER, PK)
• device_id (INTEGER, FK -> devices.id)
• captured_at (DATETIME, non nul)

CPU

• cpu_vendor (TEXT)
• cpu_model (TEXT)
• cpu_microarchitecture (TEXT, nullable)
• cpu_cores (INTEGER)
• cpu_threads (INTEGER)
• cpu_base_freq_ghz (REAL, nullable)
• cpu_max_freq_ghz (REAL, nullable)
• cpu_cache_l1_kb (INTEGER, nullable)
• cpu_cache_l2_kb (INTEGER, nullable)
• cpu_cache_l3_kb (INTEGER, nullable)
• cpu_flags (TEXT, nullable) – chaîne ou JSON (AVX, AES, etc.)
• cpu_tdp_w (REAL, nullable)

RAM

• ram_total_mb (INTEGER)
• ram_slots_total (INTEGER, nullable)
• ram_slots_used (INTEGER, nullable)
• ram_ecc (BOOLEAN, nullable)
• ram_layout_json (TEXT, nullable)
  Exemple JSON :

  [
    { "slot": "DIMM_A1", "size_mb": 16384, "type": "DDR4", "speed_mhz": 2133, "vendor": "Corsair", "part_number": "XXXX" }
  ]
  

GPU

• gpu_summary (TEXT, nullable) – ex: "Intel UHD 630"
• gpu_vendor (TEXT, nullable)
• gpu_model (TEXT, nullable)
• gpu_driver_version (TEXT, nullable)
• gpu_memory_dedicated_mb (INTEGER, nullable)
• gpu_memory_shared_mb (INTEGER, nullable)
• gpu_api_support (TEXT, nullable) – ex: "OpenGL 4.6, Vulkan"

Stockage

• storage_summary (TEXT, nullable) – résumé human readable
• storage_devices_json (TEXT, nullable)
  Exemple JSON :

  [
    {
      "name": "/dev/nvme0n1",
      "type": "NVMe",
      "interface": "PCIe 3.0 x4",
      "capacity_gb": 1000,
      "vendor": "Samsung",
      "model": "970 EVO Plus",
      "smart_health": "PASSED",
      "temperature_c": 42
    }
  ]
  

• partitions_json (TEXT, nullable)

Réseau

• network_interfaces_json (TEXT, nullable)
  Exemple :

  [
    {
      "name": "eth0",
      "type": "ethernet",
      "mac": "aa:bb:cc:dd:ee:ff",
      "ip": "10.0.0.10",
      "speed_mbps": 1000,
      "driver": "e1000e"
    }
  ]
  

OS / Carte mère

• os_name (TEXT)
• os_version (TEXT)
• kernel_version (TEXT)
• architecture (TEXT) – "x86_64", "arm64"
• virtualization_type (TEXT, nullable) – "kvm", "vmware", "none", etc.
• motherboard_vendor (TEXT, nullable)
• motherboard_model (TEXT, nullable)
• bios_version (TEXT, nullable)
• bios_date (TEXT, nullable)

Divers

• sensors_json (TEXT, nullable) – valeurs de températures, etc.
• raw_info_json (TEXT, nullable) – dump brut de commandes (inxi, lshw, etc.)

Index recommandés :

• idx_hw_snapshots_device_id
• idx_hw_snapshots_captured_at

---

Table benchmarks

Représente un run de bench.

Champs :

• id (INTEGER, PK)
• device_id (INTEGER, FK -> devices.id)
• hardware_snapshot_id (INTEGER, FK -> hardware_snapshots.id)
• run_at (DATETIME, non nul)
• bench_script_version (TEXT, non nul)

Scores

• global_score (REAL, non nul)
• cpu_score (REAL, nullable)
• memory_score (REAL, nullable)
• disk_score (REAL, nullable)
• network_score (REAL, nullable)
• gpu_score (REAL, nullable)

Détails

• details_json (TEXT, non nul)
  Contient toutes les valeurs brutes :

  • CPU events/sec, temps d’exécution, etc.
  • Throughput mémoire.
  • Read/write MB/s, IOPS.
  • Vitesse iperf3, ping.
  • Score GPU, etc.

• notes (TEXT, nullable)

Index :

• idx_benchmarks_device_id
• idx_benchmarks_run_at

---

Table manufacturer_links

Liens vers les ressources en ligne du constructeur.

Champs :

• id (INTEGER, PK)
• device_id (INTEGER, FK -> devices.id)
• label (TEXT, non nul) – ex: "Support HP", "Page produit Lenovo"
• url (TEXT, non nul)

Index :

• idx_links_device_id

---

Table documents

Fichiers (PDF, images, etc.) associés à un device.

Champs :

• id (INTEGER, PK)
• device_id (INTEGER, FK -> devices.id)
• doc_type (TEXT, non nul) – manual, warranty, invoice, photo, other
• filename (TEXT, non nul) – nom original
• stored_path (TEXT, non nul) – chemin relatif sur le serveur
• mime_type (TEXT, non nul)
• size_bytes (INTEGER, non nul)
• uploaded_at (DATETIME, non nul)

Index :

• idx_documents_device_id

---

Éventuelle table settings (optionnelle)

Pour stocker des paramètres globaux de l’application.

Champs :

• id (INTEGER, PK)
• key (TEXT, unique)
• value (TEXT)

Exemples :

• default_bench_server_url
• default_iperf_server
• score_weights_json (pondération CPU/Mem/Disque/Réseau/GPU)