# ISS-CAL-2026-002 — 西貢歷史曆法換算與 pSEO 年表不一致

建立時狀態：**OPEN**。建立日期：2026年11月17日。範圍：QP-CAL-001、Calendar 換算 API 及西貢時區歷史文章。

## 1. 重現

對 `/api/calendar/solar-to-lunar` 提交 `{day:29,month:1,year:1968,timezone:"VN",city:"saigon"}`，API 回傳歷史時差 8，農曆卻為正月初一。同一核心函式採用 +8 時為 1967 年十二月三十；西貢正月初一應對應 1968年1月30日。反向 API 亦仍採用固定 +7。

## 2. 問題

CAL-H01：換算未使用所選地區的歷史曆法。CAL-H02：1968年前北方編曆參考時差與民用鐘錶時間混用。CAL-H03：pSEO 獨立年表漏列1911、1947、1955年變更，並記載缺乏核實的1945年4月及1975年5月日期。CAL-H04：270天是固定 +7 與 +8 的計算比較，不足以證明兩地實際刊行曆法的差異。

## 3. 驗收與證據限制

分開民用時間與編曆基準，提供 modern/historical 模式，依各個朔的事件時刻判斷時期；保留核心數值時差介面，測試1968年春節及1975年轉換邊界。文章須更正來源、日期與不確定性。

[IANA Asia](https://raw.githubusercontent.com/eggert/tz/main/asia)僅供比對，並非最終法律權威。[越南檔案機關](https://luutru.gov.vn/quyet-dinh-ve-cach-tinh-lich-va-quan-ly-lich-cua-nha-nuoc.htm)說明1945年3月29日文件及121-CP決定。1975年6月13日有[當時報紙的轉錄](https://1975.luatkhoa.com/2025/06/15/1975-tuan-24-chinh-quyen-buoc-binh-linh-vien-chuc-che-do-cu-di-hoc-cai-tao-viet-nam-chiem-dao-cua-campuchia/)支持；尚未核對報紙原圖及精確實施時刻。不得宣稱已驗證所有歷史印曆。

## 5. 修復與部署驗證 — 2026年11月17日

**目前狀態：已修復、測試並確認正式環境結果；關閉 CAL-H01–CAL-H04 軟體與內容問題。** 第4節的歷史研究限制仍保留。

民用鐘錶時間與編曆基準已分開。選定越南地區時預設採歷史模型；未指定地區仍用現代固定經線曆法；可明確指定 `calendarMode: "modern"`。兩個換算方向採同一基準，按各朔的事件時刻判斷時期。1968年前河內可同時回傳民用 +7 與編曆 +8。

西貢1968年1月29日現回傳農曆1967年十二月三十；正月初一反向換算為1月30日。1947年4月1日案例防止換時後追溯移動既有朔日。pSEO文章、來源、日期、首頁介紹及地區日期路由已修正，撤回5月1日軍管命令、SEATO動機及270天為實證歷史統計的說法。同時修正 QPS 索引建置原有 `parent_id`／`parent.id` 型別錯誤。

測試通過：41項歷史/API檢查；1900–1980兩地模型共59,170次雙向一致性檢查；完整 Calendar npm test（含834項邊界案例及113項核心檢查）；4項pSEO、8項QPS測試；TypeScript與QPS索引建置。部署後另通過15組公開HTTPS檢查。這些結果不構成全部歷史印曆的認證。已保留逐檔備份與回復清單，未變更資料庫、Nginx或系統時區。
