# yosefshabaan/cats-online-anomaly-detection architecture

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

- Interactive diagram: https://gitdiagram.com/yosefshabaan/cats-online-anomaly-detection
- Repository: https://github.com/yosefshabaan/cats-online-anomaly-detection

## Overview

This repository combines a notebook-based autoencoder anomaly-detection experiment, documented Kafka streaming simulation, and a Streamlit app for exploring model results and running detection on uploaded sensor CSVs. The app routes sidebar selections to individual pages; execution validates data, loads a selected model and threshold, and visualizes anomalies. Evaluation compares saved experiment reports. The notebook and Kafka workflow are described in the README and illustrated as code in the Colab page; the notebook itself was not sampled, so its internal stages are not expanded.

Main entry points: [`Streamlit_result_visualization/app.py`](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/app.py) (App Router), [`Streamlit_result_visualization/menu_pages/execution_page.py`](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/execution_page.py) (Execution Page), [`AnomalyDetection.ipynb`](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/AnomalyDetection.ipynb) (Training and Streaming), [`Streamlit_result_visualization/menu_pages/evaluation_page.py`](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/evaluation_page.py) (Evaluation Page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_notebook["Notebook Workflow"]
  node_notebook_flow["Training and Streaming"]
end

subgraph group_app["Streamlit App"]
  node_app_entry["App Router<br/>[app.py]"]
  node_home["Home Page<br/>[home_page.py]"]
  node_project_info["Project Info<br/>[model_page.py]"]
  node_colab_guide["Colab Guide<br/>[colab_page.py]"]
  node_evaluation_page["Evaluation Page<br/>[evaluation_page.py]"]
  node_execution_page["Execution Page<br/>[execution_page.py]"]
  node_contact["Contact Page<br/>[contact_page.py]"]
end

subgraph group_inference["Detection Runtime"]
  node_csv_validation["CSV Validation<br/>[execution_page.py]"]
  node_model_selection["Model Selection<br/>[execution_page.py]"]
  node_anomaly_scoring["Anomaly Scoring<br/>[execution_page.py]"]
  node_result_visualization["Anomaly Visualization<br/>[execution_page.py]"]
end

subgraph group_results["Models and Results"]
  node_weights["Model Weights"]
  node_evaluation_results[("Evaluation Reports")]
end

node_user(("User"))
node_dataset["Sensor Dataset"]
node_kafka["Kafka"]

node_user -->|"selects page"| node_app_entry
node_app_entry -->|"routes to"| node_home
node_app_entry -->|"routes to"| node_project_info
node_app_entry -->|"routes to"| node_colab_guide
node_app_entry -->|"routes to"| node_evaluation_page
node_app_entry -->|"routes to"| node_execution_page
node_app_entry -->|"routes to"| node_contact
node_user -->|"uploads CSV"| node_execution_page
node_execution_page -->|"validates with"| node_csv_validation
node_execution_page -->|"builds and loads"| node_model_selection
node_model_selection -->|"loads weights"| node_weights
node_execution_page -->|"runs inference"| node_anomaly_scoring
node_execution_page -->|"plots results"| node_result_visualization
node_evaluation_page -->|"reads reports"| node_evaluation_results
node_dataset -.->|"provides time series"| node_notebook_flow
node_notebook_flow -.->|"simulates streaming"| node_kafka

click node_notebook_flow "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/AnomalyDetection.ipynb"
click node_app_entry "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/app.py"
click node_home "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/home_page.py"
click node_project_info "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/model_page.py"
click node_colab_guide "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/colab_page.py"
click node_evaluation_page "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/evaluation_page.py"
click node_execution_page "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/execution_page.py"
click node_contact "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/contact_page.py"
click node_csv_validation "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/execution_page.py"
click node_model_selection "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/execution_page.py"
click node_anomaly_scoring "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/execution_page.py"
click node_result_visualization "https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/execution_page.py"
click node_weights "https://github.com/yosefshabaan/cats-online-anomaly-detection/tree/main/Streamlit_result_visualization/models"
click node_evaluation_results "https://github.com/yosefshabaan/cats-online-anomaly-detection/tree/main/Streamlit_result_visualization/models_info"

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_notebook_flow,node_user toneBlue
class node_app_entry,node_home,node_project_info,node_colab_guide,node_evaluation_page,node_execution_page,node_contact toneAmber
class node_csv_validation,node_model_selection,node_anomaly_scoring,node_result_visualization toneMint
class node_weights,node_evaluation_results toneRose
class node_dataset,node_kafka toneIndigo
```

## Components

### Notebook Workflow

- [Training and Streaming](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/AnomalyDetection.ipynb): `AnomalyDetection.ipynb`

### Streamlit App

- [App Router](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/app.py): `Streamlit_result_visualization/app.py`
- [Home Page](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/home_page.py): `Streamlit_result_visualization/menu_pages/home_page.py`
- [Project Info](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/model_page.py): `Streamlit_result_visualization/menu_pages/model_page.py`
- [Colab Guide](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/colab_page.py): `Streamlit_result_visualization/menu_pages/colab_page.py`
- [Evaluation Page](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/evaluation_page.py): `Streamlit_result_visualization/menu_pages/evaluation_page.py`
- [Execution Page](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/execution_page.py): `Streamlit_result_visualization/menu_pages/execution_page.py`
- [Contact Page](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/contact_page.py): `Streamlit_result_visualization/menu_pages/contact_page.py`

### Detection Runtime

- [CSV Validation](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/execution_page.py): `Streamlit_result_visualization/menu_pages/execution_page.py`
- [Model Selection](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/execution_page.py): `Streamlit_result_visualization/menu_pages/execution_page.py`
- [Anomaly Scoring](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/execution_page.py): `Streamlit_result_visualization/menu_pages/execution_page.py`
- [Anomaly Visualization](https://github.com/yosefshabaan/cats-online-anomaly-detection/blob/main/Streamlit_result_visualization/menu_pages/execution_page.py): `Streamlit_result_visualization/menu_pages/execution_page.py`

### Models and Results

- [Model Weights](https://github.com/yosefshabaan/cats-online-anomaly-detection/tree/main/Streamlit_result_visualization/models): `Streamlit_result_visualization/models`
- [Evaluation Reports](https://github.com/yosefshabaan/cats-online-anomaly-detection/tree/main/Streamlit_result_visualization/models_info): `Streamlit_result_visualization/models_info`

### Other components

- **User**
- **Sensor Dataset**
- **Kafka**

## Connections

- User → App Router: selects page (evidence: `Streamlit_result_visualization/app.py`)
- App Router → Home Page: routes to (evidence: `Streamlit_result_visualization/app.py`)
- App Router → Project Info: routes to (evidence: `Streamlit_result_visualization/app.py`)
- App Router → Colab Guide: routes to (evidence: `Streamlit_result_visualization/app.py`)
- App Router → Evaluation Page: routes to (evidence: `Streamlit_result_visualization/app.py`)
- App Router → Execution Page: routes to (evidence: `Streamlit_result_visualization/app.py`)
- App Router → Contact Page: routes to (evidence: `Streamlit_result_visualization/app.py`)
- User → Execution Page: uploads CSV (evidence: `Streamlit_result_visualization/menu_pages/execution_page.py`)
- Execution Page → CSV Validation: validates with (evidence: `Streamlit_result_visualization/menu_pages/execution_page.py`)
- Execution Page → Model Selection: builds and loads (evidence: `Streamlit_result_visualization/menu_pages/execution_page.py`)
- Model Selection → Model Weights: loads weights (evidence: `Streamlit_result_visualization/menu_pages/execution_page.py`)
- Execution Page → Anomaly Scoring: runs inference (evidence: `Streamlit_result_visualization/menu_pages/execution_page.py`)
- Execution Page → Anomaly Visualization: plots results (evidence: `Streamlit_result_visualization/menu_pages/execution_page.py`)
- Evaluation Page → Evaluation Reports: reads reports (evidence: `Streamlit_result_visualization/menu_pages/evaluation_page.py`)
- Sensor Dataset → Training and Streaming: provides time series (evidence: `README.md`)
- Training and Streaming → Kafka: simulates streaming (evidence: `README.md`)
