Перейти к содержимому
supastack
Обзор документации
WebNext.js

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 /ru/docs/web/glossary.md (or send Accept: text/markdown).

Слова, которые вы встретите

Определения простым языком для терминов, которые используют руководства по настройке, сообщения об ошибках и сам продукт.

Задать вопрос об этом руководстве
Открыть в

Файлы и папки

Эти слова описывают загруженный вами код. Руководства по настройке называют их всякий раз, когда просят открыть или отредактировать файл.

  • Репозиторий — папка проекта вместе со всей историей её изменений, размещённая на GitHub и скопированная на ваш компьютер.
  • Клон — ваша собственная копия репозитория на компьютере; её создаёт команда git clone.
  • Монорепозиторий — один репозиторий, содержащий несколько приложений и общих пакетов; пакет All Platforms — именно такой.
  • package.json — файл в каждом приложении или пакете, который перечисляет его имя, команды и необходимые библиотеки.
  • pnpm-workspace.yaml — файл в корне монорепозитория, перечисляющий, какие папки принадлежат рабочему пространству.
  • Lockfile — файл, записывающий точную версию каждой установленной библиотеки, чтобы каждая установка совпадала.

Инструменты на вашем компьютере

Программы, которые вы устанавливаете один раз перед первым запуском. Руководства называют их в командах вроде node --version.

  • Терминал — окно, в котором вы вводите команды, например PowerShell в Windows или Terminal в macOS.
  • Node.js — программа, запускающая JavaScript вне браузера; на ней работают сервер и скрипты комплекта.
  • npm — установщик библиотек, идущий в комплекте с Node.js; в этом комплекте вы в основном используете его, чтобы добраться до Corepack.
  • Corepack — инструмент, включающий именно ту версию менеджера пакетов, которую фиксирует проект.
  • pnpm — менеджер пакетов, который загружает библиотеки и запускает скрипты проекта; обращайтесь к нему как corepack pnpm.
  • Git — инструмент, который загружает ваш репозиторий и записывает каждое вносимое вами изменение.
  • Редактор или IDE — приложение, где вы открываете папки и редактируете файлы; руководства используют Visual Studio Code.

Слова конфигурации

Настройки живут в файлах, а не в терминале. Эти слова описывают, где они находятся и как называются.

  • Переменная окружения — именованная настройка, такая как EMAIL_PROVIDER=local, изменяющая поведение приложения.
  • .env — файл в корне репозитория, хранящий настройки для команд вроде миграций базы данных.
  • .env.local — файл настроек одного приложения, например apps/web/.env.local для веб-сервера.
  • Секрет — значение, которое должно оставаться приватным, например пароль или ключ подписи; никогда не коммитьте его и не вставляйте в чаты.
  • Ключ API — секретная строка, которую выдаёт внешний сервис, чтобы распознавать ваше приложение как разрешённого вызывающего.
  • Провайдер — внешний сервис, который комплект может использовать для AI, почты, биллинга, хранилища и подобных задач.

Слова, которые использует продукт

Запущенное приложение и его экраны настроек используют эти термины. «Рабочее пространство» встречается с двумя разными значениями — смотрите контекст.

  • Рабочее пространство — в продукте: отдельные пользователи, данные и настройки одной команды; в командах pnpm — одна папка пакета внутри монорепозитория, выбираемая с --filter.
  • Право доступа — запись сервера о том, что рабочему пространству разрешено использовать платную функцию.
  • Миграция — версионированное изменение базы данных, создающее или обновляющее таблицы; миграции применяются командой.
  • Сессия — состояние входа, сообщающее серверу, кто обращается, пока она не истечёт или вы не выйдете.
  • Вебхук — сообщение, которое внешний сервис отправляет на URL вашего приложения, когда что-то происходит, например оплата счёта.
  • Аккаунт и организация — аккаунт это вход одного человека; организация — общее командное пространство, к которому присоединяются участники, также называемое рабочим пространством.

Слова веб-разработки

Термины, которые используют руководства по запуску, сборке и развёртыванию, когда вы открываете приложение в браузере.

Ctrl + C означает: нажмите и удерживайте Ctrl, кратко нажмите C, затем отпустите — это останавливает выполняющуюся команду в терминале.

  • localhost — имя этого компьютера в адресе браузера; во время разработки ваше приложение работает там.
  • Порт — пронумерованная дверь после localhost, например :3000; каждое запущенное приложение использует свою.
  • Dev-сервер — команда, которая продолжает пересобирать и обслуживать приложение, пока вы работаете; остановите её с помощью Ctrl + C.
  • Сборка — шаг, превращающий исходный код в оптимизированные файлы, которые развёртывает сервер.
  • Серверный рендеринг (SSR) — страницы, которые сервер собирает до отправки, поэтому первое представление приходит готовым.

Часто задаваемые вопросы

14 вопросов

Что такое supastack?

supastack — модульная основа для создания SaaS-продуктов с AI. Она объединяет общую инфраструктуру, чтобы вы могли сосредоточиться на продуктовых функциях.

Поддерживает ли он web и mobile?

Да. supastack включает приложения Next.js и Expo как отправные точки для web- и мобильных интерфейсов.

Какая аутентификация включена?

Better Auth покрывает e-mail/пароль, OTP и социальный вход. Личные воркспейсы провижинируются вместе с аккаунтом, чтобы продуктовые записи были ограничены с первого дня.

Как он поддерживает AI?

supastack включает настраиваемый мультипровайдерный AI, учёт использования, бюджеты и зашифрованную поддержку bring-your-own-key.

Как обрабатываются подписки?

Для продуктов на ките Stripe-биллинг, подписки и права доступа образуют основу платного доступа. Секреты провайдеров остаются только на сервере.

Где живёт мой продуктовый код?

Продуктовые функции остаются в отдельном коде, а продукт настраивает и интегрирует модули основы supastack.

Как устроены цены supastack?

Кит — разовая покупка с пожизненными обновлениями: один фреймворк за $249 (временная стартовая цена — скидка $100 от стандартной цены $349) или все фреймворки (Next.js, iOS, Android) за $499 (временная стартовая цена — скидка $100 от стандартной цены $599), плюс $75 за каждое дополнительное место разработчика. Без подписки на кит. Оплата на этом сайте доставляет лицензионный ключ по e-mail, доступ к репозиторию — через приглашение GitHub.

Как воркспейсы ограничивают мои данные?

Записи пользователей ограничены по workspaceId. Идентичность, права доступа, AI-использование, события биллинга и записи аудита остаются внутри границы личного воркспейса.

Как работают фоновые задачи?

Trigger.dev — явный рантайм задач. Контракт JobRunner обещает только enqueue, status и cancel — семантика workflow остаётся специфичной для Trigger.dev и явной.

Чем почта отличается от рассылок?

Транзакционная почта покрывает продуктовые сценарии вроде уведомлений о завершении. Холодные рассылки и кампании — забота продукта, вне почтового модуля этого кита.

Как работают покупки в мобильном приложении?

Мобильное приложение поддерживает нативные покупки и восстановление через RevenueCat, а сервер проверяет доступ. Настройте аккаунты магазинов и завершите тестирование на устройствах перед публикацией. Веб-оплата остается отдельной.

Где хранятся ключи AI-провайдеров?

Bring-your-own-key креденшелы зашифрованы и остаются только на сервере. Ключи удаляются из логов; использование и бюджеты видны на уровне воркспейса.

Какие способы оплаты принимает оформление заказа?

Оформление заказа на Stripe принимает карты, а после включения кошельков в аккаунте Stripe может также предлагать Alipay и WeChat Pay — удобно для покупателей из Китая. Авторизации кошельков подтверждаются асинхронно, поэтому страница лицензии обновляется, как только платёж завершается.

Могу ли я получить возврат средств?

После получения доступа к репозиторию supastack остается вашим навсегда, поэтому возврат средств невозможен. Но будьте уверены: вы получаете полный исходный код с пожизненными обновлениями для создания и запуска неограниченного числа продуктов для себя или клиентов. Вы лишь не можете перепродавать код или распространять репозиторий как стартовый набор или шаблон.

RU
Тема