GEOFlow · 使用說明書 GEO 內容生產系統：六模組工作流一套 PHP + Laravel 的開源 GEO 系統。

上傳產業文件、品牌素材、產品手冊，GEOFlow 會自動切片、向量化、寫入 PostgreSQL 的 pgvector。生成時自動執行 retrieval，將對應段落注入 prompt，使輸出內容具備可追溯的事實依據。未建立知識庫時，生成結果無法引用品牌特定資料。

php artisan queue:work redis 啟動 Laravel 風格的 worker，將生成任務拆成獨立 jobs 並行處理。任務失敗自動重試，超時可被中斷重排。日產量超過 50 篇時，queue 機制是維持穩定吞吐的核心依賴。

標題庫、關鍵字庫、配圖庫、作者庫統一建立在同一個資料模型內，可被 AI 任務即時調用。GEOFlow 將這四類素材作為一級資料實體管理，支援跨任務重複使用，降低每次生成的組裝成本。

GEOFlow 把編輯流程內建為一級流程：AI 產出進入 草稿池，編輯標記 review → approve → 進入發布佇列。整套狀態機與權限分離，避免「AI 自動發文章」的失控風險。對受監管產業（金融、醫療、法律）特別重要。

每篇文章自動產生 <title>、meta description、Open Graph、Twitter Card 與 JSON-LD 結構化資料。對 GEO 而言，結構化資料是 AI 答案引擎判斷可信度的線索。GEOFlow 的預設輸出已對齊 Schema.org Article / FAQPage 規格。

composer install → php artisan migrate --force → php artisan db:seed --force → php artisan serve。需要 PHP 8.2+ 與本機 PostgreSQL/Redis。建議搭配 Laravel Valet 或 Sail 開發。

生產環境必須同時起：php artisan queue:work redis（佇列）、php artisan schedule:work（排程）、php artisan reverb:start（即時 WebSocket）。Docker compose 已預設好，本地開發者請用 supervisor 或 tmux 同時跑。

APP_PORT=18080（HTTP 對外 port）、ADMIN_BASE_PATH=geo_admin（後台前綴，務必改成自訂值避免被掃描）、QUEUE_CONNECTION=redis（生產建議用 redis）、DB_HOST / REDIS_HOST。雲端部署時把這些拉成 secret manager 變數。

初次部署登入：使用者名稱 admin，密碼 password。第一次登入後務必立刻修改。建議在 production 啟動腳本中加入「若密碼仍為預設則拒絕啟動」的檢查。對外上線之前，也應將 ADMIN_BASE_PATH 改成不可猜測的字串。

內建中文（簡）、英文、日文、西班牙文、俄文、葡萄牙文後台介面，使用者可在帳號層級切換。對於跨市場代理商或 SaaS 公司，編輯與審核者可用母語操作，而資料層保持統一。

在後台模型設定中分別建立 draft-model 與 polish-model，並在任務模板把這兩個分配到生草稿與精修兩個階段。Editor 可在審核時觸發「精修」二次生成，避免每篇都用最貴的模型。

在 App\Console\Kernel 註冊 cron 任務（每日 9:00 跑 keyword cluster、每週日 23:00 重建知識庫向量等）。production 必須以 supervisor 或 systemd 守護 php artisan schedule:work，少這條線整個排程都失效。

在後台「知識庫」頁可手動觸發 rebuild；批量站台建議寫一個排程任務每月跑一次。如果產業文件更新頻繁（金融、法規），可縮短到每週。請特別注意：rebuild 期間要避開生成高峰時段，否則會搶 OpenAI 或 embedding 服務的 quota。

在 .env 設定 ADMIN_BASE_PATH=ops-2026-x9k 之類的字串，並把這條路徑只透過 1Password / 公司密碼管理工具分享給編輯團隊。配合 Cloudflare Access 或 IP 白名單，等同於把後台從公網「半隱身」。

Laravel Reverb 是 GEOFlow 內建的 WebSocket server。將其接上後台的 toast / sidebar 通知元件，當 AI 任務完成、草稿入池、編輯標記回退時即時通知對應 reviewer，適用於需要持續運作的內容工廠環境。

在後台建立多個發布頻道（Website / Hub / Partner / API），每個頻道綁定不同網域與品牌設定。發布時勾選頻道，GEOFlow 會自動處理 metadata、Open Graph、JSON-LD 的差異化。對代理商客戶矩陣特別實用。

既有官網（WordPress、Webflow、Shopify、Next.js）保留主品牌與 marketing 動線，把 /insights、/blog、/glossary 子路徑交給 GEOFlow 經營。透過反向代理或 API 對接，前端讀取 GEOFlow 提供的內容，但設計與品牌仍由原網站控制。

針對特定產業（金融科技、醫療、製造、能源、加密貨幣），將白皮書、產業報告、法規、年報等長尾權威來源建入知識庫，週期性產出「本週重點」、「年度回顧」、「主題深度」。此類具備引用依據的內容站台，較易被 AI 答案引擎引用。

代理商將每個客戶對應一個 channel，配置不同網域與品牌規範。所有客戶共用同一條 queue 與 worker，但生成模板、知識庫、字體調性各自獨立。月產 200+ 篇內容的代理商可透過此站群作業架構降低單篇內容的人工介入比例。

部署在內網，作為員工問答系統。員工輸入問題後，由 RAG 從知識庫提取相關條目並生成答案。適用場景包括 onboarding、IT 支援、合規查詢，知識庫建立後可降低重複性人工查詢的時間成本。

不適用場景：(1) 高互動電商首頁，GEOFlow 為內容引擎，非商品展示系統；(2) 即時新聞日更，AI 生成加編輯流程的速度不符合分秒級截稿需求；(3) 高度個人化的 1-on-1 客戶通訊，應由 CRM 處理；(4) 不具備 PostgreSQL / Redis / pgvector 基礎設施的純前端團隊。