# V1 → V1.1 升級與使用

新版加入可操作的發布、留言、分析、警報與報表，沿用 PHP / MySQL 架構。新安裝可直接使用安裝精靈；既有網站請按以下順序升級。

1. 暫停網站寫入、cron 與 queue worker，確認沒有正在傳送的發布／回覆。
2. 備份 MySQL 資料庫、原本 `.env`、`storage/`（包含 uploads 與安裝鎖）。保留原本 `APP_KEY`，否則既有 Token 無法解密。
3. 更新 app、public、views、bin、database、deploy 等程式檔案。不要以範本覆蓋原本 `.env`；不要重新使用安裝精靈。
4. 執行 `php bin/console.php migrate`，新增 `002_operations.sql` 的 media_assets 與 comment_replies。完成後共有 31 張應用表和一張 migrations 表；可重複執行。
5. 建立 `storage/uploads/`，讓網站及背景 worker 使用相同執行帳號存取。圖片保存在 public 之外，由登入與團隊權限控制讀取。PHP 上傳上限建議每檔 8 MB、整次請求 40 MB，參考 deploy/php.ini。
6. 執行 `php bin/console.php check`。正式環境保持 HTTPS、`SESSION_SECURE=true`、`DEMO_MODE=false`。
7. 重新啟動 queue worker，再啟用每分鐘 cron。新版 worker 同時處理監控與發布工作；更新程式後必須重啟長駐程序。
8. 用測試粉專依序驗證 OAuth、同步、Webhook、新增草稿、確認发布與留言回覆，再開放營運使用。

Docker 使用者須重新 build，沿用資料庫 volume，並保留新的 uploads volume；不要使用 `down -v` 升級。遷移後不建議只退回舊程式，回復時應使用完整備份並核對在 Facebook 已完成的操作。

## 功能與操作

| 頁面 | 可以做什麼 |
|---|---|
| 營運總覽 | 選粉專／日期，看貼文、留言、互動與情緒趨勢 |
| 發布中心 | 建草稿，選多個粉專，文字／連結／最多四張圖片，立即或預約發布；各粉專獨立記錄結果 |
| 貼文監控 | 搜尋貼文、熱門排序、查看快照與互動 |
| 留言工作台 | 搜尋與分類，標記完成，人工修正情緒，撰寫回覆並確認送出 |
| 輿情分析 | 詞典式正／中／負分類、趨勢與人工校正；不是進階語意模型 |
| 關鍵字監控 | 管理群組與詞彙，執行分析、查看命中 |
| 警報中心 | 留言數／關鍵字次數／負面比例規則，站內警報與處理狀態 |
| 成效報表 | 自訂期間、比較粉專、CSV 匯出、列印／另存 PDF |
| 粉專與授權 | Facebook 授權、選擇監控粉專、同步工作狀態 |

發布確認頁必須核對內容、時間及全部粉專，勾選後才會送入背景程序。已開始傳送的工作不可取消。若結果標為「待查核」，請先到 Facebook 查看，避免另建草稿造成重複發布。系統不會自動重送這類不確定結果。

預覽工作空間使用獨立示範資料，所有發布與回覆只保存本機。正式 Meta 串接仍須 App 憑證、核准權限與公開 HTTPS；未替使用者完成真實 Meta 驗收。