budget_alerts

Vue d’ensemble

budget_alerts parcourt les projets configurés et détecte les conditions à surveiller pour la santé du registre R&D : dépassement de budget, ralentissement d’effort, absence d’entrées récentes, désynchronisation avec Jira.

Paramètres

project string

ID d’un projet spécifique. Si omis, alerte sur tous les projets.

Types d’alertes détectées

Type	Déclencheur
`budget_exceeded`	Heures cumulées > `budget_hours` configuré pour la période
`budget_critical`	Heures cumulées > 90 % du budget
`budget_warning`	Heures cumulées > 75 % du budget
`missing_entries`	Aucune entrée scellée depuis 14 jours sur un projet actif
`low_velocity`	Vélocité hebdo < 30 % de la moyenne historique
`jira_drift`	Worklogs Jira présents mais non importés via `certify_research` depuis > 7 jours

Réponse

{
  "alerts": [
    {
      "project_id": "mon-api",
      "type": "budget_critical",
      "severity": "warn",
      "message": "92% du budget consommé (460h / 500h)",
      "details": {
        "spent_hours": 460,
        "budget_hours": 500,
        "percentage": 92
      }
    },
    {
      "project_id": "autre-projet",
      "type": "jira_drift",
      "severity": "info",
      "message": "8 worklogs Jira non scellés (4.5h)",
      "details": {
        "unsealed_worklogs": 8,
        "unsealed_hours": 4.5
      }
    }
  ],
  "summary": {
    "total_alerts": 2,
    "by_severity": { "critical": 0, "warn": 1, "info": 1 }
  }
}

Configuration des budgets

Les budgets sont définis par projet via configure :

Configure un budget de 500 heures sur mon-api avec une période de 6 mois

configure({
  "action": "update_project",
  "project_id": "mon-api",
  "budget_hours": 500,
  "budget_period_months": 6
})