返回登入

Quick Start 指南

FlightPath 是公司內部的 Vibe Coding 專案自助開通平台。透過 FlightPath，你可以在幾分鐘內自動建立 GitHub Repo、Supabase 資料庫、Vercel 部署環境以及 Cloudflare DNS，並下載 .env.local 開始開發。

登入系統

使用你的 Microsoft (@cancerfree.io) 帳號登入。點擊「以 Microsoft 帳號登入」後，完成公司 SSO 驗證。首次登入時需要設定 MFA（多因素驗證），請依照畫面指示完成。

建立新專案

登入後，點選左側 sidebar 或頂部導覽列的「建立新專案」。填寫以下資訊：

  • 專案名稱：英文小寫和數字，例如 mysalestool
  • Subdomain：你的專案將部署在 {subdomain}.cancerfree.io
  • 說明（選填）：簡短描述此專案的用途

系統會即時檢查名稱與 Subdomain 是否已被使用。確認可用後點擊「開始建立」。

等待自動開通

建立後系統會自動完成以下步驟（通常 2～5 分鐘）：

  1. 1GitHub：建立專案 Repo，寫入 CI/CD Workflow 與 PRD.md / CLAUDE.md
  2. 2Supabase：建立獨立資料庫實例
  3. 3Azure AD：設定 OAuth redirect URI
  4. 4Vercel：建立部署環境並連接 GitHub
  5. 5GitHub Secrets：自動寫入 Vercel token、Supabase key 等機密
  6. 6Cloudflare DNS：建立 CNAME，讓你的網址生效
  7. 7.env.local：打包所有環境變數，可在專案詳情頁下載

開始開發

開通完成後，在「專案詳情」頁面可以：

  • 點擊「開啟網站」確認部署正常
  • 點擊「下載 .env.local」取得本地開發環境變數
  • 點擊 GitHub 連結查看 Repo
將下載的 .env.local 放至 Repo 根目錄後，即可執行 pnpm install && pnpm dev 開始本地開發。

Bot 指令

你可以在 Teams Bot（DrAva）中為你的專案新增自訂指令。在專案詳情頁的「Bot 指令」區塊點擊「新增指令」，設定指令名稱（以 / 開頭）、說明文字和 Endpoint URL。使用者在 Teams 輸入指令時，FlightPath 會自動轉發至你的 Endpoint。

安全與憑證

下載的 .env.local 包含存取你專案資源的所有憑證。請遵守以下原則，確保公司與個人資料安全。

.env.local 裡的憑證

  • GitHub Deploy Key：僅能存取此專案的 Repo，無法影響組織內其他 Repo
  • DATABASE_URL：直接連線資料庫的字串，內含密碼（Neon 或 Supabase 皆適用）
  • Supabase keys（若使用 Supabase）：ANON_KEY（受 RLS 保護）和 SERVICE_ROLE_KEY（繞過 RLS）

最佳實踐

  • 勿將 .env.local 或 Deploy Key 提交至 Git 或分享給他人
  • 勿將下載的 Deploy Key 同步到雲端硬碟或其他裝置
  • 離職後請主動刪除本機的 .env.local 以及 ~/.ssh/id_ed25519_{專案名稱}
  • 若懷疑憑證外洩，立即通知管理員

離職時的自動保護

員工離職時，管理員可在 FlightPath 一鍵重置資料庫密碼、輪替 Supabase keys 並撤銷 GitHub Deploy Key，所有舊憑證在數秒內失效。即使你本機仍保留 .env.local，也無法再用於存取專案資源。管理員也可將專案移交給新員工，移交時同樣會輪替所有憑證並為新負責人產生全新的 .env.local，專案不需下線。

通知中心

側欄的鈴鐺圖示會顯示未讀通知數量。當管理員將專案移交給你時，你會收到應用內通知，點擊通知即可跳轉至專案頁面，並下載屬於你的新 .env.local。

設定排程任務（Cron）

需要定時執行的工作（例如每日報表、資料同步）可使用 Vercel Cron Jobs，無需自行架設排程伺服器。

  1. 1在專案根目錄的 vercel.json 中新增 crons 設定，指定路徑與 cron 排程表達式。
  2. 2在 app/api/cron 下建立對應的 Route Handler，撰寫要執行的工作邏輯。
  3. 3設定 CRON_SECRET 環境變數，並在 route 中驗證 Authorization header，避免端點被外部呼叫。

Vercel Cron 只會以 HTTP 請求觸發你的 /api/cron 端點，不會執行 Docker 容器或常駐程序；排程任務本身就是一次普通的 Serverless Function 呼叫。

常見問題

開通失敗怎麼辦？
在專案詳情頁的「建立記錄」可以看到哪個步驟失敗。請通知管理員協助處理，或在 FlightPath 中重新建立專案。
如何邀請他人協作？
直接在 GitHub Repo 的 Settings > Collaborators 新增協作者。Vercel 和 Supabase 的存取權限請聯繫管理員。
如何下架專案？
在專案詳情頁點擊「申請下架」。管理員審核後將停用 Vercel、Cloudflare 等相關服務。
我收到了「專案已指派給你」的通知，該怎麼做？
管理員已將一個現有專案移交給你。所有憑證均已輪替，並已依照你的 Git 身份產生全新的 .env.local。前往專案詳情頁點擊「下載 .env.local」，即可取得本機開發所需的環境設定。