# shaleen410/alert-o-monitor architecture

> Architecture diagram of the GitHub repository shaleen410/alert-o-monitor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shaleen410/alert-o-monitor
- Repository: https://github.com/shaleen410/alert-o-monitor

## Overview

Alert-O-Monitor is a notebook-driven early-warning-signal analytics solution. Its documented flow loads raw and lookup data into a Microsoft Lakehouse, runs data-engineering notebooks, and builds a semantic model and Power BI report. Separate notebooks support loan prediction, product recommendations, and voice analytics; voice analytics requires audio in Azure Storage and OpenAI credentials. The README describes alert generation, monitoring, and resolution as product goals, but the available files do not show their implementation. Relationships below are based on README statements; notebook internals were not available.

Main entry points: [`Data Science/Notebooks/voice_analytics.ipynb`](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Science/Notebooks/voice_analytics.ipynb) (Voice analytics), [`Data Engineering/Raw Files`](https://github.com/shaleen410/alert-o-monitor/tree/main/Data%20Engineering/Raw%20Files) (Raw data), [`Data Engineering/Lookup Files`](https://github.com/shaleen410/alert-o-monitor/tree/main/Data%20Engineering/Lookup%20Files) (Lookup data), [`Data Science/Audio Files`](https://github.com/shaleen410/alert-o-monitor/tree/main/Data%20Science/Audio%20Files) (Audio files)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_engineering["Data Engineering"]
  node_raw[("Raw data")]
  node_lookups[("Lookup data")]
  node_lakehouse[("AOM Lakehouse")]
  node_dpd["DPD analysis<br/>[DPD.ipynb]"]
  node_externalprep["External preparation"]
  node_financialprep["Financial preparation"]
  node_internalprep["Internal preparation"]
  node_paymentprep["Payments preparation"]
  node_operationalprep["Operational preparation"]
  node_main["Main notebook<br/>[main.ipynb]"]
end

subgraph group_science["Data Science"]
  node_loanprediction["Loan prediction"]
  node_recommendations["Product recommendations"]
  node_voice["Voice analytics"]
  node_audio["Audio files"]
end

subgraph group_analytics["Analytics"]
  node_semantic["Semantic model"]
  node_report["Power BI report"]
end

node_user(("User / operator"))
node_storage[("Azure Storage Gen2")]
node_openai["OpenAI service"]

node_user -->|"creates"| node_lakehouse
node_user -->|"uploads"| node_raw
node_user -->|"uploads"| node_lookups
node_user -->|"runs"| node_dpd
node_user -->|"runs"| node_externalprep
node_user -->|"runs"| node_financialprep
node_user -->|"runs"| node_internalprep
node_user -->|"runs"| node_paymentprep
node_user -->|"runs"| node_operationalprep
node_user -->|"runs last"| node_main
node_raw -->|"loads into"| node_lakehouse
node_lookups -->|"loads into"| node_lakehouse
node_lakehouse -->|"provides data"| node_semantic
node_lakehouse -->|"report uses"| node_report
node_user -->|"runs"| node_loanprediction
node_user -->|"runs"| node_recommendations
node_user -->|"runs"| node_voice
node_audio -->|"uploaded to"| node_storage
node_storage -->|"provides audio"| node_voice
node_openai -.->|"credential required"| node_voice

click node_raw "https://github.com/shaleen410/alert-o-monitor/tree/main/Data%20Engineering/Raw%20Files"
click node_lookups "https://github.com/shaleen410/alert-o-monitor/tree/main/Data%20Engineering/Lookup%20Files"
click node_dpd "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DPD.ipynb"
click node_externalprep "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DataPrepareForExternal1.ipynb"
click node_financialprep "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DataPrepareForFinancial.ipynb"
click node_internalprep "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DataPrepareForInternal.ipynb"
click node_paymentprep "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DataPrepareForPayments.ipynb"
click node_operationalprep "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DataPreparingForOperational.ipynb"
click node_main "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/main.ipynb"
click node_loanprediction "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Science/Notebooks/loan_prediction_new.ipynb"
click node_recommendations "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Science/Notebooks/product_recommendations.ipynb"
click node_voice "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Science/Notebooks/voice_analytics.ipynb"
click node_audio "https://github.com/shaleen410/alert-o-monitor/tree/main/Data%20Science/Audio%20Files"
click node_semantic "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Analysis/AOM_report%201%20-%20Semantic%20model.pbix"
click node_report "https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Analysis/AOM_report%201%20-%20Semantic%20model.pbix"

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_raw,node_lookups,node_lakehouse,node_dpd,node_externalprep,node_financialprep,node_internalprep,node_paymentprep,node_operationalprep,node_main,node_user toneBlue
class node_loanprediction,node_recommendations,node_voice,node_audio,node_storage toneAmber
class node_semantic,node_report toneMint
class node_openai toneIndigo
```

## Components

### Data Engineering

- [Raw data](https://github.com/shaleen410/alert-o-monitor/tree/main/Data%20Engineering/Raw%20Files): `Data Engineering/Raw Files`
- [Lookup data](https://github.com/shaleen410/alert-o-monitor/tree/main/Data%20Engineering/Lookup%20Files): `Data Engineering/Lookup Files`
- **AOM Lakehouse**
- [DPD analysis](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DPD.ipynb): `Data Engineering/Notebooks/DPD.ipynb`
- [External preparation](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DataPrepareForExternal1.ipynb): `Data Engineering/Notebooks/DataPrepareForExternal1.ipynb`
- [Financial preparation](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DataPrepareForFinancial.ipynb): `Data Engineering/Notebooks/DataPrepareForFinancial.ipynb`
- [Internal preparation](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DataPrepareForInternal.ipynb): `Data Engineering/Notebooks/DataPrepareForInternal.ipynb`
- [Payments preparation](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DataPrepareForPayments.ipynb): `Data Engineering/Notebooks/DataPrepareForPayments.ipynb`
- [Operational preparation](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/DataPreparingForOperational.ipynb): `Data Engineering/Notebooks/DataPreparingForOperational.ipynb`
- [Main notebook](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Engineering/Notebooks/main.ipynb): `Data Engineering/Notebooks/main.ipynb`

### Data Science

- [Loan prediction](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Science/Notebooks/loan_prediction_new.ipynb): `Data Science/Notebooks/loan_prediction_new.ipynb`
- [Product recommendations](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Science/Notebooks/product_recommendations.ipynb): `Data Science/Notebooks/product_recommendations.ipynb`
- [Voice analytics](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Science/Notebooks/voice_analytics.ipynb): `Data Science/Notebooks/voice_analytics.ipynb`
- [Audio files](https://github.com/shaleen410/alert-o-monitor/tree/main/Data%20Science/Audio%20Files): `Data Science/Audio Files`

### Analytics

- [Semantic model](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Analysis/AOM_report%201%20-%20Semantic%20model.pbix): `Data Analysis/AOM_report 1 - Semantic model.pbix`
- [Power BI report](https://github.com/shaleen410/alert-o-monitor/blob/main/Data%20Analysis/AOM_report%201%20-%20Semantic%20model.pbix): `Data Analysis/AOM_report 1 - Semantic model.pbix`

### Other components

- **User / operator**
- **Azure Storage Gen2**
- **OpenAI service**

## Connections

- User / operator → AOM Lakehouse: creates (evidence: `README.md`)
- User / operator → Raw data: uploads (evidence: `README.md`)
- User / operator → Lookup data: uploads (evidence: `README.md`)
- User / operator → DPD analysis: runs (evidence: `README.md`)
- User / operator → External preparation: runs (evidence: `README.md`)
- User / operator → Financial preparation: runs (evidence: `README.md`)
- User / operator → Internal preparation: runs (evidence: `README.md`)
- User / operator → Payments preparation: runs (evidence: `README.md`)
- User / operator → Operational preparation: runs (evidence: `README.md`)
- User / operator → Main notebook: runs last (evidence: `README.md`)
- Raw data → AOM Lakehouse: loads into (evidence: `README.md`)
- Lookup data → AOM Lakehouse: loads into (evidence: `README.md`)
- AOM Lakehouse → Semantic model: provides data (evidence: `README.md`)
- AOM Lakehouse → Power BI report: report uses (evidence: `README.md`)
- User / operator → Loan prediction: runs (evidence: `README.md`)
- User / operator → Product recommendations: runs (evidence: `README.md`)
- User / operator → Voice analytics: runs (evidence: `README.md`)
- Audio files → Azure Storage Gen2: uploaded to (evidence: `README.md`)
- Azure Storage Gen2 → Voice analytics: provides audio (evidence: `README.md`)
- OpenAI service → Voice analytics: credential required (evidence: `README.md`)
