br-acc上手实战:用合成演示数据集10分钟体验图谱检索与实体分析
【免费下载链接】br-accWorld Transparency Graph public codebase ( website in progress)项目地址https://gitcode.com/gh_mirrors/br/br-acc点击查看免费下载这是一份 br-accWorld Transparency Graph巴西公开数据透明图谱的上手实战指南。你将使用项目自带的合成演示数据集在10分钟内完成本地环境搭建并亲手体验 br-acc 的两大核心能力图谱检索与实体分析——全程不接触任何真实个人数据安全且确定可复现。br-acc 是什么一个交叉引用巴西公开数据的开源图谱br-acc 是一套开源的图基础设施把企业注册CNPJ、选举捐款、财政透明、政府采购、制裁名单等数十个巴西官方公开数据源统一归一化进一个可查询的Neo4j 图谱数据库再通过 FastAPI 后端和 React 前端对外提供搜索与分析界面。它的几个关键特点只做呈现不做指控不解释、不打分、不排名只展示公开数据之间的连接关系结论由使用者自己得出隐私优先公开部署默认启用 public-safe 策略不暴露个人信息见 PRIVACY.md⚡可本地复现一条命令即可启动完整技术栈本文就是这条路径架构总览与更多细节见 README.md。为什么新手该用合成演示数据集入门br-acc 的演示数据有两层都适合第一次体验确定性开发种子数据infra/scripts/seed-dev.cypher 内置一张小图——5 个公职人物、5 家公司、10 份合同、1 份预算修正案、1 条 CEIS 制裁记录。数据是虚构的却刻意覆盖了 5 种典型分析模式利益冲突修正、合同集中、被制裁仍中标、捐赠-合同循环、资产不匹配。合成演示图谱 JSONdata/demo/synthetic_graph.json 是一个纯合成的公开安全数据集两家公司、一份合同、一条制裁、一笔欠税不含真实 CPF、不含Person节点使用规则见 data/demo/README.md随时可用 scripts/generate_demo_dataset.py 重新生成。对新手来说这意味着没有隐私顾虑、不依赖外部数据源、每次跑出来结果都一致——是体验图谱检索与实体分析的理想起点。三步快速启动一条命令拉起演示图谱环境 前置条件已安装 Docker Docker Compose可用磁盘约 10GB 以上。git clone https://gitcode.com/gh_mirrors/br/br-acc.git cd br-acc cp .env.example .env make bootstrap-demomake bootstrap-demo对应 Makefile 中的bootstrap-demo目标会依次完成三件事脚本为 scripts/bootstrap_public_demo.sh步骤动作1️⃣ 启动服务拉起 Neo4j、API、前端三个容器定义见 docker-compose.yml2️⃣ 健康检查轮询 Neo4j 与 API 的/health端点最长各等待 60 秒3️⃣ 加载种子执行 infra/scripts/seed-dev.sh 把确定性演示图灌入 Neo4j跑完后终端会打印当前图谱节点数看到Bootstrap complete.即成功 ✅。验证 4 个本地服务入口打开浏览器逐个确认服务在线API 健康检查http://localhost:8000/healthAPI 交互文档http://localhost:8000/docs前端界面http://localhost:3000Neo4j Browserhttp://localhost:7474账号neo4j密码为.env中的NEO4J_PASSWORD实战一图谱检索1 分钟找到目标实体 打开前端http://localhost:3000的搜索页页面实现见 frontend/src/pages/Search.tsx在搜索框里尝试这些种子数据中的关键词搜索词你会找到SILVA CONSTRUCOES圣保罗建筑公司种子图中中标 10 份合同里的 7 份——一个典型的合同集中案例CARLOS ALBERTO SILVA某市工程局局长同时是预算修正案 EMD-001 的提案人PEREIRA SERVICOS一家被 CEIS 制裁后仍中标的里约服务公司11222333000181用 CNPJ 直接精确定位公司节点点击任意结果即可进入实体详情页。搜索支持按实体类型过滤公司、合同等后端查询逻辑在 api/src/bracc/queries/search.cypher。实战二实体分析一图看穿一个实体 进入实体分析页frontend/src/pages/EntityAnalysis.tsx建议分析SILVA CONSTRUCOES LTDA你会看到 4 个可切换的视图标签Graph关系图以该实体为中心的可交互力导向图。左侧控制栏可调节展开深度depth、勾选/取消实体类型与关系类型点击节点查看详情Connections连接列表以列表形式枚举所有相邻节点适合快速核对这家公司连了谁Timeline时间线按日期铺开中标记录与事件可分页加载更早事件Insights洞察面板右侧固定展示曝光指数exposure index、命中的分析模式与基线对比试着切换几个实体再对比CARLOS ALBERTO SILVA的图上会出现配偶关系CONJUGE_DE与提案修正案AUTOR_EMENDA连向其妻子持股的公司——这正是种子数据埋好的利益冲突路径。实战三直接在 Neo4j Browser 里逛图谱如果想贴近数据打开http://localhost:7474在查询框输入一句 Cypher 看看全图轮廓MATCH (n) RETURN labels(n) AS type, count(*) AS total ORDER BY total DESC;再追一条关系链验证公司 → 中标 → 合同的连接MATCH (c:Company {cnpj: 11222333000181})-[:VENCEU]-(k:Contract) RETURN k.contract_id, k.value, k.date ORDER BY k.value DESC;这正是实体分析页关系图背后的原始查询理解它对后续自定义分析很有帮助。图谱 schema 定义在 infra/neo4j/init.cypher。体验之后还能做什么完成 10 分钟之旅后按兴趣深入 阅读数据源矩阵与完整管线状态docs/pipeline_status.md 用自己的数据跑 ETLBYO-data 工作流cd etl uv run bracc-etl --help 全量摄取编排较重耗时数小时make bootstrap-all指南见 docs/bootstrap_all.md⚖️ 了解项目的合规边界与隐私默认值ETHICS.md、LGPD.md常见问题启动后 3 个高频问题Q1端口被占用怎么办7474/7687/8000/3000被占用时先停掉占用进程或修改 docker-compose.yml 中的ports映射。Q2Neo4j 健康检查失败脚本最多等待 60 秒。内存紧张的机器可临时调低.env中的NEO4J_HEAP_MAX与NEO4J_PAGECACHE然后重新docker compose up -d。Q3想重置演示数据直接重新执行make bootstrap-demo——种子脚本会先清空旧图再重建结果完全一致。写在最后br-acc 用一套演示种子图 合成数据集的轻量入口让新手零门槛体验到图数据库做公开数据交叉分析的全流程检索 → 关系展开 → 时间线 → 洞察面板。跑通本文的 10 分钟之后你就已经掌握了它最核心的使用方式剩下的就是把真实的公开数据源接进来。祝探索愉快 赞分享【免费下载链接】br-accWorld Transparency Graph public codebase ( website in progress)项目地址https://gitcode.com/gh_mirrors/br/br-acc点击查看免费下载相关推荐如何快速构建实体关系分析Metaflow从数据到知识图谱的完整指南如何快速构建实体关系分析Metaflow从数据到知识图谱的完整指南 Metaflow是一个强大的数据科学项目管理框架能帮助开发者轻松构建和管理现实生活中的数MLOps工作流自动化数据工程10分钟上手GoFr v1.32.0SurrealDB集成与gRPC新体验10分钟上手GoFr v1.32.0SurrealDB集成与gRPC新体验 你还在为Go语言微服务开发配置繁琐的数据库连接而烦恼吗还在手动实现gRPC服务的后端微服务云原生可观测性10分钟上手StarRocks Flink Connector高效数据集成实战10分钟上手StarRocks Flink Connector高效数据集成实战 你是否还在为批流数据同步到StarRocks的延迟问题烦恼是否因复杂的配置参数据库OLAP数据仓库大数据湖仓一体数据分析创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考