# syedmuhammadubaidurrehman22/aegisquant architecture

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

- Interactive diagram: https://gitdiagram.com/syedmuhammadubaidurrehman22/aegisquant
- Repository: https://github.com/syedmuhammadubaidurrehman22/aegisquant

## Overview

AegisQuant currently delivers its reproducible foundation, audited daily market-data ingestion, and point-in-time feature materialization; the README says modeling, portfolio management, execution, and backtesting are not yet implemented. The primary workflow is to ingest and validate canonical OHLCV data, persist it with audit evidence, then compute and store versioned features as of an explicit cutoff. The graph focuses on these implemented stages and the liveness API. Some subsystem links are based on README descriptions or source-index references; unsampled implementations are not treated as inspected.

Main entry points: [`data_pipeline/cli.py`](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/cli.py) (Pipeline CLI), [`data_pipeline/ingestion/service.py`](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/service.py) (Ingestion orchestration), [`feature_engineering/service.py`](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/service.py) (Feature orchestration), [`data_pipeline/ingestion/repository.py`](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/repository.py) (Market data repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation["Foundation"]
  node_settings["Runtime settings<br/>[settings.py]"]
end

subgraph group_ingestion["Market Data"]
  node_ingest_cli["Pipeline CLI<br/>[cli.py]"]
  node_universe["Approved universe<br/>[universe.py]"]
  node_ingest_service["Ingestion orchestration<br/>[service.py]"]
  node_provider["Yahoo adapter<br/>[provider.py]"]
  node_normalization["Bar normalization<br/>[normalization.py]"]
  node_quality["Quality validation<br/>[validation.py]"]
  node_snapshots["Raw snapshots<br/>[snapshots.py]"]
  node_repository["Market data repository<br/>[repository.py]"]
  node_contracts["Canonical contracts<br/>[domain.py]"]
  node_market_db[("Market data tables<br/>[tables.py]")]
  node_secondary["Alpha Vantage check<br/>[second_source.py]"]
end

subgraph group_features["Feature Engineering"]
  node_feature_cli["Feature CLI<br/>[cli.py]"]
  node_feature_service["Feature orchestration<br/>[service.py]"]
  node_feature_access["Canonical bar access<br/>[access.py]"]
  node_registry["Feature definitions<br/>[registry.py]"]
  node_computation["Feature computation<br/>[computation.py]"]
  node_persistence["Feature persistence<br/>[persistence.py]"]
  node_feature_db[("Feature tables<br/>[tables.py]")]
end

subgraph group_service["Health API"]
  node_health_main["Health application<br/>[main.py]"]
  node_health_router["Health routes<br/>[router.py]"]
end

node_operator(("Research operator"))
node_health_client(("API client"))

node_operator -->|"runs commands"| node_ingest_cli
node_operator -->|"requests materialization"| node_feature_cli
node_ingest_cli -->|"loads settings"| node_settings
node_ingest_cli -->|"selects symbols"| node_universe
node_ingest_cli -->|"runs ingestion"| node_ingest_service
node_ingest_cli -->|"seeds and inspects"| node_repository
node_ingest_cli -->|"runs comparison"| node_secondary
node_ingest_service -->|"fetches batches"| node_provider
node_ingest_service -->|"normalizes data"| node_normalization
node_ingest_service -->|"validates batches"| node_quality
node_ingest_service -->|"stores snapshots"| node_snapshots
node_ingest_service -->|"records runs"| node_repository
node_repository -->|"reads and writes"| node_market_db
node_secondary -->|"reads canonical data"| node_repository
node_feature_cli -->|"requests work"| node_feature_service
node_feature_service -->|"loads bars"| node_feature_access
node_feature_service -->|"computes observations"| node_computation
node_feature_service -->|"stores observations"| node_persistence
node_feature_service -->|"selects definitions"| node_registry
node_feature_service -.->|"reads canonical bars"| node_market_db
node_feature_access -->|"reads bars"| node_market_db
node_persistence -->|"reads and writes"| node_feature_db
node_health_client -->|"calls API"| node_health_main
node_health_main -->|"registers routes"| node_health_router
node_health_router -->|"uses app settings"| node_settings

click node_settings "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/config/settings.py"
click node_ingest_cli "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/cli.py"
click node_universe "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/universe.py"
click node_ingest_service "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/service.py"
click node_provider "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/provider.py"
click node_normalization "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/normalization.py"
click node_quality "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/quality_checks/validation.py"
click node_snapshots "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/snapshots.py"
click node_repository "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/repository.py"
click node_contracts "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/schema/domain.py"
click node_market_db "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/schema/tables.py"
click node_secondary "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/validation/second_source.py"
click node_feature_cli "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/cli.py"
click node_feature_service "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/service.py"
click node_feature_access "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/access.py"
click node_registry "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/registry.py"
click node_computation "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/computation.py"
click node_persistence "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/persistence.py"
click node_feature_db "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/tables.py"
click node_health_main "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/services/health_service/main.py"
click node_health_router "https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/services/health_service/router.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_settings,node_health_client toneBlue
class node_ingest_cli,node_universe,node_ingest_service,node_provider,node_normalization,node_quality,node_snapshots,node_repository,node_contracts,node_market_db,node_secondary toneAmber
class node_feature_cli,node_feature_service,node_feature_access,node_registry,node_computation,node_persistence,node_feature_db toneMint
class node_health_main,node_health_router toneRose
class node_operator toneIndigo
```

## Components

### Foundation

- [Runtime settings](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/config/settings.py): `config/settings.py`

### Market Data

- [Pipeline CLI](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/cli.py): `data_pipeline/cli.py`
- [Approved universe](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/universe.py): `data_pipeline/universe.py`
- [Ingestion orchestration](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/service.py): `data_pipeline/ingestion/service.py`
- [Yahoo adapter](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/provider.py): `data_pipeline/ingestion/provider.py`
- [Bar normalization](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/normalization.py): `data_pipeline/ingestion/normalization.py`
- [Quality validation](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/quality_checks/validation.py): `data_pipeline/quality_checks/validation.py`
- [Raw snapshots](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/snapshots.py): `data_pipeline/ingestion/snapshots.py`
- [Market data repository](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/ingestion/repository.py): `data_pipeline/ingestion/repository.py`
- [Canonical contracts](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/schema/domain.py): `data_pipeline/schema/domain.py`
- [Market data tables](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/schema/tables.py): `data_pipeline/schema/tables.py`
- [Alpha Vantage check](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/data_pipeline/validation/second_source.py): `data_pipeline/validation/second_source.py`

### Feature Engineering

- [Feature CLI](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/cli.py): `feature_engineering/cli.py`
- [Feature orchestration](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/service.py): `feature_engineering/service.py`
- [Canonical bar access](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/access.py): `feature_engineering/access.py`
- [Feature definitions](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/registry.py): `feature_engineering/registry.py`
- [Feature computation](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/computation.py): `feature_engineering/computation.py`
- [Feature persistence](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/persistence.py): `feature_engineering/persistence.py`
- [Feature tables](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/feature_engineering/tables.py): `feature_engineering/tables.py`

### Health API

- [Health application](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/services/health_service/main.py): `services/health_service/main.py`
- [Health routes](https://github.com/syedmuhammadubaidurrehman22/aegisquant/blob/main/services/health_service/router.py): `services/health_service/router.py`

### Other components

- **Research operator**
- **API client**

## Connections

- Research operator → Pipeline CLI: runs commands (evidence: `README.md`)
- Research operator → Feature CLI: requests materialization (evidence: `README.md`)
- Pipeline CLI → Runtime settings: loads settings (evidence: `data_pipeline/cli.py`)
- Pipeline CLI → Approved universe: selects symbols (evidence: `data_pipeline/cli.py`)
- Pipeline CLI → Ingestion orchestration: runs ingestion (evidence: `data_pipeline/cli.py`)
- Pipeline CLI → Market data repository: seeds and inspects (evidence: `data_pipeline/cli.py`)
- Pipeline CLI → Alpha Vantage check: runs comparison (evidence: `data_pipeline/cli.py`)
- Ingestion orchestration → Yahoo adapter: fetches batches (evidence: `data_pipeline/ingestion/service.py`)
- Ingestion orchestration → Bar normalization: normalizes data (evidence: `data_pipeline/ingestion/service.py`)
- Ingestion orchestration → Quality validation: validates batches (evidence: `data_pipeline/ingestion/service.py`)
- Ingestion orchestration → Raw snapshots: stores snapshots (evidence: `data_pipeline/ingestion/service.py`)
- Ingestion orchestration → Market data repository: records runs (evidence: `data_pipeline/ingestion/service.py`)
- Market data repository → Market data tables: reads and writes (evidence: `data_pipeline/ingestion/repository.py`)
- Alpha Vantage check → Market data repository: reads canonical data (evidence: `data_pipeline/validation/second_source.py`)
- Feature CLI → Feature orchestration: requests work (evidence: `README.md`)
- Feature orchestration → Canonical bar access: loads bars (evidence: `feature_engineering/service.py`)
- Feature orchestration → Feature computation: computes observations (evidence: `feature_engineering/service.py`)
- Feature orchestration → Feature persistence: stores observations (evidence: `feature_engineering/service.py`)
- Feature orchestration → Feature definitions: selects definitions (evidence: `feature_engineering/service.py`)
- Feature orchestration → Market data tables: reads canonical bars (evidence: `README.md`)
- Canonical bar access → Market data tables: reads bars (evidence: `feature_engineering/access.py`)
- Feature persistence → Feature tables: reads and writes (evidence: `feature_engineering/persistence.py`)
- API client → Health application: calls API (evidence: `README.md`)
- Health application → Health routes: registers routes (evidence: `services/health_service/main.py`)
- Health routes → Runtime settings: uses app settings (evidence: `services/health_service/router.py`)
