aiform_prod/docs/REDIS_VS_POSTGRESQL_SPEED.md

Redis vs PostgreSQL: Когда что использовать?

Скорость доступа

Redis:

• ⚡ 0.1-1 мс (данные в памяти)
• Мгновенный доступ
• Идеально для частых чтений

PostgreSQL:

• 🐢 1-10 мс (с индексами)
• Зависит от нагрузки и индексов
• Но всё равно очень быстро

---

Когда Redis имеет смысл

✅ Используй Redis, если:

1. Очень частые чтения (каждый запрос, каждый клик)

   • Например: счетчики, rate limiting, сессии

2. Временные данные (TTL, автоочистка)

   • Например: SMS коды, временные токены

3. Кеширование результатов запросов

   • Например: результаты AI классификации, шаблоны визардов

4. Pub/Sub события (реал-тайм)

   • Например: ocr_events:{claim_id} для SSE

---

Когда PostgreSQL достаточно

✅ Используй только PostgreSQL, если:

1. Данные читаются не так часто

   • Загрузка страницы, переход между шагами
   • Пользователь не заметит разницу 1-10 мс

2. Важна консистентность

   • Нужна гарантия актуальности данных
   • Нет риска рассинхронизации

3. Данные уже в PostgreSQL

   • Не нужно дублировать
   • Проще архитектура

---

Для веб-формы: Анализ использования

Когда читаются данные заявки:

1. При загрузке страницы (1 раз)

   • Пользователь открывает форму
   • Можно загрузить из PostgreSQL (10 мс) - не критично

2. При переходах между шагами (редко)

   • Пользователь нажимает "Далее"
   • Можно загрузить из PostgreSQL (10 мс) - не критично

3. При обновлении данных (редко)

   • Пользователь заполняет форму
   • Сохраняется в PostgreSQL

Вывод:

• ❌ НЕ критично по скорости - пользователь не заметит разницу
• ✅ Важнее консистентность - данные всегда актуальные
• ✅ Проще архитектура - один источник истины

---

Компромиссное решение

Вариант: Кеширование в Redis с инвалидацией

# При чтении данных заявки
async def get_claim(claim_id: str):
    # 1. Пробуем Redis (быстро)
    cached = await redis.get(f"claim:{claim_id}")
    if cached:
        return json.loads(cached)
    
    # 2. Если нет в кеше - из PostgreSQL
    claim = await db.get_claim(claim_id)
    
    # 3. Сохраняем в кеш на 1 час
    await redis.set(f"claim:{claim_id}", json.dumps(claim), ttl=3600)
    
    return claim

# При обновлении данных
async def update_claim(claim_id: str, data: dict):
    # 1. Обновляем PostgreSQL
    await db.update_claim(claim_id, data)
    
    # 2. Инвалидируем кеш (удаляем из Redis)
    await redis.delete(f"claim:{claim_id}")
    
    # Или обновляем кеш сразу
    await redis.set(f"claim:{claim_id}", json.dumps(data), ttl=3600)

Плюсы:

• ✅ Быстрый доступ (если есть в кеше)
• ✅ Актуальные данные (инвалидация при обновлении)
• ✅ Fallback на PostgreSQL (если кеш пуст)

Минусы:

• ❌ Дополнительная сложность
• ❌ Нужно инвалидировать кеш при каждом обновлении
• ❌ Риск устаревших данных (если забыли инвалидировать)

---

Рекомендация для веб-формы

Вариант 1: Только PostgreSQL (рекомендую)

Когда использовать:

• Данные читаются не так часто (загрузка страницы, переходы)
• Важна консистентность
• Простота архитектуры важнее скорости

Плюсы:

• ✅ Просто (один источник данных)
• ✅ Всегда актуальные данные
• ✅ Нет рассинхронизации
• ✅ PostgreSQL с индексами всё равно быстро (1-10 мс)

Минусы:

• ❌ Чуть медленнее, чем Redis (но не критично)

---

Вариант 2: PostgreSQL + Redis кеш (если нужна скорость)

Когда использовать:

• Очень частые чтения (каждый запрос)
• Критична скорость (но для веб-формы это не так)

Плюсы:

• ✅ Быстрый доступ (0.1-1 мс)
• ✅ Меньше нагрузки на PostgreSQL

Минусы:

• ❌ Сложнее (нужна инвалидация кеша)
• ❌ Риск устаревших данных
• ❌ Больше кода для поддержки

---

Итог

Для веб-формы:

Рекомендую: Только PostgreSQL

Почему:

1. ⚡ PostgreSQL с индексами быстро (1-10 мс) - пользователь не заметит
2. ✅ Всегда актуальные данные (нет рассинхронизации)
3. ✅ Проще архитектура (один источник истины)
4. ✅ Данные читаются не так часто (не каждый запрос)

Redis используй только для:

• ✅ Pub/Sub (ocr_events:{claim_id}) - события в реальном времени
• ✅ Кеширование AI ответов (классификация, визарды) - если нужно
• ✅ SMS коды, временные токены - с TTL

НЕ используй Redis для:

• ❌ Основных данных заявки (есть в PostgreSQL)
• ❌ Документов (есть в PostgreSQL)
• ❌ Ответов визарда (есть в PostgreSQL)

---

Если всё-таки нужен Redis кеш

Можно добавить опциональное кеширование:

# В n8n workflow после claimsave
if (channel === 'web_form' && enable_cache === true) {
  // Опционально: кешируем в Redis на 1 час
  await redis.set(
    `claim:${claim_id}`,
    JSON.stringify(claim_data),
    ttl=3600
  );
}

Но это опционально и не обязательно для веб-формы.