# youneselamraoui/intelliops-lite architecture

> Architecture diagram of the GitHub repository youneselamraoui/intelliops-lite, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/youneselamraoui/intelliops-lite
- Repository: https://github.com/youneselamraoui/intelliops-lite

## Overview

IntelliOps-Lite is a lightweight incident-processing platform. Its principal workflow accepts Docker log lines or Trivy vulnerability reports, normalizes them into shared event records, suppresses duplicates, analyzes severity and runbook matches, then creates and journals a notification. The command-line entry point displays results and asks for human approval of sensitive actions; approval is simulated, not executed. The graph reflects the sampled source and README; external delivery integrations are not shown as real services because the implementation only selects channel labels.

Main entry points: [`src/workflow.py`](https://github.com/youneselamraoui/intelliops-lite/blob/main/src/workflow.py) (Workflow dispatcher), [`src/analyse.py`](https://github.com/youneselamraoui/intelliops-lite/blob/main/src/analyse.py) (Incident analysis), [`main.py`](https://github.com/youneselamraoui/intelliops-lite/blob/main/main.py) (CLI runner), [`src/notification.py`](https://github.com/youneselamraoui/intelliops-lite/blob/main/src/notification.py) (Notification creation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Event ingestion"]
  node_extract["Event normalization<br/>[extraction.py]"]
  node_event["Event contract<br/>[contrat.py]"]
end

subgraph group_processing["Incident processing"]
  node_workflow["Workflow dispatcher<br/>[workflow.py]"]
  node_analysis["Incident analysis<br/>[analyse.py]"]
  node_runbooks["Runbook data<br/>[contrat.py]"]
end

subgraph group_delivery["Notification and review"]
  node_cli["CLI runner<br/>[main.py]"]
  node_notification["Notification creation<br/>[notification.py]"]
  node_journal[("Notification journal<br/>[main.py]")]
  node_review["Human approval<br/>[notification.py]"]
end

node_operator(("Operator"))

node_operator -->|"starts"| node_cli
node_cli -->|"dispatches events"| node_workflow
node_workflow -->|"normalizes input"| node_extract
node_extract -->|"creates records"| node_event
node_workflow -->|"checks duplicates; analyzes"| node_analysis
node_analysis -->|"reads and updates"| node_event
node_workflow -->|"supplies procedures"| node_runbooks
node_analysis -->|"matches keywords"| node_runbooks
node_workflow -->|"creates notification"| node_notification
node_notification -->|"updates status"| node_event
node_notification -->|"appends notification"| node_journal
node_cli -->|"requests approval"| node_review
node_review -->|"prompts response"| node_operator

click node_cli "https://github.com/youneselamraoui/intelliops-lite/blob/main/main.py"
click node_workflow "https://github.com/youneselamraoui/intelliops-lite/blob/main/src/workflow.py"
click node_extract "https://github.com/youneselamraoui/intelliops-lite/blob/main/src/extraction.py"
click node_event "https://github.com/youneselamraoui/intelliops-lite/blob/main/src/contrat.py"
click node_analysis "https://github.com/youneselamraoui/intelliops-lite/blob/main/src/analyse.py"
click node_runbooks "https://github.com/youneselamraoui/intelliops-lite/blob/main/src/contrat.py"
click node_notification "https://github.com/youneselamraoui/intelliops-lite/blob/main/src/notification.py"
click node_journal "https://github.com/youneselamraoui/intelliops-lite/blob/main/main.py"
click node_review "https://github.com/youneselamraoui/intelliops-lite/blob/main/src/notification.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_extract,node_event toneBlue
class node_workflow,node_analysis,node_runbooks toneAmber
class node_cli,node_notification,node_journal,node_review toneMint
class node_operator toneIndigo
```

## Components

### Event ingestion

- [Event normalization](https://github.com/youneselamraoui/intelliops-lite/blob/main/src/extraction.py): `src/extraction.py`
- [Event contract](https://github.com/youneselamraoui/intelliops-lite/blob/main/src/contrat.py): `src/contrat.py`

### Incident processing

- [Workflow dispatcher](https://github.com/youneselamraoui/intelliops-lite/blob/main/src/workflow.py): `src/workflow.py`
- [Incident analysis](https://github.com/youneselamraoui/intelliops-lite/blob/main/src/analyse.py): `src/analyse.py`
- [Runbook data](https://github.com/youneselamraoui/intelliops-lite/blob/main/src/contrat.py): `src/contrat.py`

### Notification and review

- [CLI runner](https://github.com/youneselamraoui/intelliops-lite/blob/main/main.py): `main.py`
- [Notification creation](https://github.com/youneselamraoui/intelliops-lite/blob/main/src/notification.py): `src/notification.py`
- [Notification journal](https://github.com/youneselamraoui/intelliops-lite/blob/main/main.py): `main.py`
- [Human approval](https://github.com/youneselamraoui/intelliops-lite/blob/main/src/notification.py): `src/notification.py`

### Other components

- **Operator**

## Connections

- Operator → CLI runner: starts (evidence: `README.md`)
- CLI runner → Workflow dispatcher: dispatches events (evidence: `main.py`)
- Workflow dispatcher → Event normalization: normalizes input (evidence: `src/workflow.py`)
- Event normalization → Event contract: creates records (evidence: `src/extraction.py`)
- Workflow dispatcher → Incident analysis: checks duplicates; analyzes (evidence: `src/workflow.py`)
- Incident analysis → Event contract: reads and updates (evidence: `src/analyse.py`)
- Workflow dispatcher → Runbook data: supplies procedures (evidence: `src/workflow.py`)
- Incident analysis → Runbook data: matches keywords (evidence: `src/analyse.py`)
- Workflow dispatcher → Notification creation: creates notification (evidence: `src/workflow.py`)
- Notification creation → Event contract: updates status (evidence: `src/notification.py`)
- Notification creation → Notification journal: appends notification (evidence: `src/notification.py`)
- CLI runner → Human approval: requests approval (evidence: `main.py`)
- Human approval → Operator: prompts response
