跳轉到內容
supastack
瀏覽檔案

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh-tw/docs/mobile/workspaces.md (or send Accept: text/markdown).

工作區與成員

切換工作區、管理組織並處理邀請。

詢問本指南
開啟方式

解析當前工作區

GET /api/workspaces 返回成員的工作區成員資格與當前工作區 id;帶工作區 id 的 POST 即切換。伺服器按“選擇 Cookie → 已存偏好 → 個人工作區”的順序解析上下文,並核驗即時成員資格,因此偽造或過期的選擇無法讀到別的工作區。

管理組織

GET /api/mobile/organization 返回成員、待處理邀請、席位用量以及呼叫方能力 —— canManage 與 canLeave;個人工作區則返回 notOrganization。POST 建立組織,PATCH 重新命名(僅所有者),DELETE 刪除(僅所有者,需輸入名稱確認)。

組織介面位於“設定 → 成員”與“設定 → 通用”;成員自己的顯示名修改走 Better Auth 的 profile 路由,接受 1 到 100 個字元。

邀請與接受

POST /api/mobile/invitations 以郵件發出角色為 admin、member 或 guest 的邀請 —— 僅所有者與管理員可用。帶型別的失敗涵蓋 alreadyMember、alreadyInvited、seatLimitExceeded、dailySendLimit 與 invalidInput,介面可以據此解釋每種拒絕。重發與撤銷位於邀請 id 路由上,且重發有速率限制。

接受動作通過 <scheme>://invite/<token> 深連結到達:應用把 token 提交到邀請接受路由,後者返回工作區 id、啟用該工作區,並在服務端記錄此偏好。錯誤涵蓋 expired、emailMismatch、not-pending 與 seat-limit-exceeded。

變更角色與移除成員

PATCH /api/mobile/members/:userId 指派 owner、admin、member 或 guest 角色;DELETE 移除成員;POST /api/mobile/members/leave 主動退出。唯一所有者不能退出或被降級,成員不能通過管理路由移除自己,未產生任何變化的角色修改會被拒絕而非記錄。

驗證與排障

測試席位上限、已撤銷的邀請連結、guest 角色被削減的操作,以及切回個人工作區。被移除成員的快取選擇必須在下一次請求時失敗關閉,而不是繼續讀取舊工作區。

常見問題

14 個問題

supastack 是什麼?

supastack 是用於構建 AI 驅動 SaaS 產品的模組化基礎。它把通用基礎設施整合在一起,讓你專注於產品專屬的功能。

它支援 Web 和移動端嗎?

支援。supastack 包含 Next.js 與 Expo 應用,作為 Web 與移動端體驗的起點。

包含哪些認證方式?

Better Auth 覆蓋郵箱/密碼、OTP 與社交登入。個人工作區隨賬戶一起開通,產品記錄從第一天起就有邊界。

AI 是如何支援的?

supastack 包含可配置的多供應商 AI、用量追蹤、預算,以及加密的自帶金鑰(BYOK)支援。

訂閱如何處理?

對於基於該套件構建的產品,Stripe 計費、訂閱與許可權構成付費訪問的基礎。供應商金鑰僅存於服務端。

我的產品專屬程式碼放在哪裡?

產品專屬功能保留在獨立的程式碼庫中,產品通過配置接入 supastack 的基礎模組。

supastack 如何定價?

套件為一次性購買、終身更新:單棧 249 美元(Next.js(Web)、Expo(iOS 與 Android)、Tauri(macOS 與 Windows 桌面)倉庫任選其一),雙棧 398 美元(任選兩個倉庫),或完整套裝 399 美元(全部三個倉庫與完整 monorepo),每個額外開發者席位 75 美元。套件本身沒有訂閱。本站結賬後通過郵件傳送許可證金鑰,倉庫訪問通過 GitHub 邀請授予。

工作區如何界定我的資料?

使用者記錄按 workspaceId 劃定邊界。身份、許可權、AI 用量、計費事件與審計條目都留在個人工作區邊界內。

後臺任務如何工作?

Trigger.dev 是明確的任務執行時。JobRunner 契約只承諾 enqueue、status 與 cancel——工作流語義保持 Trigger.dev 專有且顯式。

郵件與營銷觸達有何不同?

事務性郵件覆蓋產品工作流,如任務完成通知。冷觸達與營銷活動屬於產品自身的範疇,不在本套件的郵件模組內。

移動端購買如何運作?

移動端已支援 RevenueCat 原生購買和恢復購買,訪問許可權由服務端驗證。釋出前需配置商店賬戶並完成裝置測試。Web 計費保持獨立。

AI 供應商金鑰存放在哪裡?

自帶金鑰憑證經過加密且僅存於服務端。金鑰在日誌中被脫敏;用量與預算在工作區級別保持可見。

結賬支援哪些付款方式?

Stripe 託管結賬接受銀行卡,在 Stripe 賬戶啟用後還可提供支付寶與微信支付——方便中國買家。錢包授權為非同步確認,付款完成後許可證頁面會立即更新。

我能申請退款嗎?

獲得程式碼倉庫訪問許可權後,supastack 將永久歸你所有,因此無法退款。但請放心,你將獲得包含終身更新的完整原始碼,可為你自己或客戶構建併發布無限數量的產品。你只需注意不能轉賣程式碼,也不能將倉庫作為啟動模板二次分發。唯一的例外是上線返現——上線一款用 supastack 打造的真實產品並公開分享,在購買後 60 天內達到 5,000 次自然瀏覽或 50 個自然按讚,即可退還已付款項的 50%;詳見條款。

TW
主題