🇰🇷 Korea Tourism Agency

Modern tourism website for domestic travel in Korea with comprehensive admin panel.

🌟 Features

🏛️ Website Features

• Tour Packages: City tours, mountain hiking, fishing expeditions
• Guide Profiles: Experienced local guides with specializations
• Travel Blog: Articles about Korean culture, food, and destinations
• Responsive Design: Mobile-first approach with modern UI
• SEO Optimized: Clean URLs and meta tags

🛠️ Admin Panel Features

• Route Management: Create and manage tour packages
• Guide Management: Profile management with photos and schedules
• Article System: Blog management with categories
• Image Editor: Integrated upload, gallery, and URL options
• User Management: Admin authentication and roles
• Dashboard: Analytics and quick access to all features

🚀 Быстрый старт

Автоматический деплой

./deploy.sh

Ручной запуск

# Клонирование репозитория
git clone <repository-url>
cd tourism_site

# Запуск с Docker
docker-compose up --build -d

# Или локальная разработка
npm install
npm run dev

📱 Доступ к приложению

• Основной сайт: http://localhost:3000
• Админ панель: http://localhost:3000/admin
• База данных: http://localhost:8080 (Adminer)

🔑 Учётные данные по умолчанию

• Админ: admin / admin123
• База данных: postgres / postgres

🌟 Особенности

🎯 Основные функции

• Каталог туров: Городские экскурсии, горные походы, морская рыбалка
• Система гидов: Профессиональные гиды с рейтингами и специализациями
• Блог и статьи: Полезная информация о путешествиях по Корее
• Система бронирования: Онлайн заявки с управлением статусами
• Многоязычность: Поддержка корейского и английского языков

🎨 AdminLTE панель управления

• Современный дизайн: Профессиональная админ-панель на основе AdminLTE 3.2
• Управление контентом: Маршруты, гиды, статьи, бронирования
• Dashboard с аналитикой: Статистика посещений и бронирований
• Безопасность: Аутентификация с хешированием паролей
• Загрузка файлов: Система загрузки изображений с превью

🚀 Технологии

• Backend: Node.js + Express.js
• Database: PostgreSQL с миграциями
• Frontend: Bootstrap 5 + EJS шаблоны
• Admin: AdminLTE 3.2 + DataTables + Chart.js
• Deployment: Docker + Docker Compose
• Styles: Responsive дизайн с корейскими элементами

🚀 Быстрый старт

Предварительные требования

• Docker и Docker Compose
• Git

Установка и запуск

1. Клонировать репозиторий bash\ngit clone <repository-url>\ncd korea-tourism-agency\n\n\n2. Запустить среду разработки\nbash\n# Дать права на выполнение скрипту\nchmod +x start-dev.sh\n\n# Запустить полное окружение\n./start-dev.sh\n\n\n3. Ручной запуск (альтернатива)\nbash\n# Создать .env файл из примера\ncp .env.example .env\n\n# Запустить контейнеры\ndocker-compose up -d\n\n# Выполнить миграции\ndocker-compose exec app npm run db:migrate\n\n# Заполнить тестовыми данными\ndocker-compose exec app npm run db:seed\n\n\n### 🌐 Доступ к сайту\n\nПосле успешного запуска:\n\n- 🏠 Основной сайт: http://localhost:3000\n- ⚙️ Админ панель: http://localhost:3000/admin\n- 🗄️ Adminer (БД): http://localhost:8080\n\n### 🔐 Данные для входа\n\nАдмин-панель:\n- Username: admin\n- Password: admin123\n\nБаза данных (Adminer):\n- System: PostgreSQL\n- Server: postgres\n- Username: tourism_user\n- Password: tourism_password\n- Database: korea_tourism\n\n## 📁 Структура проекта\n\n\nkorea-tourism-agency/\n├── 📂 src/ # Исходный код приложения\n│ ├── 📂 config/ # Конфигурация БД\n│ └── 📂 routes/ # Express маршруты\n├── 📂 views/ # EJS шаблоны\n│ ├── 📂 admin/ # Шаблоны админки\n│ ├── 📂 routes/ # Страницы туров\n│ ├── 📂 guides/ # Страницы гидов\n│ └── 📂 articles/ # Страницы статей\n├── 📂 public/ # Статические файлы\n│ ├── 📂 css/ # Стили\n│ ├── 📂 js/ # JavaScript\n│ ├── 📂 images/ # Изображения\n│ └── 📂 uploads/ # Загруженные файлы\n├── 📂 database/ # Миграции и схемы БД\n│ ├── schema.sql # Схема БД\n│ ├── migrate.js # Скрипт миграций\n│ └── seed.js # Тестовые данные\n├── 📂 docker/ # Docker конфигурации\n└── 📂 docs/ # Документация\n\n\n## 🗄️ База данных\n\n### Основные таблицы\n\n- routes - Туристические маршруты\n- guides - Профили гидов\n- articles - Статьи блога\n- bookings - Бронирования\n- admins - Администраторы\n- contact_messages - Сообщения с формы контактов\n- site_settings - Настройки сайта\n\n### Типы туров\n\n- city - Городские экскурсии (서울, 부산)\n- mountain - Горные походы (설악산, 지리산)\n- fishing - Морская рыбалка (동해, 제주도)\n\n## 🛠️ Разработка\n\n### Полезные команды\n\nbash\n# Просмотр логов\ndocker-compose logs -f app\n\n# Перезапуск приложения\ndocker-compose restart app\n\n# Выполнение команд в контейнере\ndocker-compose exec app npm run db:migrate\ndocker-compose exec app npm run db:seed\n\n# Остановка всех контейнеров\ndocker-compose down\n\n# Полная очистка (внимание: удалит данные БД)\ndocker-compose down -v\ndocker system prune -f\n\n\n### Структура маршрутов\n\n- / - Главная страница\n- /routes - Каталог туров\n- /routes/:id - Детали тура\n- /guides - Список гидов\n- /guides/:id - Профиль гида\n- /articles - Блог статьи\n- /admin - Админ панель\n- /api - REST API\n\n### API эндпоинты\n\n- GET /api/routes - Получить туры с фильтрацией\n- GET /api/guides - Получить гидов\n- POST /api/booking - Создать бронирование\n- GET /api/search - Поиск по сайту\n\n## 🎨 Дизайн\n\n### Цветовая схема\n- Основной цвет: #2563eb (Blue)\n- Корейский красный: #c41e3a\n- Корейский синий: #003478\n- Градиенты: Современные переходы цветов\n\n### Компоненты UI\n- AdminLTE 3.2 - Админ панель\n- Bootstrap 5 - Фронтенд фреймворк\n- Font Awesome - Иконки\n- AOS - Анимации при скролле\n- DataTables - Таблицы в админке\n- Chart.js - Графики и диаграммы\n\n## 🌍 Локализация\n\nСайт поддерживает:\n- Корейский язык (основной)\n- Английский язык (для туристов)\n- Правильные шрифты: Noto Sans KR для корейского текста\n\n## 📱 Адаптивность\n\n- ✅ Desktop (1200px+)\n- ✅ Tablet (768px-1199px)\n- ✅ Mobile (до 767px)\n- ✅ Поддержка touch устройств\n\n## 🔧 Настройки\n\n### Переменные окружения (.env)\n\nenv\n# База данных\nDB_HOST=postgres\nDB_PORT=5432\nDB_NAME=korea_tourism\nDB_USER=tourism_user\nDB_PASSWORD=tourism_password\n\n# Приложение\nPORT=3000\nNODE_ENV=development\nSESSION_SECRET=your-secret-key\n\n# Загрузка файлов\nUPLOAD_PATH=/app/public/uploads\nMAX_FILE_SIZE=5242880\n\n# Контакты\nSITE_NAME=Korea Tourism Agency\nCONTACT_EMAIL=info@koreatourism.com\nCONTACT_PHONE=+82-2-1234-5678\n\n\n## 🚀 Production развертывание\n\nbash\n# Использовать production compose файл\ndocker-compose -f docker-compose.prod.yml up -d\n\n# Или создать .env.production\ncp .env.example .env.production\n# Отредактировать настройки для production\n\n# Запустить с production настройками\nNODE_ENV=production docker-compose up -d\n\n\n## 📸 Скриншоты\n\n### 🏠 Главная страница\n- Hero секция с призывом к действию\n- Карточки популярных туров\n- Статистика и отзывы\n- Современный адаптивный дизайн\n\n### ⚙️ Админ панель\n- Dashboard с аналитикой\n- Управление турами и гидами\n- Система загрузки изображений\n- Таблицы с поиском и фильтрацией\n\n## 🤝 Участие в разработке\n\n1. Fork проекта\n2. Создайте feature branch (git checkout -b feature/amazing-feature)\n3. Commit изменения (git commit -m 'Add amazing feature')\n4. Push в branch (git push origin feature/amazing-feature)\n5. Создайте Pull Request\n\n## 📄 Лицензия\n\nЭтот проект использует MIT лицензию. Подробности в файле LICENSE.\n\n## 🆘 Поддержка\n\nЕсли у вас есть вопросы:\n\n- 📧 Email: info@koreatourism.com\n- 🐛 Issues: Создайте issue в репозитории\n- 📖 Docs: Смотрите папку /docs\n\n---\n\nKorea Tourism Agency - Откройте для себя красоту Кореи! 🇰🇷✨