912 lines
39 KiB
Markdown
912 lines
39 KiB
Markdown
# Структура базы данных для AI Ассистента
|
||
|
||
**Дата проверки:** 2025-10-08
|
||
**Метод:** Прямая проверка через PostgreSQL
|
||
**Статус:** ✅ ПРОВЕРКА ЗАВЕРШЕНА
|
||
|
||
---
|
||
|
||
## 📊 Список AI таблиц
|
||
|
||
Найдено таблиц: **27 таблиц** (25 связаны с AI, 2 CMS)
|
||
|
||
---
|
||
|
||
## 1. `ai_assistant_settings` ⭐ КЛЮЧЕВАЯ
|
||
|
||
**Назначение:** Основные настройки AI ассистента
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `selected_rag_tables` - INTEGER[] - массив ID RAG таблиц для использования
|
||
- `languages` - TEXT[] - массив поддерживаемых языков
|
||
- `updated_at` - TIMESTAMP - время последнего обновления (default: now())
|
||
- `updated_by` - INTEGER - кто обновил (user_id)
|
||
- `rules_id` - INTEGER (FK → ai_assistant_rules) - ID правил для AI
|
||
- `telegram_settings_id` - INTEGER (FK → telegram_settings) - ID настроек Telegram
|
||
- `email_settings_id` - INTEGER (FK → email_settings) - ID настроек Email
|
||
- `system_prompt_encrypted` - TEXT - зашифрованный системный промпт
|
||
- `model_encrypted` - TEXT - зашифрованное название модели
|
||
- `system_message_encrypted` - TEXT - зашифрованное системное сообщение
|
||
- `embedding_model_encrypted` - TEXT - зашифрованное название embedding модели
|
||
- `system_message` - TEXT - системное сообщение (расшифрованное)
|
||
- `embedding_model` - VARCHAR(128) - embedding модель (расшифрованное)
|
||
|
||
**Связи:**
|
||
- → `ai_assistant_rules` (через rules_id)
|
||
- → `telegram_settings` (через telegram_settings_id)
|
||
- → `email_settings` (через email_settings_id)
|
||
|
||
**Используется в:**
|
||
- aiAssistantSettingsService.js (getSettings, updateSettings)
|
||
- conversationService.js (getRagTableId)
|
||
- ai-assistant.js (generateResponse)
|
||
- routes/settings.js (API)
|
||
|
||
---
|
||
|
||
## 2. `ai_assistant_rules` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Правила и инструкции для AI ассистента
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `created_at` - TIMESTAMP - дата создания (default: now())
|
||
- `updated_at` - TIMESTAMP - дата обновления (default: now())
|
||
- `name_encrypted` - TEXT - зашифрованное название правила
|
||
- `description_encrypted` - TEXT - зашифрованное описание правила
|
||
- `rules_encrypted` - TEXT - зашифрованные правила (JSON) ✅ ДОБАВЛЕНО
|
||
|
||
**Связи:**
|
||
- ← `ai_assistant_settings.rules_id` ссылается на эту таблицу
|
||
|
||
**Используется в:**
|
||
- aiAssistantRulesService.js (getAllRules, getRuleById, createRule)
|
||
- ai-assistant.js (получение правил)
|
||
- routes/settings.js (CRUD API)
|
||
|
||
---
|
||
|
||
## 3. `ai_providers_settings` ⭐ КЛЮЧЕВАЯ
|
||
|
||
**Назначение:** Настройки AI провайдеров (Ollama, OpenAI, Anthropic, Google)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `created_at` - TIMESTAMP NOT NULL - дата создания (default: now())
|
||
- `updated_at` - TIMESTAMP NOT NULL - дата обновления (default: now())
|
||
- `provider_encrypted` - TEXT - зашифрованное название провайдера ('ollama', 'openai', etc.)
|
||
- `api_key_encrypted` - TEXT - зашифрованный API ключ
|
||
- `base_url_encrypted` - TEXT - зашифрованный базовый URL
|
||
- `selected_model_encrypted` - TEXT - зашифрованное название выбранной модели
|
||
- `embedding_model_encrypted` - TEXT - зашифрованное название embedding модели
|
||
- `embedding_model` - VARCHAR(128) - embedding модель (незашифрованное, дублирует?)
|
||
|
||
**Связи:**
|
||
- Нет внешних ключей
|
||
|
||
**Используется в:**
|
||
- aiProviderSettingsService.js (getProviderSettings, upsertProviderSettings)
|
||
- ollamaConfig.js (loadSettingsFromDb - загружает настройки Ollama)
|
||
- ragService.js (getProviderSettings для вызова разных AI)
|
||
- routes/settings.js (CRUD API)
|
||
|
||
---
|
||
|
||
## 4. `messages` ⭐ КЛЮЧЕВАЯ
|
||
|
||
**Назначение:** Все сообщения пользователей и AI ответы
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `conversation_id` - INTEGER (FK → conversations) - ID беседы
|
||
- `sender_id` - INTEGER - ID отправителя (для админских сообщений)
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `user_id` - INTEGER (FK → users) - ID пользователя-владельца беседы
|
||
- `tokens_used` - INTEGER - количество токенов (default: 0)
|
||
- `is_processed` - BOOLEAN - обработано ли (default: false)
|
||
- `attachment_size` - BIGINT - размер вложения в байтах
|
||
- `attachment_data` - BYTEA - бинарные данные вложения
|
||
- `sender_type_encrypted` - TEXT - тип отправителя ('user', 'assistant', 'editor')
|
||
- `content_encrypted` - TEXT - текст сообщения
|
||
- `channel_encrypted` - TEXT - канал ('web', 'telegram', 'email')
|
||
- `role_encrypted` - TEXT - роль
|
||
- `attachment_filename_encrypted` - TEXT - имя файла
|
||
- `attachment_mimetype_encrypted` - TEXT - MIME тип
|
||
- `direction_encrypted` - TEXT - направление ('in', 'out')
|
||
- `message_id_encrypted` - TEXT - ID сообщения для дедупликации
|
||
- `message_type` - VARCHAR(20) NOT NULL - тип ('user_chat', 'admin_chat')
|
||
|
||
**Индексы:**
|
||
- idx_messages_conversation_id
|
||
- idx_messages_created_at
|
||
- idx_messages_message_type
|
||
- idx_messages_user_id
|
||
|
||
**Связи:**
|
||
- → `conversations` (ON DELETE CASCADE)
|
||
- → `users` (ON DELETE CASCADE)
|
||
|
||
**Триггеры:**
|
||
- `trg_set_message_user_id` - автоустановка user_id
|
||
|
||
**Используется в:**
|
||
- unifiedMessageProcessor.js (saveUserMessage)
|
||
- messageDeduplicationService.js (сохранение)
|
||
- conversationService.js (история)
|
||
- routes/messages.js, routes/chat.js
|
||
|
||
---
|
||
|
||
## 5. `conversations` ⭐ КЛЮЧЕВАЯ
|
||
|
||
**Назначение:** Беседы (диалоги) пользователей с AI
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор беседы
|
||
- `user_id` - INTEGER (FK → users) - ID пользователя-владельца
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `updated_at` - TIMESTAMP - дата обновления (default: CURRENT_TIMESTAMP)
|
||
- `title_encrypted` - TEXT - зашифрованный заголовок беседы
|
||
- `conversation_type` - VARCHAR(50) - тип беседы (default: 'user_chat')
|
||
- `'user_chat'` - обычный чат пользователя
|
||
- `'admin_chat'` - приватный чат между админами
|
||
|
||
**Индексы:**
|
||
- idx_conversations_conversation_type
|
||
- idx_conversations_created_at
|
||
- idx_conversations_user_id
|
||
|
||
**Связи:**
|
||
- → `users` (user_id, ON DELETE CASCADE)
|
||
- ← `conversation_participants` (для многопользовательских чатов)
|
||
- ← `messages` (все сообщения беседы)
|
||
|
||
**Используется в:**
|
||
- conversationService.js (findOrCreateConversation, getConversationHistory)
|
||
- unifiedMessageProcessor.js (создание беседы)
|
||
- guestMessageService.js (перенос гостевых сообщений)
|
||
- routes/messages.js (CRUD беседы)
|
||
|
||
---
|
||
|
||
## 6. `message_deduplication` ⭐ КЛЮЧЕВАЯ
|
||
|
||
**Назначение:** Предотвращение дублирования сообщений (дедупликация)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `channel` - VARCHAR(20) NOT NULL - канал ('web', 'telegram', 'email')
|
||
- `message_id_hash` - VARCHAR(64) NOT NULL - SHA-256 хеш ID
|
||
- `user_id` - INTEGER NOT NULL (FK → users) - ID пользователя
|
||
- `sender_type` - VARCHAR(20) NOT NULL - тип отправителя ('user', 'assistant')
|
||
- `original_message_id_encrypted` - TEXT - оригинальный ID
|
||
- `processed_at` - TIMESTAMP WITH TIME ZONE - время обработки (default: now())
|
||
- `expires_at` - TIMESTAMP WITH TIME ZONE - время истечения
|
||
|
||
**Индексы:**
|
||
- idx_message_dedup_expires
|
||
- idx_message_dedup_lookup (channel, hash, user_id, sender_type)
|
||
- idx_message_dedup_user_channel
|
||
- UNIQUE (channel, hash, user_id, sender_type)
|
||
|
||
**Связи:**
|
||
- → `users` (ON DELETE CASCADE)
|
||
|
||
**Используется в:**
|
||
- messageDeduplicationService.js
|
||
- unifiedMessageProcessor.js
|
||
- ai-assistant.js
|
||
|
||
---
|
||
|
||
## 7. `guest_messages` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Временное хранение сообщений гостей
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK)
|
||
- `is_ai` - BOOLEAN - от AI? (default: false)
|
||
- `created_at` - TIMESTAMP WITH TIME ZONE (default: now())
|
||
- `attachment_size` - BIGINT
|
||
- `attachment_data` - BYTEA
|
||
- `guest_id_encrypted` - TEXT - ID гостя (sessionID)
|
||
- `content_encrypted` - TEXT
|
||
- `language_encrypted` - TEXT
|
||
- `attachment_filename_encrypted` - TEXT
|
||
- `attachment_mimetype_encrypted` - TEXT
|
||
- `attachment_filename` - TEXT (дубль?)
|
||
- `attachment_mimetype` - TEXT (дубль?)
|
||
|
||
**Связи:**
|
||
- Нет FK (временная)
|
||
|
||
**Используется в:**
|
||
- guestService.js
|
||
- guestMessageService.js (перенос после auth)
|
||
|
||
**Цикл:**
|
||
1. Гость пишет → сохраняется
|
||
2. Авторизация → перенос в messages
|
||
3. Удаление из guest_messages
|
||
|
||
---
|
||
|
||
## 8. `guest_user_mapping` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Связь между гостями и зарегистрированными пользователями
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `user_id` - INTEGER NOT NULL (FK → users) - ID пользователя
|
||
- `processed` - BOOLEAN - обработаны ли сообщения (default: false)
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `guest_id_encrypted` - TEXT - зашифрованный ID гостя (sessionID)
|
||
|
||
**Индексы:**
|
||
- idx_guest_user_mapping_guest_id_encrypted - UNIQUE
|
||
- idx_guest_user_mapping_user_id
|
||
|
||
**Связи:**
|
||
- → `users` (user_id, ON DELETE CASCADE)
|
||
|
||
**Используется в:**
|
||
- guestMessageService.js (processGuestMessages - проверка и создание mapping)
|
||
|
||
**Логика:**
|
||
- При аутентификации гостя создается запись
|
||
- `processed = false` → сообщения еще не перенесены
|
||
- `processed = true` → сообщения уже перенесены в messages
|
||
|
||
---
|
||
|
||
## 9. `telegram_settings` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Настройки Telegram бота
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `created_at` - TIMESTAMP NOT NULL - дата создания (default: now())
|
||
- `updated_at` - TIMESTAMP NOT NULL - дата обновления (default: now())
|
||
- `bot_token_encrypted` - TEXT - зашифрованный токен Telegram бота
|
||
- `bot_username_encrypted` - TEXT - зашифрованное имя бота
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
|
||
**Связи:**
|
||
- ← `ai_assistant_settings.telegram_settings_id` ссылается на эту таблицу
|
||
|
||
**Используется в:**
|
||
- telegramBot.js (loadSettings - загрузка токена)
|
||
- botsSettings.js (getTelegramSettings, saveTelegramSettings, testConnection)
|
||
- routes/admin (API для настройки Telegram)
|
||
|
||
---
|
||
|
||
## 10. `email_settings` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Настройки Email бота (SMTP + IMAP)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `smtp_port` - INTEGER NOT NULL - порт SMTP (обычно 465)
|
||
- `imap_port` - INTEGER - порт IMAP (обычно 993)
|
||
- `created_at` - TIMESTAMP NOT NULL - дата создания (default: now())
|
||
- `updated_at` - TIMESTAMP NOT NULL - дата обновления (default: now())
|
||
- `smtp_host_encrypted` - TEXT - зашифрованный хост SMTP
|
||
- `smtp_user_encrypted` - TEXT - зашифрованный пользователь SMTP
|
||
- `smtp_password_encrypted` - TEXT - зашифрованный пароль SMTP
|
||
- `imap_host_encrypted` - TEXT - зашифрованный хост IMAP
|
||
- `from_email_encrypted` - TEXT - зашифрованный email отправителя
|
||
- `imap_user_encrypted` - TEXT - зашифрованный пользователь IMAP
|
||
- `imap_password_encrypted` - TEXT - зашифрованный пароль IMAP
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
|
||
**Связи:**
|
||
- ← `ai_assistant_settings.email_settings_id` ссылается на эту таблицу
|
||
|
||
**Используется в:**
|
||
- emailBot.js (loadSettings - создание SMTP транспортера и IMAP соединения)
|
||
- botsSettings.js (getEmailSettings, saveEmailSettings, testEmailSMTP, testEmailIMAP)
|
||
- routes/admin (API для настройки Email)
|
||
|
||
---
|
||
|
||
## 11. `is_rag_source` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Источники данных для RAG (справочник)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор источника
|
||
- `name_encrypted` - TEXT - зашифрованное название источника
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
|
||
**Связи:**
|
||
- ← `user_tables.is_rag_source_id` ссылается на эту таблицу
|
||
|
||
**Используется в:**
|
||
- Связывает RAG таблицы с типом источника данных
|
||
- user_tables имеет default: is_rag_source_id = 2
|
||
|
||
**Примеры источников:**
|
||
- ID 1: "FAQ"
|
||
- ID 2: "База знаний"
|
||
- ID 3: "Документация"
|
||
(зависит от данных в БД)
|
||
|
||
---
|
||
|
||
## 12. `user_tables` ⭐ КЛЮЧЕВАЯ (RAG)
|
||
|
||
**Назначение:** Пользовательские таблицы с данными для RAG базы знаний
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор таблицы
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `updated_at` - TIMESTAMP - дата обновления (default: CURRENT_TIMESTAMP)
|
||
- `is_rag_source_id` - INTEGER (FK → is_rag_source) - тип источника (default: 2)
|
||
- `name_encrypted` - TEXT - зашифрованное название таблицы
|
||
- `description_encrypted` - TEXT - зашифрованное описание
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
|
||
**Связи:**
|
||
- → `is_rag_source` (is_rag_source_id)
|
||
- ← `user_columns` (table_id, ON DELETE CASCADE)
|
||
- ← `user_rows` (table_id, ON DELETE CASCADE)
|
||
- ← `user_table_relations` (to_table_id, ON DELETE CASCADE)
|
||
|
||
**Используется в:**
|
||
- ragService.js (getTableData - получение данных для RAG)
|
||
- routes/tables.js (CRUD таблиц)
|
||
- routes/rag.js (выбор таблицы для RAG запроса)
|
||
|
||
**Структура RAG:**
|
||
```
|
||
user_tables (таблица)
|
||
└─ user_columns (колонки с purpose)
|
||
└─ user_rows (строки)
|
||
└─ user_cell_values (значения ячеек)
|
||
```
|
||
|
||
---
|
||
|
||
## 13. `user_columns` ⭐ КЛЮЧЕВАЯ (RAG)
|
||
|
||
**Назначение:** Колонки пользовательских таблиц с метаданными для RAG
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор колонки
|
||
- `table_id` - INTEGER NOT NULL (FK → user_tables) - ID таблицы
|
||
- `order` - INTEGER - порядок отображения (default: 0)
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `updated_at` - TIMESTAMP - дата обновления (default: CURRENT_TIMESTAMP)
|
||
- `name_encrypted` - TEXT - зашифрованное название колонки
|
||
- `type_encrypted` - TEXT - зашифрованный тип ('text', 'number', 'date', etc.)
|
||
- `placeholder_encrypted` - TEXT - зашифрованный плейсхолдер
|
||
- `placeholder` - VARCHAR(255) - плейсхолдер для RAG (UNIQUE)
|
||
- `options` - JSONB - дополнительные опции (default: '{}')
|
||
- `purpose` - назначение колонки ('question', 'answer', 'context', 'product', 'priority', 'date')
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
- idx_user_columns_options (GIN) - для быстрого поиска по JSONB
|
||
- user_columns_placeholder_key (UNIQUE) - уникальность плейсхолдеров
|
||
|
||
**Связи:**
|
||
- → `user_tables` (table_id, ON DELETE CASCADE)
|
||
- ← `user_table_relations` (column_id, ON DELETE CASCADE)
|
||
|
||
**Используется в:**
|
||
- ragService.js (getTableData - определение колонок по purpose)
|
||
- routes/tables.js (CRUD колонок)
|
||
|
||
**Важно для RAG:**
|
||
- `options.purpose` определяет роль колонки:
|
||
- 'question' - вопрос для поиска
|
||
- 'answer' - ответ
|
||
- 'context' - контекст
|
||
- 'product', 'priority', 'date' - метаданные
|
||
|
||
---
|
||
|
||
## 14. `user_rows` ⭐ КЛЮЧЕВАЯ (RAG)
|
||
|
||
**Назначение:** Строки данных в пользовательских таблицах (записи для RAG)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор строки
|
||
- `table_id` - INTEGER NOT NULL (FK → user_tables) - ID таблицы
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `updated_at` - TIMESTAMP - дата обновления (default: CURRENT_TIMESTAMP)
|
||
- `order` - INTEGER - порядок отображения (default: 0)
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
|
||
**Связи:**
|
||
- → `user_tables` (table_id, ON DELETE CASCADE)
|
||
- ← `user_cell_values` (row_id, ON DELETE CASCADE)
|
||
- ← `user_table_relations` (from_row_id, to_row_id, ON DELETE CASCADE)
|
||
- ← `user_tag_links` (tag_id, ON DELETE CASCADE)
|
||
|
||
**Используется в:**
|
||
- ragService.js (getTableData - получение всех строк таблицы)
|
||
- routes/tables.js (CRUD строк)
|
||
|
||
**Важно:**
|
||
- Каждая строка = одна запись в RAG (например, один вопрос-ответ)
|
||
- Значения хранятся в `user_cell_values`
|
||
|
||
---
|
||
|
||
## 15. `user_cell_values` ⭐ КЛЮЧЕВАЯ (RAG)
|
||
|
||
**Назначение:** Значения ячеек в пользовательских таблицах (данные для RAG)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор значения
|
||
- `row_id` - INTEGER NOT NULL (FK → user_rows) - ID строки
|
||
- `column_id` - INTEGER NOT NULL (FK → user_columns) - ID колонки ✅ ИСПРАВЛЕНО
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `updated_at` - TIMESTAMP - дата обновления (default: CURRENT_TIMESTAMP)
|
||
- `value_encrypted` - TEXT - зашифрованное значение ячейки
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
- user_cell_values_row_id_column_id_key (UNIQUE) - уникальная пара (row_id, column_id)
|
||
|
||
**Связи:**
|
||
- → `user_rows` (row_id, ON DELETE CASCADE)
|
||
- → `user_columns` (column_id, ON DELETE CASCADE) ✅ ДОБАВЛЕНО
|
||
|
||
**Используется в:**
|
||
- ragService.js (getTableData - получение всех значений для построения RAG данных)
|
||
- routes/tables.js (CRUD значений ячеек)
|
||
|
||
**Как работает RAG:**
|
||
1. ragService получает все cell_values для строк таблицы
|
||
2. Группирует по row_id
|
||
3. Находит значения по column_id с нужным purpose (question/answer/context)
|
||
4. Формирует данные для векторного поиска
|
||
|
||
---
|
||
|
||
## 16. `conversation_participants` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Участники многопользовательских бесед (для admin_chat)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `conversation_id` - INTEGER (FK → conversations) - ID беседы
|
||
- `user_id` - INTEGER (FK → users) - ID участника
|
||
- `created_at` - TIMESTAMP - дата добавления (default: CURRENT_TIMESTAMP)
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
- conversation_participants_conversation_id_user_id_key (UNIQUE) - пара (conversation_id, user_id)
|
||
- idx_conversation_participants_conversation_id
|
||
- idx_conversation_participants_user_id
|
||
|
||
**Связи:**
|
||
- → `conversations` (conversation_id, ON DELETE CASCADE)
|
||
- → `users` (user_id, ON DELETE CASCADE)
|
||
|
||
**Используется в:**
|
||
- routes/messages.js (создание admin_chat бесед между админами)
|
||
- routes/chat.js (поиск приватных бесед)
|
||
|
||
**Логика:**
|
||
- Для обычных чатов (`user_chat`) - НЕ используется (один владелец)
|
||
- Для админских чатов (`admin_chat`) - хранит всех участников беседы
|
||
|
||
---
|
||
|
||
## 17. `users` ⭐ КРИТИЧЕСКАЯ
|
||
|
||
**Назначение:** Пользователи системы (основа для всех AI взаимодействий)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор пользователя
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `updated_at` - TIMESTAMP - дата обновления (default: CURRENT_TIMESTAMP)
|
||
- `role` - user_role ENUM - роль пользователя (default: 'user')
|
||
- 'user' - обычный пользователь
|
||
- 'editor' - администратор-редактор
|
||
- 'readonly' - администратор только для чтения
|
||
- `is_blocked` - BOOLEAN NOT NULL - заблокирован ли (default: false)
|
||
- `blocked_at` - TIMESTAMP - время блокировки
|
||
- `username_encrypted` - TEXT - зашифрованное имя пользователя
|
||
- `status_encrypted` - TEXT - зашифрованный статус
|
||
- `first_name_encrypted` - TEXT - зашифрованное имя
|
||
- `last_name_encrypted` - TEXT - зашифрованная фамилия
|
||
- `preferred_language` - JSONB - предпочитаемый язык
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
- idx_users_role
|
||
|
||
**Связи (Referenced by):**
|
||
- ← conversation_participants (9 таблиц ссылаются!)
|
||
- ← conversations
|
||
- ← message_deduplication
|
||
- ← global_read_status
|
||
- ← guest_user_mapping
|
||
- ← messages
|
||
- ← user_identities
|
||
- ← user_preferences
|
||
- ← user_tag_links
|
||
- ← verification_codes
|
||
|
||
**Используется в:**
|
||
- identity-service.js (создание пользователей)
|
||
- auth-service.js (проверка ролей)
|
||
- userUtils.js (isUserBlocked)
|
||
- ВСЕ AI сервисы (через связи)
|
||
|
||
---
|
||
|
||
## 18. `user_identities` ⭐ КРИТИЧЕСКАЯ
|
||
|
||
**Назначение:** Идентификаторы пользователей (wallet, email, telegram)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `user_id` - INTEGER (FK → users) - ID пользователя
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `provider_encrypted` - TEXT - зашифрованный провайдер ('wallet', 'email', 'telegram')
|
||
- `provider_id_encrypted` - TEXT - зашифрованный идентификатор (адрес, email, telegram ID)
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
- idx_user_identities_user_id
|
||
|
||
**Связи:**
|
||
- → `users` (user_id, ON DELETE CASCADE)
|
||
|
||
**Используется в:**
|
||
- identity-service.js (findUserByIdentity, saveIdentity, linkWalletToUser)
|
||
- unifiedMessageProcessor.js (authenticateUser - поиск пользователя по Telegram/Email)
|
||
- telegramBot.js, emailBot.js (связь external ID с user_id)
|
||
- routes/identities.js (управление идентификаторами)
|
||
- routes/messages.js (broadcast - поиск каналов пользователя)
|
||
|
||
**Логика:**
|
||
- Один пользователь может иметь несколько идентификаторов (wallet + email + telegram)
|
||
- При входе через любой канал - система находит или создает пользователя
|
||
|
||
---
|
||
|
||
## 19. `global_read_status` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Глобальный статус прочтения сообщений для user_chat
|
||
|
||
**Столбцы:**
|
||
- `user_id` - INTEGER (PK, FK → users) - ID пользователя
|
||
- `last_read_at` - TIMESTAMP NOT NULL - время последнего прочитанного сообщения
|
||
- `updated_by_admin_id` - INTEGER NOT NULL - ID админа, который обновил статус
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `updated_at` - TIMESTAMP - дата обновления (default: CURRENT_TIMESTAMP)
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: user_id
|
||
- idx_global_read_status_last_read_at
|
||
- idx_global_read_status_user_id
|
||
|
||
**Связи:**
|
||
- → `users` (user_id, ON DELETE CASCADE)
|
||
|
||
**Используется в:**
|
||
- routes/messages.js (mark-read, read-status для user_chat)
|
||
|
||
**Логика:**
|
||
- Один статус на пользователя (общий для всех админов)
|
||
- Для обычных чатов (`user_chat`)
|
||
- Для админских чатов используется `admin_read_messages`
|
||
|
||
---
|
||
|
||
## 20. `admin_read_messages` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Персональный статус прочтения для admin_chat
|
||
|
||
**Столбцы:**
|
||
- `admin_id` - INTEGER NOT NULL (PK, FK → users) - ID администратора
|
||
- `user_id` - INTEGER NOT NULL (PK, FK → users) - ID пользователя/другого админа
|
||
- `last_read_at` - TIMESTAMP NOT NULL - время последнего прочитанного сообщения
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: (admin_id, user_id) - составной ключ
|
||
|
||
**Связи:**
|
||
- → `users` (admin_id, ON DELETE CASCADE) ✅ ДОБАВЛЕНО
|
||
- → `users` (user_id, ON DELETE CASCADE) ✅ ДОБАВЛЕНО
|
||
|
||
**Используется в:**
|
||
- routes/messages.js (mark-read, read-status для admin_chat)
|
||
|
||
**Логика:**
|
||
- Персональный статус для каждого админа
|
||
- Для приватных чатов между админами (`admin_chat`)
|
||
- Каждый админ имеет свой статус прочтения
|
||
|
||
**Отличие от global_read_status:**
|
||
- global_read_status - общий для всех админов (user_chat)
|
||
- admin_read_messages - персональный для каждого админа (admin_chat)
|
||
|
||
---
|
||
|
||
## 21. `user_tag_links` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Связь пользователей с тегами (для RAG фильтрации)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `user_id` - INTEGER NOT NULL (FK → users) - ID пользователя
|
||
- `tag_id` - INTEGER NOT NULL (FK → user_rows) - ID тега (строка из таблицы тегов)
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
- idx_user_tag_links_tag_id
|
||
- idx_user_tag_links_user_id
|
||
- user_tag_links_user_id_tag_id_key (UNIQUE) - уникальная пара (user_id, tag_id)
|
||
|
||
**Связи:**
|
||
- → `users` (user_id, ON DELETE CASCADE)
|
||
- → `user_rows` (tag_id, ON DELETE CASCADE) - теги хранятся как строки в RAG таблицах
|
||
|
||
**Используется в:**
|
||
- ragService.js (фильтрация данных по пользовательским тегам)
|
||
- routes/tables.js (управление тегами пользователей)
|
||
|
||
**Логика:**
|
||
- Теги позволяют фильтровать RAG данные по пользователю
|
||
- Один пользователь может иметь несколько тегов
|
||
- Используется для персонализации AI ответов
|
||
|
||
---
|
||
|
||
## 22. `roles` ⚠️ ВОЗМОЖНО УСТАРЕВШАЯ
|
||
|
||
**Назначение:** Роли пользователей (возможно старая таблица)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `name_encrypted` - TEXT - зашифрованное название роли
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
|
||
**Связи:**
|
||
- Нет внешних ключей
|
||
- Нет Referenced by (никто не ссылается!)
|
||
|
||
**⚠️ ПРОБЛЕМА:**
|
||
- Таблица существует, но НЕ используется
|
||
- В `users` роль хранится как ENUM `user_role`, а не FK
|
||
- Возможно старая таблица, которую можно удалить
|
||
|
||
**Используется в:**
|
||
- ❌ НЕ найдено использования в коде
|
||
|
||
---
|
||
|
||
## 23. `admin_pages` ⚠️ НЕ СВЯЗАНА С AI
|
||
|
||
**Назначение:** Страницы контента (CMS), НЕ связана с AI напрямую
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `author_address_encrypted` - TEXT NOT NULL - зашифрованный адрес автора
|
||
- `created_at` - TIMESTAMP - дата создания (default: now())
|
||
- `updated_at` - TIMESTAMP - дата обновления (default: now())
|
||
- `title_encrypted` - TEXT - зашифрованный заголовок
|
||
- `summary_encrypted` - TEXT - зашифрованное краткое описание
|
||
- `content_encrypted` - TEXT - зашифрованное содержимое
|
||
- `seo_encrypted` - TEXT - зашифрованные SEO данные
|
||
- `status_encrypted` - TEXT - зашифрованный статус
|
||
- `settings_encrypted` - TEXT - зашифрованные настройки
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
|
||
**Связи:**
|
||
- Нет внешних ключей
|
||
|
||
**Используется в:**
|
||
- routes/pages.js (CMS система)
|
||
- ❌ НЕ используется в AI сервисах
|
||
|
||
**Примечание:**
|
||
- Это таблица для CMS (система управления контентом)
|
||
- НЕ связана с AI ассистентом
|
||
- Упомянута в вашем списке, но к AI не относится
|
||
|
||
---
|
||
|
||
## 24. `admin_pages_simple` ⚠️ НЕ СВЯЗАНА С AI
|
||
|
||
**Назначение:** Упрощенные страницы контента БЕЗ шифрования, НЕ связана с AI
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `author_address` - TEXT NOT NULL - адрес автора (НЕ зашифрован!)
|
||
- `created_at` - TIMESTAMP - дата создания (default: now())
|
||
- `updated_at` - TIMESTAMP - дата обновления (default: now())
|
||
- `title` - TEXT - заголовок (НЕ зашифрован!)
|
||
- `summary` - TEXT - краткое описание
|
||
- `content` - TEXT - содержимое
|
||
- `seo` - TEXT - SEO данные
|
||
- `status` - TEXT - статус
|
||
- `settings` - TEXT - настройки
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
|
||
**Связи:**
|
||
- Нет внешних ключей
|
||
|
||
**Используется в:**
|
||
- routes/pages.js (CMS система)
|
||
- ❌ НЕ используется в AI сервисах
|
||
|
||
**Примечание:**
|
||
- Это таблица для CMS (система управления контентом)
|
||
- В отличие от `admin_pages`, данные НЕ зашифрованы
|
||
- НЕ связана с AI ассистентом
|
||
- Упомянута в вашем списке, но к AI не относится
|
||
|
||
---
|
||
|
||
## 25. `user_table_relations` ⭐ КЛЮЧЕВАЯ (RAG)
|
||
|
||
**Назначение:** Связи между строками в разных RAG таблицах (реляционная модель данных)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор связи
|
||
- `from_row_id` - INTEGER NOT NULL (FK → user_rows) - исходная строка
|
||
- `column_id` - INTEGER NOT NULL (FK → user_columns) - колонка со связью
|
||
- `to_table_id` - INTEGER NOT NULL (FK → user_tables) - целевая таблица
|
||
- `to_row_id` - INTEGER NOT NULL (FK → user_rows) - целевая строка
|
||
- `created_at` - TIMESTAMP - дата создания (default: CURRENT_TIMESTAMP)
|
||
- `updated_at` - TIMESTAMP - дата обновления (default: CURRENT_TIMESTAMP)
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
- idx_user_table_relations_column
|
||
- idx_user_table_relations_from_row
|
||
- idx_user_table_relations_to_row
|
||
- idx_user_table_relations_to_table
|
||
|
||
**Связи:**
|
||
- → `user_columns` (column_id, ON DELETE CASCADE)
|
||
- → `user_rows` (from_row_id, ON DELETE CASCADE)
|
||
- → `user_rows` (to_row_id, ON DELETE CASCADE)
|
||
- → `user_tables` (to_table_id, ON DELETE CASCADE)
|
||
|
||
**Используется в:**
|
||
- routes/tables.js (создание связей между данными)
|
||
- ragService.js (получение связанных данных для контекста)
|
||
|
||
**Логика:**
|
||
- Позволяет создавать связи "один-ко-многим" и "многие-ко-многим" между RAG данными
|
||
- Пример: FAQ вопрос → связанные продукты, документы → связанные разделы
|
||
- Используется для обогащения контекста AI ответов
|
||
|
||
**Структура связи:**
|
||
```
|
||
user_rows[from_row_id]
|
||
→ user_columns[column_id] (тип: "relation")
|
||
→ user_tables[to_table_id]
|
||
→ user_rows[to_row_id]
|
||
```
|
||
|
||
---
|
||
|
||
## 26. `admin_read_contacts` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Статус прочтения контактов админами (для UI непрочитанных пользователей)
|
||
|
||
**Столбцы:**
|
||
- `admin_id` - INTEGER NOT NULL (PK, FK → users) - ID администратора
|
||
- `contact_id` - INTEGER NOT NULL (PK, FK → users) - ID контакта (user_id)
|
||
- `read_at` - TIMESTAMP NOT NULL - время прочтения (default: now())
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: (admin_id, contact_id) - составной ключ
|
||
|
||
**Связи:**
|
||
- → `users` (admin_id, ON DELETE CASCADE) ✅ ДОБАВЛЕНО
|
||
- → `users` (contact_id, ON DELETE CASCADE) ✅ ДОБАВЛЕНО
|
||
|
||
**Используется в:**
|
||
- routes/messages.js (mark-contact-read - отметить контакт как прочитанный)
|
||
- adminLogicService.js (управление непрочитанными контактами)
|
||
|
||
**Логика:**
|
||
- Отслеживает, когда админ последний раз просматривал чат пользователя
|
||
- Используется для отображения непрочитанных контактов в списке
|
||
- Отличается от `global_read_status` (статус сообщений) и `admin_read_messages` (приватные чаты)
|
||
|
||
**Применение:**
|
||
- UI показывает список пользователей с новыми сообщениями
|
||
- Когда админ открывает чат → обновляется `read_at`
|
||
- Новые сообщения после `read_at` = непрочитанные
|
||
|
||
---
|
||
|
||
## 27. `user_preferences` ✅ АКТИВНАЯ
|
||
|
||
**Назначение:** Пользовательские настройки и предпочтения (может влиять на AI)
|
||
|
||
**Столбцы:**
|
||
- `id` - INTEGER (PK) - уникальный идентификатор
|
||
- `user_id` - INTEGER NOT NULL (FK → users) - ID пользователя
|
||
- `created_at` - TIMESTAMP NOT NULL - дата создания (default: now())
|
||
- `updated_at` - TIMESTAMP NOT NULL - дата обновления (default: now())
|
||
- `preference_key_encrypted` - TEXT - зашифрованный ключ настройки
|
||
- `preference_value_encrypted` - TEXT - зашифрованное значение настройки
|
||
- `metadata` - JSONB - дополнительные метаданные (default: '{}')
|
||
|
||
**Индексы:**
|
||
- PRIMARY KEY: id
|
||
- idx_user_preferences_user_id
|
||
|
||
**Связи:**
|
||
- → `users` (user_id, ON DELETE CASCADE) ✅ ИСПРАВЛЕНО
|
||
|
||
**Используется в:**
|
||
- routes/preferences.js (CRUD настроек)
|
||
- Может использоваться для персонализации AI ответов
|
||
|
||
**Возможные настройки:**
|
||
- Язык интерфейса
|
||
- Тема оформления
|
||
- Уведомления
|
||
- Персональные предпочтения для AI (стиль общения, детальность ответов)
|
||
|
||
**Примечание:**
|
||
- В таблице `users` уже есть `preferred_language` (JSONB)
|
||
- `user_preferences` - более гибкая система для любых настроек
|
||
- Может расширяться для AI-специфичных настроек
|
||
|
||
---
|
||
|
||
## 📊 ИТОГОВАЯ СТАТИСТИКА
|
||
|
||
**Всего проверено:** 27 таблиц
|
||
|
||
**По категориям:**
|
||
- ⭐ КРИТИЧЕСКИЕ: 4 (users, user_identities, messages, conversations)
|
||
- ⭐ КЛЮЧЕВЫЕ: 10 (ai_assistant_settings, ai_providers_settings, message_deduplication, user_tables, user_columns, user_rows, user_cell_values, user_table_relations)
|
||
- ✅ АКТИВНЫЕ: 10 (ai_assistant_rules, telegram_settings, email_settings, is_rag_source, conversation_participants, global_read_status, admin_read_messages, user_tag_links, admin_read_contacts, user_preferences)
|
||
- ⚠️ ПРОБЛЕМНЫЕ: 1 (roles - не используется)
|
||
- ⚠️ НЕ СВЯЗАНЫ С AI: 2 (admin_pages, admin_pages_simple)
|
||
|
||
**Обнаруженные проблемы:**
|
||
- ~~1. `ai_assistant_rules` - отсутствует столбец `rules_encrypted`~~ ✅ ИСПРАВЛЕНО (миграция 064)
|
||
- ~~2. `user_cell_values` - нет FK на `user_columns` (column_id)~~ ✅ ИСПРАВЛЕНО (миграция 065)
|
||
- 3. `roles` - таблица существует, но не используется ⚠️ НИЗКИЙ ПРИОРИТЕТ
|
||
- ~~4. `admin_read_messages` - нет FK на users~~ ✅ ИСПРАВЛЕНО (миграция 066)
|
||
- ~~5. `admin_read_contacts` - нет FK на users~~ ✅ ИСПРАВЛЕНО (миграция 066)
|
||
- ~~6. `user_preferences` - нет ON DELETE CASCADE для user_id~~ ✅ ИСПРАВЛЕНО (миграция 067)
|
||
|
||
**Применённые миграции:**
|
||
- 064_add_rules_encrypted_to_ai_assistant_rules.sql
|
||
- 065_add_fk_user_cell_values_column_id.sql
|
||
- 066_add_fk_admin_read_tables.sql
|
||
- 067_add_cascade_user_preferences.sql
|
||
|
||
**Дата проверки:** 2025-10-08
|
||
**Дата исправлений:** 2025-10-08
|
||
**Статус:** ✅ ПРОВЕРКА ЗАВЕРШЕНА + КРИТИЧНЫЕ ПРОБЛЕМЫ ИСПРАВЛЕНЫ
|
||
|