[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74215":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":15,"starSnapshotCount":15,"syncStatus":26,"lastSyncTime":27,"discoverSource":28},74215,"br-acc","brunoclz\u002Fbr-acc","brunoclz","World Transparency Graph public codebase (🚧 website in progress)","https:\u002F\u002Fbracc.org",null,"Python",1711,464,61,0,23,58.3,"GNU Affero General Public License v3.0",false,"main",true,[],"2026-06-12 04:01:13","# br\u002Facc open graph\n\n[![WTG Header](docs\u002Fbrand\u002Fbracc-header.jpg)](docs\u002Fbrand\u002Fbracc-header.jpg)\n\n[English](README.md) | [Portugues](docs\u002Fpt-BR\u002FREADME.md)\n\n**Open-source graph infrastructure that cross-references Brazil's public databases to generate actionable intelligence for civic improvement.**\n\n[![CI](https:\u002F\u002Fgithub.com\u002Fbrunoclz\u002Fbr-acc\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fbrunoclz\u002Fbr-acc\u002Factions\u002Fworkflows\u002Fci.yml)\n[![License: AGPL v3](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-AGPL_v3-blue.svg)](https:\u002F\u002Fwww.gnu.org\u002Flicenses\u002Fagpl-3.0)\n[![Last Commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fbrunoclz\u002Fbr-acc)](https:\u002F\u002Fgithub.com\u002Fbrunoclz\u002Fbr-acc\u002Fcommits)\n[![Issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fbrunoclz\u002Fbr-acc)](https:\u002F\u002Fgithub.com\u002Fbrunoclz\u002Fbr-acc\u002Fissues)\n[![Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fbrunoclz\u002Fbr-acc?style=social)](https:\u002F\u002Fgithub.com\u002Fbrunoclz\u002Fbr-acc\u002Fstargazers)\n[![Forks](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002Fbrunoclz\u002Fbr-acc?style=social)](https:\u002F\u002Fgithub.com\u002Fbrunoclz\u002Fbr-acc\u002Fnetwork\u002Fmembers)\n[![Twitter Follow](https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Ffollow\u002Fbrunoclz?style=social)](https:\u002F\u002Fx.com\u002Fbrunoclz)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20us-5865F2?logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002FYyvGGgNGVD)\n\n[Discord](https:\u002F\u002Fdiscord.gg\u002FYyvGGgNGVD) | [Twitter](https:\u002F\u002Fx.com\u002Fbrunoclz) | [Website](https:\u002F\u002Fbracc.org) | [Contributing](#contributing)\n\n---\n\n## What is br\u002Facc?\n\nbr\u002Facc is a decentralized movement of Brazilian builders using technology and open data to make public information more accessible. This repository is one of its projects: an open-source graph infrastructure that ingests official Brazilian public databases — company registries, health records, education metrics, employment data, public finances, procurement, environment — and normalizes them into a single queryable graph.\n\nIt makes public data that is already open but scattered across dozens of portals accessible in one place. It does not interpret, score, or rank results — it surfaces connections and lets users draw their own conclusions.\n\n[Learn more at bracc.org](https:\u002F\u002Fbracc.org)\n\n---\n\n## Features\n\n- **45 implemented ETL pipeline modules** — status is tracked in `docs\u002Fsource_registry_br_v1.csv` (loaded\u002Fpartial\u002Fstale\u002Fblocked\u002Fnot_built)\n- **Neo4j graph infrastructure** — schema, loaders, and query surface for normalized entities and relationships\n- **React frontend** — search, explore corporate networks, and analyze entity connections\n- **Public API** — programmatic access to graph data via FastAPI\n- **Reproducibility tooling** — one-command local bootstrap plus BYO-data ETL workflow\n- **Privacy-first** — LGPD compliant, public-safe defaults, no personal data exposure\n\n---\n\n## Quick Start\n\n```bash\ncp .env.example .env\ndocker compose up -d --build\nbash infra\u002Fscripts\u002Fseed-dev.sh\n```\n\nThis flow starts the Docker stack from the repository root and then loads deterministic development seed data into Neo4j.\n\nVerify with:\n\n- API: http:\u002F\u002Flocalhost:8000\u002Fhealth\n- API Docs: http:\u002F\u002Flocalhost:8000\u002Fdocs\n- Frontend: http:\u002F\u002Flocalhost:3000\n- Neo4j Browser: http:\u002F\u002Flocalhost:7474\n\n### Starting with Docker\n\nYou can start the stack (Neo4j, API, frontend) with Docker Compose without running the full bootstrap:\n\n```bash\ncp .env.example .env\ndocker compose up -d\n```\n\nOptional: include the ETL service (for running pipelines in a container):\n\n```bash\ndocker compose --profile etl up -d\n```\n\nSame verification URLs apply. For a ready-to-use demo graph with seed data, use `make bootstrap-demo` instead.\n\n---\n\n## One-Command Flow\n\n```bash\n# Start all core services (Neo4j + API + Frontend)\ndocker compose up -d --build\n\n# Load deterministic demo seed\nbash infra\u002Fscripts\u002Fseed-dev.sh\n\n# Include ETL service when needed\ndocker compose --profile etl up -d --build\n\n# Stop stack\ndocker compose down\n\n# Heavy full ingestion orchestration (all implemented pipelines)\nmake bootstrap-all\n\n# Noninteractive heavy run (automation)\nmake bootstrap-all-noninteractive\n\n# Print latest bootstrap-all report\nmake bootstrap-all-report\n```\n\n`make bootstrap-all` is intentionally heavy:\n- full historical default ingestion target\n- can take hours (or longer) depending on source availability\n- requires substantial disk, memory, and network bandwidth\n- continues on errors and writes auditable per-source status summary under `audit-results\u002Fbootstrap-all\u002F`\n\nDetailed guide: [`docs\u002Fbootstrap_all.md`](docs\u002Fbootstrap_all.md)\n\n---\n\n## What Is Included In This Public Repo\n\n- API, frontend, ETL framework, and infrastructure code.\n- Source registry and pipeline status documentation.\n- Synthetic demo dataset and deterministic local seed path.\n- Public safety\u002Fcompliance gates and release governance docs.\n\n## What Is Not Included By Default\n\n- A pre-populated production Neo4j dump.\n- Guaranteed uptime\u002Fstability of every third-party public portal.\n- Institutional\u002Fprivate modules and operational runbooks.\n\n## What Is Reproducible Locally Today\n\n- Full local stack startup (`docker compose up -d --build`) with demo graph seed (`bash infra\u002Fscripts\u002Fseed-dev.sh`).\n- BYO-data ingestion workflow through `bracc-etl` pipelines.\n- One-command heavy orchestration (`make bootstrap-all`) with explicit blocked\u002Ffailed source reporting.\n- Public-safe API behavior with privacy defaults.\n\nProduction-scale counters are published as a **reference production snapshot** in [`docs\u002Freference_metrics.md`](docs\u002Freference_metrics.md), not as expected local bootstrap output.\n\n---\n\n## Architecture\n\n| Layer | Technology |\n|---|---|\n| Graph DB | Neo4j 5 Community |\n| Backend | FastAPI (Python 3.12+, async) |\n| Frontend | Vite + React 19 + TypeScript |\n| ETL | Python (pandas, httpx) |\n| Infra | Docker Compose |\n\n```mermaid\ngraph LR\n    A[Public Data Sources] --> B[ETL Pipelines]\n    B --> C[(Neo4j)]\n    C --> D[FastAPI]\n    D --> E[React Frontend]\n    D --> F[Public API]\n```\n\n---\n\n## Repository Map\n\n```\napi\u002F          FastAPI backend (routes, services, models)\netl\u002F          ETL pipelines and download scripts\nfrontend\u002F     React app (Vite + TypeScript)\ninfra\u002F        Docker, Neo4j schema, seed scripts\nscripts\u002F      Utility and automation scripts\ndocs\u002F         Documentation, brand assets, legal index\ndata\u002F         Downloaded datasets (git-ignored)\n```\n\n---\n\n## API Reference\n\n| Method | Route | Description |\n|---|---|---|\n| GET | `\u002Fhealth` | Health check |\n| GET | `\u002Fapi\u002Fv1\u002Fpublic\u002Fmeta` | Aggregated metrics and source health |\n| GET | `\u002Fapi\u002Fv1\u002Fpublic\u002Fgraph\u002Fcompany\u002F{cnpj_or_id}` | Public company subgraph |\n| GET | `\u002Fapi\u002Fv1\u002Fpublic\u002Fpatterns\u002Fcompany\u002F{cnpj_or_id}` | Pattern analysis (when enabled) |\n\nFull interactive docs available at `http:\u002F\u002Flocalhost:8000\u002Fdocs` after starting the API.\n\n---\n\n## Contributing\n\nWe welcome contributions of all kinds — code, data pipelines, documentation, and bug reports. Check open issues for good first tasks, or open a new one to discuss your idea.\n\nIf you find this project useful, **star the repo** — it helps others discover it.\n\n---\n\n## Contributors\n\nThanks to everyone who has contributed to br\u002Facc.\n\n[![Contributors](https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=brunoclz\u002Fbr-acc)](https:\u002F\u002Fgithub.com\u002Fbrunoclz\u002Fbr-acc\u002Fgraphs\u002Fcontributors)\n\nSee the [full list of contributors](https:\u002F\u002Fgithub.com\u002Fbrunoclz\u002Fbr-acc\u002Fgraphs\u002Fcontributors) on GitHub.\n\n---\n\n## Support the Project\n\n[![Sponsor](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGitHub_Sponsors-Support-ea4aaa?logo=githubsponsors&logoColor=white)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fbrunoclz)\n\nIf you want to support development directly:\n\n| Network | Address |\n|---|---|\n| Solana | `HFceUyei1ndQypNKoiYSsHLHrVcaMZeNBeRhs8LmmkLn` |\n| Ethereum | `0xbB3538D3e1B1Dd7c916BE7DfAC9ac7e322f592c7` |\n\n### Token Disclosure (Transparency)\n\nA community member created an unofficial token and configured creator rewards to the maintainer wallet.\n\n- Token address: `4CtXkPU8oUXVjofhgrX6nALuQw2ZSK2U7tTZKB8qpump` \u003C!-- gitleaks:allow -->\n- This token is not an official project product.\n- Holding or trading it does not provide ownership, governance rights, privileged access, or guaranteed benefits in this repository.\n- This is not financial advice. Crypto assets are high risk; verify addresses on-chain and do your own research.\n\n---\n\n## Community\n\n- **Discord**: [discord.gg\u002FYyvGGgNGVD](https:\u002F\u002Fdiscord.gg\u002FYyvGGgNGVD)\n- **Twitter**: [@brunoclz](https:\u002F\u002Fx.com\u002Fbrunoclz)\n- **Website**: [bracc.org](https:\u002F\u002Fbracc.org)\n- **Brazilian Accelerationism Community** on X\n\n---\n\n## Legal & Ethics\n\nAll data processed by this project is public by law. Every source is published by a Brazilian government portal or international open-data initiative and made available under one or more of the following legal instruments:\n\n| Law | Scope |\n|---|---|\n| **CF\u002F88 Art. 5 XXXIII, Art. 37** | Constitutional right to access public information |\n| **Lei 12.527\u002F2011 (LAI)** | Freedom of Information Act — regulates access to government data |\n| **LC 131\u002F2009 (Lei da Transparencia)** | Mandates real-time publication of fiscal and budget data |\n| **Lei 13.709\u002F2018 (LGPD)** | Data protection — Art. 7 IV\u002FVII allow processing of publicly available data for public interest |\n| **Lei 14.129\u002F2021 (Governo Digital)** | Mandates open data by default for government agencies |\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Brazil Dataset Matrix (Legal Basis)\u003C\u002Fb>\u003C\u002Fsummary>\n\n| # | Source | Portal | Legal Basis |\n|---|--------|--------|-------------|\n| 1 | CNPJ (Company Registry) | Receita Federal | LAI, CF Art. 37 |\n| 2 | TSE (Elections & Donations) | dadosabertos.tse.jus.br | Lei 9.504\u002F1997 (Lei Eleitoral), LAI |\n| 3 | Portal da Transparencia | portaldatransparencia.gov.br | LC 131\u002F2009, LAI |\n| 4 | CEIS\u002FCNEP (Sanctions) | Portal da Transparencia | LAI, Lei 12.846\u002F2013 (Lei Anticorrupcao) |\n| 5 | BNDES (Dev. Bank Loans) | bndes.gov.br | LAI, LC 131\u002F2009 |\n| 6 | PGFN (Tax Debt) | portaldatransparencia.gov.br | LAI, Lei 6.830\u002F1980 |\n| 7 | ComprasNet (Procurement) | comprasnet.gov.br | Lei 14.133\u002F2021 (Licitacoes), LAI |\n| 8 | TCU (Audit Sanctions) | portal.tcu.gov.br | LAI, CF Art. 71 |\n| 9 | TransfereGov | transferegov.sistema.gov.br | LC 131\u002F2009, LAI |\n| 10 | RAIS (Labor Stats) | PDET\u002FMTE | LAI (aggregate, no personal data) |\n| 11 | INEP (Education Census) | dados.gov.br | LAI, Lei 14.129\u002F2021 |\n| 12 | DataSUS\u002FCNES (Health) | datasus.saude.gov.br | LAI, Lei 8.080\u002F1990 (SUS) |\n| 13 | IBAMA (Embargoes) | dados.gov.br | LAI, Lei 9.605\u002F1998 (Crimes Ambientais) |\n| 14 | DOU (Official Gazette) | in.gov.br | CF Art. 37 (publicidade) |\n| 15 | Camara (Deputy Expenses) | dadosabertos.camara.leg.br | LAI, CF Art. 37 |\n| 16 | Senado (Senator Expenses) | dadosabertos.senado.leg.br | LAI, CF Art. 37 |\n| 17 | ICIJ (Offshore Leaks) | offshoreleaks.icij.org | Public interest journalism database |\n| 18 | OpenSanctions (Global PEPs) | opensanctions.org | Open-data aggregator (CC-licensed) |\n| 19 | CVM (Securities Proceedings) | dados.cvm.gov.br | LAI, Lei 6.385\u002F1976 |\n| 20 | CVM Funds | dados.cvm.gov.br | LAI, Lei 6.385\u002F1976 |\n| 21 | Servidores (Public Servants) | Portal da Transparencia | LC 131\u002F2009, LAI |\n| 22 | CEAF (Expelled Servants) | portaldatransparencia.gov.br | LAI, Lei 8.112\u002F1990 |\n| 23 | CEPIM (Barred NGOs) | portaldatransparencia.gov.br | LAI |\n| 24 | CPGF (Govt Credit Cards) | portaldatransparencia.gov.br | LC 131\u002F2009, LAI |\n| 25 | Viagens a Servico | portaldatransparencia.gov.br | LC 131\u002F2009, LAI |\n| 26 | Renuncias Fiscais | portaldatransparencia.gov.br | LC 131\u002F2009, LAI |\n| 27 | Acordos de Leniencia | portaldatransparencia.gov.br | Lei 12.846\u002F2013, LAI |\n| 28 | BCB Penalidades | dados.bcb.gov.br | LAI, Lei 4.595\u002F1964 |\n| 29 | STF (Supreme Court) | portal.stf.jus.br | CF Art. 93 IX (publicidade judiciaria) |\n| 30 | PEP CGU | portaldatransparencia.gov.br | LAI, Decreto 9.687\u002F2019 |\n| 31 | TSE Bens (Candidate Assets) | dadosabertos.tse.jus.br | Lei 9.504\u002F1997 |\n| 32 | TSE Filiados (Party Members) | dadosabertos.tse.jus.br | Lei 9.096\u002F1995 (Lei dos Partidos) |\n| 33 | OFAC SDN | treasury.gov | US public sanctions list |\n| 34 | EU Sanctions | data.europa.eu | EU public sanctions list |\n| 35 | UN Sanctions | un.org | UN Security Council public list |\n| 36 | World Bank Debarment | worldbank.org | Public debarment list |\n| 37 | Holdings (derived) | — | Derived from CNPJ data |\n| 38 | SIOP (Budget Amendments) | siop.planejamento.gov.br | LC 131\u002F2009, LAI |\n| 39 | Senado CPIs | dadosabertos.senado.leg.br | LAI, CF Art. 58 §3 |\n\n\u003C\u002Fdetails>\n\nAll findings are presented as source-attributed data connections, never as accusations. The platform enforces public-safe defaults that prevent exposure of personal information in public deployments.\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Public-safe defaults\u003C\u002Fb>\u003C\u002Fsummary>\n\n```\nPRODUCT_TIER=community\nPUBLIC_MODE=true\nPUBLIC_ALLOW_PERSON=false\nPUBLIC_ALLOW_ENTITY_LOOKUP=false\nPUBLIC_ALLOW_INVESTIGATIONS=false\nPATTERNS_ENABLED=false\nVITE_PUBLIC_MODE=true\nVITE_PATTERNS_ENABLED=false\n```\n\u003C\u002Fdetails>\n\n- [ETHICS.md](ETHICS.md)\n- [LGPD.md](LGPD.md)\n- [PRIVACY.md](PRIVACY.md)\n- [TERMS.md](TERMS.md)\n- [DISCLAIMER.md](DISCLAIMER.md)\n- [SECURITY.md](SECURITY.md)\n- [ABUSE_RESPONSE.md](ABUSE_RESPONSE.md)\n- [Legal Index](docs\u002Flegal\u002Flegal-index.md)\n\n---\n\n## Releases\n\n- [Release history](https:\u002F\u002Fgithub.com\u002Fbrunoclz\u002Fbr-acc\u002Freleases)\n- [Release policy](docs\u002Frelease\u002Frelease_policy.md)\n- [Maintainer runbook](docs\u002Frelease\u002Frelease_runbook.md)\n\n---\n\n## License\n\n[GNU Affero General Public License v3.0](LICENSE)\n","br\u002Facc是一个开源图基础设施项目，旨在通过交叉引用巴西的公共数据库生成有助于公民改进的情报。该项目利用Python构建了45个ETL管道模块，将来自公司注册、健康记录、教育指标等领域的分散数据整合到一个可查询的Neo4j图数据库中。它提供了React前端界面供用户搜索和探索实体间的联系，并通过FastAPI提供公共API接口以支持程序化访问。此项目适用于需要透明度和数据分析来促进公共服务改进和社会监督的场景。",2,"2026-06-01 03:40:30","high_star"]