← 曆法計算引擎 / Reports / QPS-IFR-CAL-2026-001
語言版本: Tiếng Việt · English · 繁體中文
工程修復與驗證報告 · QPS-IFR-CAL-2026-001

技術缺陷修復與基準校準報告 (Issue Fix Report ISS-05, ISS-06, ISS-07)

專題:修復 Quizzman 陰陽曆法引擎代碼庫缺陷 ISS-05、ISS-06、ISS-07
報告編號 QPS-IFR-CAL-2026-001
相關審查卷宗 ISS-CAL-2026-001
驗收狀態 ● Verified & Deployed
驗收日期 2026-10-01
執行機構 Quizzman Core Engineering Group & Ban Thẩm duyệt Tiêu chuẩn QPS
驗證成果 834 boundary tests · 146.462 roundtrip (100% Pass)

1. 執行摘要 (Executive Summary)

依據主張 (Claim) → 跨源對照 (Cross-Reference) → 實證檢驗 (Evidence) 方法論所進行之獨立同行評審,共記錄了針對 QP-CAL-001 v1.0.0 的 10 項發現。經工程團隊排查,確認其中有 3 項缺陷直接影響代碼庫,必須立即實施工程修復:

上述 3 項缺陷已於 Node.js/CJS 及 Rust 源碼中直接修復完成,增補自動化回歸測試集,通過 834 組邊界測試及 146,462 日雙向雙射驗證(100% 通過)。

2. 各項缺陷修復細節

已修復並驗證 2.1. 修復 ISS-05:依據 IERS Bulletin B 443 錨定 2025.0 曆元 Delta T
嚴重等級:高

天文測量依據:

依據 IERS Bulletin B 第 443 號(2025-01-01 00:00:00 UTC 地球自轉參數):

UT1 - UTC = +0.0461939 s
TAI - UTC = 37.0000000 s
TT - TAI  = 32.1840000 s (IAU 1976 constant)
ΔT = TT - UT1 = (TT - TAI) + (TAI - UTC) - (UT1 - UTC)
ΔT(2025.0) = 32.184 + 37.0 - 0.0461939 = 69.1378061 s ≈ 69.14 s

修改代碼文件:

  • /opt/qm-calendar/backend/core/astro/delta-t.cjs: Updated 2025 from 70 to 69.14.
  • /opt/qm-calendar/backend/core/_lunar-core.source.cjs: Synchronized 2025: 69.14.
  • /opt/qm-calendar/rust/astro-core/src/delta_t.rs: Updated Rust table entry: (2025, 69.14).

驗證結果: 2024-01-11 朔點相較於 NASA 曆表之偏差由 0.07 分鐘(4.2 秒)降至 0.05 分鐘(3.0 秒)。

已修復並驗證 2.2. 修復 ISS-06:增補符蓮天文台時間 (PLMT, 1906–1911)
嚴重等級:高

歷史法理與 IANA tzdb:

IANA tzdb (Zone Asia/Ho_Chi_Minh) 規範 1906-07-01 至 1911-05-01 採用符蓮天文台子午線時間(巴黎平時 +07:06:30)。

修改代碼文件:

  • /opt/qm-calendar/backend/core/timezone/vietnam-zones.cjs: Added PLMT era (+07:06:30, 1906-07-01 to 1911-05-01).
  • /opt/qm-calendar/backend/core/_lunar-core.source.cjs: Synchronized historical timeline.
已修復並驗證 2.3. 修復 ISS-07:校正 2024 秋分基準數據為 12:44 UT
嚴重等級:確定

權威年曆基準出處:

美國海軍天文台 (USNO) 及 NASA 官方天文年曆發布之 2024 年秋分時刻為 2024-09-22 12:44 UT。

修改代碼文件:

  • /opt/qm-calendar/backend/routes/api/benchmark.cjs: Corrected datum to 2024-09-22T12:44:00Z.

驗證結果: VSOP87D 計算結果與 USNO 官方真值相差 0.1 分鐘(6.0 秒)。

3. 代碼庫修改對照表

議題 源文件路徑 作用範圍 修改內容 測試狀態
ISS-05 backend/core/astro/delta-t.cjs DELTA_T_TABLE 將 2025: 70 改為 2025: 69.14 PASS (0.05 min)
ISS-05 rust/astro-core/src/delta_t.rs DELTA_T_DATA 將 (2025, 70.0) 改為 (2025, 69.14) PASS
ISS-06 backend/core/timezone/vietnam-zones.cjs VN_TIMEZONE_ERAS 增補 PLMT 紀元 (+07:06:30, 1906–1911) PASS (IANA Parity)
ISS-07 backend/routes/api/benchmark.cjs SOLAR_TERMS_REF_2024 修正秋分時刻為 12:44:00Z PASS (0.1 min)

4. 回歸驗證與可復現性矩陣

上述各項工程修復均打包附帶開放可復現性驗證資產: