Quick Start 指南

使用你的 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

你可以在 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／SERVICE_ROLE_KEY（2026 年底淘汰）與新版 PUBLISHABLE_KEY／SECRET_KEY；新版金鑰可在專案詳情頁自助輪替

最佳實踐

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

離職時的自動保護

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

通知中心

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

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

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

在「AI Providers」頁可自助申請個人 LLM API key，直接打公司中央 LiteLLM（相容 OpenAI／Anthropic）。

1. 1到側邊欄「AI Providers」→「LiteLLM 自助金鑰」，按「申請新的 key」。
2. 2key 只會顯示一次，請立刻複製保存；之後可在同頁列出或撤銷自己的 key。
3. 3同頁「可用模型」卡片列出你能用的模型，點模型名稱即可複製。

獨立 Supabase 專案的資料庫可自助檢視與維護。

• 在專案頁可「產生資料庫直連（DATABASE_URL）」——拿到後可在本機跑 migration／DDL（重新下載 .env.local 取得）。
• 資料庫異常（例如記憶體不足當掉）時，可在專案頁或資料庫健康頁按「重啟資料庫」自助恢復。
• 「資料庫健康」頁可看服務狀態、記憶體／磁碟／CPU 歷史趨勢、拉取 Postgres 日誌，以及「自上次重啟」時間。

側邊欄還有這些工具：

• 環境變數：管理專案的 Vercel 環境變數。
• 部署日誌：排查部署失敗與執行時錯誤。
• CF Zero Trust：管理各 App 的存取白名單。
• DrAva 機器人：註冊 Teams bot 指令。
• 問題回報：回報 bug 或建議（可附檔）。
• 備份：檢視每日基礎設施快照狀態。
• 戰績排行：團隊開發活動排行榜。

開通失敗怎麼辦？

在專案詳情頁的「建立記錄」可以看到哪個步驟失敗。請通知管理員協助處理，或在 FlightPath 中重新建立專案。

如何邀請他人協作？

直接在 GitHub Repo 的 Settings > Collaborators 新增協作者。Vercel 和 Supabase 的存取權限請聯繫管理員。

如何下架專案？

在專案詳情頁點擊「申請下架」。管理員審核後將停用 Vercel、Cloudflare 等相關服務。

我收到了「專案已指派給你」的通知，該怎麼做？

管理員已將一個現有專案移交給你。所有憑證均已輪替，並已依照你的 Git 身份產生全新的 .env.local。前往專案詳情頁點擊「下載 .env.local」，即可取得本機開發所需的環境設定。

我要怎麼拿到可以呼叫 LLM 的 API key？

到「AI Providers」頁按「申請新的 key」即可；key 只顯示一次，記得複製。用法與 endpoint 同頁都有說明。

我的資料庫連不上或很慢怎麼辦？

先到專案頁或「資料庫健康」頁看狀態；若資料庫當掉，可按「重啟資料庫」。持續異常請回報或聯絡管理員。