first commit

MACOS-SETUP.md

@@ -0,0 +1,109 @@
+# Запуск сайта 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` в корне проекта.