Status-Check Agent

Atlassian Forge App die taeglich Jira-Tickets in den Status Review und Warten ueberwacht und automatische Erinnerungen per Email versendet.

Funktionsweise

Review-Status (Kunde muss verifizieren)

Zeitraum	Aktion
>= 2 Tage	Email-Erinnerung an Ersteller, Anfrageteilnehmer und Bearbeiter
>= 4 Tage	Email-Benachrichtigung + automatisches Schliessen des Tickets

Warten-Status (Warten auf externen Dienstleister)

Zeitraum	Aktion
>= 2 Tage	Email-Erinnerung an Bearbeiter ("Bitte nachfassen")
>= 4 Tage	Eskalations-Email an Bearbeiter ("DRINGEND nachfassen")

Ablauf

Taeglich (scheduled trigger)
        |
        v
  Review >= 4 Tage  -->  Email + Auto-Close
  Review >= 2 Tage  -->  Erste Erinnerung
  Warten >= 4 Tage  -->  Eskalations-Email
  Warten >= 2 Tage  -->  Erste Erinnerung

Label-Tracking

Damit niemand doppelt benachrichtigt wird, setzt der Agent Labels:

Label	Bedeutung
Erinnerung-2T-Review	Erste Review-Erinnerung gesendet
Erinnerung-4T-Review	Ticket wurde auto-geschlossen
Erinnerung-2T-Warten	Erste Warten-Erinnerung gesendet
Erinnerung-4T-Warten	Eskalation gesendet

Projekte

Ueberwacht werden: RTA (IT Service Desk) und RTAPRO (IT Projekte)

Projektstruktur

status-check-agent/
  manifest.yml                    # Forge App Config (scheduled trigger)
  package.json
  src/
    index.js                      # Handler-Export
    trigger/
      daily-status-check.js       # Hauptlogik (Orchestrator)
    lib/
      config.js                   # Konstanten (Projekte, Status-Namen, Schwellwerte)
      ticket-finder.js            # JQL-Abfragen
      notification-sender.js      # Email-Versand via Jira Notify API
      ticket-transitioner.js      # Status-Uebergang (Review -> Done)
      label-tracker.js            # Erinnerungs-Labels setzen
      message-templates.js        # Email-Texte (deutsch)

Benachrichtigungs-Methode

Emails werden ueber die Jira Notify API (POST /rest/api/3/issue/{id}/notify) versendet. Das erzeugt keine Kommentare im Ticket und ist sauber.

Deployment

npm install
npx forge register status-check-agent
npx forge deploy
npx forge install --site reisenthel-it.atlassian.net --product jira

Logs pruefen

npx forge logs -e development

Konfiguration

Alle Einstellungen in src/lib/config.js:

• Projekte (RTA, RTAPRO)
• Status-Namen (Review, Warten)
• Schwellwerte (2 und 4 Tage)
• Label-Namen
• Request Participants Feld-ID

Technologie

• Atlassian Forge (nodejs22.x)
• Scheduled Trigger (taeglich)
• Jira REST API v3
• ES Modules