architect/arh/design/PRO_SELLER1.md

PRO.seller1 — Платформа для малого торгового бизнеса

Версия: 1.0.0
Дата: 2025-12-19
Тип: Product


ДЛЯ КОГО

Малый и средний торговый бизнес:
- Продажи через маркетплейсы (OZON, WB, YM)
- Собственный интернет-магазин
- Дропшипинг и работа с поставщиками
- Розница + опт
- 1-50 сотрудников


ЧТО ЭТО

Единая платформа управления торговым бизнесом:

┌─────────────────────────────────────────────────────────────────┐
│                        PRO.seller1                               │
│         "Всё для торговли в одном месте"                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│   📦 КАТАЛОГ     💰 ЗАКУПКИ      🛒 ПРОДАЖИ     🏪 МАРКЕТЫ      │
│   товары         поставщики      заказы         OZON, WB        │
│   остатки        дропшипинг      возвраты       синхронизация   │
│   склады         маржа           платежи        FBO/FBS         │
│                                                                  │
│   🚚 ЛОГИСТИКА   👥 КЛИЕНТЫ      📊 АНАЛИТИКА   💵 ФИНАНСЫ      │
│   доставка       CRM             дашборды       учёт            │
│   курьеры        сегменты        отчёты         1С              │
│   маршруты       лояльность      прогнозы       выплаты         │
│                                                                  │
│   📢 МАРКЕТИНГ   ⚙️ НАСТРОЙКИ    🤖 АВТОМАТИЗАЦИЯ               │
│   реклама        пользователи    роботы                         │
│   акции          роли            триггеры                       │
│   промокоды      интеграции      уведомления                    │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

КЛЮЧЕВЫЕ ВОЗМОЖНОСТИ

Единый центр управления

Автоматизация рутины

Масштабируемость


МОДУЛИ СИСТЕМЫ

PRO.seller1/
│
├── 🔐 CORE ─────────────────────────────────────────────────────
│   │   Ядро системы
│   ├── Auth          Авторизация, JWT, сессии
│   ├── Users         Пользователи, профили
│   ├── Roles         Роли и права доступа
│   └── Settings      Настройки системы
│
├── 📦 CATALOG ──────────────────────────────────────────────────
│   │   Управление товарами
│   ├── Products      Карточки товаров
│   ├── Categories    Категории, дерево
│   ├── Attributes    Характеристики, фильтры
│   ├── Prices        Цены, прайс-листы
│   ├── Stock         Остатки, резервы
│   ├── Warehouses    Склады, локации
│   └── Media         Фото, видео
│
├── 💰 PROCUREMENT ──────────────────────────────────────────────
│   │   Закупки и поставщики (дропшипинг)
│   ├── Suppliers     Справочник поставщиков
│   ├── PriceList     Прайсы поставщиков
│   ├── Purchases     Заказы поставщикам
│   ├── Receiving     Приёмка товара
│   ├── Margin        Расчёт маржи
│   └── Compare       Сравнение цен
│
├── 🛒 SALES ────────────────────────────────────────────────────
│   │   Продажи и заказы
│   ├── Orders        Все заказы (единый список)
│   ├── OrderItems    Позиции заказов
│   ├── Returns       Возвраты, отмены
│   ├── Payments      Платежи, оплаты
│   └── Documents     Документы (счета, акты)
│
├── 🏪 MARKETPLACES ─────────────────────────────────────────────
│   │   Интеграции с маркетплейсами
│   ├── Accounts      Аккаунты (мульти-кабинет)
│   ├── OZON/         OZON Seller API
│   │   ├── Products  Карточки на OZON
│   │   ├── Prices    Цены на OZON
│   │   ├── Stock     Остатки FBO/FBS
│   │   ├── Orders    Заказы OZON
│   │   └── Returns   Возвраты OZON
│   ├── WB/           Wildberries API
│   ├── YM/           Яндекс.Маркет API
│   ├── Sync          Синхронизация
│   └── Mapping       Сопоставление товаров
│
├── 🚚 LOGISTICS ────────────────────────────────────────────────
│   │   Логистика и доставка
│   ├── Shipments     Отгрузки
│   ├── Carriers      Службы доставки
│   │   ├── CDEK
│   │   ├── Pochta    Почта России
│   │   ├── DPD
│   │   ├── Boxberry
│   │   └── Custom    Другие
│   ├── Labels        Этикетки, накладные
│   ├── Tracking      Отслеживание
│   ├── Routes        Маршруты
│   ├── OwnDelivery   Своя доставка
│   │   ├── Couriers  Курьеры
│   │   ├── Zones     Зоны доставки
│   │   └── Schedule  Расписание
│   └── Pickup        Самовывоз, ПВЗ
│
├── 👥 CRM ──────────────────────────────────────────────────────
│   │   Работа с клиентами
│   ├── Clients       База клиентов
│   ├── Segments      Сегментация
│   ├── History       История заказов
│   ├── Communications
│   │   ├── Calls     Звонки
│   │   ├── WhatsApp  Мессенджеры
│   │   ├── Email     Рассылки
│   │   └── SMS       SMS
│   ├── Loyalty       Программа лояльности
│   │   ├── Points    Баллы
│   │   ├── Discounts Скидки
│   │   └── Cards     Карты клиента
│   └── Feedback      Отзывы, оценки
│
├── 📢 MARKETING ────────────────────────────────────────────────
│   │   Маркетинг и реклама
│   ├── Campaigns     Рекламные кампании
│   ├── Ads           Реклама на МП
│   │   ├── OzonAds   Реклама OZON
│   │   └── WBAds     Реклама WB
│   ├── Promo         Акции, распродажи
│   ├── Coupons       Промокоды
│   └── SEO           Описания, ключевые слова
│
├── 📊 ANALYTICS ────────────────────────────────────────────────
│   │   Аналитика и отчёты
│   ├── Dashboard     Главный дашборд
│   ├── Sales         Продажи
│   │   ├── ByChannel По каналам
│   │   ├── ByProduct По товарам
│   │   └── ByPeriod  По периодам
│   ├── Stock         Оборачиваемость
│   ├── Margin        Маржинальность
│   ├── ABC           ABC-анализ
│   ├── Forecasts     Прогнозы
│   └── Export        Экспорт отчётов
│
├── 💵 FINANCE ──────────────────────────────────────────────────
│   │   Финансы и учёт
│   ├── Transactions  Движение денег
│   ├── Accounts      Счета, касса
│   ├── Payouts       Выплаты
│   │   ├── Suppliers Поставщикам
│   │   └── Couriers  Курьерам
│   ├── Reconcile     Сверка с МП
│   ├── Reports       Финансовые отчёты
│   └── Taxes         Налоги (упрощёнка)
│
├── 🔗 INTEGRATIONS ─────────────────────────────────────────────
│   │   Внешние интеграции
│   ├── 1C/           1С интеграция
│   │   ├── Export    Выгрузка в 1С
│   │   ├── Import    Загрузка из 1С
│   │   └── Sync      Синхронизация
│   ├── Banks         Банки (выписки)
│   ├── Telephony     Телефония
│   ├── Payments      Платёжные системы
│   └── Webhooks      Webhooks API
│
└── 🤖 AUTOMATION ───────────────────────────────────────────────
    │   Автоматизация
    ├── Robots        Роботы
    │   ├── PriceBot  Автоцены
    │   ├── StockBot  Автоостатки
    │   └── OrderBot  Автозаказы
    ├── Triggers      Триггеры событий
    ├── Notifications Уведомления
    │   ├── Telegram
    │   ├── Email
    │   └── Push
    └── Scheduler     Расписание задач

СЦЕНАРИИ ИСПОЛЬЗОВАНИЯ

Сценарий 1: Дропшипинг

Поставщик → Прайс → Сравнение → Публикация на OZON →
→ Заказ на OZON → Заявка поставщику → Отгрузка → Трекинг

Модули: PROCUREMENT → CATALOG → MARKETPLACES → SALES → LOGISTICS

Сценарий 2: Свой склад + маркетплейсы

Закупка → Приёмка на склад → Синхронизация остатков →
→ Заказ на WB → Сборка → Отгрузка FBS → Трекинг

Модули: PROCUREMENT → CATALOG → MARKETPLACES → LOGISTICS

Сценарий 3: Интернет-магазин + доставка

Заказ на сайте → Подтверждение → Сборка →
→ Выбор доставки (СДЭК/Почта/Курьер) → Отправка → Трекинг → Оплата

Модули: SALES → LOGISTICS → CRM → FINANCE

Сценарий 4: B2B опт

Заявка от клиента → Расчёт скидки → Счёт →
→ Оплата → Отгрузка → Закрывающие документы → 1С

Модули: CRM → SALES → FINANCE → INTEGRATIONS


РОЛИ ПОЛЬЗОВАТЕЛЕЙ

Роль Доступ
Владелец Всё
Менеджер Заказы, CRM, Отгрузки
Закупщик Поставщики, Закупки, Каталог
Логист Отгрузки, Доставка, Курьеры
Бухгалтер Финансы, 1С, Отчёты
Маркетолог Маркетинг, Реклама, Аналитика
Кладовщик Склад, Остатки, Приёмка
Оператор Заказы (только просмотр)

ПРИОРИТЕТЫ РАЗРАБОТКИ

Q1 — MVP (базовый функционал)

✅ CORE         — Auth, Users, Settings
✅ CATALOG      — Products, Stock, Warehouses (базовый)
✅ SALES        — Orders (единый список)
✅ MARKETPLACES — OZON (заказы, отгрузки)
✅ LOGISTICS    — Shipments, Labels (базовый)

Q2 — Расширение

⏳ PROCUREMENT  — Suppliers, Purchases, Margin
⏳ CRM          — Clients, History, Segments
⏳ MARKETPLACES — WB, Sync полный
⏳ LOGISTICS    — Carriers (СДЭК, Почта)
⏳ ANALYTICS    — Dashboard, Sales reports

Q3 — Автоматизация

⏳ AUTOMATION   — Robots, Triggers
⏳ FINANCE      — Transactions, Payouts
⏳ MARKETING    — Ads, Promo
⏳ LOGISTICS    — OwnDelivery, Couriers
⏳ INTEGRATIONS — 1C (базовый)

Q4 — Полный функционал

⏳ CRM          — Loyalty, Communications
⏳ ANALYTICS    — Forecasts, ABC
⏳ INTEGRATIONS — Banks, Telephony
⏳ MARKETPLACES — YM, другие
⏳ FINANCE      — Taxes, Reports полные

ОТЛИЧИЯ ОТ КОНКУРЕНТОВ

Критерий PRO.seller1 МойСклад RetailCRM 1C
Маркетплейсы ✅ Глубокая интеграция ⚠️ Базовая ⚠️ Базовая ❌ Нет
Дропшипинг ✅ Из коробки ❌ Нет ❌ Нет ❌ Нет
Своя доставка ✅ Курьеры, зоны ⚠️ Частично ❌ Нет ❌ Нет
Простота ✅ Для малого бизнеса ⚠️ Сложно ⚠️ Средне ❌ Сложно
Цена ✅ Доступно 💰 Средне 💰 Дорого 💰💰
Открытость ✅ Self-hosted ❌ SaaS ❌ SaaS ⚠️

ТЕХНИЧЕСКАЯ АРХИТЕКТУРА

┌─────────────────────────────────────────────────────────────────┐
                         FRONTEND                                 
                   Jinja2 + HTMX + DaisyUI                       
├─────────────────────────────────────────────────────────────────┤
                         GATEWAY                                  
                     FastAPI + Auth                               
├─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┤
CORE CATLGSALESPROCUMRKT LOGIS CRM MRKTGANALYFINANINTEG
├─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┤
                      SQLAlchemy ORM                              
├─────────────────────────────────────────────────────────────────┤
                      PostgreSQL                                  
├───────────────────────────┬─────────────────────────────────────┤
         Redis                           S3                      
     (сессии, кэш)              (файлы, изображения)            
└───────────────────────────┴─────────────────────────────────────┘

                    Внешние API
        ┌───────────────────────────────────┐
          OZON  WB  YM  СДЭК  1C  SMS 
        └───────────────────────────────────┘

СЛЕДУЮЩИЙ ШАГ

Создать детальные ТЗ для каждого модуля:

  1. modules/CORE.md — ядро
  2. modules/CATALOG.md — каталог
  3. modules/SALES.md — продажи
  4. modules/PROCUREMENT.md — закупки
  5. modules/MARKETPLACES.md — маркетплейсы
  6. modules/LOGISTICS.md — логистика
  7. modules/CRM.md — клиенты
  8. modules/ANALYTICS.md — аналитика
  9. modules/FINANCE.md — финансы
  10. modules/INTEGRATIONS.md — интеграции
  11. modules/AUTOMATION.md — автоматизация
  12. modules/MARKETING.md — маркетинг

Документ: architect/design/PRO_SELLER1.md