🛒 Marketplace MVP (mp1)

Система управления продажами на маркетплейсах (Ozon, Wildberries, Яндекс.Маркет).

🚀 Быстрый старт

cd /home/claude-helper/marketplace-mvp
source venv/bin/activate
streamlit run app.py

Приложение откроется:
- Production: https://mp1.seller1.ru
- Dev: http://91.218.142.168:8501

Тестовый доступ:
- Логин: admin
- Пароль: admin1234

Админская почта:
- Email: admin@kt.ru
- Пароль: adminKT1234
- Доступ: Веб-интерфейс Beget

📁 Структура проекта

marketplace-mvp/
├── app.py                   # Главная страница
├── pages/                   # Страницы Streamlit
├── modules/                 # Бизнес-логика
│   ├── api/                # API интеграции (Ozon, WB, ...)
│   ├── legal_entities/     # Работа с юр.лицами
│   ├── products/           # Управление товарами
│   ├── orders/             # Обработка заказов
│   └── utils/              # Утилиты
├── database/                # Модели БД
│   └── models.py           # SQLAlchemy модели
├── core/                    # Ядро приложения
│   ├── auth.py             # Авторизация
│   ├── config.py           # Настройки
│   └── database.py         # Подключение к БД
└── data/                    # Данные
    └── marketplace.db      # SQLite база

📚 Документация

Для работы с проектом:

• 📖 MP1-PROJECT-MASTER.md - Всё о проекте
• 🗺️ MP1-ROADMAP.md - План развития
• 🔌 MP1-API-GUIDE.md - Справочник API
• 📝 MP1-CHANGELOG.md - История версий

Универсальные стандарты:

• 🎨 STYLE-GUIDE.md - Дизайн UI/UX
• 💻 CODE-GUIDE.md - Стандарты кода
• ⚙️ WORKFLOWS.md - Процессы работы

Мета:

• 📚 DOCUMENTATION.md - О системе документации

📊 Текущий статус

Версия: 2.4.0
Статус: В разработке
Последнее обновление: 2025-11-08

Что работает:

• ✅ Авторизация
• ✅ Управление юр.лицами
• ✅ 3-шаговый визард подключения каналов
• ✅ Интеграция Ozon API (полная)
• ✅ Загрузка заказов (FBS/realFBS)
• ✅ Система возвратов и утряски

В разработке:

• 🔄 Интеграция СДЭК API
• 🔄 Интеграция Почта России API
• 🔄 Автоматическая обработка realFBS заказов

🔗 Полезные ссылки

• GitHub: (добавить ссылку)
• Документация Ozon API: https://docs.ozon.ru/api/seller/
• Streamlit Docs: https://docs.streamlit.io/

🛠️ Технологии

• Backend: Python 3.10+
• Frontend: Streamlit 1.28+
• БД: SQLite (dev) / PostgreSQL (prod)
• ORM: SQLAlchemy 2.0+
• Миграции: Alembic

📞 Контакты

Вопросы и предложения: Обновите ROADMAP.md или создайте issue.

Удачной работы! 🚀