Emendas parlamentares do Brasil

議会修正予算 — ETL（第1週）

透明性ポータルから議会修正予算をダウンロードし、各行を自治体（IBGEコード）に紐付けて、ダッシュボード用のテーブルを生成します。GitHub Actionsで毎日無料で実行されます。

data/out/ に出力されるもの

ファイル	内容
fato_emenda.parquet	修正予算 × 地域 × 年ごとに1行。支出承認額／清算額／支払額、escopo（自治体、州、地域、全国、その他）、municipio_ibge、uf、modalidade（Pix／その他）を含みます
fato_favorecido.parquet	各修正予算の資金受取者（CNPJ、法人格）を月ごとに記録し、municipio_ibge を含みます
metricas_municipio.parquet	自治体ごとの年別受取額（受取者データに基づく）、修正予算数、作成者数と受取者数、州内ランキングの順位
autores.parquet	議員（または会派／委員会）ごとの年別合計
qualidade.json	支払額のうち自治体に紐付けられた割合と、解決できなかった地域のうち金額上位20件

お使いのコンピューターで実行する

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m pytest -q          # testes com a amostra em tests/fixtures
python -m etl.build          # baixa os dados reais e gera data/out/

ANO_INICIAL=2015 python -m etl.build で開始年を変更できます（デフォルト：2020）。

公開する（費用ゼロ）

1. GitHubで公開リポジトリを作成し、このフォルダーをアップロードします（公開リポジトリではActionsを無制限に利用できます）。
2. Actionsで、ワークフロー「議会修正予算の日次ETL」を手動で一度実行し、qualidade アーティファクトをダウンロードします。
3. データを公開する準備ができたら、Cloudflare R2にバケットを作成し、Settings → Secrets and variables → Actionsで R2_ACCOUNT_ID、R2_ACCESS_KEY_ID、R2_SECRET_ACCESS_KEY、R2_BUCKET を登録します。これらのシークレットがない場合、ワークフローはレポートを生成して保存するだけです。

実際の初回実行結果（02/11/2026）

• 2020年以降の修正予算は46,510件、受取者への支払いは654,094件です。
• メインファイルでは、支払額の83％が地域「MÚLTIPLO」として記録されています。そのため、自治体別の合計には受取者ファイルを使用します。
• 受取額の99.8％が自治体（5,568自治体）に紐付けられました。残りは情報源自体で「情報なし」となっています。
• GitHubからはIBGE APIに応答がありません。自治体リストには、GitHub上で公開されているコピーを使用しています。

確認事項

• CSVの列名： コードは列名の表記ゆれに対応しています（etl/normalize.py の辞書 COLUNAS）。ポータルでラベルが変更された場合、ビルドは停止して検出した列名を一覧表示します。その場合は、新しい名前をここに追加するだけです。
• 地域の形式： 認識される形式は CIDADE - UF、CIDADE/UF、ESTADO (UF)、REGIÃO (REGIÃO)、NACIONAL です。残った項目は qualidade.json に表示されます。表記が異なるものは ALIASES_MUNICIPIO に追加します。
• Pix修正予算： アクション名（「特別移転」）で識別します。実際のファイルに記載されている修正予算の種類と照合してください。
• GitHubからのポータルへのアクセス： 外国のIPアドレスがブロックされてダウンロードに失敗する場合は、コンピューター上でETLを実行し、ファイルをR2にアップロードしてください。

今後の予定

• 第2週：Transferegov（Pix修正予算のアクションプラン）と、1人当たりの金額算出に使用するIBGEの人口データ。
• 第3〜4週：自治体別および議員別の静的ページ。