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/docs/web/onboarding.md (or send Accept: text/markdown).
入门引导流程
从注册到激活工作区与套餐的受门禁路径。
开始之前
使用“文件”→“打开文件夹”在 Visual Studio Code 中打开下载的 supastack 项目,然后选择“终端”→“新建终端”。存储库根目录是包含 package.json、apps 和 packages 的文件夹。运行下面的命令并保持终端打开。如果无法识别命令,请先完成工具安装指南,然后再继续。
首先阅读平台教程。服务器是响应浏览器或电话请求的应用程序进程。 Web 读取 apps/web/.env.local,Expo 读取 apps/mobile/.env.local,数据库迁移命令读取 root .env。无数据库/仪表板演示与真实/身份验证帐户分开,需要迁移Postgres。仅电话或桌面结帐需要单独运行的 Web 后端。
corepack pnpm --filter @supastack/web dev安装与配置
注册后,入门门禁会在进入产品功能前引导用户完成工作区设置:/onboarding、/new-organization、/select-organization 与 /choose-plan。organization-onboarding 模块根据成员当前状态决定该走哪一步。
流程可恢复 —— 每个门禁都在服务端重新推导正确的步骤,中途离开的用户回来时会落在正确的界面。
/onboarding entry gate
/new-organization create a team workspace
/select-organization pick an existing one
/choose-plan plan selection before billing
/invite/[token] invited members join here实现流程
把每一步当作门禁而非向导页 —— 服务端评估状态并重定向到下一个必需步骤。受邀成员跳过创建,落在 accept-invite。
新增产品门禁(必填资料字段、条款确认)时,扩展入门评估逻辑,而不是在各 layout 里散落重定向。
验证与排障
用一个全新账户走完每一步,再测中途返回的用户、受邀成员与多组织成员。验证任何步骤在门禁通过之前都不会渲染应用外壳。