快速開始指南

關於此專案

fast2furious 是 cancerfree.io 內部的任務管理中樞：Space → Folder → List 階層、七種視圖（總覽/清單/看板/表格/成員/月曆/時間軸）、子任務與標籤、每日進度回饋，並提供 REST API 與 Webhooks 供內部系統整合。

如何登入

使用您的 cancerfree.io Microsoft 帳號即可登入。首次登入需要設定雙重驗證（MFA）。

開始開發

  1. 從 FlightPath 下載 .env.local、CLAUDE.md、PRD.md
  2. Clone 專案到本地：git clone + cd
  3. 將下載的檔案放入專案根目錄
  4. 執行 claude 啟動 Claude Code，它會讀取 CLAUDE.md 和 PRD.md 自動開始開發

技術棧

  • Next.js (App Router)
  • TypeScript
  • Tailwind CSS
  • Neon (PostgreSQL Database)
  • Supabase (Auth + Storage)
  • Azure AD SSO

REST API

所有端點皆在 /api/v1 之下，可用瀏覽器 session 或 Personal Access Token（Authorization: Bearer <token>）認證。Token 可在登入後的「設定」頁產生。

回應格式

成功：{ "success": true, "data": … }；失敗：{ "success": false, "error": { "code", "message" } }

端點

GET/api/v1/tree
GET · POST/api/v1/spaces
PATCH · DELETE/api/v1/spaces/{id}
GET · POST/api/v1/spaces/{id}/members
DELETE/api/v1/spaces/{id}/members/{userId}
POST/api/v1/folders · PATCH · DELETE /{id}
POST/api/v1/lists · PATCH · DELETE /{id}
GET · POST/api/v1/tags · DELETE /{id}
GET · POST/api/v1/tasks
GET · PATCH · DELETE/api/v1/tasks/{id}
GET · POST/api/v1/personal-tokens
DELETE/api/v1/personal-tokens/{id}
GET · POST/api/v1/webhooks
PATCH · DELETE/api/v1/webhooks/{id}

Webhooks

可訂閱 task.created / task.updated / task.completed 事件。派送為 POST JSON，並附 x-f2f-event 與 x-f2f-signature（sha256=<HMAC-SHA256(body, secret)>）標頭，請以 secret 驗證簽章。

← 返回登入頁