Skip to content
OriginalPhase Ops Handbook

OriginalPhase Ops Handbook

這是本際文創的內部作戰地圖：把全端開發、部署、SEO、資安、金流、AI Agent 工作流與錯誤排查，整理成可複製、可驗證、可交給 Agent 協作的 SOP。

高頻使用 SOP

詳細分類入口

前端開發｜FrontendAstro、Nuxt、Starlight、Cloudflare Pages 與前端 SEO 基礎作業。後端服務｜BackendFastAPI、Render、worker、Redis 與 API debug 的部署筆記。登入與權限｜AuthSupabase Auth、OAuth callback、redirect 與登入流程檢查。金流與訂閱｜PaymentsPayUni、OEN subscription、webhook idempotency 與付款驗證。SEO 技術檢查｜Technical SEOCanonical host、redirect、sitemap、GSC 與上線前檢查。資安檢查｜SecurityRLS、環境變數、webhook security 與上線前資安檢查。Agent 工作流 Prompt｜Agent PromptsSEO audit、修復、CodeRabbit、交接摘要與部署 debug prompt。錯誤排查｜TroubleshootingCloudflare redirect loop、GSC sitemap、soft 404 與 build failure。專案管理｜Project Management任務交接、release checklist 與 context compression 方法。

System Map

產品技術生態圖｜System Map

01

使用者層

Client / User

  • Web User
  • Admin / Consultant
  • AI Agent Operator
02

前端層

Frontend Layer

  • Nuxt
  • Astro
  • Tailwind CSS
  • UI / UX
  • i18n
03

應用後端

Application Backend

  • FastAPI
  • API Router
  • Service Layer
  • Webhook Handler
04

背景任務

Async Worker Layer

  • ARQ Worker
  • Redis
  • Scheduled Jobs
  • Queue
05

資料與權限

Data / Auth Layer

  • Supabase Auth
  • PostgreSQL
  • RLS
  • Storage
06

AI 工作流

AI Workflow Layer

  • Prompt Design
  • Agent Workflow
  • RAG
  • OpenRouter
  • Gemini / OpenAI
07

外部服務

External Providers

  • Cloudflare Pages / DNS
  • Render
  • Oen / PAYUNi
  • Google Search Console
  • CodeRabbit

Development Lifecycle

開發生命週期｜Development Lifecycle

  1. 01

    專案建立

    Project Setup

    • Repo
    • Template
    • Branch
    • Env
  2. 02

    需求定義

    Requirements

    • FRD
    • PRD
    • User Flow
    • Data Flow
  3. 03

    視覺與 UI

    Visual / UI

    • Visual Direction
    • Wireframe
    • Component Spec
  4. 04

    架構設計

    Architecture

    • Frontend
    • Backend
    • DB
    • Auth
    • Payments
    • AI
  5. 05

    開發環境

    Local Dev

    • .env
    • Supabase
    • Render
    • Cloudflare
  6. 06

    核心功能實作

    Implementation

    • API
    • UI
    • DB Migration
    • Worker
    • Workflow
  7. 07

    Agent 協作

    Agent Collaboration

    • Audit Prompt
    • Fix Prompt
    • Handoff
    • Code Review
  8. 08

    測試與檢查

    Verification

    • Build
    • Typecheck
    • SEO
    • Security
    • Auth
    • Payment
  9. 09

    Staging 部署

    Staging Deploy

    • Cloudflare Pages
    • Render
    • Supabase Staging
  10. 10

    Production 上線

    Production Launch

    • DNS
    • Redirect
    • Sitemap
    • GSC
    • Monitoring
  11. 11

    上線後維運

    Operations

    • Logs
    • GSC
    • Error Tracking
    • User Feedback
  12. 12

    SOP 回寫

    Knowledge Capture

    • Troubleshooting
    • Prompt
    • Checklist
    • Handbook Update

文件撰寫原則

  • 每篇都要有適用情境，讓接手的人知道何時該用。
  • 每篇都要有完成標準，避免做到一半就以為完成。
  • Prompt 要可直接複製，並標明使用模型與輸出格式。
  • 指令要可直接複製，並寫清楚預期結果。
  • 錯誤案例要沉澱成 troubleshooting，不只留在聊天紀錄。

SOP 標準章節

新文件請優先從 SOP 撰寫模板｜SOP Writing Template 複製，保留固定章節：適用情境、最終目標、前置資料、操作流程、驗證指令、Agent Prompt、常見錯誤、完成標準、延伸文件。