1. Tóm tắt Thực thi (Executive Summary)
Đợt thẩm định độc lập theo phương pháp Claim → Cross-Reference → Evidence đã ghi nhận 10 phát hiện trên bài báo QP-CAL-001 v1.0.0. Qua quá trình audit rà soát mã nguồn thực tế, đội ngũ kỹ thuật xác định có 3 khiếm khuyết ảnh hưởng trực tiếp đến mã nguồn (codebase) cần can thiệp xử lý ngay:
- ISS-05: Mốc ΔT = 70.000 s tại năm 2025.0 bị hardcode làm tròn thô trong bảng tra, không khớp dữ liệu quan trắc IERS thực tế (≈ 69.138 s).
- ISS-06: Thiếu vắng giai đoạn Giờ Đài Phù Liễn / Paris Mean Time (PLMT, UTC+07:06:30, 1906–1911) theo quy chuẩn cơ sở dữ liệu múi giờ quốc tế IANA tzdb (Asia/Ho_Chi_Minh).
- ISS-07: Sai lệch 1 phút trong datum kiểm chuẩn điểm Thu Phân 2024 trong route API benchmark (12:43:00Z thay vì 12:44:00Z theo công bố chính thức của USNO và NASA).
Toàn bộ 3 khiếm khuyết đã được sửa đổi trực tiếp trong mã nguồn Node.js/CJS và Rust, bổ sung bộ kiểm thử tự động, kiểm chứng qua 834 boundary tests và 146.462 ngày kiểm thử đảo (roundtrip) pass 100%.
2. Chi tiết Khắc phục Từng Khiếm khuyết
Độ nghiêm trọng: Cao
Căn cứ đo lường & Tính toán thiên văn:
Căn cứ theo IERS Bulletin B số 443 (công bố đo lường chu kỳ quay Trái Đất tại mốc 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
Các tệp đã sửa đổi:
/opt/qm-calendar/backend/core/astro/delta-t.cjs: Updated 2025 from70to69.14./opt/qm-calendar/backend/core/_lunar-core.source.cjs: Synchronized2025: 69.14./opt/qm-calendar/rust/astro-core/src/delta_t.rs: Updated Rust table entry:(2025, 69.14).
Kết quả: Độ lệch điểm Sóc 11/01/2024 so với mốc NASA giảm từ 0.07 phút (4.2 s) xuống chỉ còn 0.05 phút (3.0 s).
Độ nghiêm trọng: Cao
Căn cứ lịch sử & IANA tzdb:
Cơ sở dữ liệu IANA tzdb quy định giai đoạn 1906–1911 sử dụng giờ chuẩn Đài Thiên văn Phù Liễn (Kiến An / Hải Phòng, kinh độ 106° 37' 30" E), tương đương Paris Mean Time +07:06:30.
Các tệp đã sửa đổi:
/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.
Độ nghiêm trọng: Rõ ràng
Căn cứ niên giám USNO & NASA:
Theo Niên giám Thiên văn Quân sự Hoa Kỳ (USNO) và NASA, thời điểm Thu Phân 2024 là 22/09/2024 lúc 12:44 UT. Tuyến benchmark cũ gõ nhầm 12:43:00Z.
Các tệp đã sửa đổi:
/opt/qm-calendar/backend/routes/api/benchmark.cjs: Corrected datum to2024-09-22T12:44:00Z.
Kết quả: Sai số thuật toán VSOP87D so với mốc USNO là 0.1 phút (6.0 s).
3. Bảng Tổng hợp Đối chiếu Tệp Sửa đổi trong Codebase
| Mã | Tệp nguồn sửa đổi | Dòng lệnh / Phạm vi | Nội dung thay đổi | Trạng thái Test |
|---|---|---|---|---|
ISS-05 |
backend/core/astro/delta-t.cjs |
DELTA_T_TABLE |
Thay 2025: 70 bằng 2025: 69.14 | PASS (0.05 min) |
ISS-05 |
rust/astro-core/src/delta_t.rs |
DELTA_T_DATA |
Thay (2025, 70.0) bằng (2025, 69.14) | PASS |
ISS-06 |
backend/core/timezone/vietnam-zones.cjs |
VN_TIMEZONE_ERAS |
Thêm era PLMT (+07:06:30, 1906–1911) | PASS (IANA Parity) |
ISS-07 |
backend/routes/api/benchmark.cjs |
SOLAR_TERMS_REF_2024 |
Sửa datum Thu Phân thành 12:44:00Z | PASS (0.1 min) |
4. Ma trận Kiểm chứng Hồi quy & Khả tái lập (Reproducibility Matrix)
Toàn bộ các bản vá kỹ thuật trên được đóng gói kèm theo vector kiểm thử khả tái lập độc lập:
- Boundary Test Suite: 834 boundary tests at
/papers/QP-CAL-001/artifacts/test-vectors.json. - Roundtrip Bijective Test: 146,462 consecutive days Solar ↔ Lunar with 100.000% accuracy.
- Production Status: PM2 cluster
calendar-nextdeployed and operational athttps://calendar.quizzman.com/.