Раздел 0: Введение
Проект: Интеллектуальная система управления интернет-магазином
Модуль: Shop
Версия: 1.0
Дата: Январь 2026
Назначение документа
Данный документ является введением в модуль ADOLF SHOP и содержит:
- Общее описание модуля
- Бизнес-цели и метрики
- Структуру документации
- Краткий обзор функциональности
Что такое ADOLF SHOP
ADOLF SHOP — функциональный модуль системы ADOLF, обеспечивающий AI-управление интернет-магазином на базе WordPress/WooCommerce через протокол MCP (Model Context Protocol).
Интеграция с WooCommerce
| Параметр | Значение |
|---|---|
| Платформа | WordPress + WooCommerce 10.3+ |
| Протокол | MCP (Model Context Protocol) |
| Магазин | ohana.market |
| Хостинг | Timeweb VPS |
Суббренды магазина
| Бренд | Описание |
|---|---|
| Охана Kids | Детская одежда |
| Охана Style | Взрослая одежда |
| Охана Care | Товары для ухода |
| Охана Lux | Премиум-сегмент |
Суббренды реализованы через плагин WooCommerce Brands (таксономия product_brand).
Основные возможности v1.0
| Функция | Описание |
|---|---|
| Мониторинг заказов | Отслеживание новых заказов, отмен, возвратов |
| Управление заказами | Просмотр деталей, поиск, фильтрация |
| Поиск товаров | Поиск по каталогу через MCP |
| Аналитика продаж | Выручка, средний чек, топ товаров |
| Уведомления | Push-уведомления о событиях через Notifications |
Бизнес-цели
| Цель | Описание | Метрика успеха |
|---|---|---|
| Оперативность | Мгновенное информирование о заказах | Уведомление < 1 минуты |
| Прозрачность | Единый интерфейс для всех каналов продаж | 100% заказов в ADOLF |
| Аналитика | Понимание эффективности интернет-магазина | Ежедневные отчёты |
| Проблемы | Быстрое выявление проблемных заказов | Автоматическое оповещение |
Структура документации
| Раздел | Содержание |
|---|---|
| 0. Введение | Общий обзор (этот документ) |
| 1. Архитектура | Компоненты, зависимости, интеграции |
| 2. MCP Integration | Интеграция с WooCommerce MCP |
| 3. AI Pipeline | Обработка запросов и аналитика |
| 4. Open WebUI | Интерфейс и Function Calling |
| 5. Сценарии | Пользовательские сценарии |
| 6. Celery | Фоновые задачи и polling |
Функциональный скоуп
MVP (v1.0)
Заказы:
- Сигнал о новом заказе
- Сигнал об отмене заказа
- Сигнал о возврате
- Заказы в ожидании (pending)
- Проблемные заказы (failed, refunded)
- Поиск заказов
- Просмотр деталей заказа
Каталог:
- Поиск товара по запросу
Аналитика:
- Выручка (за период, по брендам)
- Количество заказов
- Средний чек
- Топ товаров по продажам
- Продажи по брендам
- Заказы без оплаты (> 48 часов)
v2.0 (планы)
| Функция | Описание |
|---|---|
| Ответы на отзывы | Интеграция с Reputation для WooCommerce-отзывов |
| Управление каталогом | Синхронизация товаров, SEO-контент |
| Управление ценами | Синхронизация цен с маркетплейсами |
| Управление остатками | Актуализация складских остатков |
| Интеграция CFO | Передача данных для финансовой отчётности |
| Интеграция Office | Визуализация агента Shop |
Роли и доступ
| Роль | Описание | Доступ |
|---|---|---|
| Senior | Старший менеджер | Полный доступ |
| Director | Директор | Полный доступ + отчёты |
| Administrator | Администратор | Полный доступ |
> Примечание: Роли Staff и Manager не имеют доступа к модулю Shop в v1.0.
Технологический стек
| Компонент | Технология |
|---|---|
| E-commerce | WooCommerce 10.4.3 |
| CMS | WordPress |
| Протокол | MCP (Model Context Protocol) |
| AI | Claude Opus 4.5 (через MCP) |
| Interface | Open WebUI |
| Queue | Redis + Celery |
| Notifications | ADOLF Notifications |
Зависимости от ADOLF Core
Модуль Shop интегрирован с ADOLF Core:
| Компонент Core | Использование |
|---|---|
| Middleware | Авторизация, роутинг |
| Celery | Polling задачи (каждую минуту) |
| Redis | Очередь задач |
| Notifications | Push-уведомления о событиях |
Архитектура интеграции
┌─────────────────┐ MCP ┌──────────────────┐
│ Open WebUI │◄────────────►│ WooCommerce │
│ + Claude │ │ MCP Server │
└────────┬────────┘ └────────┬─────────┘
│ │
│ │
┌────────▼────────┐ ┌────────▼─────────┐
│ ADOLF Core │ │ WordPress │
│ (Celery, │ │ ohana.market │
│ Notifications)│ │ │
└─────────────────┘ └──────────────────┘Принцип работы:
- Claude в Open WebUI получает доступ к WooCommerce MCP tools
- Пользователь задаёт вопрос через чат
- Claude использует MCP для получения данных из WooCommerce
- Celery Beat периодически проверяет новые события
- При обнаружении события — push через Notifications
Быстрый старт
Для пользователя (Senior+)
- Откройте Open WebUI
- Выберите агента
@Adolf_Shop - Примеры запросов:
- "Покажи новые заказы"
- "Найди заказ
#12345" - "Аналитика продаж за неделю"
- "Топ-10 товаров по продажам"
- "Заказы в ожидании оплаты"
Для администратора
- Убедитесь, что WooCommerce MCP активирован
- Проверьте Celery Beat:
celery -A app beat - Проверьте Celery Worker:
celery -A app worker - Проверьте логи polling в Redis
Контакты
| Вопрос | Ответственный |
|---|---|
| Техническая поддержка | Administrator |
| Бизнес-процессы | Director |
| Документация | Senior |
Документ подготовлен: Январь 2026
Версия: 1.0
Статус: Черновик