# Quizzman Insight – 사주명리 엔진
## Quizzman 역법 및 천문 계산 기반 자평사주팔자(四柱八字) 시스템

- HTML 백서: https://insight.quizzman.com/tool/about-bazi-kr
- 사주명식 도구: https://insight.quizzman.com/bazi-chart
- Markdown 문서 (본 파일): https://insight.quizzman.com/tool/about-bazi-kr.md
- 역법 인프라: https://calendar.quizzman.com
- 엔진 감사 보고서: https://insight.quizzman.com/tool/about-bazi-audit
- 언어: 한국어 (`lang=ko`)

---

## 아키텍처 기본 원칙

> **기본 원칙:** BaZi Engine은 단순한 사주풀이 웹툴이 아닙니다. **Quizzman의 독립적인 고정밀 천문 역법 기반 위에 직접 구축된 학술적·결정론적 사주명리 계산 엔진**입니다. 정통 자평명리학의 원전 체계와 천문학적 행성 위치 모델, 연속 시간 표준화를 융합하여 명식 산출의 완벽한 일관성과 투명한 검증 가능성을 보장합니다.

Quizzman Insight – BaZi Engine은 Quizzman 학술 연구 생태계에서 개발된 자평 사주팔자(四柱八字) 명식 산출 및 구조 분석 엔진입니다. 일반 시중의 달력 앱처럼 양력 생년월일을 단순 간지 테이블에 기계적으로 대입하는 방식과 달리, 각 주(柱)가 형성되는 정밀한 천문학적 근거, 경계 조건의 정의, 알고리즘의 공개 검증 가능성을 최우선시합니다.

---

## 1. 자평 사주팔자(四柱八字)란 무엇인가?

사주팔자(자평명리학)는 출생 시간의 네 가지 기준 축(연·월·일·시)으로부터 도출되는 여덟 개의 천간과 지지(간지)로 운명적 구조를 분석하는 동양 전통 학문입니다:

| 주(柱) | 간지 구성 | 천문학적 결정 기준 및 전통적 상징 |
| :--- | :--- | :--- |
| **연주(年柱)** | 출생 연도의 천간과 지지 | 천문학적 **입춘(立春, 태양 황경 315°)** 절입 시점을 기준으로 엄격히 연도가 바뀝니다. 조상궁, 가문적 뿌리, 유년기 환경을 나타냅니다. |
| **월주(月柱)** | 출생 월의 천간과 지지 | **24절기**의 각 절입 시점을 기준으로 결정(입춘 인월부터 시작). 부모, 사회적 활동 환경, 계절적 배경 및 오행 사령(월령)을 나타냅니다. |
| **일주(日柱)** | 출생 일의 천간과 지지 | 일간은 **일주(일원/일간)**라 하여 자기 자신의 본질을 상징합니다. 일지는 배우자궁을 나타냅니다. |
| **시주(時柱)** | 출생 시의 천간과 지지 | 진태양시와 일간의 조합(오서둔법)으로 산출. 자녀운, 만년의 귀착점, 내면적 무의식 세계를 나타냅니다. |

---

## 2. 역법 기반: Quizzman Calendar Engine

사주 계산에서 가장 결정적인 전제는 바로 뒤에서 시간과 역법을 산출하는 기반 엔진입니다. Quizzman Calendar는 **독립적인 고정밀 천문 역법 계산 엔진**입니다.

- 역법 엔진 방문: https://calendar.quizzman.com

### 2.1. 천문 모델 기반 정밀 계산
- **VSOP87 행성 섭동 이론:** 태양 시황경($\lambda_\odot$)을 정밀 계산하여 절입 순간을 도출.
- **율리우스일(Julian Day):** 천문학적 연속 시간 척도를 채택하여 60간지 순환을 완벽히 보존.
- **24절기:** 태양 황경 15° 간격의 천문학적 실시간 위치로 특정.
- **합삭 및 삭망월:** 관측 경도 및 표준시 기반으로 합삭 시각 산출.
- **역사적 법정 표준시:** 베트남 및 동아시아 각 지역의 서머타임 및 표준시 변천 이력 데이터베이스 내장.

### 2.2. 왜 절기가 사주팔자에서 결정적인가?
정통 자평명리학에서 **해(年)와 달(月)의 경계는 음력 설날이나 양력 1월 1일과 전혀 다릅니다**:
- **연주 전환:** 엄격히 **입춘** 절입 시각 기준.
- **월주 전환:** 12절기의 절입 시각(입춘, 경칩, 청명, 입하...)을 기준으로 교체.

*경계 사례:* **2026년 2월 3일** 출생자의 경우, 2026년 입춘 절입 시각 이전이므로 양력은 2026년이지만 사주에서는 여전히 **을사(乙巳)년 뱀띠**에 해당합니다.

---

## 3. BaZi Engine 핵심 기능 모듈

- **사주팔자 완전 명식 산출:** 연·월·일·시 네 기둥과 납음오행을 정확히 산출.
- **십신(육친) 전수 매트릭스:** 비견, 겁재, 식신, 상관, 편재, 정재, 편관, 정관, 편인, 정인 100가지 전 조합 관계 분석.
- **지장간과 백분율(%) 가중치:** 12지지의 여기·중기·정기 비율 수치화.
- **오행 득실 점수 및 용신 제안:** 목·화·토·금·수 오행 점수를 산출하고 신강·신약 판별 및 기본 용신(用神) 제안.
- **10년 대운(大運) 정밀 연산:** 연간 음양과 성별에 따른 순행·역행 판정 및 '3일 = 1년' 고법에 따른 기운 연령 산출.
- **26종 표준 신살 판정:** 천을귀인, 문창귀인, 역마, 도화, 화개, 양인 등 26종 신살 조건 판정.
- **간지 형·충·회·합 관계 판별:** 천간오합, 지지육합, 삼합국, 지지육충, 삼형·자형, 상해, 상파 분석.

---

## 4. 계산 파이프라인 및 REST API

```
출생 연월일시 및 시간대
           │
           ▼
연속 율리우스일과 UTC+7 표준화
           │
           ▼
VSOP87 태양 황경 및 24절기 해법
           │
           ▼
입춘 연주 · 절기 월주 · 율리우스일 일주 · 오서둔법 시주
           │
           ▼
지장간 가중치 전개 및 오행 에너지 행렬
           │
           ▼
십신 매핑 · 대운 순역 추산 · 26신살 검증
           │
           ▼
구조화된 JSON 데이터 출력 (UI / REST API)
```

### REST API 인터페이스:
- `POST /api/tool-module/bazi/calculate` — 사주팔자 명식 산출
- `GET /api/tool-module/bazi/ten-gods` — 십신 대조 매트릭스
- `GET /api/tool-module/bazi/hidden-stems/:chi` — 지장간 및 가중치
- `POST /api/tool-module/bazi/luck-pillars` — 10년 대운 타임라인
- `POST /api/tool-module/bazi/shen-sha` — 신살 목록 판정
- `POST /api/tool-module/bazi/compatibility` — 두 사주 간 궁합 분석

---

## 5. 정밀도 및 알고리즘 검증

2026년 2월 공표된 자동화 내부 회귀 테스트 결과:

| 테스트 항목 | 내부 검증 결과 | 적용 범위 |
| :--- | :--- | :--- |
| **BaZi Engine** | **128/128건 전체 통과 (PASSED)** | 사주 간지, 입춘 교체, 절기 월 전환, 십신, 지장간, 대운, 신살 |
| **Calendar Engine** | **108/108건 전체 통과 (PASSED)** | UTC+7 천문 동기화, 윤달, 태양 황경 각도 및 절기 극점 |
| **십신 매트릭스** | 100/100 조합 전수 검증 | 10개 천간 일간과 10개 객간 간의 전 조합 상호관계 |
| **지장간 분포** | 12/12 지지 전수 검증 | 12지지의 여기·중기·정기 비율 일관성 |
| **신살 시스템** | 26종 표준 신살 | 일간, 일지, 연간, 월지 기준 조건 로직 전수 통과 |

> **테스트 지표의 기술적 함의:**
> **"내부 테스트 128/128건 통과"**는 공개 시점에 내부 회귀 테스트 세트에 정의된 모든 엔지니어링 경계 조건을 완벽히 충족함을 입증합니다.
>
> **이 지표가 모든 역사적 고문헌이나 주관적 해석 유파에 대한 '절대적 100%의 단일 정답'을 과장하여 주장하는 것은 아닙니다.**
>
> Quizzman은 데이터셋을 지속적으로 확장하고 있으며, 독립적인 외부 벤치마크(예: *Jade Almanac*과의 교차 검증 계획)를 추진하고 있습니다.

---

## 6. 고전 문헌적 배경

1. **『연해자평(淵海子平)』:** 송대 서승, 일간 본위의 원칙을 확립한 자평명리의 원전.
2. **『삼명통회(三命通會)』:** 명대 만민영, 명대 이전의 학설과 신살, 납음을 집대성한 대백과사전.
3. **『적천수(滴天髓)』:** 명대 경도 원저 / 유기 주석, 오행의 체용과 기세 유전을 논증한 최고의 이론서.
4. **『자평진전(子平真詮)』:** 청대 심효첨, 월령 용신과 격국의 순잡을 체계화한 저작.
5. **『궁통보감(窮通寶鑑)』:** 청대 여춘태 편, 12달 자연환경의 한난조습과 10천간의 조후용신론 저작.

---

## 7. 적용 범위 및 윤리적 선언

1. **역법 천문 계산:** 절기 시각, 음양력 환산, 시차 보정, 60간지 회귀는 객관적·수학적으로 검증 가능한 천문학의 영역입니다.
2. **전통 명리 해석:** 성향 분석이나 운세 해석은 전통적 상징 체계에 속하며, **현대 실증과학의 인과법칙과 동일시될 수 없습니다**.

**Quizzman은 인간의 운명을 절대적으로 예언할 수 있다고 주장하지 않습니다.**

---

## Quizzman Insight – BaZi Engine 살펴보기

- **사주명식 도구:** https://insight.quizzman.com/bazi-chart
- **Quizzman Calendar:** https://calendar.quizzman.com
- **Quizzman Wiki:** https://wiki.quizzman.com
- **Quizzman Insight Hub:** https://insight.quizzman.com

*Quizzman Insight – 현대 계산공학 기반 동양 전통 수리 연구.*
*© 2026 Quizzman. All rights reserved.*