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) — страницы, которые сервер собирает до отправки, поэтому первое представление приходит готовым.