# agusvalenti59/radar-comex-argentina architecture

> Architecture diagram of the GitHub repository agusvalenti59/radar-comex-argentina, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/agusvalenti59/radar-comex-argentina
- Repository: https://github.com/agusvalenti59/radar-comex-argentina

## Overview

Radar COMEX Argentina is a trade-intelligence data product that turns official Comtrade, INDEC, and BCRA data into export-opportunity scores, market metrics, mirror-statistics alerts, price benchmarks, and monthly export views. Its principal workflow is source extraction to landing, bronze ingestion, silver normalization and quality checks, then gold analytics for dashboard consumption. The graph also shows shared configuration, table I/O, and operational auditing. Some documented integrations and consumption components are not present in the supplied tree; those are shown as external actors, and relationships are limited to cited excerpts or README statements.

Main entry points: [`src/trade_intel/jobs/silver_build.py`](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/jobs/silver_build.py) (Silver build), [`src/trade_intel/gold/build.py`](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/gold/build.py) (Gold model build), [`src/trade_intel/common/table_io.py`](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/common/table_io.py) (Layered table I/O), [`src/trade_intel/jobs/ingest_comtrade.py`](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/jobs/ingest_comtrade.py) (Comtrade extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Source ingestion"]
  node_comtrade_job["Comtrade extraction<br/>[ingest_comtrade.py]"]
  node_comtrade_client["Comtrade client<br/>[comtrade.py]"]
  node_bcra_ingestion["BCRA ingestion<br/>[bcra.py]"]
  node_landing["Landing files<br/>[landing.py]"]
end

subgraph group_transform["Data transformation"]
  node_bronze_job["Bronze task<br/>[bronze_ingest.py]"]
  node_bronze["Bronze ingestion<br/>[ingest.py]"]
  node_silver_job["Silver build<br/>[silver_build.py]"]
  node_references["Reference dimensions<br/>[reference.py]"]
  node_trade_flows["Trade normalization<br/>[trade_flows.py]"]
  node_fx_rates["FX normalization<br/>[fx_rates.py]"]
  node_quality["Quality rules<br/>[expectations.py]"]
end

subgraph group_analytics["Trade analytics"]
  node_gold_job["Gold task<br/>[gold_build.py]"]
  node_gold_build["Gold model build<br/>[build.py]"]
  node_gold_metrics["Trade metrics<br/>[metrics.py]"]
end

subgraph group_platform["Runtime and operations"]
  node_table_io[("Layered table I/O<br/>[table_io.py]")]
  node_settings["Environment settings<br/>[config.py]"]
  node_audit["Run auditing<br/>[audit.py]"]
end

node_comtrade_api(("UN Comtrade"))
node_indec(("INDEC data"))
node_bcra_api(("BCRA API"))
node_dashboard["COMEX dashboard"]

node_comtrade_api -->|"serves requests"| node_comtrade_client
node_comtrade_job -->|"fetches data"| node_comtrade_client
node_comtrade_job -->|"writes responses"| node_landing
node_bcra_api -.->|"provides rates"| node_bcra_ingestion
node_indec -.->|"lands exports"| node_landing
node_landing -->|"reads files"| node_bronze
node_bronze_job -->|"runs ingestion"| node_bronze
node_bronze -->|"writes bronze"| node_table_io
node_silver_job -->|"loads dimensions"| node_references
node_silver_job -->|"normalizes flows"| node_trade_flows
node_silver_job -->|"normalizes FX"| node_fx_rates
node_silver_job -->|"checks records"| node_quality
node_silver_job -->|"reads and writes"| node_table_io
node_silver_job -->|"records runs"| node_audit
node_gold_job -->|"builds outputs"| node_gold_build
node_gold_build -->|"computes metrics"| node_gold_metrics
node_gold_build -->|"reads and writes"| node_table_io
node_gold_job -.->|"records runs"| node_audit
node_settings -->|"configures extraction"| node_comtrade_job
node_settings -->|"configures build"| node_silver_job
node_table_io -.->|"serves gold tables"| node_dashboard
node_gold_build -->|"produces dashboard data"| node_dashboard

click node_comtrade_job "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/jobs/ingest_comtrade.py"
click node_comtrade_client "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/ingestion/comtrade.py"
click node_bcra_ingestion "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/ingestion/bcra.py"
click node_landing "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/ingestion/landing.py"
click node_bronze_job "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/jobs/bronze_ingest.py"
click node_bronze "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/bronze/ingest.py"
click node_silver_job "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/jobs/silver_build.py"
click node_references "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/silver/reference.py"
click node_trade_flows "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/silver/trade_flows.py"
click node_fx_rates "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/silver/fx_rates.py"
click node_quality "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/quality/expectations.py"
click node_table_io "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/common/table_io.py"
click node_settings "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/config.py"
click node_audit "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/common/audit.py"
click node_gold_job "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/jobs/gold_build.py"
click node_gold_build "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/gold/build.py"
click node_gold_metrics "https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/gold/metrics.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_comtrade_job,node_comtrade_client,node_bcra_ingestion,node_landing toneBlue
class node_bronze_job,node_bronze,node_silver_job,node_references,node_trade_flows,node_fx_rates,node_quality toneAmber
class node_gold_job,node_gold_build,node_gold_metrics,node_bcra_api toneMint
class node_table_io,node_settings,node_audit toneRose
class node_comtrade_api,node_indec,node_dashboard toneIndigo
```

## Components

### Source ingestion

- [Comtrade extraction](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/jobs/ingest_comtrade.py): `src/trade_intel/jobs/ingest_comtrade.py`
- [Comtrade client](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/ingestion/comtrade.py): `src/trade_intel/ingestion/comtrade.py`
- [BCRA ingestion](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/ingestion/bcra.py): `src/trade_intel/ingestion/bcra.py`
- [Landing files](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/ingestion/landing.py): `src/trade_intel/ingestion/landing.py`

### Data transformation

- [Bronze task](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/jobs/bronze_ingest.py): `src/trade_intel/jobs/bronze_ingest.py`
- [Bronze ingestion](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/bronze/ingest.py): `src/trade_intel/bronze/ingest.py`
- [Silver build](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/jobs/silver_build.py): `src/trade_intel/jobs/silver_build.py`
- [Reference dimensions](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/silver/reference.py): `src/trade_intel/silver/reference.py`
- [Trade normalization](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/silver/trade_flows.py): `src/trade_intel/silver/trade_flows.py`
- [FX normalization](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/silver/fx_rates.py): `src/trade_intel/silver/fx_rates.py`
- [Quality rules](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/quality/expectations.py): `src/trade_intel/quality/expectations.py`

### Trade analytics

- [Gold task](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/jobs/gold_build.py): `src/trade_intel/jobs/gold_build.py`
- [Gold model build](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/gold/build.py): `src/trade_intel/gold/build.py`
- [Trade metrics](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/gold/metrics.py): `src/trade_intel/gold/metrics.py`

### Runtime and operations

- [Layered table I/O](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/common/table_io.py): `src/trade_intel/common/table_io.py`
- [Environment settings](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/config.py): `src/trade_intel/config.py`
- [Run auditing](https://github.com/agusvalenti59/radar-comex-argentina/blob/main/src/trade_intel/common/audit.py): `src/trade_intel/common/audit.py`

### Other components

- **UN Comtrade**
- **INDEC data**
- **BCRA API**
- **COMEX dashboard**

## Connections

- UN Comtrade → Comtrade client: serves requests (evidence: `src/trade_intel/ingestion/comtrade.py`)
- Comtrade extraction → Comtrade client: fetches data (evidence: `src/trade_intel/jobs/ingest_comtrade.py`)
- Comtrade extraction → Landing files: writes responses (evidence: `src/trade_intel/jobs/ingest_comtrade.py`)
- BCRA API → BCRA ingestion: provides rates
- INDEC data → Landing files: lands exports
- Landing files → Bronze ingestion: reads files (evidence: `src/trade_intel/bronze/ingest.py`)
- Bronze task → Bronze ingestion: runs ingestion (evidence: `src/trade_intel/jobs/bronze_ingest.py`)
- Bronze ingestion → Layered table I/O: writes bronze (evidence: `src/trade_intel/bronze/ingest.py`)
- Silver build → Reference dimensions: loads dimensions (evidence: `src/trade_intel/jobs/silver_build.py`)
- Silver build → Trade normalization: normalizes flows (evidence: `src/trade_intel/jobs/silver_build.py`)
- Silver build → FX normalization: normalizes FX (evidence: `src/trade_intel/jobs/silver_build.py`)
- Silver build → Quality rules: checks records (evidence: `src/trade_intel/jobs/silver_build.py`)
- Silver build → Layered table I/O: reads and writes (evidence: `src/trade_intel/jobs/silver_build.py`)
- Silver build → Run auditing: records runs (evidence: `src/trade_intel/jobs/silver_build.py`)
- Gold task → Gold model build: builds outputs (evidence: `src/trade_intel/jobs/gold_build.py`)
- Gold model build → Trade metrics: computes metrics (evidence: `src/trade_intel/gold/build.py`)
- Gold model build → Layered table I/O: reads and writes (evidence: `src/trade_intel/gold/build.py`)
- Gold task → Run auditing: records runs (evidence: `src/trade_intel/jobs/gold_build.py`)
- Environment settings → Comtrade extraction: configures extraction (evidence: `src/trade_intel/jobs/ingest_comtrade.py`)
- Environment settings → Silver build: configures build (evidence: `src/trade_intel/jobs/silver_build.py`)
- Layered table I/O → COMEX dashboard: serves gold tables
- Gold model build → COMEX dashboard: produces dashboard data
