# danielfelromero/aa-dev architecture

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

- Interactive diagram: https://gitdiagram.com/danielfelromero/aa-dev
- Repository: https://github.com/danielfelromero/aa-dev

## Overview

AA Dev is a teaching example of an analytics Lakehouse and churn-prediction workflow, not a production platform. Its main path ingests a CSV into Bronze, transforms and pseudonymizes it into Silver, prepares Gold features, trains a model, and serves predictions; a separate observation script checks data quality and drift. The graph follows the sampled script calls and file reads/writes. README-described capabilities such as service observability and broader Lakehouse trade-offs are not expanded into unsampled implementation details.

Main entry points: [`scripts/02_transform.py`](https://github.com/danielfelromero/aa-dev/blob/main/scripts/02_transform.py) (Silver Transform), [`scripts/01_ingest.py`](https://github.com/danielfelromero/aa-dev/blob/main/scripts/01_ingest.py) (Bronze Ingestion), [`scripts/03_train.py`](https://github.com/danielfelromero/aa-dev/blob/main/scripts/03_train.py) (Model Training), [`scripts/05_observe.py`](https://github.com/danielfelromero/aa-dev/blob/main/scripts/05_observe.py) (Data Observation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lakehouse["Lakehouse Data"]
  node_ingest["Bronze Ingestion<br/>[01_ingest.py]"]
  node_bronze[("Bronze Delta<br/>[01_ingest.py]")]
  node_transform["Silver Transform<br/>[02_transform.py]"]
  node_quality["Quality and Privacy<br/>[quality.py]"]
  node_silver[("Silver Delta<br/>[02_transform.py]")]
  node_features["Feature Dataset<br/>[features.py]"]
  node_gold[("Gold Parquet<br/>[02_transform.py]")]
end

subgraph group_ml["ML Workflow"]
  node_training["Model Training<br/>[03_train.py]"]
  node_model["Trained Model<br/>[03_train.py]"]
  node_serving["Prediction API<br/>[04_serve.py]"]
end

subgraph group_ops["Observation"]
  node_observe["Data Observation<br/>[05_observe.py]"]
  node_monitoring["Quality and Drift<br/>[monitoring.py]"]
end

node_source["Customer CSV<br/>[customers.csv]"]
node_client(("API Client"))

node_source -->|"reads CSV"| node_ingest
node_ingest -->|"writes Delta"| node_bronze
node_bronze -->|"reads Delta"| node_transform
node_transform -->|"calls transform"| node_quality
node_transform -->|"writes Delta"| node_silver
node_transform -->|"builds features"| node_features
node_transform -->|"writes Parquet"| node_gold
node_gold -->|"reads dataset"| node_training
node_training -->|"saves model"| node_model
node_model -->|"loads model"| node_serving
node_client -->|"requests predictions"| node_serving
node_gold -->|"reads dataset"| node_observe
node_observe -->|"calls metrics"| node_monitoring

click node_source "https://github.com/danielfelromero/aa-dev/blob/main/data/source/customers.csv"
click node_ingest "https://github.com/danielfelromero/aa-dev/blob/main/scripts/01_ingest.py"
click node_bronze "https://github.com/danielfelromero/aa-dev/blob/main/scripts/01_ingest.py"
click node_transform "https://github.com/danielfelromero/aa-dev/blob/main/scripts/02_transform.py"
click node_quality "https://github.com/danielfelromero/aa-dev/blob/main/src/aa_dev/quality.py"
click node_silver "https://github.com/danielfelromero/aa-dev/blob/main/scripts/02_transform.py"
click node_features "https://github.com/danielfelromero/aa-dev/blob/main/src/aa_dev/features.py"
click node_gold "https://github.com/danielfelromero/aa-dev/blob/main/scripts/02_transform.py"
click node_training "https://github.com/danielfelromero/aa-dev/blob/main/scripts/03_train.py"
click node_model "https://github.com/danielfelromero/aa-dev/blob/main/scripts/03_train.py"
click node_serving "https://github.com/danielfelromero/aa-dev/blob/main/scripts/04_serve.py"
click node_observe "https://github.com/danielfelromero/aa-dev/blob/main/scripts/05_observe.py"
click node_monitoring "https://github.com/danielfelromero/aa-dev/blob/main/src/aa_dev/monitoring.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_ingest,node_bronze,node_transform,node_quality,node_silver,node_features,node_gold,node_client toneBlue
class node_training,node_model,node_serving toneAmber
class node_observe,node_monitoring toneMint
class node_source toneTeal
```

## Components

### Lakehouse Data

- [Bronze Ingestion](https://github.com/danielfelromero/aa-dev/blob/main/scripts/01_ingest.py): `scripts/01_ingest.py`
- [Bronze Delta](https://github.com/danielfelromero/aa-dev/blob/main/scripts/01_ingest.py): `scripts/01_ingest.py`
- [Silver Transform](https://github.com/danielfelromero/aa-dev/blob/main/scripts/02_transform.py): `scripts/02_transform.py`
- [Quality and Privacy](https://github.com/danielfelromero/aa-dev/blob/main/src/aa_dev/quality.py): `src/aa_dev/quality.py`
- [Silver Delta](https://github.com/danielfelromero/aa-dev/blob/main/scripts/02_transform.py): `scripts/02_transform.py`
- [Feature Dataset](https://github.com/danielfelromero/aa-dev/blob/main/src/aa_dev/features.py): `src/aa_dev/features.py`
- [Gold Parquet](https://github.com/danielfelromero/aa-dev/blob/main/scripts/02_transform.py): `scripts/02_transform.py`

### ML Workflow

- [Model Training](https://github.com/danielfelromero/aa-dev/blob/main/scripts/03_train.py): `scripts/03_train.py`
- [Trained Model](https://github.com/danielfelromero/aa-dev/blob/main/scripts/03_train.py): `scripts/03_train.py`
- [Prediction API](https://github.com/danielfelromero/aa-dev/blob/main/scripts/04_serve.py): `scripts/04_serve.py`

### Observation

- [Data Observation](https://github.com/danielfelromero/aa-dev/blob/main/scripts/05_observe.py): `scripts/05_observe.py`
- [Quality and Drift](https://github.com/danielfelromero/aa-dev/blob/main/src/aa_dev/monitoring.py): `src/aa_dev/monitoring.py`

### Other components

- [Customer CSV](https://github.com/danielfelromero/aa-dev/blob/main/data/source/customers.csv): `data/source/customers.csv`
- **API Client**

## Connections

- Customer CSV → Bronze Ingestion: reads CSV (evidence: `scripts/01_ingest.py`)
- Bronze Ingestion → Bronze Delta: writes Delta (evidence: `scripts/01_ingest.py`)
- Bronze Delta → Silver Transform: reads Delta (evidence: `scripts/02_transform.py`)
- Silver Transform → Quality and Privacy: calls transform (evidence: `scripts/02_transform.py`)
- Silver Transform → Silver Delta: writes Delta (evidence: `scripts/02_transform.py`)
- Silver Transform → Feature Dataset: builds features (evidence: `scripts/02_transform.py`)
- Silver Transform → Gold Parquet: writes Parquet (evidence: `scripts/02_transform.py`)
- Gold Parquet → Model Training: reads dataset (evidence: `scripts/03_train.py`)
- Model Training → Trained Model: saves model (evidence: `scripts/03_train.py`)
- Trained Model → Prediction API: loads model (evidence: `scripts/04_serve.py`)
- API Client → Prediction API: requests predictions (evidence: `README.md`)
- Gold Parquet → Data Observation: reads dataset (evidence: `scripts/05_observe.py`)
- Data Observation → Quality and Drift: calls metrics (evidence: `scripts/05_observe.py`)
