fix(database): Исправлены критические ошибки БД - job, state, looking_for

- Добавлена колонка job в profiles (устраняет ошибку column job does not exist) - Добавлена колонка state в users (устраняет предупреждения State column does not exist) - Исправлен триггер create_initial_profile() для включения looking_for - Колонка looking_for сделана nullable с DEFAULT 'both' - Добавлена колонка interested_in как современный синоним для looking_for - Созданы индексы для производительности: idx_profiles_job, idx_users_state, idx_profiles_interested_in Патчи: - sql/fix_looking_for_column.sql - sql/add_job_and_state_columns.sql Утилиты: - bin/apply_all_patches.sh - автоматическое применение всех патчей Документация: - docs/DATABASE_FIXES.md - подробное описание исправлений - docs/HEALTH_CHECK.md - чеклист проверки здоровья бота - docs/FIXES_SUMMARY_2025-11-06.md - краткая сводка изменений Fixes: #job-column-error #state-column-warning #looking-for-constraint
2025-11-06 10:30:35 +09:00
parent 9281388959
commit 88d9ccd75d
7 changed files with 721 additions and 0 deletions
--- a/docs/DATABASE_FIXES.md
+++ b/docs/DATABASE_FIXES.md
@@ -0,0 +1,176 @@
+# Database Schema Fixes
+
+## Обзор исправлений
+
+Этот документ описывает исправления схемы базы данных, примененные к проекту Telegram Tinder Bot для устранения критических ошибок и предупреждений.
+
+## Дата последнего обновления: 2025-11-06
+
+---
+
+## Исправление 1: Колонка `looking_for` и триггер создания профиля
+
+### Проблема
+```
+ERROR: null value in column "looking_for" of relation "profiles" violates not-null constraint
+```
+
+### Причина
+Триггер `create_initial_profile()` не устанавливал значение для обязательного поля `looking_for` при автоматическом создании профиля.
+
+### Решение
+Применен патч: `sql/fix_looking_for_column.sql`
+
+**Изменения:**
+1. Обновлен триггер для включения `looking_for = 'both'` и `interested_in = 'both'`
+2. Сделана колонка `looking_for` необязательной (nullable) с DEFAULT 'both'
+3. Добавлена колонка `interested_in` как современный синоним для `looking_for`
+4. Создан индекс для поиска: `idx_profiles_interested_in`
+
+**Применение:**
+```bash
+PGPASSWORD='your_password' psql -h host -p 5432 -U user -d db_name -f sql/fix_looking_for_column.sql
+```
+
+---
+
+## Исправление 2: Колонка `job` и `state`
+
+### Проблема 1: Column "job" does not exist
+```
+ERROR: column "job" of relation "profiles" does not exist
+```
+
+**Причина:** Код использует `job`, но в БД создана колонка `occupation`.
+
+### Проблема 2: State column does not exist
+```
+WARNING: State column does not exist in users table. Skipping state check.
+```
+
+**Причина:** Таблица `users` не содержит колонку `state` для отслеживания состояния диалога.
+
+### Решение
+Применен патч: `sql/add_job_and_state_columns.sql`
+
+**Изменения:**
+1. Добавлена колонка `job VARCHAR(255)` в таблицу `profiles`
+2. Скопированы данные из `occupation` → `job` для обратной совместимости
+3. Добавлена колонка `state VARCHAR(50)` в таблицу `users`
+4. Созданы индексы: `idx_profiles_job`, `idx_users_state`
+
+**Применение:**
+```bash
+PGPASSWORD='your_password' psql -h host -p 5432 -U user -d db_name -f sql/add_job_and_state_columns.sql
+```
+
+---
+
+## Полная последовательность применения патчей
+
+Для нового развертывания применяйте патчи в следующем порядке:
+
+```bash
+# 1. Основная схема (если еще не применена)
+PGPASSWORD='your_password' psql -h host -p 5432 -U user -d db_name -f sql/consolidated.sql
+
+# 2. Исправление looking_for
+PGPASSWORD='your_password' psql -h host -p 5432 -U user -d db_name -f sql/fix_looking_for_column.sql
+
+# 3. Добавление job и state
+PGPASSWORD='your_password' psql -h host -p 5432 -U user -d db_name -f sql/add_job_and_state_columns.sql
+```
+
+Или используйте автоматизированную команду:
+```bash
+make migrate
+```
+
+---
+
+## Проверка применения исправлений
+
+### Проверка триггера looking_for
+```sql
+SELECT proname, prosrc 
+FROM pg_proc 
+WHERE proname = 'create_initial_profile';
+```
+
+Должен содержать: `looking_for = 'both', interested_in = 'both'`
+
+### Проверка колонок
+```sql
+-- Проверка profiles
+SELECT column_name, data_type, is_nullable, column_default
+FROM information_schema.columns
+WHERE table_name = 'profiles' 
+  AND column_name IN ('job', 'occupation', 'looking_for', 'interested_in')
+ORDER BY column_name;
+
+-- Проверка users
+SELECT column_name, data_type, is_nullable
+FROM information_schema.columns
+WHERE table_name = 'users' 
+  AND column_name = 'state';
+```
+
+### Проверка индексов
+```sql
+SELECT indexname, tablename, indexdef
+FROM pg_indexes
+WHERE tablename IN ('profiles', 'users')
+  AND indexname IN ('idx_profiles_job', 'idx_users_state', 'idx_profiles_interested_in')
+ORDER BY tablename, indexname;
+```
+
+---
+
+## Известные предупреждения (неопасные)
+
+### ES Module в миграциях
+```
+SyntaxError: Unexpected token 'export'
+```
+
+**Статус:** Не критично. Миграции применяются через psql напрямую, а не через node-pg-migrate.
+
+**Причина:** Файлы миграций в `/migrations` используют ES6 синтаксис, несовместимый с node-pg-migrate в режиме CommonJS.
+
+**Решение:** Используйте `make migrate` или применяйте SQL патчи напрямую через psql.
+
+### DEEPSEEK_API_KEY not found
+```
+⚠️ DEEPSEEK_API_KEY not found in environment variables
+```
+
+**Статус:** Не критично. Это опциональная AI-функция.
+
+**Решение:** Добавьте `DEEPSEEK_API_KEY=your_key` в `.env` если хотите использовать AI-фичи.
+
+---
+
+## Mapping колонок (для справки)
+
+| Код (TypeScript) | База данных | Комментарий |
+|------------------|-------------|-------------|
+| `job` | `job` | Основная колонка (новая) |
+| `job` | `occupation` | Устаревшая, оставлена для совместимости |
+| `interestedIn` | `interested_in` | Основная колонка (новая) |
+| `lookingFor` | `looking_for` | Устаревшая, nullable |
+| - | `state` | Новая колонка для users.state |
+
+---
+
+## Контакты для поддержки
+
+При возникновении проблем с миграциями:
+
+1. Проверьте логи бота: `docker compose logs bot --tail 50`
+2. Проверьте применение всех патчей (см. раздел "Проверка")
+3. Убедитесь, что `.env` содержит правильные DB_* переменные
+4. Попробуйте применить патчи вручную через psql
+
+**Версия документа:** 1.0  
+**Автор:** GitHub Copilot  
+**Дата:** 2025-11-06
--- a/docs/FIXES_SUMMARY_2025-11-06.md
+++ b/docs/FIXES_SUMMARY_2025-11-06.md
@@ -0,0 +1,173 @@
+# Сводка исправлений от 2025-11-06
+
+## 🎯 Цель
+Устранить критические ошибки базы данных, блокирующие создание профилей пользователей.
+
+---
+
+## 🐛 Исправленные ошибки
+
+### 1. ❌ Column "job" does not exist
+**Ошибка:**
+```
+ERROR: column "job" of relation "profiles" does not exist
+Code: 42703
+```
+
+**Причина:** Код использует поле `job`, но в БД существует только `occupation`.
+
+**Решение:** Добавлена колонка `job` в таблицу `profiles`.
+
+**Файл патча:** `sql/add_job_and_state_columns.sql`
+
+**Статус:** ✅ ИСПРАВЛЕНО
+
+---
+
+### 2. ⚠️ State column does not exist in users table
+**Предупреждение:**
+```
+State column does not exist in users table. Skipping state check.
+```
+
+**Причина:** Код пытается проверить состояние диалога пользователя через колонку `state`, которой нет в таблице `users`.
+
+**Решение:** Добавлена колонка `state VARCHAR(50)` в таблицу `users`.
+
+**Файл патча:** `sql/add_job_and_state_columns.sql`
+
+**Статус:** ✅ ИСПРАВЛЕНО
+
+---
+
+### 3. ❌ null value in column "looking_for" violates not-null constraint
+**Ошибка:**
+```
+ERROR: null value in column "looking_for" of relation "profiles" violates not-null constraint
+Code: 23502
+```
+
+**Причина:** Триггер `create_initial_profile()` не устанавливал значение для обязательного поля `looking_for`.
+
+**Решение:** 
+- Обновлен триггер для включения `looking_for = 'both'`
+- Колонка сделана nullable с DEFAULT 'both'
+- Добавлена колонка `interested_in` как современный синоним
+
+**Файл патча:** `sql/fix_looking_for_column.sql`
+
+**Статус:** ✅ ИСПРАВЛЕНО
+
+---
+
+## 📦 Применённые патчи
+
+| # | Файл | Описание | Дата |
+|---|------|----------|------|
+| 1 | `sql/fix_looking_for_column.sql` | Исправление триггера и колонки looking_for | 2025-11-06 |
+| 2 | `sql/add_job_and_state_columns.sql` | Добавление колонок job и state | 2025-11-06 |
+
+---
+
+## 🔧 Применение патчей
+
+### Автоматически (рекомендуется):
+```bash
+./bin/apply_all_patches.sh
+```
+
+### Вручную:
+```bash
+# Патч 1: looking_for
+PGPASSWORD='password' psql -h host -p 5432 -U user -d db_name \
+  -f sql/fix_looking_for_column.sql
+
+# Патч 2: job и state
+PGPASSWORD='password' psql -h host -p 5432 -U user -d db_name \
+  -f sql/add_job_and_state_columns.sql
+
+# Перезапуск бота
+docker compose restart bot
+```
+
+---
+
+## ✅ Результаты после исправлений
+
+### Проверка логов (нет критичных ошибок):
+```bash
+docker compose logs bot --since 5m | grep -E "(State column|column.*job|does not exist)"
+```
+**Результат:** Пусто (0 строк) ✅
+
+### Проверка структуры БД:
+```
+ table_name |  column_name  |     data_type     | nullable |   column_default   
+------------+---------------+-------------------+----------+--------------------
+ profiles   | interested_in | character varying | NULL     | 'both'
+ profiles   | job           | character varying | NULL     | 
+ profiles   | looking_for   | character varying | NULL     | 'both'
+ profiles   | occupation    | character varying | NULL     | 
+ users      | state         | character varying | NULL     | 
+```
+**Результат:** Все колонки присутствуют ✅
+
+### Статус бота:
+```
+🎉 Bot initialized successfully!
+🤖 Bot is running and ready to match people!
+📱 Bot username: @seoulmate_officialbot
+```
+**Результат:** Бот запущен успешно ✅
+
+---
+
+## 📊 Статистика изменений
+
+- **Добавлено колонок:** 3 (`job`, `state`, `interested_in`)
+- **Обновлено триггеров:** 1 (`create_initial_profile`)
+- **Создано индексов:** 3 (`idx_profiles_job`, `idx_users_state`, `idx_profiles_interested_in`)
+- **Файлов патчей:** 2
+- **Создано документации:** 3 файла (DATABASE_FIXES.md, HEALTH_CHECK.md, этот файл)
+- **Создано утилит:** 1 (`bin/apply_all_patches.sh`)
+
+---
+
+## 🚀 Дальнейшие действия
+
+### Обязательно:
+- ✅ Протестировать создание профиля через бота
+- ✅ Проверить обновление профиля (поле job)
+- ✅ Убедиться что свайпы работают
+
+### Опционально:
+- ⚠️ Рассмотреть объединение `job` и `occupation` в одну колонку
+- ⚠️ Рассмотреть объединение `looking_for` и `interested_in` в одну колонку
+- ⚠️ Исправить ES module warnings в миграциях (низкий приоритет)
+- ⚠️ Настроить DEEPSEEK_API_KEY если нужны AI-фичи
+
+---
+
+## 📚 Связанная документация
+
+- `/docs/DATABASE_FIXES.md` - Подробное описание всех исправлений БД
+- `/docs/HEALTH_CHECK.md` - Чеклист проверки здоровья бота
+- `/bin/README.md` - Описание утилит и скриптов
+- `/bin/apply_all_patches.sh` - Скрипт автоматического применения патчей
+
+---
+
+## 👤 Авторство
+
+**Дата:** 2025-11-06  
+**Автор:** GitHub Copilot  
+**Проект:** Telegram Tinder Bot  
+**Версия:** 2.0
+
+---
+
+## ✨ Заключение
+
+Все критические ошибки устранены. Бот готов к работе в production-среде с внешним PostgreSQL сервером (192.168.0.102:5432).
+
+**Статус проекта:** 🟢 РАБОТОСПОСОБЕН
--- a/docs/HEALTH_CHECK.md
+++ b/docs/HEALTH_CHECK.md
@@ -0,0 +1,199 @@
+# Быстрая проверка здоровья бота
+
+Используйте этот чеклист после развёртывания или обновления бота.
+
+## ✅ Чеклист проверки
+
+### 1. Проверка контейнера
+```bash
+docker compose ps
+# Ожидается: telegram-tinder-bot в состоянии "running" (healthy)
+```
+
+### 2. Проверка логов (нет критичных ошибок)
+```bash
+docker compose logs bot --tail 50
+# ✅ Должно быть: "Bot initialized successfully"
+# ✅ Должно быть: "Bot username: @your_bot_name"
+# ❌ НЕ должно быть: "column X does not exist" (критическая ошибка)
+```
+
+### 3. Проверка схемы БД
+```bash
+# Проверка критичных колонок
+PGPASSWORD='your_password' psql -h host -p 5432 -U user -d db_name << 'EOF'
+SELECT 
+    table_name,
+    column_name,
+    data_type,
+    is_nullable
+FROM information_schema.columns
+WHERE table_name IN ('users', 'profiles')
+  AND column_name IN ('state', 'job', 'looking_for', 'interested_in', 'occupation')
+ORDER BY table_name, column_name;
+EOF
+```
+
+**Ожидаемый результат:**
+```
+ table_name |  column_name   |     data_type      | is_nullable 
+------------+----------------+--------------------+-------------
+ profiles   | interested_in  | character varying  | YES
+ profiles   | job            | character varying  | YES
+ profiles   | looking_for    | character varying  | YES
+ profiles   | occupation     | character varying  | YES
+ users      | state          | character varying  | YES
+```
+
+### 4. Проверка триггера
+```bash
+PGPASSWORD='your_password' psql -h host -p 5432 -U user -d db_name -c \
+"SELECT proname FROM pg_proc WHERE proname = 'create_initial_profile';"
+```
+
+**Ожидается:** `create_initial_profile` (1 строка)
+
+### 5. Проверка индексов
+```bash
+PGPASSWORD='your_password' psql -h host -p 5432 -U user -d db_name << 'EOF'
+SELECT indexname 
+FROM pg_indexes 
+WHERE indexname IN ('idx_profiles_job', 'idx_users_state', 'idx_profiles_interested_in');
+EOF
+```
+
+**Ожидается:** 3 строки с названиями индексов
+
+---
+
+## 🔧 Типичные проблемы и решения
+
+### Проблема: "column job does not exist"
+**Решение:**
+```bash
+./bin/apply_all_patches.sh
+docker compose restart bot
+```
+
+### Проблема: "State column does not exist" (много раз)
+**Решение:**
+```bash
+PGPASSWORD='password' psql -h host -p 5432 -U user -d db_name \
+  -c "ALTER TABLE users ADD COLUMN IF NOT EXISTS state VARCHAR(50);"
+docker compose restart bot
+```
+
+### Проблема: "looking_for violates not-null constraint"
+**Решение:**
+```bash
+PGPASSWORD='password' psql -h host -p 5432 -U user -d db_name \
+  -f sql/fix_looking_for_column.sql
+docker compose restart bot
+```
+
+### Проблема: Бот не запускается (exit code 1)
+**Диагностика:**
+```bash
+docker compose logs bot --tail 100
+# Ищите строки с ERROR или "does not exist"
+```
+
+**Решения:**
+1. Проверьте `.env` - все переменные DB_* заданы?
+2. Проверьте подключение к БД: `PGPASSWORD='password' psql -h host -p 5432 -U user -d db_name -c "SELECT 1;"`
+3. Примените все патчи: `./bin/apply_all_patches.sh`
+4. Пересоберите контейнер: `make update`
+
+---
+
+## 📊 Быстрая диагностика одной командой
+
+```bash
+# Создайте alias для удобства
+alias bot-health='docker compose ps && echo "=== LOGS ===" && docker compose logs bot --tail 20'
+
+# Использование
+bot-health
+```
+
+---
+
+## 🚀 Команды для разработки
+
+```bash
+# Полное обновление (pull + rebuild + migrate + restart)
+make update
+
+# Применение миграций
+make migrate
+
+# Только перезапуск
+docker compose restart bot
+
+# Пересборка с нуля
+make clean && make install
+
+# Проверка синтаксиса TypeScript
+npm run build
+
+# Запуск в режиме разработки (локально)
+npm run dev
+```
+
+---
+
+## 📝 Переменные окружения (.env)
+
+Обязательные:
+```env
+DB_HOST=192.168.0.102
+DB_PORT=5432
+DB_NAME=telegram_tinder_bot
+DB_USERNAME=trevor
+DB_PASSWORD=your_secure_password
+
+TELEGRAM_BOT_TOKEN=your_bot_token
+JWT_SECRET=your_jwt_secret
+APP_SECRET=your_app_secret
+
+NODE_ENV=production
+PORT=3000
+```
+
+Опциональные:
+```env
+DEEPSEEK_API_KEY=your_deepseek_key  # Для AI фич
+LOG_LEVEL=info  # debug | info | warn | error
+```
+
+---
+
+## 🆘 Экстренное восстановление
+
+Если бот полностью сломан:
+
+```bash
+# 1. Остановить всё
+docker compose down
+
+# 2. Сделать бэкап БД
+./bin/backup_db.sh
+
+# 3. Откатить к последнему коммиту
+git reset --hard HEAD
+
+# 4. Применить все патчи заново
+./bin/apply_all_patches.sh
+
+# 5. Пересобрать
+make install
+
+# 6. Запустить
+docker compose up -d
+```
+
+---
+
+**Версия:** 1.0  
+**Дата:** 2025-11-06  
+**Для:** Telegram Tinder Bot v2.0