Về Zodiac Sign V2.0

Quizzman Zodiac Sign is an astrology interpretation engine that combines real astronomical positions with transparent rule-based astrology models to generate daily sun-sign readings and personal natal chart interpretations.

Engine qm-zodiacsign V2.0 trên lab.quizzman.com/zodiac-sign — chiêm tinh nhiệt đới (Western / tropical), không phải fortune cookie Sun-sign đơn lẻ. Hai chế độ: theo cung (một Today's Sky → rule theo từng cung → Career/Love/Health/Finance + NLG) và theo ngày sinh (lá số natal: Asc, MC, 12 nhà, hành tinh, góc + transit). Thiên văn từ astro.quizzman.com (Support API 1.1+), fallback @quizzman/qm-astro. Luận giải mô tả xu hướng tượng trưng theo mô hình quy tắc — không phải dự báo thực tế hay bảo đảm sự kiện tương lai.

Western astrology · Natal chart · Birth chart · Sun sign · Horoscope · Planetary transit · Transit astrology · Ascendant · Midheaven · Whole-sign houses · Astrology engine · Ephemeris · Rule-based astrology · Tropical zodiac · Synastry · NLG · Expert system

• Astronomy and interpretation are separated. Positions/events come from the ephemeris layer; text never invents sky facts.
• Astronomical positions come from Astro Support API (astro.quizzman.com), with local @quizzman/qm-astro fallback when configured.
• Interpretations are generated only after rule evaluation (Condition Engine + domain fusion).
• Rules are deterministic and reproducible for the same when / birth / sign inputs.
• Natural-language generation never invents evidence that does not exist in the scored evidence bag.
• Sun-sign and natal modes stay distinct — daily sun-sign does not pretend to have a personal Asc from a fake birth chart.

Earlier versions generated sun-sign readings using representative mid-season chart dates (a probe “natal” at lat 0). That mixed artificial natal assumptions into a daily horoscope workflow.

Version 2.0 instead evaluates one real sky snapshot and projects it consistently across all twelve tropical signs via sign-relative rules. This produces more coherent daily interpretations and removes artificial natal assumptions from the sun-sign path. Natal / birth-chart analysis remains a separate, full-geometry mode.

Supported

• Tropical (Western) zodiac
• Natal / birth charts
• Daily sun-sign horoscope from a shared sky
• Weekly and monthly cycles
• Transit overlays on natal
• Synastry · evidence-bound NLG · public Lab gateway APIs

Not supported

• Sidereal / Vedic astrology
• Human fortune prediction or guarantees of future events
• Psychic / mediumship readings
• Numerology as a core engine
• Claiming a personal Ascendant without birth place/time

1. Chính: HTTP API https://astro.quizzman.com — Zodiac Support (snapshot, events, snapshot/range). Lab cấu hình QM_ASTRO_BASE_URL + token dịch vụ.
2. Phụ: Gói local @quizzman/qm-astro khi remote lỗi (nếu bật fallback).
3. Nội dung snapshot: kinh độ hoàng đạo địa tâm các hành tinh, tốc độ / nghịch hành, pha trăng, tiết khí (khi có), sự kiện (station, eclipse, ingress, retrograde_period…).
4. Asc / MC: chỉ khi có lat·lon (lá số cá nhân) — công thức thiên văn cầu.

Hợp đồng consumer: engine docs/ASTRO_API_REQUIREMENTS.md. Không dùng mid-date probe natal cho duyệt theo cung (đã bỏ ở V2.0).

Today's Sky
  → điều kiện: Rx, station, VOC, phase, eclipse, góc sky–sky, ingress
  → với mỗi cung: Asc* = 0° cung · whole-sign houses
  → hits (nhà, ruler, moon element, aspect) → fuseEvidence
  → NLG reading-v2

Natal
  → chart Asc/MC/houses/aspects
  → rules baseline → transit deltas (khi có when) → cycle score → NLG

• Góc: hợp / đối / vuông / tam hợp / lục hợp; orb theo loại; applying từ tốc độ.
• Fusion: gốc 50; trần +/-; giảm xung đột khi hai phía cùng cháy; trọng số theo strength & orb.
• NLG: gloss tiếng Việt rõ + thuật ngữ chuyên môn trong ngoặc; trend theo evidence, không telemetry debug.

Base: /api/tool-module/zodiac

• GET /health
• POST /v1/sky — Today's Sky
• POST /v1/sunsign — một cung
• POST /v1/sunsign/batch — tới 12 cung
• POST /v1/interpret — natal (+ cycle)
• POST /v1/chart — chỉ lá số
• POST /v1/synastry — tương hợp

• Công cụ Zodiac Sign
• Bản Markdown (LLM-friendly)
• Về Calendar Engine
• Astro Tools · Sky Viewer
• llms.txt · Lab home