# 瑞歐車庫 E83 部署包

這是可由 cPanel、FTPS/SFTP 與 phpMyAdmin 操作的 PHP 部署包。E83 執行時不需要 Node.js、npm、Composer、SSH、root、Docker、Redis 或常駐服務。

完整步驟請先閱讀 [`docs/deployment-e83.md`](docs/deployment-e83.md)。本 README 只做安裝順序與高風險提醒，不代表實際 E83 已部署或驗收通過。

## 安裝順序

1. **先備份現站**：用 cPanel File Manager（HTTPS）或 FTPS/SFTP 備份既有 WordPress 全部檔案；用 phpMyAdmin 匯出目前唯一 MySQL database 的完整 SQL（所有表、結構與資料）。備份要私下保存，因為 SQL 可能包含 WordPress、帳號與個資。不要刪除 WordPress、不要 `DROP DATABASE`、不要建立第二個資料庫。
2. **檢查同庫衝突與容量**：查詢全庫 `garage_*` 命名衝突，並以 `information_schema.tables` 估算 `data_length + index_length`。20MB 可能是十進位 MB 或二進位 MiB；I_S 估算不等於 E83 計費/檔案實際用量。未確認前不要匯入。
3. **放置檔案**：將交付包 `public_html/` 的內容放到實際 DocumentRoot，不要多一層 `public_html/`；`private/` 放在 DocumentRoot 外的兄弟目錄。`database/`、`docs/`、`source/` 不得公開。
4. **建立設定檔**：在 webroot 外將 `private/config.example.php` 複製為 `private/config.php`，填入既有 DB 連線資訊、`app_origin='https://ruiougarage.com.tw'`、`allow_http_local=false`、依 provider 實際配額保守下修的 `max_db_bytes`，以及由密碼管理器產生至少 32 字元的 setup key。不要使用 `.env`，不要把 Telegram token/chat ID 放進 ZIP 或 SQL。
5. **匯入資料庫**：在同一個既有資料庫依序匯入 `database/schema.sql`、再匯入一次 `database/seed.sql`。若任何 `garage_*` 表已存在或容量不足，先停止並由資料擁有人決定；不要刪表來讓 seed 通過。seed 含 1 筆預約與 2 筆已停用舊 Node/scrypt 帳號雜湊，不能公開分享。
6. **建立新 PHP owner**：HTTPS 開啟 `/setup.php`，不要把 key 放 URL；先用 POST setup key 解鎖，再用短期 cookie、CSRF 與 exact Origin 送出 owner 表單。setup 成功後會永久鎖定。新密碼須為 12–72 UTF-8 bytes，含大寫、小寫、數字與特殊符號。舊 Node/scrypt 帳號不相容、不登入、不重設；原 WordPress 帳密不變。
7. **正式入口與驗收**：登入入口是 `https://ruiougarage.com.tw/admin/login`，網站從 `/` 驗收；不要直接開 `/app.html`，該檔案被刻意回 HTTP 403。現場需另驗 SSL、handler、WAF/ModSecurity、cURL outbound、容量、目錄寫入與效能。
8. **備份/還原與通知**：依部署手冊備份 `public_html/uploads/images/` 與 `private/storage/private-photos/`；業務 JSON 只含 10 表與照片 metadata，不含 auth/security/secrets。restore 前先做全庫 SQL 與完整檔案備份，UI 必須雙確認並輸入 `RESTORE`。Telegram token/chat ID 需私下設定，無須重設既有 Bot Token；本輪未對外發送或確認手機收訊。Production 已可使用相同安全流程，先測試成功、確認手機收到且設定摘要相符，才能啟用預設關閉的案件通知，不能假稱已在 E83 收訊。

## 目錄要點

```text
DocumentRoot/
├── index.php
├── app.html                 # 由 index.php 載入；直接請求預期 403
├── .htaccess
├── images/                  # 交付的靜態圖片
├── fonts/                   # 交付的字型
└── uploads/images/          # 公開上傳圖片（不可執行 PHP）

~/private/                   # DocumentRoot 外
├── config.php               # 從 config.example.php 私下複製，不公開
├── app/
├── storage/logs/
└── storage/private-photos/  # 估價私有照片
```

`database/`、`docs/`、`source/` 與完整 SQL/ZIP 備份應留在 webroot 外並限制存取。`private/.htaccess` 只是額外防護；最重要的是 `private/` 本身不在 DocumentRoot。

## 已知測試邊界

本包在隔離本機 Apache/mod_php PHP 8.3.6、MySQL 8.4.7 已完成 11 組 API、55 組單元測試與桌機/手機尺寸檢查；這不等同 E83 實機通過。實際 E83 的 SSL、PHP handler、WAF/ModSecurity、cURL 對外網路、Telegram 手機收訊、資料庫 provider 配額、目錄權限與效能仍須現場記錄。

`preflight.php` 回報 PHP 8.2+／SAPI／擴充與 GD 解碼器、PHP 每次請求資源參數、PDO MySQL 連線與 8.4.7+ 版本、全庫資料／索引估算和三個儲存目錄可寫入狀態。它不驗證 E83 計費配額、SSL、WAF、cURL 外送或帳號總資源／效能。容量與同庫 WordPress 用量仍需另在 cPanel/phpMyAdmin 確认。

完整的備份/還原、HTTPS、容量與驗收清單見 [`docs/deployment-e83.md`](docs/deployment-e83.md)。
