Use Case Diagram

📐 System Modeling

EcoGuard — Use Case Analysis

A complete behavioral model of EcoGuard's actors and system interactions, structured from stakeholder goals down to technical system boundaries.

---

👥 Actors

EcoGuard serves four distinct actors, each with a different level of system interaction and concern.

⚙️

DevOps Engineer

Primary User

Manages CI/CD pipelines day-to-day. Monitors emissions, applies AI-generated optimizations, and reviews anomaly alerts to improve pipeline efficiency.

• Views live emission dashboards
• Reviews & applies optimization MRs
• Configures pipeline thresholds
• Schedules eco-friendly deployments

🧑‍💼

Team Lead

Supervisor

Oversees the team's collective pipeline sustainability posture. Approves AI-generated merge requests and receives escalated anomaly alerts.

• Receives threshold breach alerts
• Approves AI remediation MRs
• Reviews team-level emission trends
• Sets project sustainability goals

🌿

Sustainability Officer

Compliance Owner

Responsible for regulatory compliance reporting. Generates AI-assisted audit reports for EU CSRD, ISO 14064, and GHG Protocol requirements.

• Generates compliance reports
• Exports PDF / DOCX / CSV reports
• Tracks sustainability goal progress
• Submits to regulatory bodies

🤖

AI Agent System

Automated Actor

An autonomous subsystem that continuously monitors pipeline data, detects anomalies, forecasts emissions, and generates code-level optimization patches.

• Forecasts future emissions (ML)
• Detects pipeline anomalies
• Generates remediation MRs
• Auto-drafts compliance reports

---

📋 Use Case Inventory

All use cases are listed below, grouped by functional domain, before being visualized in the diagrams.

📊 Monitoring & Visibility

UC-01View Emission Trend DashboardDevOps Engineer

UC-02Filter Emissions by Project / Branch / JobDevOps Engineer

UC-03View Carbon Intensity HeatmapDevOps Engineer

UC-04Track Sustainability Goal ProgressTeam Lead · Sustainability Officer

UC-05View AI Emission Forecast (7-day)DevOps Engineer · Team Lead

🚨 Alerting & Anomaly Detection

UC-06Configure Emission Threshold AlertsTeam Lead

UC-07Receive Threshold Breach NotificationTeam Lead

UC-08Receive AI Anomaly Detection AlertDevOps Engineer · Team Lead

UC-09View Root-Cause Job BreakdownDevOps Engineer

🔧 Optimization & Remediation

UC-10View Manual Optimization RecommendationsDevOps Engineer

UC-11Receive AI-Generated Remediation MRDevOps Engineer

UC-12Review & Approve AI Remediation MRTeam Lead

UC-13Schedule Eco-Friendly Deployment WindowDevOps Engineer

UC-14Trigger Manual Re-optimization ScanDevOps Engineer

📄 Reporting & Compliance

UC-15Generate Monthly Compliance ReportSustainability Officer

UC-16Select Regulatory Format (EU/ISO/GHG)Sustainability Officer

UC-17Export Report (PDF / DOCX / CSV)Sustainability Officer

UC-18AI Auto-Draft Compliance NarrativeAI Agent System

⚙️ System & Data Operations

UC-19Collect Pipeline Data from GitLab APIAI Agent System

UC-20Fetch Carbon Intensity from Electricity MapsAI Agent System

UC-21Calculate CO₂ Emissions per JobAI Agent System

UC-22Retrain Anomaly Detection ModelAI Agent System

UC-23Retrain Emission Forecast ModelAI Agent System

UC-24Validate AI Output via SandboxAI Agent System

---

🗺️ Use Case Diagram — Overview

The master diagram below shows all actors and their relationships to the EcoGuard system boundary.

---

🎯 Detailed Use Case Views

1️⃣ DevOps Engineer — Daily Workflow

2️⃣ Team Lead — Oversight & Approval Workflow

3️⃣ Sustainability Officer — Compliance Workflow

4️⃣ AI Agent System — Autonomous Operations

---

🔗 Use Case Relationships Summary

Relationship	From	To	Type
UC-01 → UC-02	View Dashboard	Filter by Criteria	«include»
UC-06 → UC-07	Configure Alert	Receive Alert	«include»
UC-08 → UC-12	AI Anomaly Alert	Approve Remediation MR	«extend»
UC-10 → UC-11	Manual Recs	AI Remediation MR	«extend»
UC-13 → UC-03	Eco Scheduling	Carbon Intensity Heatmap	«extend»
UC-15 → UC-16	Generate Report	Select Format	«include»
UC-15 → UC-18	Generate Report	AI Auto-Draft Narrative	«include»
UC-15 → UC-17	Generate Report	Export Report	«extend»
UC-19 → UC-21	Collect Data	Calculate Emissions	«include»
UC-20 → UC-21	Fetch Carbon Intensity	Calculate Emissions	«include»
UC-21 → UC-05	Calculate Emissions	AI Forecast	«include»
UC-21 → UC-08	Calculate Emissions	Anomaly Alert	«include»
UC-11 → UC-24	Generate MR	Sandbox Validation	«include»
UC-18 → UC-24	Auto-Draft Report	Sandbox Validation	«include»

---

📊 Actor Coverage Matrix

Use Case

⚙️ DevOps

🧑‍💼 Lead

🌿 Officer

🤖 AI Agent

UC-01 View Emission Trends

✅

—

—

—

UC-02 Filter Emissions

✅

—

—

—

UC-03 Carbon Intensity Heatmap

✅

—

—

—

UC-04 Track Goal Progress

—

✅

✅

—

UC-05 AI Emission Forecast

✅

✅

—

✅

UC-06 Configure Alerts

—

✅

—

—

UC-07 Threshold Alert

—

✅

—

—

UC-08 AI Anomaly Alert

✅

✅

—

✅

UC-09 Root-Cause Breakdown

✅

—

—

—

UC-10 Manual Recommendations

✅

—

—

—

UC-11 AI Remediation MR

✅

—

—

✅

UC-12 Approve Remediation MR

—

✅

—

—

UC-13 Eco Deployment Schedule

✅

—

—

—

UC-14 Re-optimization Scan

✅

—

—

—

UC-15 Generate Compliance Report

—

—

✅

—

UC-16 Select Regulatory Format

—

—

✅

—

UC-17 Export Report

—

—

✅

—

UC-18 AI Auto-Draft Narrative

—

—

—

✅

UC-19 Collect GitLab Data

—

—

—

✅

UC-20 Fetch Carbon Intensity

—

—

—

✅

UC-21 Calculate CO₂ per Job

—

—

—

✅

UC-22 Retrain Anomaly Model

—

—

—

✅

UC-23 Retrain Forecast Model

—

—

—

✅

UC-24 Validate via Sandbox

—

—

—

✅

Total Use Cases

10

6

5

10