From b883ab46d8370e2a4aba908cc394df951a4ca897 Mon Sep 17 00:00:00 2001
From: konard <drakonard@gmail.com>
Date: Wed, 10 Sep 2025 22:06:43 +0300
Subject: [PATCH 1/3] Initial commit with task details for issue #12

Adding CLAUDE.md with task information for AI processing.
This file will be removed when the task is complete.

Issue: https://github.com/deep-assistant/GPTutor/issues/12
---
 CLAUDE.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..84aec7a4
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,5 @@
+Issue to solve: https://github.com/deep-assistant/GPTutor/issues/12
+Your prepared branch: issue-12-b27d1cc7
+Your prepared working directory: /tmp/gh-issue-solver-1757531186412
+
+Proceed.
\ No newline at end of file

From 774fb9b92da811395b0032ba3f8d9ae654c6ba09 Mon Sep 17 00:00:00 2001
From: konard <drakonard@gmail.com>
Date: Wed, 10 Sep 2025 22:06:59 +0300
Subject: [PATCH 2/3] Remove CLAUDE.md - PR created successfully

---
 CLAUDE.md | 5 -----
 1 file changed, 5 deletions(-)
 delete mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
deleted file mode 100644
index 84aec7a4..00000000
--- a/CLAUDE.md
+++ /dev/null
@@ -1,5 +0,0 @@
-Issue to solve: https://github.com/deep-assistant/GPTutor/issues/12
-Your prepared branch: issue-12-b27d1cc7
-Your prepared working directory: /tmp/gh-issue-solver-1757531186412
-
-Proceed.
\ No newline at end of file

From 6f1bd85e57fd4304b9067e3e51c7e631c0d741a9 Mon Sep 17 00:00:00 2001
From: konard <drakonard@gmail.com>
Date: Wed, 10 Sep 2025 22:08:55 +0300
Subject: [PATCH 3/3] Add comprehensive README.md with full process
 descriptions
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Document project architecture and technology stack
- Add detailed deployment processes for local, staging, and production
- Include configuration examples and environment setup
- Document supported platforms (VK, Telegram) and applications
- Add security, monitoring, and database information
- Provide quick start guide and system requirements

Resolves #12

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 README.md | 191 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 191 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 00000000..89e4cdcd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,191 @@
+# GPTutor
+
+GPTutor — это платформа для создания AI-ассистентов и чат-ботов с поддержкой различных интеграций (VK, Telegram) и приложений (GPTutor, Stable Art, AiHumor).
+
+## Архитектура проекта
+
+Проект состоит из четырех основных компонентов:
+
+- **GPTutor-Frontend** — React-приложение для веб-интерфейса
+- **GPTutor-Backend** — Spring Boot бэкенд с REST API и WebSocket поддержкой  
+- **GPTutor-Models** — сервис машинного обучения для обработки запросов
+- **GPTutor-Rag** — система поиска и обработки документов
+
+## Технологический стек
+
+### Frontend
+- React 18.2.0 с TypeScript
+- VK UI Kit для интерфейса VK Mini Apps
+- Telegram SDK для Telegram Bot Platform
+- Monaco Editor для редактирования кода
+- Markdown-it для рендеринга разметки
+
+### Backend  
+- Spring Boot 3.0.5 (Java 17)
+- Spring WebSocket для real-time коммуникации
+- PostgreSQL для хранения данных
+- AWS S3 для файлового хранилища
+
+### Инфраструктура
+- Docker и Docker Compose для контейнеризации
+- Nginx для проксирования запросов
+- Traefik для автоматического SSL
+- Let's Encrypt (certbot) для SSL сертификатов
+
+## Процессы разработки и развертывания
+
+### Локальная разработка
+
+#### Запуск для разработки
+```bash
+./local-run.sh
+```
+
+Этот скрипт:
+1. Запускает PostgreSQL и backend в Docker
+2. Запускает models сервис
+3. Устанавливает зависимости frontend через npm
+4. Запускает frontend в режиме разработки на порту 10888
+
+#### Локальная сборка с Nginx
+```bash
+./build-local-frontend-nginx.sh
+```
+
+Этот процесс:
+1. Загружает переменные окружения
+2. Удаляет старые volumes
+3. Пересобирает и запускает frontend контейнер
+4. Перезапускает Nginx для обновления конфигурации
+
+#### Полная локальная сборка
+```bash
+./deploy-local-all.sh
+```
+
+Выполняет:
+1. Установку frontend зависимостей и запуск в dev режиме
+2. Перезапуск PostgreSQL с новой сборкой
+3. Перезапуск backend с новой сборкой
+
+### Производственное развертывание
+
+#### Полное развертывание
+```bash
+./deploy-all.sh
+```
+
+Процесс включает:
+
+**Production окружение:**
+1. Загрузка переменных из `.env.sh`
+2. Checkout и pull основной ветки
+3. Остановка и пересборка frontend
+4. Очистка Docker volumes
+5. Последовательный запуск всех сервисов:
+   - frontend (основное приложение)
+   - nginx (прокси-сервер)
+   - postgresql (база данных)
+   - backend (API сервер)
+   - certbot (SSL сертификаты)
+
+**Stage окружение:**
+1. Загрузка переменных из `.env-stage.sh`
+2. Checkout ветки develop
+3. Аналогичный процесс для stage версий сервисов
+
+#### Отдельные процессы развертывания
+
+**Frontend:**
+```bash
+./deploy-frontend.sh        # Production
+./deploy-frontend-stage.sh  # Staging
+```
+
+**Backend:**
+```bash
+./deploy-backend.sh
+```
+
+**Stage окружение:**
+```bash
+./deploy-stage.sh
+```
+
+### Конфигурация окружений
+
+#### Переменные окружения
+
+- `.env.example` — пример базовой конфигурации
+- `.env-prod.example` — пример production конфигурации  
+- `.env-stage.example` — пример staging конфигурации
+- `.env-frontend.example` — пример frontend конфигурации
+
+Базовые переменные:
+```bash
+EMAIL=your-email@domain.com  # Для SSL сертификатов
+HOST=your-domain.com         # Основной домен
+```
+
+#### Docker Compose файлы
+
+- `docker-compose-dev.yaml` — локальная разработка
+- `docker-compose-prod.yaml` — производственное окружение
+- `docker-compose-stage.yaml` — staging окружение  
+- `docker-compose-infra.yaml` — инфраструктурные сервисы
+- `docker-compose-gpt.yaml` — специфичные GPT сервисы
+
+### Поддерживаемые платформы и приложения
+
+Система поддерживает несколько приложений на разных платформах:
+
+#### Приложения:
+- **GPTutor** — основное приложение для обучения
+- **Stable Art** — генерация изображений  
+- **AiHumor** — генерация юмористического контента
+
+#### Платформы:
+- **VK Mini Apps** — интеграция с ВКонтакте
+- **Telegram Bot Platform** — Telegram боты
+
+#### Production домены:
+- `gptutor.prod.${HOST}` — основное приложение GPTutor
+- `deep-gpt.prod.${HOST}` — Telegram версия GPTutor
+- `stable-art.prod.${HOST}` — Stable Art приложение
+- `ai-humor.prod.${HOST}` — AiHumor приложение
+
+### Мониторинг и логирование
+
+- Все сервисы работают в Docker контейнерах с автоматическим перезапуском
+- Nginx логи доступны через Docker logs
+- Backend логирование через Spring Boot
+- Автоматическое обновление SSL сертификатов через certbot
+
+### База данных
+
+- PostgreSQL 13.1-alpine для production
+- Отдельные инстансы для prod и stage окружений
+- Persistent volumes для сохранения данных
+- Автоматические миграции через Spring Boot
+
+### Безопасность
+
+- Автоматические SSL сертификаты через Let's Encrypt
+- Traefik reverse proxy с автоматическим TLS
+- Изоляция сервисов через Docker networks
+- Переменные окружения для sensitive данных
+
+## Быстрый старт
+
+1. Клонируйте репозиторий
+2. Скопируйте `.env.example` в `.env` и настройте переменные
+3. Для локальной разработки: `./local-run.sh`
+4. Для production: `./deploy-all.sh`
+
+## Требования к системе
+
+- Docker и Docker Compose
+- Node.js 12+ для локальной разработки frontend
+- Java 17 для локальной разработки backend
+- 2GB+ RAM для всех сервисов
+- SSL домен для production развертывания
\ No newline at end of file