# ezariya/air-quality-dataops-mlops architecture

> Architecture diagram of the GitHub repository ezariya/air-quality-dataops-mlops, 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/ezariya/air-quality-dataops-mlops
- Repository: https://github.com/ezariya/air-quality-dataops-mlops

## Overview

This is a small air-quality project scaffold; the shown runtime behavior is a Kafka producer demo, not a demonstrated OpenAQ ingestion pipeline. The demo creates a producer, publishes a sample message using configured topic settings, and flushes it; the producer uses configured broker settings. OpenAQ and normalization modules have empty excerpts, so their behavior and connections are not established here. The scripts and sample data concern dataset inspection rather than the runtime workflow.

Main entry points: [`src/air_quality/kafka/producer.py`](https://github.com/ezariya/air-quality-dataops-mlops/blob/main/src/air_quality/kafka/producer.py) (Kafka producer), [`src/air_quality/producer_demo.py`](https://github.com/ezariya/air-quality-dataops-mlops/blob/main/src/air_quality/producer_demo.py) (Producer demo), [`src/air_quality/config.py`](https://github.com/ezariya/air-quality-dataops-mlops/blob/main/src/air_quality/config.py) (Runtime settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Kafka publishing"]
  node_demo["Producer demo<br/>[producer_demo.py]"]
  node_producer["Kafka producer<br/>[producer.py]"]
  node_settings["Runtime settings<br/>[config.py]"]
end

node_kafka["Kafka broker"]

node_demo -->|"reads topic"| node_settings
node_demo -->|"creates producer"| node_producer
node_producer -->|"reads broker config"| node_settings
node_producer -->|"publishes messages"| node_kafka

click node_demo "https://github.com/ezariya/air-quality-dataops-mlops/blob/main/src/air_quality/producer_demo.py"
click node_producer "https://github.com/ezariya/air-quality-dataops-mlops/blob/main/src/air_quality/kafka/producer.py"
click node_settings "https://github.com/ezariya/air-quality-dataops-mlops/blob/main/src/air_quality/config.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_demo,node_producer,node_settings toneBlue
class node_kafka toneIndigo
```

## Components

### Kafka publishing

- [Producer demo](https://github.com/ezariya/air-quality-dataops-mlops/blob/main/src/air_quality/producer_demo.py): `src/air_quality/producer_demo.py`
- [Kafka producer](https://github.com/ezariya/air-quality-dataops-mlops/blob/main/src/air_quality/kafka/producer.py): `src/air_quality/kafka/producer.py`
- [Runtime settings](https://github.com/ezariya/air-quality-dataops-mlops/blob/main/src/air_quality/config.py): `src/air_quality/config.py`

### Other components

- **Kafka broker**

## Connections

- Producer demo → Runtime settings: reads topic (evidence: `src/air_quality/producer_demo.py`)
- Producer demo → Kafka producer: creates producer (evidence: `src/air_quality/producer_demo.py`)
- Kafka producer → Runtime settings: reads broker config (evidence: `src/air_quality/kafka/producer.py`)
- Kafka producer → Kafka broker: publishes messages
