GoodAction Hub 数据仓库

本仓库是GoodAction Hub的独立数据仓库，用于存储公益慈善活动、会议和竞赛的结构化数据。

This repository is an independent data warehouse affiliated with GoodAction Hub, specialized in storing structured data covering public welfare and charity activities, conferences, and competitions.

原始信息汇总

GoodAction Hub 数据仓库数据集概述

数据集基本信息

• 数据集名称：GoodAction Hub 数据仓库 / GoodAction Hub Data Repository
• 存储内容：公益慈善活动、会议和竞赛的结构化数据
• 数据仓库性质：独立数据仓库，服务于 GoodAction Hub

数据类别与存储

• 活动数据：存储在 data/activities.yml 文件中
• 餐厅数据：存储在 data/restaurants.yml 文件中

活动数据结构

• 数据字段：
  • title：活动名称
  • description：活动描述
  • category：活动类别，必须是 meetup、conference 或 competition
  • tags：活动标签列表
  • events：活动事件列表，包含：
    • id：全局唯一的ID
    • link：活动链接
    • start_time：活动开始时间，格式为 YYYY-MM-DD HH:mm:ss
    • end_time：活动结束时间，格式为 YYYY-MM-DD HH:mm:ss
    • timeline：关键时间节点列表，每个节点包含 deadline（ISO 8601 格式）和 comment
    • timezone：活动时区，使用标准的 IANA 时区名称
    • place：活动地点，格式为 国家，城市，线上活动则写 线上

餐厅数据结构

• 数据字段：
  • id：全局唯一的 ID
  • name：餐厅名称
  • description：餐厅描述
  • features：餐厅特色列表
  • food：食品列表，包含 name 和 price
  • avg_spend：人均消费
  • social_values：社会价值列表
  • address：餐厅地址
  • lat：GPS 纬度
  • lng：GPS 经度
  • issue_link：相关 Issue 链接

数据提交方式

• 新手提交：通过功能入口链接提交表单
  • 提交活动：https://github.com/GoodAction-Hub/GoodAction-data/issues/new?template=activity.yml
  • 提交餐厅：https://github.com/GoodAction-Hub/GoodAction-data/issues/new?template=restaurant.yml
• 开发者提交：熟悉 Git 和 Pull Request 流程的用户可直接编辑对应 YAML 文件并提交 Pull Request
• 审核列表：https://github.com/GoodAction-Hub/GoodAction-data/pulls
• JSON API：https://goodaction-hub.github.io/GoodAction-data/

搜集汇总

数据集介绍

构建方式

在公益慈善领域，数据资源的系统化整合对于提升信息透明度与协作效率具有关键意义。GoodAction Hub 数据仓库的构建采纳了开放协作模式，通过结构化的YAML文件存储活动与餐厅信息。其数据采集流程兼顾了易用性与专业性，既提供面向新手的表单提交界面，也支持熟悉Git工作流的贡献者直接编辑文件并提交拉取请求。这种双重路径设计有效降低了参与门槛，同时确保了数据格式的规范统一，为社区驱动的数据积累提供了可持续的框架。

特点

该数据集的核心特征在于其高度结构化的组织方式与明确的数据分类。活动数据严格区分为聚会、会议与竞赛三类，并采用标准化的时间、地点与时区字段，便于进行精确的时空分析。餐厅数据则聚焦于社会价值属性，详细标注无障碍设施、残障就业支持等特征，体现了数据集在公益导向上的深度。所有条目均要求全局唯一标识符，并通过JSON API提供标准化访问接口，显著提升了数据的可发现性与机器可读性，为后续的分析与应用奠定了坚实基础。

使用方法

使用者可通过多种途径利用该数据集。对于数据消费者，可通过仓库提供的JSON API直接获取结构化数据，集成到第三方应用或研究分析中。对于数据贡献者，最便捷的方式是通过项目页面提供的专用表单链接提交新条目，系统将自动创建标准化的问题模板。具备技术背景的用户亦可直接克隆仓库，按照规定的YAML架构编辑本地文件，并通过GitHub的拉取请求流程完成提交与审核。这种清晰的使用分层使得数据集能够持续吸纳来自广泛社区的优质内容。

背景与挑战

背景概述

在公益慈善领域，长期以来缺乏一个统一、结构化的数据平台来整合各类公益活动、会议及竞赛信息。GoodAction Hub 数据仓库应运而生，由 GoodAction Hub 团队创建并维护，旨在构建一个开放、可扩展的公益数据生态系统。该数据集的核心研究问题聚焦于如何系统化地收集、存储和共享公益相关活动与具有社会价值的商业场所信息，以促进信息透明、提高参与效率，并推动公益资源的优化配置。通过提供标准化的数据结构和便捷的提交入口，该仓库为研究者、公益组织及公众提供了宝贵的数据基础，对推动公益慈善领域的数字化与协作化发展具有显著影响力。

当前挑战

该数据集致力于解决公益慈善领域信息碎片化与可及性不足的核心挑战，具体包括如何从多元、分散的来源中有效聚合高质量的结构化数据，以及如何确保数据的时效性与准确性以支持可靠的分析与应用。在构建过程中，团队面临多重技术与管理挑战：设计既能涵盖活动多样性（如聚会、会议、竞赛）又能保持简洁性的数据模式；建立用户友好的提交机制以降低贡献门槛，同时维护数据的一致性与完整性；处理时空信息的标准化（如时区、坐标）以实现跨地域的可比性与可视化；并通过审核流程平衡开放协作与数据质量控制之间的张力。

常用场景

经典使用场景

在公益慈善与数字人文交叉领域，GoodAction Hub 数据仓库作为结构化数据源，其经典使用场景聚焦于学术研究与社区实践的整合。研究者常利用该数据集中的活动与餐厅信息，分析公益活动的时空分布、主题演化及社会影响力。例如，通过解析会议、竞赛和聚会等类别数据，学者能够追踪特定议题如老龄服务或无障碍设施的发展趋势，为跨学科研究提供实证基础。

解决学术问题

该数据集有效解决了公益慈善领域长期存在的数据碎片化与标准化缺失问题。通过提供统一的结构化格式，它支持对公益活动进行量化分析，助力研究者探讨志愿行为的组织模式、社会创新扩散机制以及包容性设计的经济社会效应。其意义在于构建了一个可扩展的开放数据框架，促进了公益数据的透明共享与比较研究，为政策制定和理论构建提供了可靠的数据支撑。

衍生相关工作

围绕该数据集衍生的经典工作主要包括开源工具与学术研究两类。开发者利用其JSON API构建了公益活动日历聚合平台与无障碍地图可视化系统；学术界则以此为基础，发表了关于公益数据语义标注、社会价值量化评估的论文。这些工作进一步拓展了数据在智能推荐、影响力测量等方向的应用，形成了以数据驱动公益创新的生态系统。