台南不動產實價登錄儀表板
台南市不動產交易資料視覺化平台，資料來源為內政部不動產交易實價查詢服務網。
🔗 線上網址：https://tainan-realestate-ai.vercel.app
功能
📖 完整功能說明（每項功能 30 字內）：見 docs/USER-GUIDE.md
🧭 開發中：購屋潛在客群分析（資料來源、評估、實作與下一步）：見 docs/potential-buyer-analysis-plan.md
| 頁面 | 內容 |
|---|
| 數據看板 | KPI 總覽、實價登錄明細、個案排行、行政區／類型／房型統計 |
| ↳ 地圖 | 群集標記與預售屋單價熱力圖，點擊查看建案交易明細 |
| ↳ 框選分析 | 地圖框選建案（最多 8 案）比較單價、類型分布與月度走勢 |
| 數據分析 | 多行政區並列比較單價、總價、面積、車位、交易量、成交額走勢 |
| 住宅價格指數 | 全市／建物型態／行政區指數趨勢（基期 110 年 1 月 = 100） |
| 市場供給面 | 建照／使照核發量疊上成交量，及各區待售新成屋餘屋趨勢 |
| 建案比較 | 中位單價 × 中位坪數散佈定位產品，附總價等值線 |
| 建案搜尋 | 搜尋預售建案，查看位置與完整實價登錄明細 |
| AI 問答 | 自然語言轉 SQL 查詢並自動視覺化（需密碼） |
全站共用篩選器（日期區間、行政區、建物類型、房型、成屋／預售屋、屋齡）、深色／亮色主題、三段字級切換，篩選條件會寫入網址可直接分享。
資料自動更新
- GitHub Actions 每月 1 日、11 日、21 日自動抓取內政部最新實價登錄資料
- GitHub Actions 每月 3 日自動抓取公會開放資料（建照、使照、新建餘屋）
技術架構
📐 系統架構圖與資料更新流程圖：見 docs/ARCHITECTURE.md
| 層級 | 技術 |
|---|
| 前端 | Next.js 16 App Router + Tailwind CSS |
| 後端 | Next.js API Routes (Server) |
| 資料庫 | Supabase PostgreSQL |
| AI 問答 | Google Gemini 3.5 Flash-Lite（免費層，429 時備援 2.5 Flash-Lite） |
| 部署 | Vercel |
| 資料抓取 | Python + GitHub Actions |
本地開發
# 安裝依賴
npm install
# 設定環境變數（複製後填入你的金鑰）
cp .env.local.example .env.local
# 啟動開發伺服器
npm run dev
開啟 http://localhost:3000 查看結果。
環境變數
NEXT_PUBLIC_SUPABASE_URL= # Supabase 專案網址
NEXT_PUBLIC_SUPABASE_ANON_KEY= # Supabase 公開金鑰
SUPABASE_SERVICE_ROLE_KEY= # Supabase 服務金鑰（伺服器端專用）
GEMINI_API_KEY= # Google Gemini API 金鑰
GEMINI_MODEL= # 選填，預設 gemini-3.5-flash-lite
CHAT_PASSWORD= # AI 問答密碼閘（未設定則功能回 503）
資料來源
內政部不動產交易實價查詢服務網・台南市不動產開發公會開放資料・臺南市實價登錄大數據輔助區段地價平衡之研究（第六期）｜資料僅供參考，不構成投資建議
