incident.altavoce.tech

[!WARNING] Statut de déploiement : Ce système de gestion des incidents n'a pas encore été déployé en production. Son utilisation actuelle est restreinte aux environnements de développement et de test local.

Vue d'ensemble

incident.altavoce.tech est le système de gestion des incidents dédié aux services d'intelligence artificielle d'Alta Voce.

Fonctionnalités

  • Détection automatique d'incidents
  • Classification et priorisation
  • Notification en temps réel
  • Suivi de résolution
  • Analyse post-incident

Architecture

Le système s'intègre avec les services suivants :

  • ia-altavoce.tech : Source principale des incidents
  • Monitoring Stack : Métriques et alertes
  • Notification Service : Envoi d'alertes (email, Slack, SMS)
  • Knowledge Base : Base de données des incidents résolus

Spécifications Techniques

Le système est conçu sur une architecture moderne à haute performance, permettant une réactivité maximale lors de la capture et du traitement des incidents :

  • Framework principal : Laravel 13 / PHP 8.3
  • Moteur Frontend : Livewire v4 (interactivité dynamique sans JavaScript lourd côté client)
  • Routage d'événements : Laravel Reverb (WebSockets natifs pour la diffusion des incidents en temps réel sur le tableau de bord)
  • Base de données locale : SQLite (database/database.sqlite) pour une légèreté maximale en local, MySQL en production
  • Visualisation des Logs : Laravel Pail (logs en temps réel dans le terminal)

Guide d'installation et de Démarrage Local

Pour installer et lancer le projet incident.alta-voce.tech en local, suivez la procédure d'ingénierie standard :

1. Installation automatique (Script Setup)

Le projet intègre un script Composer pour installer et configurer tout l'environnement en une seule ligne :

composer run setup

Ce script exécute successivement : composer install, la création du fichier .env, php artisan key:generate, les migrations SQL, npm install et le build de production de Vite (npm run build).

2. Démarrage de l'environnement de développement (Concurrently)

En développement local, plusieurs processus doivent s'exécuter simultanément (le serveur web, l'écouteur de file d'attente des tâches en arrière-plan, l'écouteur de logs Pail, et le serveur de build à chaud de Vite).

Pour vous éviter d'ouvrir 4 terminaux différents, utilisez la commande suivante pour tout orchestrer en parallèle :

composer run dev

Cette commande utilise concurrently pour démarrer et synchroniser :

  • server : Le serveur web local (php artisan serve)
  • queue : L'écouteur de file d'attente (php artisan queue:listen)
  • logs : L'écouteur de logs en temps réel (php artisan pail)
  • vite : Le serveur de développement frontend Vite (npm run dev)

Accès

  • URL : https://incident.altavoce.tech
  • Dashboard : https://incident.altavoce.tech/dashboard
  • API : https://incident.altavoce.tech/api

Flux de gestion des incidents

1. Détection

Les incidents sont détectés automatiquement via :

  • Monitoring des métriques système
  • Analyse des logs d'erreur
  • Signalements utilisateurs

2. Classification

Chaque incident est classifié selon :

  • Sévérité : Critique, Élevée, Moyenne, Faible
  • Catégorie : Performance, Disponibilité, Qualité, Sécurité
  • Impact : Utilisateurs affectés, Services impactés

3. Notification

Les notifications sont envoyées selon la sévérité :

  • Critique : Immédiat (tous les canaux)
  • Élevée : Immédiat (email + Slack)
  • Moyenne/Faible : Quotidien (email)

4. Résolution

Le suivi inclut :

  • Assignation automatique ou manuelle
  • Suivi du temps de résolution
  • Documentation des actions

Procédures d'urgence

Incident Critique

  1. Alerte immédiate à l'équipe on-call
  2. Activation du canal d'urgence Slack
  3. Communication aux parties prenantes
  4. Résolution dans un délai de 15 minutes

Incident Élevé

  1. Notification à l'équipe concernée
  2. Évaluation de l'impact
  3. Planification de la résolution
  4. Résolution dans un délai de 1 heure

Intégration API

Créer un incident

curl -X POST https://incident.altavoce.tech/api/v1/incidents \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "title": "Service IA indisponible",
    "severity": "critical",
    "description": "Le service ia-altavoce.tech ne répond pas",
    "service": "ia-altavoce.tech"
  }'

Consulter les incidents

curl -H "Authorization: Bearer <token>" \
  https://incident.altavoce.tech/api/v1/incidents?status=open

Bonnes pratiques

  • Documenter chaque incident pour l'apprentissage continu
  • Analyser les causes profondes pour éviter les récurrences
  • Mettre à jour les procédures régulièrement
  • Former l'équipe aux protocoles d'urgence

Support

Pour toute question sur le système de gestion des incidents, contactez l'équipe DevOps ou référez-vous à la documentation interne.