# Quizzman Insight – BaZi Engine
## Hệ thống lập Tử Bình Bát Tự (四柱八字) trên nền tảng tính toán lịch pháp và thiên văn Quizzman

- HTML Whitepaper: https://insight.quizzman.com/tool/about-bazi
- Công cụ lập lá số: https://insight.quizzman.com/bazi-chart
- Bản Markdown (file này): https://insight.quizzman.com/tool/about-bazi.md
- Nền tảng lịch pháp: https://calendar.quizzman.com
- Engine Audit: https://insight.quizzman.com/tool/about-bazi-audit
- Quizzman Paper (QPS-ISO 1.0): https://paper.quizzman.com/papers/QP-BAZI-001/
- Ngôn ngữ quy chuẩn: Tiếng Việt (`lang=vi`)

---

## Tổng quan kiến trúc & Định vị

> **Nguyên lý kiến trúc:** BaZi Engine không chỉ đơn thuần là một công cụ lập lá số thông thường, mà là **một ứng dụng tính toán mệnh lý được xây dựng trực tiếp trên nền tảng lịch pháp và thiên văn độc lập của Quizzman**.

Quizzman Insight – BaZi Engine là hệ thống lập và phân tích lá số Tử Bình Bát Tự (子平八字), được phát triển trong hệ sinh thái nghiên cứu Quizzman. Công cụ kết hợp các nguyên lý mệnh lý học cổ điển với thuật toán tính toán lịch pháp, thiên văn và hệ thống xử lý dữ liệu hiện đại.

Khác với việc chỉ chuyển đổi ngày sinh thành các ký hiệu Can Chi theo lịch vạn niên dân dụng, BaZi Engine chú trọng đến cơ sở hình thành từng trụ, quy ước xác định thời gian và khả năng kiểm chứng kết quả tính toán minh bạch.

Hệ thống sử dụng **Quizzman Calendar Engine** làm nền tảng lịch pháp, bảo đảm sự thống nhất giữa phép tính thời gian thiên văn và các thành phần phân tích Bát Tự.

---

## 1. Bát Tự Tử Bình là gì?

Bát Tự (八字), còn gọi là **Tứ Trụ (四柱)** hay **Tử Bình (子平)**, là một hệ thống mệnh lý truyền thống của Trung Hoa và phương Đông, sử dụng tám chữ Can Chi được xác định từ bốn yếu tố thời gian sinh:

| Trụ | Thành phần Can Chi | Cơ sở xác định & Ý nghĩa |
| :--- | :--- | :--- |
| **Trụ Năm** (年柱) | Thiên Can & Địa Chi năm sinh | Xác định theo thời điểm thiên văn **Lập Xuân (立春)**. Đại diện cho tổ tiên, ông bà, gốc rễ. |
| **Trụ Tháng** (月柱) | Thiên Can & Địa Chi tháng sinh | Xác định theo **mốc Tiết khí Mặt Trời** (bắt đầu từ Dần tại Lập Xuân). Đại diện cho cha mẹ, môi trường xã hội, mùa sinh, Ngũ Hành nắm lệnh (Lệnh Tháng). |
| **Trụ Ngày** (日柱) | Thiên Can & Địa Chi ngày sinh | Thiên Can ngày được gọi là **Nhật Chủ (日主)** — đại diện cho bản thân đương số; Địa Chi ngày đại diện cho phối ngẫu. |
| **Trụ Giờ** (時柱) | Thiên Can & Địa Chi giờ sinh | Xác định theo giờ địa phương và can ngày. Đại diện cho con cái, hậu vận và nội tâm. |

Từ bốn trụ này, hệ thống Tử Bình xây dựng các quan hệ Ngũ Hành, Âm Dương, Thập Thần, Tàng Can, Đại Vận và những thành phần phân tích khác.

Quizzman BaZi Engine hỗ trợ tự động hóa các phép tính trên, đồng thời cho phép người dùng tra cứu và tìm hiểu cấu trúc của lá số theo những quy tắc đã được xác định.

---

## 2. Nền tảng lịch pháp: Quizzman Calendar Engine

Một trong những thành phần quan trọng nhất của BaZi Engine là hệ thống lịch pháp đứng phía sau quá trình lập Tứ Trụ.

Quizzman Calendar không đơn thuần là một ứng dụng xem âm lịch hay lịch vạn niên. Đây là **hệ thống tính toán lịch pháp độc lập**, được xây dựng trên các thuật toán thiên văn, phục vụ việc xác định ngày tháng, tiết khí, chu kỳ Can Chi và các yếu tố thời gian trong nhiều công cụ thuộc hệ sinh thái Quizzman.

- Truy cập Quizzman Calendar: https://calendar.quizzman.com

### 2.1. Tính toán dựa trên các mô hình thiên văn
Quizzman Calendar sử dụng các phương pháp thiên văn học, bao gồm:
- **VSOP87:** Mô hình tính toán vị trí thiên thể, được ứng dụng để xác định hoàng kinh biểu kiến của Mặt Trời và các mốc tiết khí.
- **Julian Day (JD):** Hệ thống biểu diễn thời gian thiên văn liên tục, hỗ trợ các phép tính ngày tháng và chu kỳ Can Chi không bị ngắt quãng bởi các cải cách lịch sử.
- **24 tiết khí (二十四節氣):** Được xác định theo các mốc hoàng kinh Mặt Trời ($15^\circ$ mỗi tiết), thay vì chỉ dựa vào ngày cố định trong lịch dân dụng.
- **Chuyển đổi âm – dương lịch:** Kết hợp các quy tắc lịch pháp với dữ liệu thiên văn và múi giờ tương ứng.
- **Múi giờ lịch sử:** Hỗ trợ nghiên cứu những biến đổi về giờ pháp định, đặc biệt trong bối cảnh lịch sử Việt Nam qua các thời kỳ.

Các thành phần này tạo nên cơ sở tính toán dùng chung cho BaZi Engine và các công cụ lịch pháp khác của Quizzman.

### 2.2. Vì sao tiết khí quan trọng đối với Bát Tự?
Trong hệ thống Tử Bình được Quizzman áp dụng, ranh giới năm và tháng Bát Tự không hoàn toàn trùng với ranh giới năm âm lịch hay tháng dương lịch thông thường:
- **Trụ Năm** được xác định theo thời điểm **Lập Xuân (立春)**, thay vì mặc nhiên đổi năm vào ngày Tết Nguyên Đán.
- **Trụ Tháng** được xác định theo các mốc tiết khí tương ứng, bắt đầu từ tháng Dần tại Lập Xuân.

*Ví dụ:* Ngày **03/02/2026**, trước thời điểm Lập Xuân năm 2026, vẫn thuộc năm **Ất Tỵ (乙巳)** khi lập Bát Tự theo quy ước này, mặc dù năm dương lịch đã chuyển sang 2026 và sắp đến Tết Bính Ngọ.

Việc xác định chính xác thời khắc chuyển tiết có ý nghĩa đặc biệt đối với những trường hợp sinh gần ranh giới giữa hai tháng hoặc hai năm Bát Tự. Thay vì gán tiết khí theo ngày cố định, Quizzman Calendar tính thời điểm chuyển tiết từ mô hình vị trí Mặt Trời, sau đó cung cấp cơ sở thời gian cho BaZi Engine.

### 2.3. Múi giờ và những trường hợp lịch sử
Cùng một thời điểm tuyệt đối có thể tương ứng với các ngày hoặc giờ dân dụng khác nhau tại những địa phương khác nhau.

Đối với dữ liệu ngày sinh trong quá khứ, sự thay đổi múi giờ pháp định có thể ảnh hưởng đến việc xác định trụ ngày hoặc trụ giờ. Quizzman Calendar cung cấp cơ sở tra cứu lịch sử múi giờ Việt Nam, giúp người dùng nhận diện và xử lý những trường hợp cần đối chiếu thời gian sinh theo bối cảnh lịch sử.

Ngoài yếu tố múi giờ, các quy ước riêng của từng trường phái về ranh giới ngày, đặc biệt quanh giờ Tý (子時, Dạ Tý vs Chính Tý), cũng cần được phân biệt khi đối chiếu kết quả giữa các hệ thống Bát Tự.

---

## 3. Các chức năng của BaZi Engine

- **Lập Tứ Trụ (Four Pillars):** Tính toán đầy đủ tám chữ Can Chi của năm, tháng, ngày và giờ sinh, dựa trên hệ thống quy tắc lịch pháp được áp dụng trong Quizzman.
- **Phân tích Thập Thần (十神):** Xác định quan hệ giữa Nhật Chủ và các Thiên Can khác, bao gồm Tỷ Kiên, Kiếp Tài, Thực Thần, Thương Quan, Chính Tài, Thiên Tài, Chính Quan, Thất Sát, Chính Ấn và Thiên Ấn. Hệ thống hỗ trợ đầy đủ **100 tổ hợp** giữa 10 Nhật Chủ và 10 Thiên Can.
- **Phân tích Tàng Can (藏干):** Hiển thị các Thiên Can ẩn trong 12 Địa Chi, kèm trọng số (%) theo quy ước phân tích của hệ thống. Các trọng số được sử dụng để hỗ trợ tổng hợp và đánh giá sự phân bố Ngũ Hành trong lá số.
- **Phân tích Ngũ Hành (五行):** Tổng hợp các yếu tố Kim, Mộc, Thủy, Hỏa, Thổ từ Thiên Can và Tàng Can, hỗ trợ xem xét tương quan mạnh – yếu và cung cấp gợi ý Dụng Thần ở mức cơ bản. Kết quả phản ánh mô hình phân tích đã được lựa chọn, không phải đại lượng vật lý có thể đo lường trực tiếp.
- **Tính toán Đại Vận (大運):** Xác định chiều thuận hoặc nghịch của Đại Vận theo quy tắc Âm Dương và thông tin giới tính được sử dụng trong hệ thống. Thời điểm khởi vận được tính dựa trên khoảng cách thời gian đến mốc tiết khí tương ứng.
- **Tra cứu Thần Sát (神煞):** Hỗ trợ chuẩn hóa **26 loại Thần Sát**, bao gồm những mục thường gặp như Thiên Ất Quý Nhân, Văn Xương, Dịch Mã, Đào Hoa, Hoa Cái, Dương Nhẫn, Thiên Đức và Nguyệt Đức...
- **Phân tích quan hệ Can Chi:** Hỗ trợ nhận diện các quan hệ Thiên Can Ngũ Hợp, Địa Chi Lục Hợp, Tam Hợp, Lục Xung, Hình, Hại và những quan hệ liên quan trong hệ thống Tứ Trụ.

---

## 4. Thuật toán và kiến trúc tính toán

BaZi Engine được tổ chức thành các thành phần xử lý riêng biệt, từ dữ liệu thời gian đầu vào đến quá trình lập Tứ Trụ và phân tích lá số.

### Quy trình tính toán tổng quát:
```
Ngày, giờ & múi giờ sinh
       │
       ▼
Chuẩn hóa thời gian (JD / UTC+7)
       │
       ▼
Quizzman Calendar Engine (VSOP87)
       │
       ▼
Xác định Tiết khí & Can Chi
       │
       ▼
Lập Tứ Trụ & Bảng Tàng Can
       │
       ▼
Phân tích Mệnh lý (Thập Thần, Đại Vận, 26 Thần Sát, Hợp/Xung)
       │
       ▼
Xuất kết quả (UI / REST API)
```

### Bảng quy tắc chính:

| Thành phần | Phương pháp & Quy chuẩn |
| :--- | :--- |
| **Can Chi năm** | Ranh giới thiên văn của tiết Lập Xuân |
| **Can Chi tháng** | Các mốc tiết khí Mặt Trời (VSOP87) |
| **Can Chi ngày** | Chu kỳ Can Chi 60 hoa giáp từ phép tính ngày Julian Day |
| **Can Chi giờ** | Địa Chi giờ kết hợp Thiên Can ngày theo quy tắc Ngũ Thử Độn |
| **Thập Thần** | Quan hệ Ngũ Hành, Âm Dương với Nhật Chủ (100 tổ hợp) |
| **Tàng Can** | Bảng Thiên Can ẩn và trọng số % chuẩn hóa |
| **Đại Vận** | Quy tắc thuận/nghịch theo Âm Dương + giới tính và khoảng cách đến tiết khí |

### Kiến trúc phân tách lớp & REST API:
Hệ thống được thiết kế theo hướng phân tách lớp tính toán lịch pháp, lớp xử lý Bát Tự và lớp cung cấp dữ liệu cho ứng dụng.
BaZi Engine cung cấp các REST API:
- `POST /api/tool-module/bazi/calculate` — Lập lá số Bát Tự đầy đủ
- `GET /api/tool-module/bazi/ten-gods` — Tra cứu Thập Thần
- `GET /api/tool-module/bazi/hidden-stems/:chi` — Tra cứu Tàng Can
- `POST /api/tool-module/bazi/luck-pillars` — Tính Đại Vận
- `POST /api/tool-module/bazi/shen-sha` — Tra cứu Thần Sát
- `POST /api/tool-module/bazi/compatibility` — Phân tích tương hợp

Kiến trúc này tạo điều kiện để mở rộng tính năng, thực hiện kiểm thử hồi quy và duy trì sự thống nhất giữa các công cụ sử dụng cùng nền tảng lịch pháp.

---

## 5. Độ chính xác và kiểm chứng thuật toán

Quizzman chú trọng khả năng kiểm chứng của các phép tính thay vì chỉ trình bày kết quả cuối cùng.

Theo kết quả kiểm thử nội bộ được công bố vào tháng 2/2026:

| Thành phần | Kết quả | Ghi chú bao phủ |
| :--- | :--- | :--- |
| **BaZi Engine** | **128/128 bài kiểm thử đạt** | Hồi quy Tứ Trụ, Lập Xuân, Tiết khí, Thập Thần, Tàng Can, Đại Vận, Thần Sát |
| **Calendar Engine** | **108/108 bài kiểm thử đạt** | Đồng bộ lịch pháp thiên văn UTC+7, VSOP87 |
| **Thập Thần** | Bao phủ 100 tổ hợp | Ma trận 10 Nhật Chủ × 10 Thiên Can |
| **Tàng Can** | Bao phủ 12 Địa Chi | Toàn bộ Bản khí, Trung khí, Dư khí |
| **Thần Sát** | Hỗ trợ 26 loại | Kiểm tra đầy đủ điều kiện kích hoạt |

Bộ kiểm thử BaZi bao gồm các nhóm chức năng như xác định Tứ Trụ, xử lý ranh giới tiết khí, đối chiếu Thập Thần, phân tích Tàng Can, tính Đại Vận và các quan hệ Can Chi. Các trường hợp đặc biệt gần thời điểm Lập Xuân, ranh giới tháng tiết khí và ranh giới ngày giờ được xem là những tình huống quan trọng cần kiểm tra.

> **Ý nghĩa của kết quả kiểm thử:**
> Chỉ số **128/128 bài kiểm thử đạt** cho thấy phiên bản được đánh giá đáp ứng toàn bộ các điều kiện trong bộ kiểm thử nội bộ tại thời điểm công bố.
>
> **Kết quả này không đồng nghĩa với việc mọi trường hợp lịch sử, mọi quy ước Bát Tự hoặc mọi cách diễn giải đều đã được xác nhận độc lập.**
>
> Quizzman hướng đến việc tiếp tục mở rộng dữ liệu kiểm thử, đối chiếu với các nguồn độc lập (như kế hoạch triển khai kiểm chứng đối sánh với đối tác độc lập Jade Almanac) và ghi nhận những khác biệt phát sinh từ quy ước lịch pháp hoặc phương pháp tính toán.

---

## 6. Cơ sở tài liệu và phương pháp nghiên cứu

BaZi Engine tham khảo những tác phẩm quan trọng trong truyền thống Tử Bình:
1. **Uyên Hải Tử Bình (淵海子平):** Một trong những trước tác nền tảng về hệ thống Tử Bình.
2. **Tam Mệnh Thông Hội (三命通會):** Tác phẩm tổng hợp nhiều hệ thống lý luận mệnh lý cổ điển.
3. **Đích Thiên Tủy (滴天髓):** Tài liệu quan trọng về quan hệ Ngũ Hành và cấu trúc mệnh cục.
4. **Tử Bình Chân Thuyên (子平真詮):** Tập trung vào phương pháp phân tích cách cục theo Tử Bình.
5. **Cùng Thông Bảo Giám (窮通寶鑑):** Chú trọng mối quan hệ giữa Ngũ Hành và điều kiện thời tiết, mùa sinh (Điều Hậu).

Các tài liệu này cung cấp nền tảng lý luận cho việc xây dựng những quy tắc phân tích trong hệ thống. Đối với các vấn đề có nhiều dị bản hoặc khác biệt trường phái, cần phân biệt giữa dữ liệu lịch pháp có thể kiểm chứng bằng tính toán và những quy ước diễn giải thuộc truyền thống mệnh lý.

---

## 7. Định hướng phát triển

Quizzman Insight – BaZi Engine được phát triển theo định hướng xây dựng một công cụ nghiên cứu có cấu trúc, có khả năng mở rộng và có thể kiểm chứng về phương pháp.

Trong đó, Quizzman Calendar giữ vai trò hạ tầng lịch pháp, còn BaZi Engine đảm nhiệm quá trình tổ chức và phân tích dữ liệu theo hệ thống Tử Bình.

Việc sử dụng một nền tảng lịch pháp chung cũng góp phần duy trì tính nhất quán giữa các công cụ Bát Tự, Tử Vi, Kinh Dịch và những ứng dụng khác trong hệ sinh thái Quizzman. Mục tiêu không chỉ là rút ngắn thời gian lập lá số, mà còn giúp người dùng hiểu rõ hơn cơ sở tính toán, các giả định được sử dụng và giới hạn của kết quả.

---

## 8. Phạm vi sử dụng và giới hạn

Quizzman BaZi Engine hướng đến người học Tử Bình, người nghiên cứu lịch pháp, những người thực hành mệnh lý truyền thống và các nhà phát triển cần tích hợp dữ liệu Tứ Trụ vào ứng dụng.

### Cần phân biệt hai phạm vi:
1. **Tính toán lịch pháp:** Những vấn đề như thời điểm tiết khí, quy đổi lịch, múi giờ và chu kỳ Can Chi có thể được kiểm tra theo các quy tắc xác định.
2. **Diễn giải mệnh lý:** Những nhận định về tính cách, vận hạn hoặc tương lai thuộc phạm vi lý thuyết và thực hành truyền thống, không được xem là kết luận khoa học đã được xác nhận.

**Quizzman không tuyên bố có khả năng dự đoán chắc chắn số phận của con người.** Công cụ cung cấp dữ liệu và phương pháp phân tích để người dùng nghiên cứu, tham khảo và tự đánh giá.

---

## Khám phá Quizzman Insight – BaZi Engine

- **Lập lá số Bát Tự:** https://insight.quizzman.com/bazi-chart
- **Nền tảng lịch pháp Quizzman Calendar:** https://calendar.quizzman.com
- **Tài liệu nghiên cứu và thuật toán:** https://wiki.quizzman.com
- **Hệ sinh thái Quizzman Insight:** https://insight.quizzman.com

*Quizzman Insight – Nghiên cứu truyền thống trên nền tảng công nghệ tính toán hiện đại.*
*© 2026 Quizzman. All rights reserved.*
