new file: main_dc/yalarba/README.md

new file: main_dc/yalarba/documentation/docs.md add documentation for all system yaltrip
2025-12-04 07:09:57 +05:00
parent a824a55319
commit 1776b8c410
2 changed files with 298 additions and 0 deletions
@@ -0,0 +1,112 @@
+# 🏔️ Туристический агрегатор EasySite & YalArba
+
+**Полноценная экосистема для туристического рынка:**  
+**B2B-платформа для владельцев + B2C-платформа для туристов**
+
+---
+
+## 🎯 Что это?
+
+### EasySite (easysite102.ru)
+**Платформа для владельцев туристических объектов:**  
+Отели, санатории, рестораны, достопримечательности создают и управляют своими сайтами в несколько кликов.
+
+### YalArba (yalarba.ru)  
+**Платформа для туристов:**  
+Поиск, отзывы, маршруты и бронирование мест отдыха по всей России.
+
+---
+
+## 🛠️ Технологии
+
+- **Frontend:** Nuxt.js 3 (EasySite), Vue 3 (YalArba)
+- **Backend:** Go (Golang) + PostgreSQL
+- **Инфраструктура:** Docker, Nginx, Let's Encrypt
+- **Безопасность:** JWT, HTTPS, ролевая модель
+
+---
+
+## 🚀 Быстрый старт
+
+```bash
+# Клонировать репозиторий
+git clone <репозиторий>
+
+# Запустить все сервисы
+docker-compose up -d
+
+# Доступны:
+# - EasySite: http://localhost (или через nginx)
+# - YalArba: http://localhost (SPA)
+# - API: порты 8088, 8888, 7777
+```
+
+---
+
+## 📁 Структура проекта
+
+```
+├── yalarba/           # Основной проект (EasySite + YalArba)
+├── BB/                # Проект "Бегущий Башкир"
+├── nginx/             # Веб-сервер с SSL
+├── certbot/           SSL-сертификаты
+└── docker-compose.yml # Контейнеры всех сервисов
+```
+
+---
+
+## 🔗 API Документация
+
+- **EasySite API:** `http://localhost:8088/docs` (Go, Chi)
+- **YalArba API:** `http://localhost:8888/docs` (Go, GORM)
+- **Базы данных:** PostgreSQL (порты 5432, 5433)
+
+---
+
+## 👥 Роли пользователей
+
+1. **Турист** – поиск, отзывы, избранное (YalArba)
+2. **Владелец** – управление объектами, статистика (EasySite)
+3. **Модератор** – проверка контента
+4. **Админ** – управление системой
+
+---
+
+## 📈 Что уже работает
+
+✅ Автоматическое создание сайтов для объектов  
+✅ Поиск мест отдыха с фильтрами  
+✅ Система отзывов и рейтингов  
+✅ JWT-аутентификация  
+✅ Docker-развертывание  
+✅ SSL (HTTPS)  
+✅ Аналитика посещений  
+
+---
+
+## 📅 Планы развития
+
+- [ ] Платежная система
+- [ ] Мобильное приложение (PWA)
+- [ ] Мультиязычность
+- [ ] Интеграция с картами
+- [ ] Система бронирования
+
+---
+
+## 📞 Контакты
+
+**Разработчик:** Валитов Газиз – https://valitovgaziz.ru  
+**Поддержка:** support@easysite102.ru  
+**Проект:** https://easysite102.ru / https://yalarba.ru  
+
+---
+
+## 📄 Лицензия
+
+Проект находится в стадии активной разработки.  
+© 2025 Туристический агрегатор EasySite & YalArba
+
+---
+
+**Статус:** 🟢 Активная разработка (04.12.2025)