# carlosbkiss/bcb-data architecture

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

- Interactive diagram: https://gitdiagram.com/carlosbkiss/bcb-data
- Repository: https://github.com/carlosbkiss/bcb-data

## Overview

Painel Cartão · Bacen is a static dashboard for credit-card market and bank metrics. Its principal workflow retrieves Bacen data, converts it into the dashboard’s JSON format, and presents time-series cards in the browser. The README documents SGS, IF.data and complaint-ranking data; the pipeline excerpt also describes SCR.data and payment-method data, but their implementation and use by the generator are not shown. The dashboard’s data-loading behavior is documented, but its source was not excerpted.

Main entry points: [`scripts/bacen_cartao_pipeline.py`](https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py) (Bacen pipeline), [`scripts/generate_data_json.py`](https://github.com/carlosbkiss/bcb-data/blob/main/scripts/generate_data_json.py) (JSON generator), [`index.html`](https://github.com/carlosbkiss/bcb-data/blob/main/index.html) (Metrics dashboard), [`docs/data.json`](https://github.com/carlosbkiss/bcb-data/blob/main/docs/data.json) (Dashboard data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sources["Bacen data sources"]
  node_sgs["SGS series"]
  node_ifdata["IF.data banks"]
  node_scr["SCR.data"]
  node_mpv["Payment methods"]
  node_ranking["Complaint ranking"]
end

subgraph group_processing["Data processing"]
  node_pipeline["Bacen pipeline"]
  node_generator["JSON generator"]
end

subgraph group_dashboard["Dashboard"]
  node_data["Dashboard data<br/>[data.json]"]
  node_panel["Metrics dashboard<br/>[index.html]"]
end

node_user(("Dashboard visitor"))
node_bacen(("Banco Central"))

node_pipeline -->|"fetches"| node_sgs
node_pipeline -->|"fetches"| node_ifdata
node_pipeline -->|"downloads"| node_ranking
node_pipeline -.->|"described source"| node_scr
node_pipeline -.->|"described source"| node_mpv
node_generator -->|"uses pipeline"| node_pipeline
node_generator -->|"writes"| node_data
node_panel -->|"fetches"| node_data
node_user -->|"views"| node_panel
node_sgs -->|"queries"| node_bacen
node_ifdata -->|"queries"| node_bacen
node_ranking -->|"downloads"| node_bacen

click node_sgs "https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py"
click node_ifdata "https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py"
click node_scr "https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py"
click node_mpv "https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py"
click node_ranking "https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py"
click node_pipeline "https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py"
click node_generator "https://github.com/carlosbkiss/bcb-data/blob/main/scripts/generate_data_json.py"
click node_data "https://github.com/carlosbkiss/bcb-data/blob/main/docs/data.json"
click node_panel "https://github.com/carlosbkiss/bcb-data/blob/main/index.html"

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_sgs,node_ifdata,node_scr,node_mpv,node_ranking toneBlue
class node_pipeline,node_generator toneAmber
class node_data,node_panel toneMint
class node_user,node_bacen toneIndigo
```

## Components

### Bacen data sources

- [SGS series](https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py): `scripts/bacen_cartao_pipeline.py`
- [IF.data banks](https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py): `scripts/bacen_cartao_pipeline.py`
- [SCR.data](https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py): `scripts/bacen_cartao_pipeline.py`
- [Payment methods](https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py): `scripts/bacen_cartao_pipeline.py`
- [Complaint ranking](https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py): `scripts/bacen_cartao_pipeline.py`

### Data processing

- [Bacen pipeline](https://github.com/carlosbkiss/bcb-data/blob/main/scripts/bacen_cartao_pipeline.py): `scripts/bacen_cartao_pipeline.py`
- [JSON generator](https://github.com/carlosbkiss/bcb-data/blob/main/scripts/generate_data_json.py): `scripts/generate_data_json.py`

### Dashboard

- [Dashboard data](https://github.com/carlosbkiss/bcb-data/blob/main/docs/data.json): `docs/data.json`
- [Metrics dashboard](https://github.com/carlosbkiss/bcb-data/blob/main/index.html): `index.html`

### Other components

- **Dashboard visitor**
- **Banco Central**

## Connections

- Bacen pipeline → SGS series: fetches (evidence: `scripts/bacen_cartao_pipeline.py`)
- Bacen pipeline → IF.data banks: fetches (evidence: `scripts/bacen_cartao_pipeline.py`)
- Bacen pipeline → Complaint ranking: downloads (evidence: `scripts/bacen_cartao_pipeline.py`)
- Bacen pipeline → SCR.data: described source (evidence: `scripts/bacen_cartao_pipeline.py`)
- Bacen pipeline → Payment methods: described source (evidence: `scripts/bacen_cartao_pipeline.py`)
- JSON generator → Bacen pipeline: uses pipeline (evidence: `scripts/generate_data_json.py`)
- JSON generator → Dashboard data: writes (evidence: `scripts/generate_data_json.py`)
- Metrics dashboard → Dashboard data: fetches (evidence: `README.md`)
- Dashboard visitor → Metrics dashboard: views (evidence: `README.md`)
- SGS series → Banco Central: queries (evidence: `scripts/bacen_cartao_pipeline.py`)
- IF.data banks → Banco Central: queries (evidence: `scripts/bacen_cartao_pipeline.py`)
- Complaint ranking → Banco Central: downloads (evidence: `scripts/bacen_cartao_pipeline.py`)
