​

ADOLF CORE v4.0 — Введение

​

1. Что такое ADOLF?

​

1.1 Простыми словами

• Отвечает на вопросы сотрудников по внутренним документам компании
• Помогает обрабатывать отзывы покупателей на маркетплейсах
• Следит за ценами конкурентов
• Генерирует описания товаров
• Формирует финансовые отчёты

​

1.2 Что такое ADOLF CORE?

┌─────────────────────────────────────────────────────────────┐
│                      ADOLF (вся система)                     │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│   ┌─────────────────────────────────────────────────────┐   │
│   │                   ADOLF CORE                         │   │
│   │         (ядро — фундамент системы)                   │   │
│   └─────────────────────────────────────────────────────┘   │
│                            │                                 │
│         ┌──────────────────┼──────────────────┐             │
│         │                  │                  │             │
│         ▼                  ▼                  ▼             │
│   ┌──────────┐      ┌──────────┐      ┌──────────┐         │
│   │Reputation│      │  Watcher │      │   CFO    │   ...   │
│   │(отзывы)  │      │  (цены)  │      │(финансы) │         │
│   └──────────┘      └──────────┘      └──────────┘         │
│                                                              │
│              Функциональные модули                           │
│       (работают поверх Core, используют его API)            │
│                                                              │
└─────────────────────────────────────────────────────────────┘

​

1.3 Что входит в CORE?

​

2. Как всё устроено (архитектура)

​

2.1 Общая схема

​

2.2 Что делает каждый компонент

​

🚪 Nginx — «Охранник»

• Шифрует соединение (HTTPS) — чтобы никто не подслушал
• Решает куда направить запрос — в чат или в API
• Защищает от атак — блокирует подозрительные запросы

Пользователь открывает https://adolf.su
    │
    ▼
Nginx принимает запрос
    │
    ├─► Запрос на /          → отправить в Open WebUI (чат)
    ├─► Запрос на /api/v1/   → отправить в Middleware (API)
    └─► Запрос на /ws/       → отправить в WebSocket (уведомления)

​

💬 Open WebUI — «Чат-интерфейс»

• Показывает красивый чат
• Позволяет загружать файлы
• Показывает уведомления
• Работает на телефоне (PWA)

• Писать сообщения AI
• Загружать документы
• Видеть историю переписки
• Получать уведомления

​

⚙️ Middleware — «Мозг системы»

1. Авторизация — проверяет кто ты такой
2. Права доступа — решает что тебе можно видеть
3. Роутинг — направляет запросы куда нужно
4. Фильтрация — скрывает чужие данные
5. Логирование — записывает кто что делал

​

📄 ETL — «Обработчик документов»

• Extract (извлечь) — достать текст из файла
• Transform (преобразовать) — привести к единому формату
• Load (загрузить) — отправить в базу знаний

БЫЛО (Excel-файл):                      СТАЛО (Markdown):
┌─────────┬────────┬───────┐           ---
│ Размер  │ Грудь  │ Длина │           title: Размерная сетка худи
├─────────┼────────┼───────┤           category: product
│ S       │ 100    │ 65    │           brand_id: ohana_market
│ M       │ 106    │ 68    │           ---
│ L       │ 112    │ 71    │           
└─────────┴────────┴───────┘           # Размерная сетка худи
                                       
                                       | Размер | Грудь | Длина |
                                       |--------|-------|-------|
                                       | S      | 100   | 65    |
                                       | M      | 106   | 68    |
                                       | L      | 112   | 71    |

​

🗄️ PostgreSQL — «База данных»

• Пользователи и их роли
• Метаданные документов
• История действий (аудит)
• Уведомления
• Настройки системы

​

📮 Redis — «Очередь задач»

• Отправить email — занимает 2-3 секунды
• Обработать большой файл — занимает минуту
• Проверить здоровье сервисов — нужно делать регулярно

​

⏰ Celery — «Работник на заднем плане»

• Отправка уведомлений
• Очистка старых данных
• Проверка здоровья сервисов
• Периодические отчёты

​

3. Как компоненты общаются между собой

​

3.1 Протоколы общения

​

3.2 Синхронные vs Асинхронные запросы

Ты: "Привет, какие размеры есть?"
[ждёшь 2 секунды]
AI: "Размеры: S, M, L, XL"

Ты: "Загрузи этот файл"
Система: "Принято!" (мгновенно)
[через 1 минуту]
🔔 Уведомление: "Файл обработан"

​

3.3 Пример полного пути запроса

1. Браузер → Nginx: Пользователь нажал Enter, браузер отправил зашифрованный запрос
2. Nginx: Расшифровал HTTPS, понял что это запрос к чату, отправил в Open WebUI
3. Open WebUI → Middleware: Переслал сообщение пользователя в API
4. Middleware → PostgreSQL: «Кто это? Что ему можно?» — запрос информации о пользователе
5. Middleware: Получил ответ — это менеджер бренда «Охана»
6. Middleware → Timeweb AI: Отправил запрос с фильтрами (только данные Оханы)
7. Timeweb AI: Обработал запрос, нашёл информацию
8. Middleware → PostgreSQL: Записал в лог — «пользователь X спросил про отзывы»
9. Обратный путь: Ответ идёт назад по цепочке

​

4. Роли и права доступа

​

4.1 Иерархия ролей

​

4.2 Что может каждая роль

​

4.3 Фильтрация по брендам

# Middleware добавляет фильтр в запрос к AI

def add_brand_filter(user, request):
    if user.role == "manager":
        # Менеджер видит только свой бренд
        request.filters["brand_id"] = user.brand_id
    elif user.role in ("senior_manager", "director", "administrator"):
        # Старшие роли видят всё
        request.filters["brand_id"] = None  # без фильтра
    
    return request

​

5. Обработка документов (ETL)

​

5.1 Путь документа

​

5.2 Автоклассификация

Проанализируй документ и определи:
1. Категорию (product/instruction/legal/finance/other)
2. Уровень доступа (staff/manager/senior_manager/director)
3. Бренд (ohana_market/gorodok/all)

Документ:
---
Размерная сетка для худи оверсайз
Бренд: Охана Маркет
Артикул: 12345
...
---

Ответь в формате JSON:
{"category": "...", "access_level": "...", "brand_id": "..."}

​

5.3 Модерация

• Проверить что AI правильно классифицировал
• Убедиться что документ не содержит ошибок
• Защитить базу знаний от мусора

​

6. Система уведомлений

​

6.1 Как работают уведомления

​

6.2 Типы уведомлений

​

6.3 Кто получает уведомления

​

7. Безопасность

​

7.1 Слои защиты

​

7.2 Что логируется

​

8. Что важно помнить

​

8.1 Ключевые принципы

1. Разделение ответственности
   • Каждый компонент делает что-то одно
   • Nginx — принимает запросы
   • Middleware — бизнес-логика
   • ETL — обработка файлов
   • И так далее
2. Stateless (без состояния)
   • Middleware не хранит данные между запросами
   • Всё состояние — в PostgreSQL и Redis
   • Можно запустить несколько копий Middleware
3. Асинхронность для тяжёлых задач
   • Всё что дольше 1 секунды — в Celery
   • Пользователь не должен ждать
4. Безопасность по умолчанию
   • Всё запрещено, пока явно не разрешено
   • Каждый запрос проверяется
   • Все действия логируются

​

8.2 Частые вопросы новичков

• Распределять задачи между серверами
• Повторять упавшие задачи
• Планировать задачи по расписанию
• Мониторить что происходит

​

8.3 Словарь терминов

​

9. Следующие шаги

1. Изучить конкретные разделы:
   • Раздел 2.1: Архитектура — детали серверной части
   • Раздел 2.2: Middleware — как работает API
   • Раздел 2.3: ETL — обработка документов
2. Посмотреть код:
   • Начать с middleware/main.py — точка входа
   • Изучить middleware/api/ — эндпоинты API
   • Посмотреть middleware/services/ — бизнес-логика
3. Поднять локально:
   • Склонировать репозиторий
   • Запустить docker compose up
   • Попробовать отправить запрос