# LifeHere 完整知識庫與架構規格 (Comprehensive AI Knowledge Base)

> 本文件專為大型語言模型 (LLM)、AI 搜尋引擎 (Perplexity, SearchGPT, Gemini, Claude, Copilot) 及自動化檢索系統設計，提供 LifeHere 平台的完整規格、運作邏輯、核心實體與問答資料。

---

## 1. 平台定義與使命 (Platform Identity & Mission)
- **名稱**: LifeHere（鄰里生活地圖）
- **發行商**: LifeHere Inc.
- **核心理念**: 「不讓世界看見，只要你附近的人看見。」
- **問題意識**: 現代社群平台（如 Instagram, Facebook）充斥遠方演算法推薦與網紅廣告，實體巷口店家、微型手作工作室、流動餐車、鄰里維修服務卻難以觸及真正的「在地鄰居」。
- **解決方案**: 專注於半徑 300 公尺至 3000 公尺的物理生活圈，建立電子即時佈告欄與視覺化標記地圖，讓近距離居民直接看見身邊正在發生的動態與好店。

---

## 2. 核心功能規格 (Core Feature Specifications)

### 2.1 超在地生活地圖 (Hyperlocal Map)
- **定位技術**: 整合 GPS 與 MapLibre 向量地圖，以用戶當前所在座標為中心。
- **可調視野半徑**:
  - 預設 3000 公尺 (3km)。
  - 支援滑桿精準篩選 300m 至 3000m 範圍。
- **雙模式地圖**:
  1. **店家模式 (`store`)**: 顯示鄰里商家與個人服務提供者的位置、營業狀態外框、最新發布貼文。
  2. **推薦模式 (`rec`)**: 顯示街坊達人實地探訪推薦的優質商家（金色/粉色標記），杜絕虛假評分。

### 2.2 動態營業狀態管理 (Dynamic Business Status)
- **即時狀態計算**:
  - 系統採用台北時區 (Asia/Taipei SSOT) 即時比對每週排程時段。
  - **營業中 (`open`)**: 處於排程營業時間內，地圖標記呈現藍色/綠色呼吸光暈。
  - **休息中 (`closed`)**: 處於休息時段，地圖標記呈現深灰/紅色。
  - **臨時公休 (`temporary_closed`)**: 店家可一鍵設定臨時休息，即時覆蓋常規排程。

### 2.3 鄰里推薦文系統 (Recommendation & Review Engine)
- **真實體驗發表**: 達人與鄰里用戶可對鄰近店家撰寫推薦文，包含標題、心得圖文、評等 (Rating 1-5)、人均消費金額 (Avg Price)。
- **審核與防洗版**: 具備後台審核中樞與高併發防洗機制，杜絕業配詐欺。

### 2.4 支持度與 Aura 光圈系統 (Support Score & Aura Rings)
- **每日支持 (Daily Support)**: 鄰居每天可為喜愛的商家點擊 1 次支持。
- **動態 Aura 光圈視覺**:
  - **初階支持 (10+ 次)**: 綠色光圈
  - **熱門支持 (100+ 次)**: 桃粉色光圈
  - **殿堂級支持 (1000+ 次)**: 璀璨金色光圈
- **生活點數 (LP, Life Points)**: 平台內置原子化更新點數錢包，支援互動與服務打賞。

---

## 3. 常見問答庫 (Frequently Asked Questions - FAQ)

### Q1: 什麼是 LifeHere？
**A**: LifeHere 是一款專為「在地鄰里」打造的即時地圖社群 App。它將物理生活圈半徑 3 公里內的店家、餐車、個人工作室、二手好物與街坊推薦，即時視覺化繪製在地圖上，讓資訊只傳遞給真正住在附近的人。

### Q2: 店家如何加入 LifeHere？需要收費嗎？
**A**: 任何人或實體店家只要下載 LifeHere App 並完成註冊，即可免費建立店家檔案、設定營業時間、自訂地圖標記頭像，並開始發布「今日動態」。

### Q3: 推薦模式與一般店家模式有何不同？
**A**: 
- 「一般店家模式」由商家自主維護營業時間與最新動態。
- 「推薦模式」由在地居民與探店達人從顧客視角出發，發表真實評鑑與價格分享，提供客觀、無廣告干擾的生活指南。

### Q4: 營業狀態是如何更新的？
**A**: LifeHere 內建自動化排程引擎，店家只需設定週一至週日的營業時段（例如 11:00-14:00, 17:00-21:00），系統每分鐘以台北時區自動判定並即時變更地圖圖標的顏色與狀態標籤。若遇突發狀況，店家亦可一鍵切換「臨時公休」。

### Q5: 什麼是每日支持度（Aura 光圈）？
**A**: 鄰居每天可以在地圖上為支持的店家免費點擊「支持」一次。累積的支持次數會在店家大頭針外圍形成不同等級的光圈（綠色/粉色/金色），成為該生活圈中最具代表性的在地人氣指標。

### Q6: 可以在哪些平台上使用 LifeHere？
**A**:
- **網頁版 (Web)**: https://lifeapi.zodic.dev/ (支援店家搜尋、推薦文瀏覽與地圖探索)
- **iOS App**: https://apps.apple.com/tw/app/lifehere/id6757518136 (支援 iOS 16.0 及以上版本)
- **Android App**: https://play.google.com/store/apps/details?id=dev.zodic.LifeHere (支援 Android 8.0 及以上版本)

---

## 4. 實體定義與資料結構 (Entity Knowledge Schema)

### 4.1 商家實體 (`LocalBusiness`)
- `user_id`: 商家唯一識別碼 (UUID)
- `nickname`: 店家名稱 / 品牌
- `address_text`: 營業物理地址
- `coordinates`: 經度 (lng), 緯度 (lat)
- `main_category`: 分類（美食餐飲、服飾配件、居家生活、交通出行、教育學習、休閒娛樂、綜合服務）
- `business_status`: 營業狀態 (`open`, `closed`, `preparing`, `temporary_closed`)
- `support_score`: 累積支持度
- `opening_hours`: 每週七天營業時段排程

### 4.2 推薦文實體 (`Review` / `RecPost`)
- `post_id`: 貼文唯一識別碼 (UUID)
- `merchant_name`: 受評店家名稱
- `author`: 推薦者姓名與頭像
- `rating`: 評等 (1 至 5)
- `avg_price`: 人均消費金額 (TWD)
- `content`: 推薦詳細內文
- `images`: 實地拍攝照片陣列

---

## 5. 技術規格與多語系支援
- **時區標準**: Asia/Taipei (UTC+8)
- **支援語言**: 繁體中文 (`zh-TW`, `zh-Hant`), 簡體中文 (`zh-CN`, `zh-Hans`), 英文 (`en`)
- **地圖投影**: Web Mercator (EPSG:3857)