方法论

本档案库的运作方式。

kakao.io,即 Open Cacao Index,是一个关于可可作物本身的独立开放数据项目——涵盖 Theobroma cacao 这种树木、其种植区域,以及背后的人们与实践。它是一个参考档案库,不是商店,也不是宣传网站。

本档案库的资金来自展示广告,以及一个独立的 /reviews/ 栏目——该栏目含有联盟营销链接,并在其每个页面上予以披露。任何档案页面上都不会出现联盟营销链接,任何广告主也无权影响记录的内容。数据本身仍以 CC BY-NC-SA 4.0 许可发布,因此无论网站如何获得资金,商业性再利用都需要单独的许可。这条界线划在何处、为何如此,都公开记录在项目的决策日志中。

数据的基本单位

本档案库的基本记录是产地(origin):一个明确界定的可可产区,可以是一个国家、一个地区,或更具体的区域。每个产地都被赋予一个稳定的标识符,即使其名称、描述或分类日后被修订,该标识符也不会改变。稳定的 ID 使记录能够随时间被引用、链接和更正,而不破坏既有引用。

分类

产地采用现代遗传聚类框架进行描述,而非较早的 Criollo / Forastero / Trinitario 模型。在传统或商业术语确有用处时,会将其如实记录,并明确标注为历史或贸易词汇,而非遗传学事实。

数据状态

本档案库中的每条记录目前均为等待来源核实的草稿。条目可能不完整、属临时性质或存在错误,暂时不应被视为权威。随着记录逐一与已发表的来源核对,其状态将得到更新。

格式与许可

数据以纯 JSON 格式保存,便于阅读、校验和再利用。数据计划以 Creative Commons Attribution 4.0(CC BY 4.0)许可发布,允许在署名的前提下再利用。

更正

欢迎提出更正与补充。这是一个处于早期阶段、公开维护的档案库,来自具有田间、贸易或研究经验人士的审阅尤为宝贵。