TL;DR

이 저장소는 Next.js 14와 TypeScript로 만든 독립 실행형 紫微斗数 웹앱이며, 倪海夏《天纪》 체계에 맞춘 배판 알고리즘과 사화·격국 지식库를 제공합니다. 14주성·12궁 지식, 고전 원문, 합명 로직과 함께 518,400개 명반 JSON·해석 데이터도 Release로 공개해 RAG나 Fine-tuning에 쓸 수 있습니다. 반면 AI 해석용 백엔드 API와 prompt, 사용자 계정·결제·배포 설정은 제외되어 있어 서비스 완제품으로 바로 운영하기보다 계산 엔진과 프런트엔드를 기반으로 직접 확장해야 합니다. MIT License 코드와 attribution 조건의 데이터 라이선스가 분리되어 있으므로 상업 이용 시 데이터 출처 표기를 유지하면 됩니다.

핵심 포인트

• 이 저장소는 독립 실행형 Next.js 14 웹 애플리케이션이자 TypeScript 기반 紫微斗数 배포 엔진입니다. `lib/ziwei/algorithm.ts`가 명궁·오행국·14주성·보조성·대운·유년을 계산하고 `sihua.ts`가 사화 체계를 처리합니다. Next.js App Router와 Tailwind CSS를 사용하는 점에서 일반 라이브러리보다 바로 실행 가능한 웹앱에 가깝습니다.
• Release에서 518,400개 명반 조합을 5.5GB 압축 데이터로 받을 수 있습니다. 각 샘플에는 명반 JSON과 13개 주제의 해석 텍스트가 들어 있어 Fine-tuning, RAG, 규칙 변경 후 A/B 비교에 활용할 수 있습니다. 데이터는 상업 이용과 재배포가 가능하지만 프로젝트 출처 표기가 필요합니다.
• 핵심 계산 외에도 `patterns.ts`에 1100행 이상의 격국 규칙이 있고 `heming-knowledge.ts`에는 두 명반을 비교하는 합명 지식이 담겨 있습니다. `lib/classics/`에는 세 종류의 고전 원문이 들어 있으며 `lib/seo/`에는 14주성과 12궁의 구조화된 지식 데이터가 있습니다. 따라서 단순 배판 계산기보다 특정 倪海夏《天纪》 체계의 지식 기반 서비스 구축에 적합합니다.
• 공개 버전에는 `/api/interpret`와 `/api/heming` 같은 백엔드 API, AI 해석 prompt, 사용자·결제·보안·배포 설정이 빠져 있습니다. `npm install` 뒤 `.env.local`을 설정하고 `npm run dev`로 화면과 배판 알고리즘을 실행할 수 있지만 AI 해석 API는 직접 구현해야 합니다. 코드에는 MIT License가 적용되고 데이터는 attribution 조건의 자유 사용이며 고전 원문은 Public Domain으로 구분됩니다.

벤치마크