跳轉到主要內容
文件協作團隊管理

團隊與成員

建立團隊、邀請成員、共享工作流程與憑證、移交所有權。

Team 是 Braidrun 裡的協作單位 —— 幾個人一起維護同一批工作流、共享憑據、互相審批。這一頁講怎麼建團隊、邀請成員、遷移資源。

誰能用 Team

Team 功能從 Team 套餐開始可用。Free / Pro 套餐下你始終是「個人工作區」。可以在 訂閱與定價 頁查看套餐對比。

一張圖看明白結構

  • 一個賬號可以屬於 多個 Team；在 UI 右上角下拉切換當前 Team。
  • 每個 Team 有自己獨立的：
    • 工作流程列表
    • 模板 / 模塊庫（自己 Promote 出來的模塊共享給團隊）
    • 憑據命名空間
    • 調度 / Webhook
    • 成員名單與權限
    • 執行歷史 + 審計日誌
    • 通知設置
    • 訂閱與配額

創建團隊

  1. 左側導航「團隊」→ 右上角「新建團隊」。
  2. 填名稱（其他成員會看到）、slug（URL 一部分）、描述。
  3. 選擇套餐 —— 從當前賬號已購買的套餐裡選，或點"升級套餐"先買一個。
  4. 創建者自動成為 Team Owner。

邀請成員（郵件邀請，2026-04-27 起）

從 2026-04 起，邀請成員完全透過郵件而非 UUID 貼上：

  1. Team 詳情頁 → 成員標籤 → “發送邀請”
  2. 填寫對方信箱（一次一條；冪等：對同信箱重發會重複使用 PENDING 邀請記錄）+ 選取預先分配的角色
  3. 系統發送郵件，包含一個 32 位元組隨機 token 的連結（256 bits 熵，不可枚舉）
  4. 對方點連結 → 跳到 /teams/invitations/accept 兌換頁
  5. 如果對方沒有登錄，自動跳到登入頁，登入後再回兌換頁
  6. 兌換時系統校驗：目前登入使用者的信箱必須與邀請信箱（case-insensitive）一致 —— 轉寄的連結也不能被他人用
邀請的幾個貼心細節
  • 对方邮箱还没注册 Braidrun？發出邀請後，對方點郵件連結會先跳到註冊頁並預填信箱；註冊完成後自動跳到兌換頁。
  • 同一郵箱可同時被邀請到多個團隊 —— 對方在 /teams/invitations/me 收件匣可以看到所有 PENDING 邀請。
  • TTL 預設 7 天，可在建立時改（最小 5 分鐘，最大 30 天）；過期後 14 天寬限期內系統自動清理。
  • 可撤銷：成員清單 → 邀請標籤裡找到 PENDING 邀請 → 撤銷，連結立即失效。
  • 成員清單加了 ?enrich=true 模式 → 顯示真實姓名 + 郵箱而不是 UUID。

用 API 創建邀請

curl -X POST 'https://braidrun.com/api/teams/{teamId}/invitations' \
  -H 'Authorization: Bearer dyk_...' \
  -H 'Content-Type: application/json' \
  -d '{"email": "newmember@example.com"}'

對方端兌換：

curl -X POST 'https://braidrun.com/api/teams/invitations/accept' \
  -H 'Authorization: Bearer dyk_...' \
  -H 'Content-Type: application/json' \
  -d '{"token": "<32-byte-token-from-email>"}'

角色分配

四種角色，從高到低：Owner / Admin / Editor / Viewer。具體每種角色能做什麼見 權限與角色。

成員管理

在成員列表裡，Admin 及以上可以：

  • 修改成員角色（降級 / 升級）
  • 移除成員（對方所有關聯操作歷史保留，但權限失效）
  • 看每個成員最近一次活躍時間
  • 看每個成員持有的憑據數量、創建的工作流數量
降級成 Viewer 之後

被降級的成員如果正在編輯某條 workflow，編輯鎖會被強制釋放，對方界面變成只讀並彈 toast 提示。未保存的本地修改會丟失。

轉移所有權

團隊只能有一個 Owner。想把所有權轉給別人：

  1. 團隊設置 → 「轉移所有權」。
  2. 選一個當前 Admin 作為新 Owner。
  3. 雙因子驗證 —— 需要當前 Owner 用郵箱或 TOTP 二次確認。
  4. 完成後當前 Owner 自動降級為 Admin；訂閱賬單歸屬也轉移。

切換當前團隊

右上角用戶頭像下拉 → 選擇"當前團隊"。切換後：

  • 側邊欄所有列表（工作流 / 憑據 / 調度 / 執行 / 審批）都重新加載到新團隊的數據
  • URL 會帶一個 team 參數，刷新後保留
  • 切換會把你已打開的工作流編輯器關閉（防止跨團隊誤改）

資源的跨團隊移動

工作流移動到另一個團隊

  1. 工作流詳情頁 → 設置 → "移動到團隊"。
  2. 選目標團隊 —— 你必須是目標團隊的 Editor 以上角色。
  3. 系統校驗工作流裡引用的憑據是否在目標團隊也存在同名的 —— 不存在的會被列出來讓你選"跳過 / 建立同名憑據 / 取消移動"。
  4. 確認後工作流 + 歷史 execution 一起遷移到新團隊。

憑據的跨團隊複製

憑據不能"移動"，只能"複製" —— 為了避免意外吊銷原團隊的權限。你會被要求重新輸入值，然後創建一份同名憑據到目標團隊。

團隊審計

「團隊設置 → 審計日誌」記錄所有變更：

  • 誰 / 什麼時候 / 改了哪條工作流 / 哪個字段
  • 誰 / 什麼時候 / 創建 / 刪除 / 更新了哪條憑據
  • 誰 / 什麼時候 / 發起 / 批准了哪條審批
  • 成員加入 / 退出 / 角色變更

審計日誌保留 365 天（Team）/ 永久（Enterprise），支持 CSV 導出。

解散團隊

Owner 才能解散。解散前系統會讓你：

  1. 導出所有工作流（ZIP of YAML）
  2. 導出所有執行記錄（CSV 或 JSON）
  3. 通知所有成員（自動發郵件）
  4. 雙因子確認

解散後 30 天內可恢復；30 天后數據徹底清理，無法找回。

下一步