# Rapport Hermes — 2026-06-07_19-30
> Branche : `hermes/daily-work` · Fichiers analysés : 5

---
## Résumé
- ✅ À jour : 4
- ⚠️  À améliorer : 1

## ✅ `admin/ia/litellm.md` — 8/10

**Statut** : à_jour  
**Résumé** : Documentation complète sur la configuration et l'utilisation de LiteLLM avec des informations sur les modèles, coûts et outils d'administration, mais avec des lacunes dans la gestion IaC.  

**Problèmes :**
- Le template Ansible manque les modèles CPU (qwen3-1.7b-system et qwen3-1.7b-monitor) nécessaires pour ask-agent
- La table des coûts Claude contient des caractères non standards ($ et —)
- L'absence de mention des risques de dépendance vers les fichiers manuellement modifiés (/etc/litellm/config.yaml)

**Suggestions :**
- Ajouter les modèles CPU dans le template Ansible (config.yaml.j2)
- Normaliser la présentation des coûts avec des symboles monétaires standards
- Ajouter une note sur la gestion des configurations manuelles et les risques d'incohérence

**État réel connu de Hermes :**  
Le service LiteLLM est opérationnel sur storage-01 avec des modèles GPU disponibles, mais les modèles CPU nécessaires à ask-agent sont configurés manuellement, créant un risque de désalignement avec les templates Ansible.

---

## ✅ `admin/ia/llama_server.md` — 9/10

**Statut** : ok  
**Résumé** : Documentation complète et structurée sur la configuration et l'utilisation de llama-server sur gpu-01, avec détails techniques et commandes d'administration  

**Problèmes :**
- Manque de section sur la sécurité (firewall, authentification API)
- Aucune mention des dépendances logicielles requises (ROCm, librairies système)
- Pas de guide de dépannage pour les erreurs courantes

**Suggestions :**
- Ajouter une section 'Configuration requise' avec les dépendances logicielles
- Inclure un exemple de configuration de sécurité (TLS, auth API keys)
- Ajouter un appendice 'Dépannage' avec solutions pour les erreurs courantes
- Mettre à jour les commandes pour les versions ROCm 7.x récentes

**État réel connu de Hermes :**  
Le composant est actif et fonctionnel dans Funk avec les métriques Prometheus disponibles. Les instances CPU et GPU fonctionnent selon les spécifications, les tests d'embeddings sont validés et les performances respectent les benchmarks.

---

## ✅ `admin/ia/rag.md` — 8/10

**Statut** : à_jour  
**Résumé** : Documentation complète sur le système RAG de Funk, expliquant l'architecture, les composants et les procédures d'utilisation, avec des exemples concrets.  

**Problèmes :**
- Utilisation de Qwen3-8B (modèle génératif) pour les embeddings, ce qui entraîne une perte de discrimination sémantique (scores cosinus uniformément élevés)

**Suggestions :**
- Ajouter des étapes pour migrer vers des modèles d'embedding dédiés comme nomic-embed-text-v1.5 ou bge-m3
- Préciser l'impact des scores cosinus uniformes sur la pertinence des résultats

**État réel connu de Hermes :**  
Le système RAG de Funk utilise actuellement Qwen3-8B pour les embeddings avec les limitations sémantiques décrites. L'index est alimenté depuis le dossier admin/ et peut être mis à jour via Ansible ou manuellement.

---

## ✅ `admin/ia/rocm.md` — 8/10

**Statut** : à_jour  
**Résumé** : Le document ROCm décrit correctement la configuration et les vérifications nécessaires pour AMD RX 6700XT sur AlmaLinux, avec un état conforme à la date d'audit.  

**Problèmes :**
- Manque d'explications sur pourquoi HSA_OVERRIDE_GFX_VERSION est obligatoire
- La section 'État vérifié' pourrait inclure des métriques d'utilisation GPU plus détaillées

**Suggestions :**
- Ajouter une note sur les mises à jour ROCm récentes et leur impact
- Proposer un script automatisé pour vérifier les étapes critiques
- Inclure des exemples de sortie attendue pour les commandes clés

**État réel connu de Hermes :**  
OK - Services ROCm opérationnels, noyau 5.14.0, aucune divergence détectée, configuration conforme

---

## ⚠️ `admin/incidents.md` — 6/10

**Statut** : incomplet  
**Résumé** : Document d'historique d'incidents avec structure claire mais contenant des sections incomplètes et des informations manquantes  

**Problèmes :**
- La section 'État post-migration' est incomplète (texte coupé : 'Espace disponibl')
- Seul l'incident du 2026-05-29 est détaillé, les autres entrées de l'index ne sont pas développées
- Manque de synthèse globale des incidents et de conclusions
- Formatage irrégulier des tableaux (certains ont des colonnes mal alignées)

**Suggestions :**
- Compléter la section 'État post-migration' avec les données d'espace disque
- Développer les sections des autres incidents listés dans l'index
- Ajouter une conclusion synthétique des mesures correctives appliquées
- Standardiser le formatage des tableaux et des listes

**État réel connu de Hermes :**  
/srv/data a été migré vers un LV NVMe (XFS) via bind-mount, le RAID5 original a été dégradé et non plus utilisé

---

