> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 組織與邀請

交付演示級組織閉環：建立、切換、邀請、角色、退出與危險區刪除。

## 安裝與配置

在執行任何步驟之前，請閱讀[開始之前](https://supastack.dev/zh-tw/docs/web/before-you-start.md) 和[終端基礎知識](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)。這些說明假設您在 VS Code 中開啟了完整的 supastack monorepo；它的根 package.json 標記儲存庫根。在 pnpm 命令中，工作區包是應用程式或共享程式碼資料夾；在產品中，工作空間是團隊的資料容器和安全邊界。 corepack pnpm --filter ... 從 monorepo 選擇一個包，同時從其根執行命令。如果您僅開啟同步的移動或桌面資料夾，則它不包含 Web 後端、Docker 設定或根指令碼：從此 monorepo 或可訪問的託管伺服器執行後端，並使用平臺資料夾自己的指令碼。環境變數是儲存在本地 .env 檔案或託管儀錶板中的命名設定；更改後重新啟動相關應用程式，並將伺服器機密保留在 NEXT_PUBLIC_ 和 EXPO_PUBLIC_ 值之外。

1. 使用 corepack pnpm --filter @supastack/web dev 從儲存庫根啟動 Web 應用程式並建立一個測試帳戶。

2. 開啟組織設定螢幕，建立一個測試工作區，然後從“設定”→“成員”邀請第二封測試電子郵件。工作區是擁有成員和記錄的團隊邊界。

3. 使用同一電子郵件登入時接受邀請。預期：第二個帳戶可以以其分配的角色進入受邀工作區，但無法管理僅限所有者的操作。

packages/db 中，組織工作區與個人工作區是區分開的。註冊後，入門門檻（/onboarding、/new-organization、/select-organization、/choose-plan）會先把使用者帶入一個啟用的組織，再進入產品計費與設定。

邀請會建立一條待處理的 workspace_invitation 記錄，併傳送帶 /invite/[token] 接受連結的事務性郵件。接受要求登入郵箱匹配。成員列表、角色變更與退出在 /settings/members；重新命名/刪除與退出也出現在 /organization/settings。

```
Routes
  /new-organization
  /select-organization
  /invite/[token]
  /settings/members
  /organization/settings

Server actions
  createOrganizationAction
  createWorkspaceInviteAction
  acceptWorkspaceInviteAction
  updateMemberRoleAction
  leaveOrganizationAction
  renameOrganizationAction
  deleteOrganizationAction
```


## 要複製的命令

按照註釋檢視命令在哪個資料夾中執行。如果標記了兩個終端，請開啟兩個終端視窗，並在使用第二個命令時保持第一個命令執行。

```
corepack pnpm --filter @supastack/web dev
```


## 實現流程

按 cookie → 使用者偏好 → 成員關係解析當前工作區，然後每次寫入都校驗成員資格。所有者與管理員管理邀請/角色；唯一所有者不能退出或降級自己。

變更成員關係前，優先使用 @supastack/db 的 evaluateLeaveOrganization 與 evaluateMemberRoleUpdate。inAppProduct 開啟時，成功變更後發出 member.left / member.role_changed 應用內通知。

平臺管理是一個單獨的邊界：只有平臺管理員可以管理使用者、禁令和模擬。工作區所有者/管理員角色不授予平臺訪問許可權。記錄的組織角色是所有者、管理員和成員。


## 驗證與排障

如果邀請連結顯示電子郵件不匹配，請使用收到電子郵件的確切地址登入。如果邀請郵件丟失，請檢查本地郵件結果後再重新傳送。如果成員看不到組織，請切換到正確的工作區並驗證成員身份；切勿通過從瀏覽器傳遞另一個 workspaceId 來解決此問題。

聚焦 Vitest：工作區退出/角色助手、邀請接受、組織入門門檻。手動：建立組織 → 邀請 → 第二賬戶接受 → 改角色 → 非所有者退出 → 所有者帶輸入確認刪除。


## 下一篇

[入門引導流程](https://supastack.dev/zh-tw/docs/web/onboarding.md)