XSPA LITE — 環境需求（什麼情況下裝得起來）
============================================

本說明適用 LITE 安裝包（不含 forum/）。只要符合「必要條件」，即可用 /install/ 完成安裝。

---

一、必要條件（缺一不可）
------------------------

  項目              最低要求
  ----------------  ------------------------------------------
  PHP               8.0 以上（建議 8.1+）
  資料庫            MySQL 5.7+ 或 MariaDB 10.3+
  Web 伺服器        Apache 或 Nginx（能執行 .php 即可）
  PHP 擴充          pdo、pdo_mysql（安裝精靈會檢查）
  目錄可寫          config/、data/、uploads/（含子目錄）

  說明：
  - 共享主機（cPanel、HestiaCP、Plesk 等）通常可用，請先在控制台建立
    「資料庫 + 使用者」，再把帳密填進 config/db.php。
  - 精靈不會幫你 CREATE DATABASE；資料庫須事先建好。
  - json 為 PHP 內建，一般不需額外安裝。

---

二、建議條件（沒有也能裝，但部分功能受限）
------------------------------------------

  項目              用途
  ----------------  ------------------------------------------
  mbstring          中文與多語系字串（強烈建議）
  curl              新手村 API 同步、圖片下載、Brevo 寄信
  fileinfo          上傳檔案類型判斷
  gd 或 imagick     頭像／圖片縮圖（若主機有）

  沒有 curl：後台「同步店家／同步圖片」可能無法連外 API。
  沒有 mbstring：中文顯示或搜尋可能異常。

---

三、選用功能（需要額外設定或擴充）
----------------------------------

  功能                    需要
  ----------------------  ------------------------------------------
  Brevo 寄信              curl + 後台或環境變數 FATE_BREVO_API_KEY
  PHP mail() 寄信         主機已設定 sendmail／SMTP（多數共享主機可）
  反向 Email 驗證（IMAP）  PHP imap 擴充 + 信箱設定（PHP 8.4 常需另裝）
  新手村店家同步          可連外 HTTP + API 金鑰 + 白名單網址
  Google 地圖／Geocoding  data/fate_secrets.json 或環境變數金鑰

  LITE 版不含討論區；不需 forum/ 目錄。

---

四、本機開發（Windows 範例）
----------------------------

  以下任一組合即可本地測試：

  1. XAMPP（Apache + PHP 8.x + MariaDB）
     - 解壓 ZIP 到 htdocs\xspa（或自訂資料夾）
     - 在 phpMyAdmin 建立資料庫（例如 xspa）
     - 複製 config/db.example.php → config/db.php 並填入
     - 瀏覽 http://localhost/xspa/install/

  2. Laragon / WampServer / PHP 內建伺服器
     - 原則相同：PHP 8+、MySQL、可寫入 config/data/uploads

  本機注意：
  - Windows 下 mail() 常無法真正送達，Email 驗證請改 Brevo 或略過測試。
  - 不必安裝同層 newbies/ 專案；LITE 可獨立運作。

---

五、正式主機（Linux 共享／VPS）
------------------------------

  Apache：
  - 已有 config/.htaccess、data/.htaccess 阻擋直接下載設定檔
  - 無需 mod_rewrite（網址以 /index.php、/store.php 等形式存取）

  Nginx：
  - 須自行設定：禁止 HTTP 存取 /config/、/data/、/includes/ 等
  - PHP 以 php-fpm 處理 .php

  上線後：
  - 完成 /install/ 後請刪除或限制 install/ 目錄
  - 子目錄部署時設定 FATE_SESSION_COOKIE_PATH、FATE_PUBLIC_SITE_ORIGIN

---

六、磁碟與權限（粗略）
--------------------

  僅文字與少量上傳：數百 MB 即可。
  若啟用「同步圖片至本站」：建議預留數 GB 以上（依店家數與相片量）。

  uploads/ 子目錄（精靈可自動建立）：
  avatars、stores、blog、masseurs、ads

---

七、安裝前快速自檢
------------------

  [ ] PHP >= 8.0，且已啟用 pdo_mysql
  [ ] MySQL 資料庫與使用者已建立
  [ ] config/、data/、uploads/ 對 Web 程序可寫
  [ ] 已上傳完整 ZIP（含 sql/、install/、includes/）
  [ ] 無 config/db.php 時，可先從 db.example.php 複製

  開啟 /install/ 後，精靈會再跑一次環境與目錄檢查；紅色項目須先修正。

---

相關檔案：INSTALL-LITE.txt（安裝步驟）、README.md（功能概覽）
