Инструкции за Deployment на Landing Страницата

Преглед

Landing страницата е достъпна на главния URL (/) на приложението и не изисква автентикация. Тя показва информация за приложението, основните функционалности и скрийншоти от различните dashboards.

Стъпки за Deployment

1. Build на приложението

Преди да деплойнеш, трябва да build-неш приложението:

cd /home/pepinko/lager-guru
npm run build

Това ще създаде production-ready файлове в директорията dist/.

2. Проверка на build резултата

Провери дали всички файлове са създадени правилно:

ls -lh dist/
# Трябва да видиш:
# - index.html
# - assets/ (с JS и CSS файлове)
# - screenshots/ (с всички скрийншоти)
# - logo.svg, logo.png
# - manifest.webmanifest
# и други статични файлове

3. Копиране на файловете на сървъра

Ако вече имаш настроен Nginx сървър (според deploy/nginx-lager-guru.hashmatrix.de.conf):

# Копирай build-натите файлове в Nginx root директорията
sudo cp -r dist/* /var/www/lager-guru/dist/

# Или ако използваш друга директория, актуализирай пътя

4. Проверка на Nginx конфигурацията

Уверете се, че Nginx конфигурацията е правилна:

# Провери конфигурацията
sudo nginx -t

# Ако е валидна, рестартирай Nginx
sudo systemctl reload nginx

5. Проверка на правата за достъп

Уверете се, че Nginx може да чете файловете:

# Провери правата
ls -la /var/www/lager-guru/dist/

# Ако е необходимо, промени правата
sudo chown -R www-data:www-data /var/www/lager-guru/dist/
sudo chmod -R 755 /var/www/lager-guru/dist/

6. Тестване

Отвори браузър и провери:

1. Landing страница: https://lager-guru.hashmatrix.de/

   • Трябва да видиш hero секцията с логото и CTA бутоните
   • Скрийншотите трябва да се показват правилно
   • При hover върху скрийншотите, те трябва да се уголемяват

2. Public Dashboard: https://lager-guru.hashmatrix.de/dashboard

   • Трябва да работи без автентикация

3. Login страница: https://lager-guru.hashmatrix.de/login

   • Трябва да работи нормално

Важни бележки

Скрийншоти

Скрийншотите се намират в public/screenshots/ и трябва да бъдат копирани в dist/screenshots/ след build. Vite автоматично копира всичко от public/ в dist/ при build.

Лого

Новото лого (logo.svg и logo.png) трябва да бъде в dist/ директорията. Това също се случва автоматично при build.

Service Worker

Ако използваш PWA функционалност, Service Worker файловете също трябва да бъдат правилно конфигурирани. Провери vite.config.ts за PWA настройки.

Автоматичен Deployment (Опционално)

Можеш да създадеш скрипт за автоматичен deployment:

#!/bin/bash
# deploy.sh

cd /home/pepinko/lager-guru

# Pull latest changes
git pull origin main

# Install dependencies (ако е необходимо)
npm install

# Build приложението
npm run build

# Копирай файловете
sudo cp -r dist/* /var/www/lager-guru/dist/

# Рестартирай Nginx
sudo systemctl reload nginx

echo "Deployment completed!"

Направи скрипта изпълним:

chmod +x deploy.sh

Troubleshooting

Скрийншотите не се показват

1. Провери дали файловете съществуват:

   ls -lh /var/www/lager-guru/dist/screenshots/

2. Провери правата за достъп:

   sudo chmod -R 644 /var/www/lager-guru/dist/screenshots/*

3. Провери Nginx логове:

   sudo tail -f /var/log/nginx/lager-guru.hashmatrix.de-error.log

Логото не се показва

1. Провери дали logo.svg и logo.png са в dist/ директорията
2. Провери branding.json - трябва да сочи към /logo.svg

Hover zoom не работи

1. Провери дали JavaScript файловете са заредени правилно
2. Отвори Developer Console и провери за грешки
3. Уверете се, че Tailwind CSS класовете са правилно компилирани

Обновяване на Landing Страницата

Когато правиш промени в landing страницата:

1. Направи промените в src/pages/LandingPage.tsx
2. Build приложението: npm run build
3. Копирай новите файлове: sudo cp -r dist/* /var/www/lager-guru/dist/
4. Рестартирай Nginx: sudo systemctl reload nginx

Допълнителни ресурси

• Nginx конфигурация: deploy/nginx-lager-guru.hashmatrix.de.conf
• Installation guide: INSTALLATION.bg.md
• Vite build конфигурация: vite.config.ts