# fsegurado/bi-ds---maior-clube-do-centro-oeste architecture

> Architecture diagram of the GitHub repository fsegurado/bi-ds---maior-clube-do-centro-oeste, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fsegurado/bi-ds---maior-clube-do-centro-oeste
- Repository: https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste

## Overview

Este repositório é um pipeline Python que transforma resultados históricos de futebol em tabelas para análise no Power BI. O fluxo principal verifica a cobertura por competição e temporada, seleciona clubes com participação na Série A ou B, monta fatos de participação e calcula pontuações-base e dimensões analíticas. O README documenta também fontes alternativas e correções manuais. As relações entre etapas seguem o orquestrador e as entradas/saídas descritas; não foram inspecionados os trechos omitidos dos scripts.

Main entry points: [`scripts/03_fato_participacao.py`](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/03_fato_participacao.py) (Fato de participação), [`scripts/04_pontuacao.py`](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/04_pontuacao.py) (Pontuação e dimensões BI), [`rodar_pipeline.py`](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/rodar_pipeline.py) (Pipeline completo), [`scripts/02_dim_times.py`](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/02_dim_times.py) (Participações e seleção)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Orquestração"]
  node_runner["Pipeline completo<br/>[rodar_pipeline.py]"]
end

subgraph group_sources["Fontes e ingestão"]
  node_coverage["Cobertura de dados"]
  node_common["Ingestão e detecção<br/>[rsssf_comum.py]"]
  node_manual_sources["Dados manuais"]
  node_historical_tables["Históricos estaduais"]
end

subgraph group_model["Modelo de dados"]
  node_club_selection["Participações e seleção<br/>[02_dim_times.py]"]
  node_team_dim["Dimensão de clubes<br/>[02_dim_times.py]"]
  node_participation["Fato de participação"]
  node_competition_dim["Dimensão de competição"]
end

subgraph group_analytics["Preparação analítica"]
  node_scoring["Pontuação e dimensões BI<br/>[04_pontuacao.py]"]
  node_scored_fact["Fato pontuado<br/>[04_pontuacao.py]"]
  node_bi_dimensions["Dimensões e cenários<br/>[04_pontuacao.py]"]
  node_processed["Tabelas processadas"]
end

node_analyst(("Analista"))
node_web_sources(("RSSSF e fontes alternativas"))
node_powerbi["Relatório Power BI"]

node_analyst -->|"executa"| node_runner
node_runner -->|"inicia etapa"| node_coverage
node_runner -->|"inicia etapa"| node_club_selection
node_runner -->|"inicia etapa"| node_participation
node_runner -->|"inicia etapa"| node_scoring
node_coverage -->|"usa funções"| node_common
node_club_selection -->|"usa funções"| node_common
node_participation -->|"usa funções"| node_common
node_common -->|"baixa páginas"| node_web_sources
node_club_selection -->|"lê participações"| node_manual_sources
node_participation -->|"aplica correções"| node_manual_sources
node_club_selection -->|"gera dimensão"| node_team_dim
node_club_selection -->|"fornece clubes"| node_participation
node_coverage -->|"fornece cobertura"| node_participation
node_participation -->|"gera dimensão"| node_competition_dim
node_participation -->|"fornece participações"| node_scoring
node_team_dim -->|"fornece clubes"| node_scoring
node_coverage -->|"fornece cobertura"| node_scoring
node_scoring -->|"gera pontuação"| node_scored_fact
node_scoring -->|"gera dimensões"| node_bi_dimensions
node_scored_fact -->|"grava tabelas"| node_processed
node_bi_dimensions -->|"grava tabelas"| node_processed
node_processed -->|"alimenta relatório"| node_powerbi
node_analyst -->|"analisa resultados"| node_powerbi

click node_runner "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/rodar_pipeline.py"
click node_coverage "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/01_cobertura_dados.py"
click node_common "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/rsssf_comum.py"
click node_manual_sources "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/tree/main/dados/manual"
click node_club_selection "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/02_dim_times.py"
click node_team_dim "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/02_dim_times.py"
click node_participation "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/03_fato_participacao.py"
click node_competition_dim "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/03_fato_participacao.py"
click node_historical_tables "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/tree/main/dados/historico-estadual"
click node_scoring "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/04_pontuacao.py"
click node_scored_fact "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/04_pontuacao.py"
click node_bi_dimensions "https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/04_pontuacao.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_runner toneBlue
class node_coverage,node_common,node_manual_sources,node_historical_tables toneAmber
class node_club_selection,node_team_dim,node_participation,node_competition_dim toneMint
class node_scoring,node_scored_fact,node_bi_dimensions,node_processed toneRose
class node_analyst,node_web_sources,node_powerbi toneIndigo
```

## Components

### Orquestração

- [Pipeline completo](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/rodar_pipeline.py): `rodar_pipeline.py`

### Fontes e ingestão

- [Cobertura de dados](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/01_cobertura_dados.py): `scripts/01_cobertura_dados.py`
- [Ingestão e detecção](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/rsssf_comum.py): `scripts/rsssf_comum.py`
- [Dados manuais](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/tree/main/dados/manual): `dados/manual`
- [Históricos estaduais](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/tree/main/dados/historico-estadual): `dados/historico-estadual`

### Modelo de dados

- [Participações e seleção](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/02_dim_times.py): `scripts/02_dim_times.py`
- [Dimensão de clubes](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/02_dim_times.py): `scripts/02_dim_times.py`
- [Fato de participação](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/03_fato_participacao.py): `scripts/03_fato_participacao.py`
- [Dimensão de competição](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/03_fato_participacao.py): `scripts/03_fato_participacao.py`

### Preparação analítica

- [Pontuação e dimensões BI](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/04_pontuacao.py): `scripts/04_pontuacao.py`
- [Fato pontuado](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/04_pontuacao.py): `scripts/04_pontuacao.py`
- [Dimensões e cenários](https://github.com/fsegurado/bi-ds---maior-clube-do-centro-oeste/blob/main/scripts/04_pontuacao.py): `scripts/04_pontuacao.py`
- **Tabelas processadas**

### Other components

- **Analista**
- **RSSSF e fontes alternativas**
- **Relatório Power BI**

## Connections

- Analista → Pipeline completo: executa (evidence: `README.md`)
- Pipeline completo → Cobertura de dados: inicia etapa (evidence: `rodar_pipeline.py`)
- Pipeline completo → Participações e seleção: inicia etapa (evidence: `rodar_pipeline.py`)
- Pipeline completo → Fato de participação: inicia etapa (evidence: `rodar_pipeline.py`)
- Pipeline completo → Pontuação e dimensões BI: inicia etapa (evidence: `rodar_pipeline.py`)
- Cobertura de dados → Ingestão e detecção: usa funções (evidence: `scripts/01_cobertura_dados.py`)
- Participações e seleção → Ingestão e detecção: usa funções (evidence: `scripts/02_dim_times.py`)
- Fato de participação → Ingestão e detecção: usa funções (evidence: `scripts/03_fato_participacao.py`)
- Ingestão e detecção → RSSSF e fontes alternativas: baixa páginas (evidence: `scripts/rsssf_comum.py`)
- Participações e seleção → Dados manuais: lê participações (evidence: `scripts/02_dim_times.py`)
- Fato de participação → Dados manuais: aplica correções (evidence: `scripts/03_fato_participacao.py`)
- Participações e seleção → Dimensão de clubes: gera dimensão (evidence: `README.md`)
- Participações e seleção → Fato de participação: fornece clubes (evidence: `README.md`)
- Cobertura de dados → Fato de participação: fornece cobertura (evidence: `README.md`)
- Fato de participação → Dimensão de competição: gera dimensão (evidence: `README.md`)
- Fato de participação → Pontuação e dimensões BI: fornece participações (evidence: `README.md`)
- Dimensão de clubes → Pontuação e dimensões BI: fornece clubes (evidence: `README.md`)
- Cobertura de dados → Pontuação e dimensões BI: fornece cobertura (evidence: `README.md`)
- Pontuação e dimensões BI → Fato pontuado: gera pontuação (evidence: `README.md`)
- Pontuação e dimensões BI → Dimensões e cenários: gera dimensões (evidence: `README.md`)
- Fato pontuado → Tabelas processadas: grava tabelas (evidence: `README.md`)
- Dimensões e cenários → Tabelas processadas: grava tabelas (evidence: `README.md`)
- Tabelas processadas → Relatório Power BI: alimenta relatório (evidence: `README.md`)
- Analista → Relatório Power BI: analisa resultados (evidence: `README.md`)
