公共数据发布前核查清单

发布前检查公共数据

公共数据容易获取，也容易误读。大多数错误不在API调用中，而在于数字的含义。在给出答案、绘制图表或发布页面之前运行此清单，并将发现的内容写入输出（脚注、警示行或“我们的计算方法”说明）。切勿为了结果更整洁而隐藏警示信息。

以下每条规则均来自真实案例。示例使用葡萄牙数据，但这些检查适用于任何国家。

如何使用

1. 用一句话写下结论（“阿罗卡每居民公共合同支出为845欧元”）。
2. 逐项检查八个项目。对每项，要么确认无误，要么添加警示说明。
3. 输出结束时包含：数据源、参考时段、提取日期、方法概述（一行）以及所有警示说明。

八项检查

1. 参考时期

• 每个数字都要有明确的年份（或日期范围）。“最新”不是年份。
• 当合并多个数据源时，比较它们的年份。如果年份不同，需在图表上注明，而非仅放在脚注中。
• 检查最新时期是否确实有值：部分API返回空的最近年份（Eurostat的lastTimePeriod=1返回value: {}），INE将近年份标记为“初步数据”。
• 注意数据集使用哪个日期。Portal BASE文件的“年份”字段是合同年份，而门户网站称日期为发布日期；选择其一并明确说明。
• 进行中的年份需在所有地方标注（“2026年截至10月4日”），且不得与完整年份直接比较而未作说明。

示例：合同来自2025年，最新的INE人口数据是2023年 → “欧元/居民 = 2025年合同 ÷ 2023年人口”。

2. 单位与量级

• 在查看数据前先阅读元数据。INE的市政财政指标以千欧元为单位（10的幂指数 = 3）：23754代表2375.4万欧元，而非23,754欧元。
• 检查货币单位、名义值还是实际值（通货膨胀）、现金制还是权责发生制，以及“%”表示占比还是变化。
• 人均数据需要使用同一区域且理想情况下同一年份的人口数据。

3. 数字的计量对象

• 准确命名概念。公共合同不是总支出：它们只涵盖已签约（并公布）的内容，不包括薪资、转移支付或所有支出。市政收支来自预算执行情况（DGAL，通过INE）。
• 合同价值 ≠ 实付金额。在Portal BASE中，“实际价格”字段通常为0或缺失——不要将其视为真实值。
• 估算值、预测值和AI生成的笔录不是官方记录。需说明是哪种。

4. 覆盖范围与缺口

• 检查是否存在缺失的实体和年份（例如，某个市的某年预算数据缺失；当学生人数少于15–20人时，学校数据被屏蔽）。
• 被屏蔽的值（“*”、“-99.0”、“无效数据”）是缺失的，绝非零。在计算平均值时剔除它们，并说明剔除的数量。
• 如果数据集已被弃用（例如BASE OCDS feed自2020年冻结；api.openar.pt API于2026年归档），不要将其与实时数据混合使用。

5. 小数字与异常值

• 一个大型项目可能主导总额：在阿罗卡，一个项目（Parque da Saúde）占2025年合同的35%。每当某个项目占总量的比例超过约20%时，就应说明。
• 小规模人口使人均数据波动较大。将小地区与大地区一起排名时，必须附带警示说明，或按规模分组。
• 在存在不确定性的情况下，显示不确定性或样本量（例如，学生人数较少时的“观察值vs期望值”学校指标）。

6. 实体与重复

• 同一供应商、学校或机构以不同名称出现 → 使用标识符（税号NIF/NIPC、DGEEC学校代码、INE地区代码）进行匹配，而非名称。
• 检查跨文件重复（重叠的年度文件、同一合同后来的修订版）。
• 分类编码可能不可靠（合同中的CPV代码）：将其作为参考信号使用，进行验证，并报告仍处于“待审核”状态的比例。
• 绝不发布个人的个人数据。对个人税号进行脱敏处理；以公共身份行事的议员和官员则无需隐藏。

7. 公平比较

• 同类比较：相同时期、相同定义、相同单位、相近规模或背景。
• 优先使用进行背景调整后的指标而非原始排名（例如，学校的“针对相似背景的观察值与期望值比较”）。
• 将模式描述为模式，而非指控（“成绩高于预期水平”，而非“X学校的成绩通胀”）。

8. 许可证与署名

• 记录每个数据集或资源的许可证；在dados.gov.pt上，同一数据集可能有不同许可证。
• 常见案例：Portal BASE的other-pd（公有领域）；INE的cc-by（引用INE + 指标代码）；IPMA禁止商业用途；Eurostat和ECB免费包括商业用途但需署名；共和国议会的许可证要求署名。
• 如果许可证为“未指定”或不明确，需说明，并在确认之前不得将该数据用于商业产品。

输出模板

每个数据答案或页面结尾都应包含如下信息块：

数据源：Portal BASE/IMPIC via dados.gov.pt（2025年合同，公有领域）· INE，常住人口2023年（指标0008273，CC BY）
提取日期：2026-11-02
方法：2025年合同价值 ÷ 2023年常住人口
警示信息：参考年份不同；合同 ≠ 总支出；一个项目占阿罗卡总额的35%

快速检查（时间紧迫时）

年份？单位？具体计量什么？是否缺失数据？是否有单一项目主导？同一实体是否被重复计数？比较是否公平？许可证情况如何？——如果任何一项“不确定”，请在输出中说明。