跳轉到內容
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/web/deployment.md (or send Accept: text/markdown).

部署清單

準備生產依賴,並驗證你打算交付的流程。

詢問本指南
開啟方式

按此順序準備公共應用程式

部署意味著在託管服務上執行您的應用程式,以便其他人可以訪問它。 localhost 只能在您的開發環境中訪問。首先在本地完成真正的資料庫支援的登入,選擇下面的託管指南,建立單獨的測試資料庫,並使用實際的公共 HTTPS 應用程式 URL 配置主機的環境設定。將本地演示設定與公共應用程式分開。

在儲存庫根目錄的第二個終端中,執行下面的 Web 檢查。成功的構建會在您的計算機上建立一個生產版本;它不會上傳或釋出它。不要將 corepack pnpm --filter @supastack/web start 與部署混淆:start 在本地執行之前構建的版本。僅在埠 3000 上停止開發伺服器後執行它。

請遵循所選主機的遷移、環境和啟動步驟指南。測試註冊、電子郵件程式碼、重啟後儲存的帳戶資料以及開始銷售前提供商沙箱中的付費功能。移動或桌面客戶端必須指向此正在執行的 HTTPS 後端。釋出本機應用程式是一個單獨的步驟,記錄在其平臺的分發指南中。

corepack pnpm --filter @supastack/web typecheck
corepack pnpm --filter @supastack/web build

準備服務

建立 Postgres 資料庫,應用儲存庫的遷移,並在託管儀錶板中輸入公共應用程式 URL 和身份驗證設定。為您啟用的功能選擇一個受支援的網路計費提供商和一個交易電子郵件提供商。當您的產品使用其後臺工作流程時配置 Trigger.dev;您不需要每次整合來發布基本應用程式。

在接受生產 AI 任務之前,配置好不可變的模型/價格目錄與工作區 AI 策略。空的別名策略應讓這些選項不可用。

構建並部署 Web 應用

從儲存庫根目錄執行以下 Web 命令並解決所有錯誤,然後再繼續。 typecheck 檢查型別,test 執行 Web 測試,build 在本地建立生產檔案。按照您選擇的託管指南上傳並使用其伺服器端環境設定執行它們。這些命令不會部署應用程式。

corepack pnpm --filter @supastack/web typecheck
corepack pnpm --filter @supastack/web test
corepack pnpm --filter @supastack/web build

驗證已部署的邊界

在已部署資料庫上驗證登入與持久化;測試工作區隔離;確認 Stripe 沙箱 webhook 處理與許可權變更;跑一個後臺任務直到結果持久化與事務性投遞。

閱讀倉庫中的 docs/real-provider-smoke.md 與 docs/production-ai-runtime.md 瞭解顯式的供應商驗收流程。構建成功或被攔截的瀏覽器測試並不能證明這些外部結果。

常見問題

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
主題