> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

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

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

## Файлы и папки

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

- Репозиторий — папка проекта вместе со всей историей её изменений, размещённая на 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, затем отпустите — это останавливает выполняющуюся команду в терминале.

[Изучите команды, файлы и конфигурацию на практике](https://supastack.dev/ru/docs/web/terminal-basics.md)

[Как пользоваться этой документацией](https://supastack.dev/ru/docs/web/using-the-docs.md)

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


## Вперёд

[Обновляйте свою копию, когда комплект улучшается](https://supastack.dev/ru/docs/web/updating-the-kit.md)