# Запуск сайта LabNetHub на macOS

## 1. Проверьте, установлен ли Node.js

Откройте Terminal (⌘+Space → введите «Terminal» → Enter) и выполните:

```bash
node -v
npm -v
```

- Если видите номер версии Node **18.17 и выше** (например, `v20.x`) — переходите к шагу 3.
- Если команда не найдена или версия ниже — переходите к шагу 2.

## 2. Установите Node.js

**Вариант А — официальный установщик (самый простой):**

1. Откройте https://nodejs.org
2. Скачайте версию **LTS**
3. Запустите скачанный `.pkg`-файл и пройдите установку по шагам

**Вариант Б — через Homebrew** (если уже пользуетесь brew):

```bash
brew install node@20
brew link node@20
```

После установки закройте и снова откройте Terminal, затем проверьте:

```bash
node -v
npm -v
```

## 3. Распакуйте архив проекта

Дважды кликните `labnethub-website.zip` в Finder — рядом появится папка `labnethub`.

Либо через терминал:

```bash
cd ~/Downloads
unzip labnethub-website.zip
cd labnethub
```

## 4. Установите зависимости проекта

Находясь внутри папки `labnethub`, выполните:

```bash
npm install
```

Это скачает Next.js, React, Tailwind и остальные пакеты. При первом запуске занимает пару минут.

## 5. Настройте переменные окружения

```bash
cp .env.local.example .env.local
open -e .env.local
```

В открывшемся файле впишите свои значения:

```
TELEGRAM_BOT_TOKEN=токен_от_BotFather
TELEGRAM_CHAT_ID=ваш_chat_id
```

Сохраните (⌘+S) и закройте окно.

## 6. Запустите сайт локально

```bash
npm run dev
```

В терминале появится адрес — откройте в браузере:

```
http://localhost:3000
```

Чтобы остановить сервер — нажмите `Control + C` в терминале.

## 7. Проверка продакшен-сборки (по желанию)

```bash
npm run build
npm run start
```

Так сайт запустится в том же режиме, в котором будет работать на реальном сервере.

## Частые проблемы

| Проблема | Решение |
|---|---|
| `command not found: npm` | Node не установлен, либо терминал открыт до установки — закройте и откройте Terminal заново |
| Порт 3000 занят | Next.js сам предложит другой порт, либо укажите вручную: `npm run dev -- -p 3001` |
| Ошибки при `npm install` | Проверьте версию Node (`node -v`) — нужна 18.17 или выше |
| `EACCES` / ошибки прав доступа | Не используйте `sudo npm install` — переустановите Node через официальный установщик или Homebrew |

## Что дальше

Инструкции по заполнению реальных контактов, деплою на сервер и настройке безопасности — в `README.md` в корне проекта.