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

Файлы и папки

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

• Репозиторий — папка проекта вместе со всей историей её изменений, размещённая на 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-tanstack/.env.local для веб-сервера.
• Секрет — значение, которое должно оставаться приватным, например пароль или ключ подписи; никогда не коммитьте его и не вставляйте в чаты.
• Ключ API — секретная строка, которую выдаёт внешний сервис, чтобы распознавать ваше приложение как разрешённого вызывающего.
• Провайдер — внешний сервис, который комплект может использовать для AI, почты, биллинга, хранилища и подобных задач.

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

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

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

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

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

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

• Изучите команды, файлы и конфигурацию на практике
• Как пользоваться этой документацией

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