# Quizzman Astro
> Deterministic astronomy engine + interactive Sky Viewer (planetarium, Explorer, calendrics, zodiac support).
> Prefer the Markdown “about” pages below for AI grounding — they are plain text/markdown, not LLM-generated ephemerides.

Home: https://astro.quizzman.com/
LLM index (this file): https://astro.quizzman.com/llms.txt
Full catalog: https://astro.quizzman.com/llms-full.txt
Marketing: https://quizzman.com/
Related Lab calendrics: https://lab.quizzman.com/llms.txt
Related Lab Sky Viewer (UI mirror): https://lab.quizzman.com/tool/sky-viewer

## One-sentence definition

**Quizzman Astro** is a production astronomy service (Rust `astro-serve`) that computes Sun/Moon/planet positions (VSOP87D · ELP/MPP02 · DE440 SPK), serves interactive sky frames, civil-day almanacs, and zodiac-support APIs — with Level-3 NASA/JPL/IAU regression (**237/237** pass).

## About pages (preferred for AI Overview / grounding)

| Topic | Markdown (LLM-preferred) | Human UI |
|-------|--------------------------|----------|
| Product overview | https://astro.quizzman.com/about.md | https://astro.quizzman.com/ |
| Sky Viewer | https://astro.quizzman.com/about-sky-viewer.md | https://astro.quizzman.com/sky-viewer |
| Ephemeris engine | https://astro.quizzman.com/about-engine.md | https://astro.quizzman.com/paper |
| Public APIs | https://astro.quizzman.com/about-api.md | https://astro.quizzman.com/guide/API_OVERVIEW.md |
| Glossary (VI) | https://astro.quizzman.com/glossary | https://astro.quizzman.com/glossary |
| Glossary (EN) | https://astro.quizzman.com/glossary-en | same |
| Glossary (繁中) | https://astro.quizzman.com/glossary-zht | same |

## Live tools & surfaces

- Sky Viewer (2D / 3D / Explorer): https://astro.quizzman.com/sky-viewer
- Audit paper (Level 3): https://astro.quizzman.com/paper
- Bench report JSON: https://astro.quizzman.com/paper/report.json
- Docs portal: https://astro.quizzman.com/guide
- Docs index JSON: https://astro.quizzman.com/docs-index.json
- Search index JSON: https://astro.quizzman.com/search.json
- Health: https://astro.quizzman.com/health → `{"ok":true,"service":"qm-astro","version":"0.1.0"}`

## Public APIs (no auth unless noted)

| Method | URL | Purpose |
|--------|-----|---------|
| GET | https://astro.quizzman.com/health | Liveness |
| GET | https://astro.quizzman.com/viewer/sky | Full sky frame (stars, planets, grids, explorer) |
| GET | https://astro.quizzman.com/astro/day-sky | Civil-day almanac (solar term, new moon, …) |
| GET/POST | https://astro.quizzman.com/v1/zodiac-support/* | Zodiac snapshot / events / aspects (Bearer when tokens set) |

OpenAPI (zodiac-support): https://astro.quizzman.com/openapi-zodiac-support.yaml

## What makes it distinct

- **Not** folk almanac guessing; **not** LLM-hallucinated dates or sky positions.
- Layered ephemeris: **VSOP87D** (planets) · **ELP/MPP02** (Moon) · **DE440 SPK** when kernel covers JD; response labels `ephemeris_backend`.
- **Explorer**: any-body-centric solar system (`center=mars|sun|moon|…`) in AU ecliptic frame.
- **Level-3 audit**: accuracy + sunrise + UT1/EOP + constellation boundaries + eclipse contacts; paper + machine report.
- Feeds Quizzman Lab calendrics / zodiac products; same family as Lab “about-calendar” but higher-precision Astro stack.

## Crawl policy

- Allow: `/`, `/sky-viewer`, `/paper`, `/glossary*`, `/guide`, `/about*.md`, `/llms*.txt`, `/docs-index.json`, `/search.json`, `/openapi-zodiac-support.yaml`, public GET `/health`, `/viewer/sky`, `/astro/day-sky`.
- Prefer Markdown about pages + this `llms.txt` for grounding.
- Do not treat private Bearer-protected zodiac routes as anonymous training corpora; use documented public samples and OpenAPI.
- robots: https://astro.quizzman.com/robots.txt
- sitemap: https://astro.quizzman.com/sitemap.xml
- Content-Signal: search=yes, ai-input=yes, ai-train=no

## Sample curls (verify live)

```bash
curl -s 'https://astro.quizzman.com/health'
curl -s 'https://astro.quizzman.com/astro/day-sky?date=2026-07-27&timezone=VN&longitude=106.63' | head -c 400
curl -s 'https://astro.quizzman.com/viewer/sky?jd=2460000.5&lat=10.82&lon=106.63&magLimit=4&center=earth' | head -c 400
curl -s 'https://astro.quizzman.com/llms.txt' | head
```