# 人口與就業月資料維護

## 更新

在專案目錄執行：

```sh
mise exec -- python fetch_population_series.py
```

程式重抓公開官方 ODS，更新 `population-timeseries.json`，並只替換 `salary.html` 的 `publicHistory` 資料區塊；不更動其餘畫面、公式或私人欄位，不寫 cookies／CSRF 暫存檔。RIS 期別碼由西元轉民國，例如 `2026-10 → 11510`，逐期 POST `type=ods&m4c=m0s7&d5c=期別碼`。CSRF 從當次工作階段取得，不保存。`sourceRequests` 列 14 個單齡月表、當月出生死亡表 `m0s2`、歷年出生死亡表 `y1s3` 及 3 個就業 ODS 的 URL、方法與公開參數，供 `archive_sources.py` 封存原名原格式附件。

## JSON 欄位與口徑

- `checkedAt`：抓取完成時間（UTC）。`series` 各序列按 `period` 升冪排列；`coverage` 列起訖、應有／實有筆數及缺月。
- `householdRegistrationPopulation`：內政部戶籍登記月底人口，單位為精確人數。每筆有 `periodCode`、`total`、`male`、`female`、`under18`、`age65Plus`。未滿 18 歲精確加總 0–17 歲單齡；65 歲以上加總 65–99 歲及 100 歲以上，非用 0–14 歲代替未成年。
- `householdRegisteredEmployment`：主計總處戶籍人口人力資源調查，單位為官方表列千人（四捨五入）；每筆含 Table 5 同表的就業總數、男、女及學歷大分類 `educationIncludingStudentsAndDropouts`（含在學及肄業者），另列同母體 Table 6 最高學歷 `educationByHighestAttained`（國中及以下、高級中等、專科與大學但未達研究所、研究所）。
- `residentPopulationEmployment`：同一發布月份的常住人口人力資源調查，單位同為表列千人；只提供總數、男、女，來源表沒有教育交叉表。常住人口指實際或預期在臺灣地區居住至少六個月者，不論國籍或是否設籍。
- 每個序列均明列 `cohort`、`unit`、`source`、`coverage`。不同母體分開呈現；戶籍就業與常住就業不可相減來推算國籍或外籍人數。就業表列數以千人獨立四捨五入，性別或學歷小計與總數可能相差 1 千人，不應人工調平或視為精確個人數。
- `salary.html` 的 D3 時間線以實際年月為橫軸，可用西元年月選擇起訖，提示同時顯示民國／西元、群組及單位。範圍只能取已取得的官方月資料，不以日期控制項憑空產生新資料。
- 群組切換保留選定範圍；空白、反向、超界或沒有觀測值時顯示錯誤且隱藏舊圖。單月合法，只畫一點；較首期是所選區間首月，較上月須有同母體真實前期。
- `householdRegistrationAnnualBirthsDeaths`：戶政司歷年表 `y1s3` 的「全國」工作表，每年 `year`、`births`、`deaths`（按登記日期，單位人）。民國 46 年基期列的出生死亡欄為 0，不是件數，故自 1958 年起；每年出生減死亡等於表內自然增加，抓取時逐年檢查。`salary.html` 第 4 站「台灣每年出生與死亡人數」卡使用此序列。
- `notProvided.monthlyBirthsAndDeaths` 說明月序列未提供原因；沒有用人口差額反推出生或死亡。

## 來源及涵蓋期間

- **戶籍人口：2025-09 至 2026-10，14/14 月，無缺月。** 戶政司單齡 ODS `m0s7`，`d5c` 從 `11409` 至 `11510`。最新月總數 23,204,000、男 11,403,512、女 11,800,488、未滿 18 歲 3,157,240、65 歲以上 4,823,709 人。
- **戶籍人口就業：2026-01 至 2026-09，9/9 月，無缺月。** 主計總處 115 年 9 月新聞稿表 5、6；總數、性別與最高學歷採同月同母體未季調原值。最新月總數 11,640 千人，男女小計因捨入差 1 千人。
- **常住人口就業：2026-01 至 2026-09，9/9 月，無缺月。** 同稿表 18，最新月 12,204 千人；沒有教育程度欄，包括符合常住定義的非本國籍人士。
- **全國每年出生與死亡：1958 至 2025，68/68 年，無缺年。** 戶政司快速下載「歷年全國人口統計資料 09. 人口年增加及出生死亡率(35)」ODS（`m4c=y1s3`），只取「全國」工作表；另兩表（臺灣地區、各縣市）母體不同，不合併。原檔封存於 `sources/2026-10-17/`，`verify_salary.py` 離線比對封存原檔與 JSON、HTML 一致。2025 年出生 107,812、死亡 200,268；自 2020 年起每年死亡多於出生。
- 就業不延伸或估計未發布的月份。當月出生死亡改由可重播的 `m0s2` ODS 核對；本輪未擴充完整月出生死亡序列，頁面仍只呈現最新月及歷年全國資料。

## 目前可判讀的變化

- 戶籍人口由 2025-09 至 2026-10：總數 **−113,031 人**（23,317,031 → 23,204,000）；男性 **−71,569**、女性 **−41,462**；未滿 18 歲 **−116,397**；65 歲以上 **+206,825**。最新月 2026-09 → 2026-10：總數 −9,251、未滿 18 歲 −10,816、65 歲以上 +17,656 人。
- 戶籍就業者 2026-01 → 2026-09：總數 **−9 千人**（11,649 → 11,640），男性 −21、女性 +11 千人。最高學歷四組依序 −67、−12、+30、+41 千人，均為原表獨立捨入值。
- 常住就業者同期間 **+39 千人**（12,165 → 12,204），男性 +3、女性 +36 千人。此變化只描述常住調查，不與戶籍人口相減或解讀成國籍差額。