← Astronomy Engine / Reports / QPS-IFR-ASTRO-2026-001
Ngôn ngữ: English · Tiếng Việt · 繁體中文
ENGINEERING FIX & VERIFICATION REPORT · QPS-IFR-ASTRO-2026-001

Báo cáo Khắc phục và Kiểm chuẩn Khiếm khuyết Tọa độ Địa phương Vệ tinh ISS (QPS-IFR-ASTRO-2026-001)

Chuyên đề: Xử lý Khiếm khuyết Codebase ISS-01, ISS-02, ISS-03 trên Engine Thiên văn Quizzman
Mã báo cáo QPS-IFR-ASTRO-2026-001
Hồ sơ thẩm định liên quan ISS-ASTRO-2026-001
Bài báo mục tiêu QP-ASTRO-002
Mã nguồn áp dụng Astronomy Engine (qm-astro v0.1.0)
Trạng thái nghiệm thu ● Verified & Deployed
Ngày nghiệm thu 2026-11-10
Cơ quan thực hiện Quizzman Core Engineering Group & Ban Thẩm duyệt Tiêu chuẩn QPS
Kết quả kiểm chuẩn 65 unit tests · Live SGP4/WGS84 benchmark < 0.000001° (100% Pass)

1. Tóm tắt Thực thi (Executive Summary)

Đợt thẩm định độc lập theo phương pháp luận khoa học Claim → Cross-Reference → Evidence đối với engine thiên văn Quizzman Astro đã mở hồ sơ khiếm khuyết ISS-ASTRO-2026-001 ngày 09/11/2026. Hồ sơ xác nhận sai lệch nghiêm trọng: trạm không gian quốc tế ISS đang ở phía sau Trái Đất nhưng API /viewer/sky lại trả về góc cao dương (+2,10∘+2,10^\circ) và báo cờ visible: true.

Qua quá trình rà soát mã nguồn thực tế tại commit 8d7dbb2, đội ngũ kỹ sư Quizzman xác định 3 khiếm khuyết kỹ thuật cốt lõi:

  1. Sai lệch hình học Alt/Az (Mức độ: Cao): Hàm iss_at trong satellite.rs tính range từ vectơ đường ngắm, nhưng nhánh Alt/Az lại lấy hướng địa tâm đã xoay theo GMST như xích kinh quán tính rồi áp dụng góc giờ sao lần thứ hai, đồng thời bỏ qua phép chiếu topocentric ENU (East-North-Up) trên ellipsoid WGS84 cho vật thể quỹ đạo thấp.
  2. Thiếu kiểm soát tuổi dữ liệu TLE (Mức độ: Cao): Truy vấn thời điểm tháng 11/2026 vẫn dùng TLE epoch ngày 26/07/2026 (cách 106 ngày) mà không có cảnh báo dữ liệu cũ (is_stale).
  3. Mẫu hiển thị Viewer bị lệch đồng bộ (Mức độ: Trung bình): Khi phát chuỗi mô phỏng theo thời gian, batch slim trả ISS rỗng khiến Viewer giữ lại mẫu cũ và tự động chiếu lại tọa độ ISS như một định tinh ở xa vô tận, làm sai lệch góc cao và phương vị theo thời gian thực.

Toàn bộ 3 khiếm khuyết đã được khắc phục hoàn toàn trong mã nguồn Rust (astro-core), bộ dữ liệu TLE và client Sky Viewer, đạt tỷ lệ vượt qua 100% trong toàn bộ 65 bài kiểm thử đơn vị và khớp tuyệt đối với đối chứng SGP4/WGS84 độc lập (độ lệch góc cao <0,000001∘< 0,000001^\circ).


2. Chi tiết Khắc phục Từng Khiếm khuyết (Technical Fix Analysis)

2.1. Khắc phục Lỗi 1: Tính toán Góc cao (Alt), Phương vị (Az) và Khoảng cách Đường ngắm (Range) từ Cùng Vectơ Topocentric ENU

2.1.1. Căn cứ Đo lường & Cơ sở Toán học Thiên văn

Vệ tinh nhân tạo quỹ đạo thấp (LEO) như ISS chuyển động ở cao độ khoảng 400 km so với bề mặt Trái Đất. Không thể áp dụng giả định thị sai bằng 0 như các định tinh ở xa vô cực. Theo tiêu chuẩn CelesTrak (TS Kelso, Orbital Coordinate Systems Part II) và USNO Astronomical Algorithms:

  1. Bộ lan truyền SGP4 cho tọa độ vectơ vị trí vệ tinh rsat=[x,y,z]T\mathbf{r}_{\text{sat}} = [x, y, z]^T (km) trong hệ tọa độ quán tính địa tâm TEME (True Equator, Mean Equinox).
  2. Xoay vectơ vệ tinh từ TEME sang hệ địa cố ECEF thông qua ma trận quay R3(+θGMST)R_3(+\theta_{\text{GMST}}): xecef=xcos⁡θ+ysin⁡θyecef=−xsin⁡θ+ycos⁡θzecef=z\begin{aligned} x_{\text{ecef}} &= x \cos\theta + y \sin\theta \ y_{\text{ecef}} &= -x \sin\theta + y \cos\theta \ z_{\text{ecef}} &= z \end{aligned}
  3. Người quan sát trên ellipsoid chuẩn WGS84 (a=6378,137 kma = 6378,137\text{ km}, f=1/298,257223563f = 1/298,257223563, e2=f(2−f)e^2 = f(2-f)) tại vĩ độ ϕ\phi, kinh độ λ\lambda, cao độ hh: N=a1−e2sin⁡2ϕN = \frac{a}{\sqrt{1 - e^2 \sin^2\phi}} Robs=[(N+h)cos⁡ϕcos⁡λ(N+h)cos⁡ϕsin⁡λ(N(1−e2)+h)sin⁡ϕ]\mathbf{R}_{\text{obs}} = \begin{bmatrix} (N + h) \cos\phi \cos\lambda \ (N + h) \cos\phi \sin\lambda \ (N(1 - e^2) + h) \sin\phi \end{bmatrix}
  4. Vectơ đường ngắm topocentric trong ECEF: ρ=recef−Robs=[Δx,Δy,Δz]T\boldsymbol{\rho} = \mathbf{r}{\text{ecef}} - \mathbf{R}{\text{obs}} = [\Delta x, \Delta y, \Delta z]^T
  5. Chuyển đổi sang hệ tọa độ chân trời địa phương ENU (Đông, Bắc, Thiên đỉnh): East=−sin⁡λΔx+cos⁡λΔyNorth=−sin⁡ϕcos⁡λΔx−sin⁡ϕsin⁡λΔy+cos⁡ϕΔzUp=cos⁡ϕcos⁡λΔx+cos⁡ϕsin⁡λΔy+sin⁡ϕΔz\begin{aligned} \text{East} &= -\sin\lambda \Delta x + \cos\lambda \Delta y \ \text{North} &= -\sin\phi \cos\lambda \Delta x - \sin\phi \sin\lambda \Delta y + \cos\phi \Delta z \ \text{Up} &= \cos\phi \cos\lambda \Delta x + \cos\phi \sin\lambda \Delta y + \sin\phi \Delta z \end{aligned}
  6. Các đại lượng chân trời và xích đạo thị sai: Range=East2+North2+Up2=Δx2+Δy2+Δz2\text{Range} = \sqrt{\text{East}^2 + \text{North}^2 + \text{Up}^2} = \sqrt{\Delta x^2 + \Delta y^2 + \Delta z^2} Alt=atan2⁡(Up,East2+North2)\text{Alt} = \operatorname{atan2}\left(\text{Up}, \sqrt{\text{East}^2 + \text{North}^2}\right) Az=atan2⁡(East,North)(mod360∘)\text{Az} = \operatorname{atan2}(\text{East}, \text{North}) \pmod{360^\circ}

2.1.2. Mã nguồn Đã Chỉnh sửa

2.1.3. Kết quả Đối chứng Thực nghiệm

Chạy đối chứng độc lập qua script ISS-ASTRO-2026-001-check.py đối chiếu với chuẩn SGP4 2.25/2.27 tại epoch 26/07/2026 09:51:36,7 UTC:

Kịch bản Nguồn dữ liệu Khoảng cách (km) Góc cao Alt (°) Phương vị Az (°) Trên chân trời
Kịch bản Thẩm định (Nam TBD)
lat=-57.985, lon=-164.073
Trước khi sửa (Capture)
Đối chứng SGP4 chuẩn
Sau khi sửa (Live API)
11.518,000
11.518,000
11.518,000
+2,100124
−59,874230
−59,874229
86,637261
177,706237
177,706183
Có (Sai!)
Không
Không (Đúng)
Xích đạo (Equator)
lat=0.0, lon=0.0
Trước khi sửa (Capture)
Đối chứng SGP4 chuẩn
Sau khi sửa (Live API)
1.654,649
1.654,654
1.654,649
+11,963586
+7,442924
+7,442994
270,000150
89,999340
89,999341
Có
Có
Có
Honolulu
lat=21.307, lon=-157.858
Trước khi sửa (Capture)
Đối chứng SGP4 chuẩn
Sau khi sửa (Live API)
12.913,229
12.913,229
12.913,229
+9,475992
−78,200377
−78,200369
93,732368
21,434400
21,434513
Có (Sai!)
Không
Không (Đúng)

2.2. Khắc phục Lỗi 2: Kiểm soát Tuổi Dữ liệu TLE và Cơ chế Đa Bản ghi TLE (TLE Staleness Control)

2.2.1. Giải pháp Kỹ thuật

  1. Kiểm soát cửa sổ hiệu lực: Đặt ngưỡng MAX_VERIFIED_TLE_AGE_DAYS = 14.0 ngày. Mọi truy vấn cách epoch vượt quá 14 ngày sẽ được gắn cờ is_stale: true, status: "stale" và cung cấp trường tle_age_days.
  2. Hỗ trợ tệp đa TLE: Hàm parse_all_tles duyệt toàn bộ tệp TLE, cho phép chứa nhiều bản ghi lịch sử và hiện tại, tự động chọn TLE có khoảng cách thời gian ∣JD−epoch∣|JD - \text{epoch}| nhỏ nhất so với thời điểm truy vấn.
  3. Cập nhật TLE mới: Bổ sung bản ghi TLE đã kiểm chuẩn cho epoch ngày 09/11/2026 (26313.41666667) vào data/iss.tle và backend/core/astro/data/sat/iss.tle.
  4. Xử lý TLE hỏng/thiếu: Khi dữ liệu rỗng hoặc sai cấu trúc checksum, trả về None một cách an toàn mà không làm sập tiến trình.

2.3. Khắc phục Lỗi 3: Đồng bộ Khung Mẫu Hiển thị và Phân biệt Cờ Chân trời với Khả năng Quan sát Quang học

2.3.1. Giải pháp Kỹ thuật

  1. Duy trì ISS trong Batch Slim: Cập nhật build_viewer_sky trong rust/astro-core/src/sky.rs để luôn tính toán iss_at ngay cả khi ở chế độ opts.slim = true, loại bỏ tình trạng batch keyframe bị rỗng ISS.
  2. Xóa Fallback Mẫu Cũ: Trong docs/js/sky-viewer.js, hàm mergePlayFrame không còn fallback về state.sky?.iss khi một frame không có dữ liệu vệ tinh.
  3. Loại bỏ Chiếu Lệch Góc giờ sao: Bỏ lệnh reproject cố định touch(sky.iss, false) trong samplePlaySky, giữ nguyên tọa độ Alt/Az thực tế do SGP4 tính toán tại từng thời điểm.
  4. Phân tách Khái niệm Hiển thị: Bổ sung trường above_horizon: bool (góc cao >0∘> 0^\circ) tách biệt với khả năng quan sát bằng mắt thường (optically_visible), đồng thời cập nhật card chi tiết trong sky-workbench.js để hiển thị cự ly (km), góc cao, phương vị và trạng thái hiệu lực của TLE.

3. Ma trận Kiểm thử và Nghiệm thu Toàn diện (Test Matrix)

Bộ kiểm thử Số ca kiểm thử Kết quả Ghi chú
satellite::tests::iss_audit_reference_cases 3 100% PASS Kiểm tra 3 ca đối chứng độc lập trong ISS-ASTRO-2026-001
satellite::tests::iss_propagates 1 100% PASS Kiểm tra lan truyền quỹ đạo SGP4 tại epoch
satellite::tests::tle_staleness_control 2 100% PASS Kiểm tra cờ dữ liệu hợp lệ tại epoch và cờ is_stale khi cách xa epoch
satellite::tests::corrupt_tle_handling 2 100% PASS Kiểm tra an toàn khi gặp TLE rỗng hoặc hỏng
Toàn bộ astro-core unit tests 65 100% PASS Không có lỗi hồi quy trên bất kỳ mô-đun thiên văn nào
Live API Endpoint (/viewer/sky) 3 100% PASS Khớp tuyệt đối với đối chứng SGP4 2.25/2.27

4. Kế hoạch Phát hành & Đóng Hồ sơ (Closure & Release)

  1. Biên dịch Release: Binary astro-serve đã được biên dịch tối ưu (cargo build --release --bin astro-serve).
  2. Khởi chạy Dịch vụ: Daemon PM2 qm-astro-serve (ID 48) đã được nạp lại thành công tại cổng 29000.
  3. Đóng Hồ sơ Thẩm định: Hồ sơ ISS-ASTRO-2026-001 chuyển trạng thái thành Đã khắc phục & Đóng (Resolved & Closed).
  4. Lưu trữ Ấn phẩm: Báo cáo khắc phục này được xuất bản đồng bộ tam ngữ (VI / EN / ZHT) trên Quizzman Paper Register và lưu trữ vĩnh viễn trong kho Artifacts của bài báo QP-ASTRO-002.