Merge dev: Add Windows/PowerShell and Ubuntu server environment info

This commit is contained in:
DosAi 2025-11-02 16:31:42 +03:00
commit fafe671578
3 changed files with 89 additions and 7 deletions

View File

@ -96,3 +96,16 @@ export const myCalculatorConfig: CalculatorConfig = {
Подробнее: `docs/PROJECT_RULES.md` Подробнее: `docs/PROJECT_RULES.md`
### Окружение разработки
**Платформы:**
- Разработка: Windows + PowerShell
- Хостинг: Ubuntu Linux
**Важно для разработки:**
- В PowerShell используй `;` вместо `&&` для цепочки команд
- Пути в Git всегда с `/`, даже на Windows
- При работе через SSH используй Linux команды
Подробнее: `docs/PROJECT_RULES.md` и `docs/KNOWLEDGE_BASE.md`

View File

@ -194,20 +194,55 @@ import { myCalcConfig } from '@/calculators/my-calc/config';
registerCalculator(myCalcConfig); registerCalculator(myCalcConfig);
``` ```
## Окружение разработки
### Платформы
- **Разработка**: Windows с PowerShell
- **Хостинг**: Ubuntu Linux
### Особенности разработки на Windows
- PowerShell не поддерживает оператор `&&` для цепочки команд
- Используйте `;` или выполняйте команды отдельно
- Пути в Git и конфигах всегда используют `/`, даже на Windows
- При работе через SSH используйте Linux команды
### Локальная разработка (Windows + PowerShell)
```powershell
# Frontend - один терминал
cd frontend
npm install
npm run dev
# Backend - отдельный терминал
cd backend
node bot.js
```
## Деплой ## Деплой
### Сервер ### Сервер
- IP: 192.168.0.19 - **ОС**: Ubuntu Linux
- Пользователь: dosai - **IP**: 192.168.0.19
- Путь: ~/projects/DoSoapCalc - **Пользователь**: dosai
- **Путь**: ~/projects/DoSoapCalc
- **Управление процессами**: PM2
### Процессы PM2 ### Процессы PM2
- `dosoap-frontend` - Next.js приложение - `dosoap-frontend` - Next.js приложение
- `dosoap-backend` - Express сервер - `dosoap-backend` - Express сервер
### Команды деплоя ### Команды деплоя
**С локального Windows (PowerShell):**
```powershell
# Отправить изменения
git push origin dev
# Подключиться и обновить сервер (Ubuntu команды через SSH)
ssh dosai@192.168.0.19 "cd ~/projects/DoSoapCalc && git pull origin dev && cd frontend && npm run build && pm2 restart dosoap-frontend dosoap-backend"
```
**Или на сервере напрямую (Ubuntu):**
```bash ```bash
# На сервере
cd ~/projects/DoSoapCalc cd ~/projects/DoSoapCalc
git pull origin dev git pull origin dev
cd frontend && npm run build cd frontend && npm run build

View File

@ -132,14 +132,48 @@ git push origin dev
4. ✅ Функционал работает корректно 4. ✅ Функционал работает корректно
5. ✅ Нет критических ошибок в консоли браузера 5. ✅ Нет критических ошибок в консоли браузера
## Окружение разработки
### Платформы
- **Разработка**: Windows с PowerShell
- **Хостинг**: Ubuntu Linux сервер
**Важно учитывать:**
- В PowerShell команды с `&&` не работают, используйте `;` или отдельные команды
- Пути к файлам на Windows используют обратные слеши `\`, но в Git и конфигах используйте `/`
- При работе через SSH с Ubuntu используйте стандартные Linux команды
### Локальная разработка (Windows)
```powershell
# Frontend
cd frontend
npm install
npm run dev
# Backend (в отдельном терминале)
cd backend
node bot.js
```
## Деплой на сервер ## Деплой на сервер
### Сервер информация:
- **ОС**: Ubuntu Linux
- **Пользователь**: dosai
- **Путь проекта**: `~/projects/DoSoapCalc`
- **Управление процессами**: PM2
### Порядок действий: ### Порядок действий:
1. Закоммитить изменения в ветку `dev` 1. Закоммитить изменения в ветку `dev`
2. Отправить на сервер: `git push origin dev` 2. Отправить на сервер: `git push origin dev`
3. На сервере: `git pull origin dev` 3. Подключиться к серверу: `ssh dosai@192.168.0.19`
4. Пересобрать фронтенд: `cd frontend && npm run build` 4. На сервере (Ubuntu):
5. Перезапустить процессы: `pm2 restart dosoap-frontend dosoap-backend` ```bash
cd ~/projects/DoSoapCalc
git pull origin dev
cd frontend && npm run build
pm2 restart dosoap-frontend dosoap-backend
```
## Тестирование ## Тестирование