Quick Start 指南
FlightPath 是公司內部的 Vibe Coding 專案自助開通平台。透過 FlightPath,你可以在幾分鐘內自動建立 GitHub Repo、Supabase 資料庫、Vercel 部署環境以及 Cloudflare DNS,並下載 .env.local 開始開發。
登入系統
使用你的 Microsoft (@cancerfree.io) 帳號登入。點擊「以 Microsoft 帳號登入」後,完成公司 SSO 驗證。首次登入時需要設定 MFA(多因素驗證),請依照畫面指示完成。
建立新專案
登入後,點選左側 sidebar 或頂部導覽列的「建立新專案」。填寫以下資訊:
- 專案名稱:英文小寫、數字、連字符,例如 my-sales-tool
- Subdomain:你的專案將部署在 {subdomain}.cancerfree.io
- 說明(選填):簡短描述此專案的用途
系統會即時檢查名稱與 Subdomain 是否已被使用。確認可用後點擊「開始建立」。
等待自動開通
建立後系統會自動完成以下步驟(通常 2~5 分鐘):
- 1GitHub:建立專案 Repo,寫入 CI/CD Workflow 與 PRD.md / CLAUDE.md
- 2Supabase:建立獨立資料庫實例
- 3Azure AD:設定 OAuth redirect URI
- 4Vercel:建立部署環境並連接 GitHub
- 5GitHub Secrets:自動寫入 Vercel token、Supabase key 等機密
- 6Cloudflare DNS:建立 CNAME,讓你的網址生效
- 7.env.local:打包所有環境變數,可在專案詳情頁下載
開始開發
開通完成後,在「專案詳情」頁面可以:
- 點擊「開啟網站」確認部署正常
- 點擊「下載 .env.local」取得本地開發環境變數
- 點擊 GitHub 連結查看 Repo
將下載的 .env.local 放至 Repo 根目錄後,即可執行 pnpm install && pnpm dev 開始本地開發。Bot 指令
你可以在 Teams Bot(DrAva)中為你的專案新增自訂指令。在專案詳情頁的「Bot 指令」區塊點擊「新增指令」,設定指令名稱(以 / 開頭)、說明文字和 Endpoint URL。使用者在 Teams 輸入指令時,FlightPath 會自動轉發至你的 Endpoint。
常見問題
- 開通失敗怎麼辦?
- 在專案詳情頁的「建立記錄」可以看到哪個步驟失敗。請通知管理員協助處理,或在 FlightPath 中重新建立專案。
- 如何邀請他人協作?
- 直接在 GitHub Repo 的 Settings > Collaborators 新增協作者。Vercel 和 Supabase 的存取權限請聯繫管理員。
- 如何下架專案?
- 在專案詳情頁點擊「申請下架」。管理員審核後將停用 Vercel、Cloudflare 等相關服務。