# Quizzman Paper Standard (QPS-ISO 1.0) — Complete Context Corpus Generated: 2026-10-01T23:31:59.350Z Canonical Platform: https://paper.quizzman.com ================================================================================ PART 1: QPS-ISO 1.0 STANDARD SPECIFICATION ================================================================================ # Quizzman Paper Standard — ISO Profile (QPS-ISO) - **Standard Identifier:** QPS-ISO - **Edition:** 1.0 - **Release Date:** 2026-10-01 - **Status:** Normative Standard (Quizzman Internal) - **Publisher:** Quizzman Research & Engineering Architecture Board - **Canonical Repository:** `https://github.com/quizzman/qm-paper` - **Publishing Portal:** `https://paper.quizzman.com` --- ## Important Notice and Disclaimer > **QPS-ISO is an internal scholarly and technical publishing profile developed by Quizzman. It adopts selected structural and bibliographic principles from relevant ISO standards. Conformance with QPS-ISO does not imply certification or endorsement by ISO.** This specification defines the editorial, architectural, mathematical, and programmatic standards for research papers, formal algorithm specifications, calendar models, and computational validation studies across the Quizzman knowledge ecosystem. --- ## 1 Scope This document specifies the structural, bibliographic, metadata, and lifecycle requirements for academic papers and technical specifications published within the Quizzman ecosystem (`https://paper.quizzman.com`). The objectives of QPS-ISO are: 1. To establish immutable, machine-readable specifications that serve as the **authoritative source of truth** for Quizzman algorithms, models, historical computations, and validation suites. 2. To guarantee full end-to-end traceability: from ancient or astronomical primary sources, through formal models and mathematical proofs, to software implementation and executable test vectors. 3. To enforce rigorous, reproducible validation and eliminate unsubstantiated promotional language from technical literature. 4. To provide a deterministic schema and automated Continuous Integration (CI) verification process for all published works. --- ## 2 Normative References The following referenced standards provide the baseline principles adopted by QPS-ISO. Specific adaptations and profile deviations are detailed in their respective sections: - **ISO 7144:1986** — *Documentation — Presentation of theses and similar documents* (structural layout and front matter organization). - **ISO 214:1976** — *Documentation — Abstracts for publications and documentation* (abstract completeness and composition). - **ISO 2145:1978** — *Documentation — Numbering of divisions and subdivisions in written documents* (hierarchical decimal numbering without terminal period). - **ISO 690:2021** — *Information and documentation — Guidelines for bibliographic references and citations to information resources* (citation schema and reference structuring). - **ISO 8601-1:2019** — *Date and time — Representations for information interchange* (all date/time stamps). - **ISO 639-1 / ISO 639-2** — *Codes for the representation of names of languages*. - **ISO 3166-1** — *Codes for the representation of names of countries and their subdivisions*. --- ## 3 Terms and Definitions ### 3.1 paper Structured scholarly or technical document published with an immutable identifier, semantic version, machine-readable metadata, and complete bibliographic references. ### 3.2 canonical language The designated primary language edition of a paper against which normative assertions, rules, and proofs are authoritatively evaluated. ### 3.3 normative content Document content that specifies requirements, rules, algorithms, or definitions with which all conformant implementations SHALL comply. ### 3.4 informative content Document content that provides context, rationale, historical background, non-binding examples, implementation commentary, or exploratory discussion. ### 3.5 test vector A deterministic pair of specified input parameters and expected output values used to empirically verify the correctness of an algorithm or rule implementation. ### 3.6 reproducibility manifest Machine-readable metadata block specifying the exact software versions, runtime environments, external ephemerides/datasets, and compiler targets required to replicate computational results. --- ## 4 Document Identification and Versioning ### 4.1 Paper Identifier (QP-ID) Every document SHALL possess a globally unique, invariant identifier conforming to the following format: ```text QP-{DOMAIN}-{NUMBER} ``` - `QP`: Prefix designating Quizzman Paper. - `{DOMAIN}`: Uppercase alphanumeric domain code identifying the subject domain. Standard domains include: - `CAL`: Calendar systems, ephemerides, lunisolar synchronization. - `ASTRO`: Celestial mechanics, planetary positions, coordinate transformations. - `YINGQI`: Ying Qi and cyclical timing models. - `GANZHI`: Sexagenary cycle (Can Chi / Gan Zhi) rules and calculations. - `LIUYAO`: Hexagram combinatorics and mathematical transformations. - `SYS`: Distributed architecture, knowledge graph, and search engine infrastructure. - `BENCH`: Benchmark corpora and verification datasets. - `{NUMBER}`: Zero-padded sequential decimal number with a minimum of three digits (e.g., `001`, `042`). **Rule:** The Paper ID SHALL NOT change across revisions, minor updates, or major rewrites. A paper maintains its identity permanently. ### 4.2 Versioning Model Every paper SHALL specify a semantic version conforming to SemVer 2.0.0 (`MAJOR.MINOR.PATCH`): ```text QP-{DOMAIN}-{NUMBER}@{MAJOR}.{MINOR}.{PATCH} ``` - **PATCH (`x.y.Z`)**: Editorial adjustments, typographical corrections, citation link fixes, formatting improvements, or non-normative clarifying phrasing. Normative rules and algorithm outputs MUST NOT change. - **MINOR (`x.Y.z`)**: Addition of supplementary test vectors, new illustrative examples, expanded informative discussions, or backward-compatible rule clarifications that do not invalidate prior conformant implementations. - **MAJOR (`X.y.z`)**: Fundamental modifications to mathematical models, normative rules, algorithm equations, variable definitions, or breaking behavioral changes in the reference specification. **Rule:** Published versions (`stable`, `deprecated`, `superseded`) are immutable in Git history. Authors SHALL NOT silently modify previously released papers without incrementing the version tag. --- ## 5 Document Lifecycle Every paper SHALL declare its lifecycle status in `metadata.yaml` using one of the following eight enumerated values: ```mermaid graph TD draft([draft]) --> review([review]) review --> proposed([proposed]) proposed --> stable([stable]) draft --> experimental([experimental]) stable --> deprecated([deprecated]) stable --> superseded([superseded]) stable --> retracted([retracted]) deprecated --> superseded ``` 1. **`draft`**: Work in progress. The structure, formulas, and normative statements are subject to arbitrary changes. Not eligible for production reliance. 2. **`review`**: Author-frozen draft submitted for formal peer review, mathematical audit, or historical source criticism. 3. **`proposed`**: Passed peer review; pending final sign-off or public comment period. 4. **`stable`**: Fully vetted and published. Normative rules serve as the authoritative **source of truth** for all Quizzman engineering libraries. 5. **`experimental`**: Fully articulated research paper documenting preliminary exploratory methodologies, heuristic approximations, or prototype models without normative stability guarantees. 6. **`deprecated`**: Still valid for legacy codebases, but scheduled for obsolescence. A warning note SHALL specify migration targets. 7. **`superseded`**: Replaced by a newer paper or major revision. The `superseded_by` metadata attribute SHALL reference the new Paper ID. 8. **`retracted`**: Severely flawed, factually erroneous, or historically invalid. Retracted papers remain archived for historical auditing, but their normative assertions SHALL NOT be relied upon under any circumstances. --- ## 6 Document Taxonomy QPS-ISO classifies all publications into eight distinct types: | Type | Purpose | Validation Requirements | Source & Citation Requirements | |---|---|---|---| | **`method`** | Formal algorithmic or mathematical method for computing calendar, astronomical, or combinatoric states. | Automated test vectors, computational complexity analysis, error bounds. | Primary astronomical/mathematical literature cited with edition and page references. | | **`validation`** | Empirical benchmark comparing Quizzman implementations against external authoritative ground truth. | Full test suite execution, confusion matrices, pass/fail counts, failure analysis. | Ground truth datasets and reference tools cited with exact versions. | | **`specification`** | Normative technical standard defining data structures, interfaces, rule engines, or protocol semantics. | Conformance test suite, edge-case coverage, JSON/TypeScript schema verification. | Upstream standard references (ISO, IETF, Unicode) where applicable. | | **`technical-note`** | Focused analysis of an isolated anomaly, leap-second edge case, or mathematical derivation. | Numerical verification of the specific case. | Specific primary citation for the examined edge case. | | **`historical-study`** | Scholarly analysis of historical calendar decrees, dynasty almanacs, or classical texts. | Source criticism, collation of textual variants, philological analysis. | Rigorous distinction between primary text, commentaries, and modern translations. | | **`dataset`** | Description and curation methodology of a formal validation corpus or historical astronomical catalog. | Schema validation, checksum verification, provenance record. | Original observational records or archival source repositories. | | **`system`** | Architectural description of large-scale computational infrastructure or distributed services. | System load benchmarks, latency profiles, fault-tolerance analysis. | Architecture references, open-source protocol specifications. | | **`review`** | Comprehensive critical survey of existing literature, competing algorithms, or traditional models. | Comparative feature/accuracy matrix across published methods. | Exhaustive bibliography of survey corpus. | --- ## 7 Standard Paper Structure and Applicability Matrix ### 7.1 Structural Components A QPS-ISO paper consists of three major divisions: 1. **Front Matter**: - Paper Title (Multilingual: `en`, `vi`, etc.) - Paper ID & Semantic Version - Status, Publication Date, Revision Date - Authors, Affiliations, ORCID identifiers, and CRediT roles - Abstract (Self-contained, structured) - Standardized Keywords 2. **Main Body (Divisions 1–16)**: - 1 Scope - 2 Normative references - 3 Terms and definitions - 4 Symbols and abbreviated terms - 5 Conventions and assumptions - 6 Background - 7 Sources and materials - 8 Methodology - 9 Formal model - 10 Algorithm or rules - 11 Implementation - 12 Validation - 13 Results - 14 Discussion - 15 Limitations - 16 Conclusion - Bibliography 3. **Annexes**: - Annex A — Algorithms - Annex B — Test vectors - Annex C — Source tables - Annex D — Derivations - Annex E — Supplementary data ### 7.2 Section Applicability Matrix ```text M = Mandatory O = Optional C = Conditional (Mandatory under specific statuses, e.g. stable) N = Not normally applicable ``` | Section | Method | Validation | Specification | Technical Note | Historical Study | Dataset | System | Review | |---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:| | **Front Matter** | M | M | M | M | M | M | M | M | | **1 Scope** | M | M | M | M | M | M | M | M | | **2 Normative references** | M | M | M | O | M | M | M | M | | **3 Terms and definitions** | M | M | M | O | M | M | M | M | | **4 Symbols and abbreviated terms** | O | O | O | O | O | O | O | O | | **5 Conventions and assumptions** | M | O | M | O | M | M | M | O | | **6 Background** | O | O | O | O | M | O | O | M | | **7 Sources and materials** | M | M | O | O | M | M | O | M | | **8 Methodology** | M | M | O | O | M | M | M | O | | **9 Formal model** | M | O | M | O | O | O | M | O | | **10 Algorithm or rules** | M | O | M | O | N | N | M | N | | **11 Implementation** | O | M | M | O | N | O | M | N | | **12 Validation** | M | M | C | O | N | M | M | N | | **13 Results** | M | M | O | M | M | M | M | M | | **14 Discussion** | O | M | O | O | M | O | M | M | | **15 Limitations** | C | M | C | M | M | M | M | M | | **16 Conclusion** | M | M | M | M | M | M | M | M | | **Bibliography** | M | M | M | M | M | M | M | M | | **Annexes** | O | O | O | O | O | O | O | O | *Conditional rules:* - For `stable` Method papers, **15 Limitations** and **12 Validation** are **Mandatory**. - For `stable` Validation papers, **12 Validation** and **13 Results** are **Mandatory**. - For `stable` Specification papers, **12 Validation** (conformance testing) and **15 Limitations** are **Mandatory**. --- ## 8 Numbering Principles (ISO 2145 Profile) QPS-ISO adheres strictly to ISO 2145 for division and subdivision numbering: 1. **Hierarchy**: Divisions are numbered with Arabic numerals separated by single dots: ```text 1 Scope 2 Normative references 3 Terms and definitions 3.1 civil day 3.2 solar term 3.2.1 major solar term (Zhongqi) ``` 2. **Terminal Period Prohibition**: Division numbers **SHALL NOT** end with a period. - Correct: `1 Scope`, `3.1 civil day` - Strictly Prohibited: `1. Scope`, `3.1. civil day`, `3.1.1.` 3. **Cross-References**: References to sections within prose SHALL use lowercase keywords with exact division numbers: - Correct: `see 7.3`, `as specified in 10.2`, `refer to Annex B` - Prohibited: `see section 7.3.`, `as defined in Section #10` 4. **Generated Anchors**: Heading slugs are automatically generated as `section-{number}` (e.g., `#section-3-1`) to ensure permanent, stable hyperlink anchors. --- ## 9 Normative and Informative Content ### 9.1 Distinctions - **Normative Content**: Establishes mandatory behavior, formulas, and constraints that reference software libraries MUST execute without deviation. - **Informative Content**: Explains context, rationale, historical context, or suggested optimizations. Informative content cannot establish binding requirements. ### 9.2 Markup and Metadata Annotation Sections or Annexes may declare their normative designation explicitly: ```markdown ## 10 Algorithm or rules ``` or ```markdown ## 6 Background ``` Annexes SHALL explicitly declare their type in the title: - `## Annex A — Astronomical Algorithms (Normative)` - `## Annex B — Test Vectors and Benchmarks (Informative)` --- ## 10 Normative Vocabulary When defining normative requirements, algorithms, and interfaces, papers SHALL use the following standardized modal verbs in capital letters: | Keyword | Definition | |---|---| | **SHALL** | An absolute, mandatory requirement of the specification. Conformance is impossible without compliance. | | **SHALL NOT** | An absolute prohibition. Any implementation exhibiting this behavior is non-conformant. | | **SHOULD** | A strong recommendation. Valid reasons may exist in particular circumstances to ignore this item, but the full implications MUST be understood and documented. | | **SHOULD NOT** | A strong recommendation against. | | **MAY** | Truly optional behavior. | *Usage constraint:* Authors SHALL NOT use uppercase `SHALL`, `SHOULD`, etc., in narrative or historical background prose where no normative rule is being formulated. --- ## 11 Abstract Composition (ISO 214 Profile) In accordance with ISO 214 principles, an abstract in QPS-ISO: 1. SHALL be completely **self-contained**, intelligible without reading the paper. 2. SHALL NOT exceed 300 words. 3. SHALL NOT contain promotional hype, commercial calls to action (CTA), or subjective marketing slogans. 4. SHALL be structured into four distinct informational segments: - **Background / Problem**: The specific computational, historical, or astronomical problem addressed. - **Method**: The formal algorithm, mathematical approach, or philological method applied. - **Results**: Quantitative accuracy bounds, verified test cases, or historical findings. - **Conclusion**: The normative implications or recommended implementation standard. --- ## 12 Source and Evidence Model To ensure scholarly and algorithmic integrity, Quizzman papers distinguish epistemic assertions according to a strict classification: ```text source → Direct citation of an uninterpreted primary text or ephemeris. computed → Output produced deterministically by an audited computational model. derived → Mathematical deduction proven from established axioms or rules. interpretation → Scholarly hypothesis or commentary explaining an ambiguous source. tradition → Heuristic convention transmitted through historical lineages without physical proof. hypothesis → Proposed explanation subject to ongoing empirical verification. normative-rule → Binding operational decision codified into software logic. ``` ### 12.1 Source Classification Hierarchy Sources listed in `references.yaml` SHALL be classified into: 1. `primary`: Original dynasty astronomical tables, ephemeris archives (JPL DE440), foundational mathematical treatises. 2. `secondary`: Peer-reviewed scholarly monographs, commentaries, and critical editions. 3. `tertiary`: Encyclopedias, general textbooks, overview surveys. 4. `software`: Reference astronomical engines, official standard libraries. 5. `dataset`: Structured validation sets, benchmark databases. 6. `traditional-text`: Pre-modern manuscript copies, woodblock prints, transmitted canons. 7. `legal`: Official state calendar decrees or governmental standards. 8. `archival`: Historical observatory logs or rare manuscripts. 9. `web`: Online resources, documentation portals. **Authoring Rule:** Writers SHALL NOT present a later scholarly interpretation as if it were the direct text of a primary source. --- ## 13 Reproducibility Manifest Every paper that introduces or validates computational methods SHALL provide a `reproducibility` manifest in `metadata.yaml`, including: ```yaml reproducibility: software: name: Quizzman Calendar Engine version: 2.1.0 commit: a9b4c81f7e02 runtime: node: 20.x algorithms: - VSOP87D - ELP2000-82B datasets: - CAL-BENCH-001@1.2.0 timezone_database: name: IANA tzdb version: 2026b ``` Finite test suite outcomes (e.g. `139/139 test cases passed`) SHALL specify the exact input domain and limitations. Authors SHALL NOT extrapolate finite test passes into claims of "universal 100% accuracy". --- ## 14 Multilingual Model A paper MAY provide translations alongside its canonical text: ```yaml language: vi translations: - en - zh-Hant ``` ### Prevailing Edition Rule In the event of semantic discrepancy, grammatical divergence, or translation ambiguity between language editions: > **The canonical-language version SHALL prevail.** This rule guarantees unambiguous legal and algorithmic interpretations across international deployments. --- ## 15 Conformance and Designation A document may claim compliance with this standard if and only if it satisfies all of the following requirements: 1. `metadata.yaml` passes schema validation against `schema/paper.schema.json`. 2. All cited references in `references.yaml` validate against `schema/citation.schema.json`. 3. Division numbering conforms to ISO 2145 rules without terminal dots. 4. All mandatory sections for its declared paper type are present. 5. All internal cross-references and citation links resolve without error. 6. The paper complies with `docs/EDITORIAL-POLICY.md`. Documents meeting these criteria are designated: ```text QPS-ISO 1.0 Conformant ``` **Prohibited Designations:** Under no circumstances SHALL any paper be labeled "ISO Certified", "ISO Approved", or "Official ISO Standard". ================================================================================ PART 2: PUBLISHED PAPERS CATALOG & ABSTRACTS ================================================================================ ### Paper QP-CAL-001: Kiến trúc hệ thống tính toán lịch pháp âm dương và mô hình quy chiếu thiên văn Quizzman - **Type**: system | **Status**: stable | **Version**: 1.0.0 - **Publication Date**: 2026-10-01 - **Canonical URL**: https://paper.quizzman.com/papers/QP-CAL-001/ - **Abstract**: Background / Context: Lịch âm dương phương Đông (Lunisolar Calendar) và các hệ thống tri thức lịch pháp dân sự, thuật số cổ truyền đặt ra yêu cầu tính toán kết hợp giữa cơ học thiên văn hiện đại và các quy ước văn hóa, lịch sử phức tạp. Trong các hệ thống tính toán phân tán, sự thiếu đồng nhất giữa ranh giới ngày dân sự địa phương, phép chiếu thời gian động học và các mô hình hành tinh thường dẫn đến những sai số nghiêm trọng như lệch ngày sóc, sai lệch tiết khí và tính sai Can Chi. Methodology: Công trình này giới thiệu toàn diện kiến trúc hệ thống tính toán lịch pháp @quizzman/qm-calendar phiên bản 1.2.0. Hệ thống tích hợp chuỗi tính toán thiên văn chính xác cao: quy đổi Julian Date liên tục theo chuẩn quốc tế, xấp xỉ kinh độ hoàng đạo Mặt Trời qua lý thuyết hành tinh VSOP87 (129 số hạng theo Jean Meeus), giải nghiệm điểm Sóc thiên văn theo Meeus (Chương 49), mô hình nội suy liên tục 5 năm cho hiệu số $\Delta T$, và giải thuật xác định 24 Tiết Khí dựa trên thời điểm chuyển tiếp UTC thực tế. Đồng thời, hệ thống chuẩn hóa giải thuật Giờ Thái Dương Thực (True Solar Time) với phương trình thời gian (Equation of Time), phân định ranh giới Dạ Tý / Chính Tý, chu kỳ 60 Hoa Giáp, Thập Nhị Trực theo chi tháng tiết khí, Nhị Thập Bát Tú neo theo mốc JDN cố định, và bảng tra cứu 8 giai đoạn múi giờ lịch sử Việt Nam. Results: Báo cáo kiểm định và hồ sơ audit thuật toán đã xác định và khắc phục triệt để 9 khiếm khuyết cơ bản (A01 đến A09). Hệ thống đã vượt qua 100% (139/139) ca kiểm chuẩn biên và hồi quy trong bộ benchmark độc lập, 834 phép kiểm tra ranh giới, cùng 146 462 ngày kiểm thử đối ứng hai chiều liên tục từ năm 1800 đến 2200 với 0 lỗi sai biệt. Kết quả so chuẩn phân chí năm 2024 với dữ liệu của Đài quan sát Hải quân Hoa Kỳ (USNO) đạt sai số kinh độ $|\Delta\lambda_\odot| < 0.0005^\circ$, và thời điểm Sóc khớp với NASA trong giới hạn 0.1 phút. Conclusion: Hệ thống @quizzman/qm-calendar thiết lập một khung quy chuẩn toán học khả kiểm, có tính tái lập cao và đóng vai trò nguồn chân lý thực thi (executable source of truth) chuẩn mực cho nghiên cứu lịch pháp và các dịch vụ tính toán liên quan. --- ### Paper QP-EXAMPLE-001: Phương pháp tham chiếu xác định ranh giới ngày dân sự - **Type**: method | **Status**: stable | **Version**: 1.0.0 - **Publication Date**: 2026-10-01 - **Canonical URL**: https://paper.quizzman.com/papers/QP-EXAMPLE-001/ - **Abstract**: Background / Problem: Trong tính toán lịch âm dương và hệ thống thiên văn Quizzman, việc xác định ranh giới ngày dân sự (civil day boundary) tại thời điểm nửa đêm cục bộ là tiền đề bắt buộc để phân định ngày đầu tháng (sóc / new moon) và tiết khí. Sự thiếu nhất quán giữa múi giờ quy chiếu và thang đo thời gian có thể dẫn đến lệch nguyên một ngày lịch. Method: Tài liệu này chuẩn hóa phương pháp quy chiếu toán học xác định thời khắc chuyển giao ngày dân sự dựa trên thời gian thực địa phương gắn với kinh tuyến quy chiếu, tuân thủ nguyên tắc ISO 8601 và thuật toán khử thời gian động học của Meeus. Results: Thuật toán đề xuất được kiểm chứng trên bộ chuẩn đối sánh CAL-BENCH-001 (phiên bản 1.2.0) với 139 trường hợp kiểm thử biên, đạt kết quả trùng khớp hoàn toàn với dữ liệu thực nghiệm tiêu chuẩn. Conclusion: Phương pháp này được phê chuẩn làm quy chuẩn source of truth chuẩn mực cho thư viện @quizzman/qm-calendar và các dịch vụ tính lịch thuộc hệ sinh thái Quizzman. --- ### Paper QP-ASTRO-001: Kiến trúc hệ thống tính toán thiên văn ephemeris, mô hình quy chiếu tọa độ hành tinh và chuẩn kiểm định độ chính xác Level-3 Quizzman - **Type**: system | **Status**: stable | **Version**: 1.0.0 - **Publication Date**: 2026-10-01 - **Canonical URL**: https://paper.quizzman.com/papers/QP-ASTRO-001/ - **Abstract**: Bối cảnh (Background / Context): Các hệ thống tính toán tọa độ thiên văn, niên giám hành tinh và lập lịch hiện đại đòi hỏi sự kết hợp chặt chẽ giữa các mô hình giải tích cơ học thiên thể cổ điển và các nghiệm số tích phân quỹ đạo độ chính xác cao. Trong các ứng dụng dịch vụ tính toán thời gian thực, sự phụ thuộc đơn nhất vào các tệp dữ liệu kernel số trị kích thước lớn (như JPL DE series) thường gây suy giảm hiệu năng khởi động và hạn chế khả năng ngoại suy ngoài khoảng thời gian bao phủ, trong khi các công thức rút gọn cổ điển (như Jean Meeus rút gọn) lại phát sinh sai số vị trí đáng kể tại các điểm phân chí và ranh giới tuần trăng. Phương pháp (Methodology): Công trình này giới thiệu kiến trúc phân tầng của hệ thống tính toán thiên văn @quizzman/qm-astro phiên bản 0.1.0, kết hợp giải pháp kép giữa nhân số trị JPL DE440 SPK (định dạng DAF/Chebyshev) và chuỗi giải tích hành tinh VSOP87D (bản đầy đủ của Bretagnon và Francou) cùng lý thuyết chuyển động Mặt Trăng ELP/MPP02 (Chapront và Francou). Hệ thống triển khai cơ chế điều phối chuyển mạch tự động CompositeProvider, áp dụng chuẩn quy đổi thời gian động học Trái Đất (TT/TDB) liên tục qua mô hình $\Delta T$ tích hợp giữa đa thức Espenak-Meeus và bảng tham số định hướng Trái Đất IERS finals2000A. Vị trí biểu kiến được quy chuẩn qua mô hình chương động IAU 2000B, quang hành sai hàng năm, hiệu chỉnh thời gian truyền ánh sáng, mô hình khúc xạ khí quyển Bennett / Kasten–Young có xét hạ độ cao chân trời địa hình, và thuật toán phân định ranh giới chòm sao IAU 1930 qua hình học đa giác phẳng. Kết quả (Results): Báo cáo kiểm định thực nghiệm và bộ kiểm chuẩn độc lập Level-3 ghi nhận 100% tỷ lệ vượt qua (237/237 ca kiểm thử tự động) trên 6 mô-đun kiểm chứng. Độ sai biệt vectơ vị trí Cartesian so với hệ thống JPL Horizons đạt dưới 1 km đối với các hành tinh vòng trong. Kinh độ hoàng đạo biểu kiến của Mặt Trời tại điểm phân chí năm 2024 đạt sai số tồn dư $|\Delta\lambda_\odot| \ll 0.02^\circ$, thời điểm Sóc thiên văn khớp với dữ liệu quan sát của NASA trong khoảng 1.0 phút, và sai số thời điểm mọc/lặn của Mặt Trời tại kinh vĩ độ Hà Nội đạt dưới 30 giây khi tính đủ khúc xạ khí quyển. Kết luận (Conclusion): Hệ thống @quizzman/qm-astro thiết lập một nền tảng tính toán ephemeris có cấu trúc phân tầng khả kiểm, đạt chuẩn độ chính xác Level-3, đóng vai trò nguồn chân lý thực thi (executable source of truth) phục vụ công cụ hiển thị bầu trời Sky Viewer, các dịch vụ tra cứu lịch thiên văn, và hạ tầng API vị trí hành tinh. --- ### Paper QP-ASTRO-020: Thực nghiệm kiểm định độ chính xác Level-3 và đối chuẩn vi sai hệ thống ephemeris Quizzman Astro với dữ liệu NASA JPL Horizons - **Type**: validation | **Status**: stable | **Version**: 1.0.0 - **Publication Date**: 2026-10-01 - **Canonical URL**: https://paper.quizzman.com/papers/QP-ASTRO-020/ - **Abstract**: Bối cảnh (Background / Context): Việc xác nhận độ tin cậy của một hệ thống tính toán thiên văn đòi hỏi phương pháp đo kiểm vi sai thực nghiệm độc lập so với các chuẩn quy chiếu quốc tế được thừa nhận rộng rãi như NASA JPL Horizons, Cơ quan Định hướng Trái Đất và Hệ quy chiếu Quốc tế (IERS), và Niên giám Thiên văn USNO. Các hệ thống phần mềm thương mại thường đưa ra tuyên bố về độ chính xác mà thiếu hồ sơ kiểm chuẩn khả tái lập, gây khó khăn cho việc tích hợp vào các dịch vụ tính toán lịch pháp và thiên văn đòi hỏi độ tin cậy cao. Phương pháp (Methodology): Báo cáo kiểm định này công bố phương pháp và kết quả đo kiểm độc lập toàn diện của bộ kiểm chuẩn Level-3 áp dụng cho hệ thống @quizzman/qm-astro phiên bản 0.1.0 (bao gồm lõi tính toán Node.js và crate Rust qm-astro-core). Quy trình đo kiểm bao gồm: (1) so chuẩn vectơ trạng thái Cartesian ba chiều giữa hạt nhân số trị JPL DE440 SPK với hệ thống NASA JPL Horizons Web API; (2) đánh giá sai số tồn dư kinh độ hoàng đạo biểu kiến của Mặt Trời tại 4 điểm phân chí năm 2024 so với bảng USNO; (3) đối chuẩn thời điểm Sóc thiên văn với danh mục nguyệt thực NASA; (4) đo kiểm thời điểm mọc và lặn của Mặt Trời tại trạm quan trắc địa phương có xét chiết quang khí quyển Bennett và hạ độ cao chân trời Kasten–Young; (5) thực thi ma trận kiểm thử hồi quy gồm 237 ca kiểm chuẩn tự động trên 6 mô-đun phần mềm; và (6) xác lập nguyên tắc phân định trách nhiệm kiến trúc độc lập giữa tầng ephemeris thiên văn @quizzman/qm-astro và hệ thống tính lịch dân sự @quizzman/qm-calendar. Kết quả (Results): Toàn bộ 237 ca kiểm chuẩn tự động đạt tỷ lệ vượt qua 100% với 0 ca thất bại và 0 ca bỏ qua. Vectơ vị trí Cartesian của Mặt Trời và các hành tinh vòng trong khớp với JPL Horizons trong giới hạn sai số không gian dưới 0.85 km (đáp ứng tiêu chuẩn Level-3 dưới 1 km). Kinh độ hoàng đạo Mặt Trời tại các điểm phân chí năm 2024 đạt sai số tồn dư tuyệt đối $|\Delta\lambda_\odot| \le 0.0018^\circ$ (thấp hơn nhiều so với ngưỡng $0.02^\circ$). Thời điểm Sóc thiên văn khớp với danh mục NASA trong khoảng 1.03 phút, và sai số thời điểm mặt trời mọc/lặn tại Hà Nội đạt dưới 24 giây. Kết luận (Conclusion): Dữ liệu kiểm định xác nhận hệ thống @quizzman/qm-astro đáp ứng đầy đủ các tiêu chí khắt khe của cấp độ chính xác Level-3, bảo đảm tính tái lập khoa học và xác lập hồ sơ kiểm chứng chính thức cho toàn bộ hệ sinh thái tính toán Quizzman. ================================================================================ PART 3: ACTIVE ISSUES & AUDIT DOSSIERS ================================================================================ ### Issue ISS-CAL-2026-001: Báo cáo Thẩm định Độc lập và Danh mục Khiếm khuyết Kỹ thuật (Technical Audit & Errata Dossier) - **Target Paper**: QP-CAL-001 - **Status**: Open / Accepted for Patch (Target Patch: v1.0.1) - **Summary**: Báo cáo ghi nhận 10 phát hiện thẩm định độc lập theo phương pháp Claim → Cross-Reference → Evidence. Các phát hiện tập trung vào mâu thuẫn công thức JDN §7.1, sai số đại số về tính đẳng cấu chu kỳ 60 Hoa Giáp với Z10 x Z12, xuất xứ hằng số Meeus epoch 1900 vs J2000, trộn lẫn các thang thời gian TT/UT/UT1/UTC, sai lệch hằng số Delta T tại 2025.0 so với IERS, và giới hạn phương pháp luận của phép thử roundtrip. - **Findings Count**: 10 ================================================================================ PART 4: ISSUE FIX REPORT (QPS-IFR-CAL-2026-001) ================================================================================ # BÁO CÁO KHẮC PHỤC VÀ KIỂM CHUẨN KHIẾM KHUYẾT KỸ THUẬT (ISSUE FIX REPORT) ## Chuyên đề: Xử lý Khiếm khuyết Codebase ISS-05, ISS-06, ISS-07 * **Mã báo cáo:** `QPS-IFR-CAL-2026-001` * **Hồ sơ liên quan:** `ISS-CAL-2026-001` (Báo cáo Thẩm định Độc lập & Danh mục Khiếm khuyết Kỹ thuật) * **Bài báo mục tiêu:** `QP-CAL-001 v1.0.0` → Kế hoạch bản vá `v1.0.1` * **Mã nguồn áp dụng:** Engine Lịch pháp Quizzman (`qm-calendar v1.2.0` → `v1.2.1`) * **Ngày thực hiện & Nghiệm thu:** 2026-10-01 * **Cơ quan thực hiện:** Quizzman Core Engineering Group & Ban Thẩm duyệt Tiêu chuẩn QPS --- ## 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: 1. **ISS-05 (Cao):** Mốc $\Delta T = 70.000\text{ 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ế ($\approx 69.138\text{ s}$). 2. **ISS-06 (Cao):** Thiếu vắng giai đoạn Giờ Đài Phù Liễn / Paris Mean Time (`PLMT`, UTC+7: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`). 3. **ISS-07 (Rõ ràng):** 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). Toàn bộ hệ thống đã được biên dịch, nạp lại trên môi trường sản xuất (PM2 cluster) và pass 100%. --- ## 2. Chi tiết Khắc phục Từng Khiếm khuyết ### 2.1. Khắc phục ISS-05: Neo chuẩn $\Delta T$ năm 2025.0 theo IERS Bulletin B 443 #### a. Bối cảnh & Căn cứ Đo lường - Trong phiên bản cũ, bảng tra `DELTA_T_TABLE` hardcode giá trị nguyên `2025: 70`. Mặc dù đoạn mã có ghi nhận đây là mốc nối tạm thời (*"compatibility handoff"*), việc thiếu chuẩn hóa so với số liệu quan trắc của IERS (International Earth Rotation and Reference Systems Service) dẫn đến độ bất định $0.86\text{ s}$ không cần thiết. - 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\text{ s}$$ $$TAI - UTC = 37.0000000\text{ s}$$ - Theo chuẩn của Cơ quan Niên giám Thiên văn Quân sự Hoa Kỳ (USNO) và Hiệp hội Thiên văn Quốc tế (IAU): $$\Delta T = TT - UT1 = (TT - TAI) + (TAI - UTC) - (UT1 - UTC)$$ Biết rằng hiệu số định nghĩa tuyệt đối giữa Thời gian Trái Đất (Terrestrial Time - TT) và Thời gian Nguyên tử Quốc tế (TAI) là hằng số: $$TT - TAI = 32.184\text{ s}$$ Ta tính được giá trị thực nghiệm chính xác của $\Delta T$ tại 2025.0: $$\Delta T_{2025.0} = 32.184 + 37.0 - 0.0461939 = 69.1378061\text{ s} \approx 69.14\text{ s}$$ #### b. Các tệp đã sửa đổi trong Codebase 1. `/opt/qm-calendar/backend/core/astro/delta-t.cjs`: - Cập nhật mốc 2025 từ `70` sang `69.14`. - Bổ sung chú thích minh thị xuất xứ từ IERS Bulletin B 443 và cơ chế chuyển tiếp trơn tru sang đa thức ngoại suy từ năm 2030. 2. `/opt/qm-calendar/backend/core/_lunar-core.source.cjs`: - Đồng bộ giá trị `2025: 69.14`. 3. `/opt/qm-calendar/rust/astro-core/src/delta_t.rs`: - Cập nhật phần tử bảng tra Rust: `(2025, 69.14)`. #### c. Kết quả Thử nghiệm & Kiểm chuẩn - **Tính liên tục & đơn điệu:** Chạy kiểm thử hồi quy `algorithm-regression.test.cjs` qua toàn bộ dải năm $2025.0 \to 2050.0$ với bước nhảy $0.25$ năm. Độ chênh lệch tại biên $2025.000001$ so với $2025.0$ là $< 0.000002\text{ s}$, đảm bảo tính trơn và đơn điệu hoàn hảo. - **Tác động tới điểm Sóc:** Khi chạy lại kiểm chuẩn điểm Sóc 11/01/2024 với $\Delta T$ mới, độ lệch so với mốc NASA giảm từ $0.07\text{ phút}$ ($4.2\text{ s}$) xuống chỉ còn **$0.05\text{ phút}$** ($3.0\text{ s}$). --- ### 2.2. Khắc phục ISS-06: Bổ sung giai đoạn Giờ Đài Phù Liễn (PLMT) 1906–1911 #### a. Bối cảnh & Căn cứ Lịch sử - Cơ sở dữ liệu múi giờ quốc tế IANA tzdb (`tzdata.zi` mục `Zone Asia/Ho_Chi_Minh`) quy định lịch sử múi giờ Việt Nam như sau: ``` Z Asia/Ho_Chi_Minh 7:6:30 - LMT 1906 Jul 7:6:30 - PLMT 1911 May 7 - %z 1942 D 31 23 ... ``` - **Sử liệu pháp lý:** Nghị định của Toàn quyền Đông Dương ban hành áp dụng giờ chuẩn của Đài Thiên văn Phù Liễn (Kiến An / Hải Phòng) kể từ ngày 01/07/1906. Đài Phù Liễn có kinh độ thiên văn $106^\circ 37' 30''\text{E}$, tương đương giờ chuẩn Paris Mean Time tại Đông Dương là $+07:06:30$. - Đến ngày 01/05/1911, chính quyền Đông Dương mới chính thức ban hành nghị định chuyển sang múi giờ chuẩn quốc tế thứ 7 (UTC+7:00:00). - Trước đây, codebase đã ghi nhận sự tồn tại của PLMT trong chú thích mã nguồn nhưng cố tình giản lược gộp vào UTC+7. Việc này khiến tuyên bố của Paper *"số hóa trọn vẹn theo IANA"* bị coi là không trung thực với chính tzdb. #### b. Các tệp đã sửa đổi trong Codebase 1. `/opt/qm-calendar/backend/core/timezone/vietnam.cjs`: - Phân tách PERIOD 2 thành 2 giai đoạn con tường minh: - **PERIOD 2A (01/07/1906 – 30/04/1911):** Đông Dương thuộc Pháp — Giờ Đài Thiên văn Phù Liễn (`PLMT`). Offset chính xác: $7 + \frac{6}{60} + \frac{30}{3600} = 7.108333333333333\text{ giờ}$ (`+7:06:30`). - **PERIOD 2B (01/05/1911 – 31/12/1942):** Đông Dương thuộc Pháp chuẩn hóa múi giờ kinh tuyến thứ 7 (`UTC+7`, offset `7.0`). - Cập nhật hàm `getHistoricalPeriodName()`: bổ sung mã phân kỳ lịch sử `'PLMT_PHU_LIEN'`. - Bảo toàn tính tương thích ngược cho hàm số nguyên `getVietnamTimeZone()`: `Math.round(7.10833) = 7`, đảm bảo các module chỉ cần múi giờ nguyên số không bị ảnh hưởng. 2. `/opt/qm-calendar/backend/core/_lunar-core.source.cjs`: - Đồng bộ toàn bộ khối logic PERIOD 2A và mã định danh `'PLMT_PHU_LIEN'`. 3. `/opt/qm-calendar/backend/services/calendar/lunar-core.test.cjs`: - Bổ sung 5 bộ kiểm thử tự động xác minh: - `getHistoricalVietnamTimezone(1, 1, 1908).offsetFormatted === '+7:06:30'` - `getVietnamTimeZone(1, 1, 1908) === 7` - `getHistoricalPeriodName(1, 1, 1908) === 'PLMT_PHU_LIEN'` - `getHistoricalPeriodName(1, 1, 1920) === 'FRENCH_INDOCHINA'` --- ### 2.3. Khắc phục ISS-07: Đính chính Datum Thu Phân 2024 trong API Benchmark #### a. Bối cảnh & Đối chuẩn Thiên văn - Cả hai cơ quan thiên văn hàng đầu thế giới là Cơ quan Niên giám Thiên văn Quân sự Hoa Kỳ (USNO) và Trung tâm Bay Không gian Goddard của NASA (NASA GSFC) đều công bố chính thức mốc Thu Phân (Autumnal Equinox) năm 2024 tại: $$\text{Thu Phân 2024} = \mathbf{2024\text{-}09\text{-}22\text{ }12:44\text{ UT}}$$ - Thời điểm hoàng kinh biểu kiến của Mặt Trời cắt kinh độ $180^\circ 00' 00''$ tính theo lý thuyết nhiễu động hành tinh VSOP87 là $12:43:37\text{ UT}$. Do $37\text{ giây} > 30\text{ giây}$, quy tắc làm tròn thiên văn quốc tế quy ước làm tròn thành **12:44 UT**. - Trong file mã nguồn tuyến API kiểm chứng `backend/services/calendar/calendar-routes.cjs` (dòng 1197) và tài liệu `backend/docs/ENGINE_TECHNICAL_REFERENCE.md`, lập trình viên trước đây đã nhập nhầm mốc `12:43:00Z` (lấy phần sàn của phút). #### b. Các tệp đã sửa đổi trong Codebase 1. `/opt/qm-calendar/backend/services/calendar/calendar-routes.cjs`: - Dòng 1197: Sửa mốc kiểm chứng từ `12:43` thành `12:44`: ```javascript { label: 'Autumnal Equinox 2024', jd: lunarCore.utcDateTimeToJulianDate(22, 9, 2024, 12, 44), target: 180, nasaUTC: '2024-09-22T12:44:00Z' } ``` 2. `/opt/qm-calendar/backend/docs/ENGINE_TECHNICAL_REFERENCE.md`: - Cập nhật bảng đối chuẩn điểm cardinal: ```markdown | Thu Phân 2024 | 22/09 12:44 | 180° | 180.000264° | 0.000264° | ``` #### c. Kết quả Thực nghiệm trên API Live - Gọi trực tiếp endpoint `GET /api/tool-module/calendar/astro/nasa-parity` trên cổng dịch vụ `4050`: ```json { "label": "Autumnal Equinox 2024", "nasaUTC": "2024-09-22T12:44:00Z", "targetDeg": 180, "engineDeg": 180.0003, "deltaDeg": 0.0003, "ok": true, "toleranceDeg": 1 } ``` - Sai số hoàng kinh đo được tại mốc 12:44 chỉ là $0.000264^\circ \approx 0.95''$ (dưới 1 giây cung), tốt hơn so với mốc cũ 12:43 ($0.000415^\circ$). --- ## 3. Ma trận Kiểm chuẩn Toàn diện Hệ thống Sau khi áp dụng toàn bộ bản vá cho cả 3 khiếm khuyết, toàn bộ các bộ test tự động của hệ thống `qm-calendar` đã được thực thi và xác nhận: | Bộ Kiểm thử (Test Suite) | Số lượng Test Assertions | Kết quả | Ghi chú kiểm thử | | :--- | :--- | :--- | :--- | | `lunar-core.test.cjs` | 113 / 113 | **PASS 100%** | Bổ sung kiểm thử PLMT 1906–1911 và kiểm tra Delta T | | `day-sky.test.cjs` | 15 / 15 | **PASS 100%** | Tính toán Mặt Trời, pha Trăng, Sky Viewer | | `tet-divergence.test.cjs` | 12 / 12 | **PASS 100%** | Phân kỳ Mậu Thân 1968, Đinh Hợi 2007, Sóc NASA $\Delta=0.05\text{ min}$ | | `truc-xiu.test.cjs` | 23 / 23 | **PASS 100%** | Thập Nhị Trực, Nhị Thập Bát Tú | | `folk-month-rules.test.cjs` | Suite Passed | **PASS 100%** | Quy tắc dân gian ngày lành | | `purpose-resolver.test.cjs` | Suite Passed | **PASS 100%** | Bộ giải xung hợp mục đích | | `algorithm-regression.test.cjs` | 834 / 834 | **PASS 100%** | Kiểm tra ranh giới thuật toán, tính đơn điệu $\Delta T$ | | `test_intl_tz.js` | 53 / 53 | **PASS 100%** | Múi giờ quốc tế CN, TW, JP, KR, US | | `rust/astro-core` Cargo Test | Unit test | **PASS 100%** | Đồng bộ parity giữa Node.js và Rust | | `exhaustive-lunar-roundtrip.cjs` | 146,462 / 146,462 ngày | **PASS 100%** | Quy đổi Dương $\to$ Âm $\to$ Dương từ 1800 đến 2200: **0 lỗi** | --- ## 4. Kết luận & Đóng Hồ sơ Khiếm khuyết 1. **Về phía Codebase:** - Cả 3 khiếm khuyết **ISS-05**, **ISS-06**, **ISS-07** đã được khắc phục triệt để và triển khai an toàn lên dịch vụ sản xuất. - Trạng thái codebase: **Verified & Deployed in `qm-calendar v1.2.1`**. 2. **Về phía Xuất bản Học thuật (Paper `QP-CAL-001`):** - Hồ sơ thẩm định công khai tại [paper.quizzman.com/issues/ISS-CAL-2026-001/](https://paper.quizzman.com/issues/ISS-CAL-2026-001/) đã ghi nhận việc tiếp nhận phương án xử lý. - Ban biên tập sẽ cập nhật nội dung văn bản trong bản vá `QP-CAL-001 v1.0.1` theo đúng các căn cứ đo lường và sửa đổi đã thực hiện tại báo cáo này.