版本演进 / Changelog

GTAmap 从单国试点到全球发布用了四个内部版本。本页记录每个版本做了什么、下一步计划什么。
所有变更遵循同一条规则：更正与新增都必须留下记录，不悄悄改数据。

当前正式版本：v1.1（2026-09-29）。旧版统计仅作为各版本历史记录；当前文件数、体积与校验值以 v1.1 manifest.csv 及 QA_GATE.csv 为准。

v1.0 — 全球首个发布（2026-09-26）

首个公开版本，覆盖全球的三级行政区划时间序列。

规模

• 233 个国家/区域时间序列包（232 个实体 + EU NUTS）；
• 时间序列 518,916 行（658 个 GeoParquet 文件）；
• 事件库 19,952 条 / 176 个数据集；
• 全球锚点年快照 2000 / 2010 / 2020 / 2025 × ADM0/1/2；
• 发布包 706 文件 / 48.1 GB，附 manifest.csv 全文件 SHA-256。

覆盖

• 2025 快照：ADM0 232（真实几何 100%）、ADM1 3,440（99.6%）、ADM2 55,137（98.3%）；
• 长序列国家：中国 27 年（2000–2026，CTAmap v2.1）、挪威 34 年（1986–2019）、爱沙尼亚 30 年、巴西 18 年、日本 22 年、德国 19 年、美国 16 年等；≥10 年的国家 18 个。

机制

• 标准 20 列 schema：逐要素 snapshot_year / unit_id + 6 个来源字段 + conf_grade / conf_note；
• geom_origin 四值透明标注（真实官方 / 并集派生 / GADM 锚点 / 回填）；
• 官网（下载索引、文档站、地图浏览）同步上线。

已知问题（将在补丁中解决）

• 发布包暂缺 events/ 目录与合并事件主表 parquet（逐国事件 CSV 齐全），重打包时补入；
• 事件主表与逐国 CSV 存在 54 条口径差（BR_mun_2023_2024 补充数据集），需统一；
• README.md 个别数字（"222 vs 216 实体"、回填实体数）与实测不符，以 country_timeseries_inventory.csv / coverage_2000_2025.csv 为准，重打包时修订。

v1.1 — 数据修订版正式发布（2026-09-29）

• 全球层交付 2000 / 2010 / 2020 / 2025 四期 × ADM0/1/2，共 12 个 GeoParquet；2025 期分别为 ADM0 243 行、ADM1 3,492 行、ADM2 55,075 行。
• 逐国包目录共 244 个、含 683 个 GeoParquet；相较 v1.0 增加 12 个实体包，并交付 12 个巴西沿革 crosswalk 文件及中国 ADM3 附加数据。
• 重建 411 个结构损坏包，并修复缺层、几何有效性、海岸水域与层级引用等问题；终版验收门禁为 GREEN。
• 完整差异、限制与验收证据见随版本发布的 RELEASE_NOTES.md、QA_GATE.csv 与 docs/RELEASE_ACCEPTANCE_v1.1.md。

v0.3 — 全球推进与回退体系（内部版本）

从"多国"走向"全网"的关键阶段。

• 建立分层采集架构：官方直采 → 聚合器（OCHA COD-AB、geoBoundaries）→ OSM/GADM 回退的三层来源结构成型；
• 建立 2026 基准年：为官方源不可达的实体统一制作基准几何，作为回填与锚点的公共底座；
• 引入 GADM 双锚点回退（≈2018 / ≈2022）与 current_carried_back 回填机制，确立"拿不到就明说"的诚实性原则；
• 来源 8 字段规范（src_id … conf_note）定稿并全量落地，来源登记表机器可读；
• 覆盖从数十国扩展到 200+ 实体，事件库从单一国家 diff 扩展到多通道（官方序列 diff / 权威清单 / OSM 历史管线）。

v0.2 — 多国扩展与溯源规范（内部版本）

• 国家覆盖从试点国扩展到各大洲主要国家；
• 事件模型定型：from_snapshot → to_snapshot 锚定 + confidence 三档 + legal_reference 文号字段；
• 制定来源与置信度规范（Provenance Spec）：A–D 四级判据、"每个面都必须能回答从哪来、有多可信"的原则；
• 引入等积面积字段 area_km2（EPSG:6933）与 conf_note 口径说明；
• 欧盟 NUTS 1/2/3 六个版本纳入（2003–2021，1,460 条事件）。

v0.1 — 巴西试点与事件引擎（内部版本）

• 以巴西（IBGE 逐年 malha）为试点，验证"相邻年份官方底图逐单元 diff"的事件抽取管线；
• 产出第一版事件库（gtamap_events_v0.1.parquet 快照，5,336 条）；
• 设计 unit_id 稳定 ID 方案：同一单元跨快照共用 ID，支撑面板数据；
• 确立 GeoParquet 为主要分发格式、WGS84 为坐标系、SHA-256 manifest 校验。

v1.2 计划（待启动）

• 持续补齐可获得官方历史源的国家；对第三方来源受限数据先核清许可与发布范围；
• 将 events/ 与合并事件主表纳入独立发布验收，统一逐国 CSV 与主表计数口径；
• 扩充 OSM 历史管线覆盖的国家；
• 出具系统性拓扑 QC（同级缝隙/重叠、ADM1↔ADM0 面积守恒抽样）；
• 持续完善多语言文档与站点摘要页；
• 每个小版本同步更新本页与 manifest.csv。

反馈的纠错会在下一个版本更正并在此记录。发现错误请到反馈页提交。