Поток онбординга

Прежде чем начать

Откройте загруженный проект supastack в Visual Studio Code, используя «Файл» → «Открыть папку», затем выберите «Терминал» → «Новый терминал». Корень репозитория — это папка, содержащая package.json, приложения и пакеты. Запустите команду ниже и оставьте терминал открытым. Если команда не распознается, завершите руководство по установке инструмента, прежде чем продолжить.

Сначала прочтите руководство по платформе. Сервер — это процесс приложения, который отвечает на запросы браузера или телефона. Веб читает apps/web-tanstack/.env.local, Expo читает apps/mobile/.env.local, а команды миграции базы данных читают корневой .env. Демонстрация без базы данных / панели мониторинга отделена от реальных учетных записей / аутентификации, для которых необходимо перенести Postgres. Для оформления заказа только на телефоне или компьютере требуется отдельно работающий веб-сервер.

• Установите инструменты и получите код
• Изучение команд, файлов и конфигурации
• Пройдите руководство по первому запуску в Интернете

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

Настройка и конфигурация

После регистрации гейты онбординга проводят пользователя через настройку workspace до продуктовой работы: /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.

Добавляя продуктовый гейт — обязательное поле профиля, подтверждение условий — расширяйте оценку онбординга, а не разбрасывайте редиректы по лейаутам.

Проверка и устранение неполадок

Протестируйте новый аккаунт на каждом шаге, вернувшегося на середине пользователя, приглашённого участника и участника нескольких организаций. Убедитесь, что ни один шаг не рендерит app shell до прохождения своего гейта.