# 台灣彩券開獎歷史 (Taiwan Lotto History) — llms-full

> 台灣彩券開獎歷史查詢系統：提供威力彩、大樂透、今彩539等彩券的歷史開獎紀錄查詢與統計分析（號碼頻率、趨勢、熱度圖等）。本專案採用 Astro + Tailwind + Cloudflare Pages/Workers/D1。

本檔案是 `llms.txt` 的「較完整版本」，以文字方式整理本站重要頁面、主要功能、API 端點、SEO/Schema 與 PWA 設定，方便 LLM/agent 在不解析整站 HTML 的情況下理解網站結構與用途。

## 站點導覽（人類/LLM 都適用）

- [首頁（最近開獎）](/): 顯示各彩券遊戲「最新一筆」開獎資料
- [進階搜尋](/search): 依彩券類型、日期、期數範圍查詢開獎記錄
- [統計分析](/stats): 圖表統計分析（頻率、趨勢、和值、遺漏、奇偶比、威力彩熱度圖…）
- [開發者資源](/developers): timetable.tw 公開唯讀 JSON API、OpenAPI 規格與機器可讀資源
- [OpenAPI 3.1 規格](/openapi.json): 公開 API 的正式端點、參數與回應描述

## 使用說明（重點摘要）

來源頁面：[/about/guide](/about/guide)

- **最近開獎**：首頁預設顯示各遊戲的「最新一筆」資料，可切換遊戲查看更多歷史。
- **進階搜尋**：可用彩券類型、日期範圍、期數範圍、排序（新→舊／舊→新）精準查詢。
- **統計分析**：提供號碼頻率、冷熱門、趨勢圖等視覺化分析（依資料完整度而定）。

## 資料來源與免責（重點摘要）

來源頁面：[/about/data-source](/about/data-source)

- 本站資料（開獎號碼、期別、銷售金額及獎金資訊）**轉載或彙整自台灣彩券公司官方網站公開資訊**：`https://www.taiwanlottery.com.tw/`
- 本站非官方、無授權關係；開獎結果以官方公告為準。

## 隱私政策（重點摘要）

來源頁面：[/about/privacy](/about/privacy)

- 不主動收集個人身份資料（姓名、地址、電話、Email…）。
- 可能記錄非識別性資訊（IP、瀏覽器類型、造訪時間）用於效能與體驗統計。
- 可能使用基本 Cookie 記住偏好（例如最後選擇的遊戲分頁）；可自行在瀏覽器拒絕/刪除。

## 開發者資源

來源頁面：[/developers](/developers)

- 公開 API 僅提供唯讀 `GET` 與 `application/json` 回應，不需要登入或 API key。
- 先呼叫 [`/api/games`](/api/games) 取得彩券類型 ID，再依 OpenAPI 規格查詢開獎與統計端點。
- API 使用方式、參數、錯誤處理與資料限制請見 [OpenAPI 3.1 JSON 規格](/openapi.json)。
- 會員、付款、管理及 AI 功能端點不是公開開發者 API，未列入 OpenAPI 文件。

## 品牌與維護團隊

- [Arise Design Studio](/about/arise-design-studio): 台灣彩券開獎歷史的網站與數位產品設計、技術維護團隊。
- 官方品牌網站：`https://arise.tw`

## API（JSON）— 主要端點

### `/api/games`

- **用途**：取得彩券類型清單（含 id、name、display_name 等）

### `/api/draws`

- **用途**：取得開獎記錄（分頁、篩選、排序）
- **常用 query string**
  - `gameTypeId`: 指定彩券類型
  - `limit` / `offset`: 分頁
  - `startDate` / `endDate`: 依日期範圍
  - `startPeriod` / `endPeriod`: 依期數範圍
  - `sortOrder`: `DESC`（新→舊）或 `ASC`（舊→新）
  - `latestEach=true`: 取得每種遊戲最新一筆

### `/api/stats/*`（統計相關）

- `/api/stats/numbers-frequency`: 號碼出現頻率
- `/api/stats/trends`: 銷售額與獎金趨勢
- `/api/stats/sum-trend`: 和值趨勢
- `/api/stats/number-missing`: 遺漏分析
- `/api/stats/odd-even-ratio`: 奇偶/大小比
- `/api/stats/scatter-data`: 散點資料（多種類型）
- `/api/stats/games-comparison`: 各遊戲比較
- `/api/stats/date-range`: 可用日期/期數範圍
- `/api/stats/heatmap`: 威力彩熱度圖資料（general / special）

## 熱度圖（Heatmap）規格（威力彩）

- **頁面入口**：[/stats](/stats)（選擇「威力彩」後顯示）
- **資料 API**：`/api/stats/heatmap?gameTypeId={id}&type=general|special`
- **顯示方式**
  - 每一列 = 一個期數（由新到舊）
  - 右側為號碼格：一般號碼 1–38、第二區 1–8
  - **號碼只在該期「有開出」時顯示在格子內**（未開出為空白/淺色）
  - 顏色代表「最近 N 期」的熱度（越紅越熱）
  - 可切換最近 N 期（例如 20 / 50 / 100）
  - 點擊有開出的號碼格：導向搜尋頁（未來可升級為 SEO 友善號碼詳情頁）

## SEO / 結構化資料（Schema.org）

本站已使用 `astro-seo` 統一輸出：
- **基本 SEO meta**：title / description / canonical / robots / keywords
- **Open Graph / Twitter Card**
- **JSON-LD 結構化資料**（`@graph`）

主要頁面 Schema 概念：
- 首頁：`WebSite` + `CollectionPage`
- 搜尋頁：`SearchActionPage`（含 SearchAction）
- 統計頁：`WebPage` + `DataCatalog`（datasets：威力彩/大樂透/今彩539…）
- 說明頁：`Article`

## 組織資訊（Organization Schema）

站內結構化資料包含 Organization（用於 publisher 與品牌識別）：

- 名稱：Arise Design Studio
- 網站：`https://arise.tw`
- Email：`line@arise.tw`
- Phone：`04-23959274`
- Line：`https://lin.ee/asme4UJ`
- 地址：台中市太平區樹德八街 38 號 5 樓

## PWA（Progressive Web App）

本站提供基礎 PWA 支援：
- Web App Manifest：[/manifest.json](/manifest.json)
- Service Worker：[/sw.js](/sw.js)（快取基本靜態資源；network-first + cache fallback）
- `<meta name="theme-color">`、Apple PWA meta、註冊 SW 的 client script（layout 中）

## Optional

- [精簡版導覽 llms.txt](/llms.txt): 較短、僅導覽與 API 入口