# BornOnce — 数据说明（DATA.md）

取数日期：**2026-11-16**。取数脚本：`tools/fetch_data.py`（可重复运行）。
原始 API 响应快照保存在 `tools/raw/`。

## 来源

世界银行公开数据 API（World Bank Open Data API，无需 key）：

- 国家列表：`https://api.worldbank.org/v2/country?format=json&per_page=400`
- 指标：`https://api.worldbank.org/v2/country/all/indicator/<CODE>?format=json&per_page=20000&date=2018:2023`

| 字段 | 指标 | 含义 | 单位 |
|---|---|---|---|
| `population` | SP.POP.TOTL | 总人口 | 人 |
| `birth_rate` | SP.DYN.CBRT.IN | 粗出生率 | 每 1000 人 |
| `death_rate` | SP.DYN.CDRT.IN | 粗死亡率 | 每 1000 人 |
| `life_expectancy` | SP.DYN.LE00.IN | 出生时预期寿命 | 岁 |
| `under5_mortality` | SH.DYN.MORT | 5 岁以下死亡率 | 每 1000 活产 |
| `gdp_ppp_per_capita` | NY.GDP.PCAP.PP.CD | 人均 GDP（购买力平价） | 现价国际元 |
| `school_years` | SE.SCH.LIFE | 学校预期年限 | 年 |

## 规则

- 每个国家取 **2018–2023 年间最新可用值**；每个值后面都带 `*_year` 年份。
- 派生值（写在文件里，非 API 原值）：
  - `births_per_year = population × birth_rate ÷ 1000`（四舍五入取整）
  - `deaths_per_year = population × death_rate ÷ 1000`（四舍五入取整）
- **不估算、不填补。** 缺失就是 `null`，界面显示“—”。

## 覆盖情况（`public/data.json`）

- **共 217 个国家和地区**（世界银行列表中 `region.id != "NA"` 的全部经济体，含香港、澳门、波多黎各等地区；聚合体如“世界”“东亚”等已排除）。
- 0 个因缺核心数据被排除：人口、出生率、预期寿命 **全部 217 国都是 2023 年值**；死亡率也全部 217 国有值（2023 年）。
- 缺失：5 岁以下死亡率缺 **21** 国、人均 GDP（PPP）缺 **18** 国、学校预期年限缺 **119** 国。该指标最新值多为 2018–2019 年（世界银行此后未更新该序列），年份如实标注。
- 合计（由本文件数字加总得出，非引用外部数字）：
  - 每年出生约 **131,560,931** 人 → 约 **4.17 人/秒**
  - 每年死亡约 **60,984,258** 人 → 约 **1.93 人/秒**
  - 首页计数器用的就是这两个速率。
- 中文国名是翻译对照表（`tools/fetch_data.py` 内 `ZH_NAMES`），仅作显示；英文名为世界银行原名。

## 抽取与死亡模型（模拟方法，不是真实统计）

以下模型只用于游戏内模拟，**不是**世界银行数据，界面《关于 / 数据与方法》里已明说：

1. **出生地**：按每年出生人数（或按人口）加权随机抽取。
2. **性别**：按约 105 名男婴比 100 名女婴的出生性别比抽取（男 105/205）。
3. **家庭收入**：收入倍数按对数正态分布 `exp(N(0, 0.75))` 抽取，乘以该国人均 GDP（PPP）得到示意值，界面标注为“约相当于……倍”，不是真实家庭收入数据。
4. **死亡年龄（简化模型）**：
   - 先按该国 5 岁以下死亡率抽一次：命中则死亡年龄在 0–4 岁均匀抽取；
   - 否则按正态分布 `N(预期寿命, 标准差 12 年)` 抽取，截断到 [5, 105] 岁。
   - 这不是真实生命表，不预测任何真人的寿命；死因只显示大致类别（如心脏疾病、癌症、意外），无细节。
5. **同秒出生的 4 个人**：用同一套方法独立抽取，仅作对照。

## 抽查（2026-11-16，核对 `tools/raw/` 的 API 原始响应）

| 国家 | 人口（2023） | 粗出生率 | 每年出生 | 预期寿命 |
|---|---|---|---|---|
| 印度 IND | 1,438,069,596 | 16.15‰ | 23,219,072 | 72.0 岁 |
| 中国 CHN | 1,410,710,000 | 6.39‰ | 9,014,437 | 77.95 岁 |
| 尼日利亚 NGA | 227,882,945 | 32.95‰ | 7,509,655 | 54.46 岁 |
| 美国 USA | 336,755,052 | 10.7‰ | 3,603,279 | 78.39 岁 |
| 日本 JPN | 124,516,650 | 6.0‰ | 747,100 | 84.04 岁 |

以上全部直接取自 `public/data.json`（每年出生为派生值，人口×粗出生率÷1000 取整）。

## 已知局限

- 学校预期年限覆盖差（98 国有值），只在有值的国家显示。
- 5 岁以下死亡率缺失的 21 国（多为小岛屿地区）跳过幼年夭折抽取，直接按预期寿命分布抽取；已在代码注释中说明。
- 世界银行数据本身有 1–2 年滞后；下次取数只需重跑 `python3 tools/fetch_data.py`。
