WBUnit решает прикладную задачу расчета юнит-экономики по отчетам Wildberries.

Система принимает детализированный отчет продавца в формате xlsx или zip с вложенным xlsx, агрегирует строки по артикулу поставщика, рассчитывает финансовые показатели и отдает пользователю:

  • список загруженных отчетов
  • детальную расшифровку по каждому артикулу
  • экспорт отчета по юнит-экономике в xlsx
  • сводный экспорт по нескольким отчетам
  • объединенный отчет, собранный из нескольких исходных отчетов

Состав проекта

  • src/backend - FastAPI-приложение, парсер отчетов, экспорт, миграции и тесты
  • src/frontend - Next.js-приложение с MUI-интерфейсом
  • docs-site - отдельный сайт документации на Hugo + LotusDocs
  • storage - файловое хранилище исходных загруженных отчетов
  • docker-compose.yml - локальный dev-контур
  • docker-compose.prod.yml - production-контур

Основные бизнес-объекты

  • пользователь
  • роль
  • селлер
  • товар
  • отчет
  • строка отчета
  • история загрузок
  • история движения лимитов

Ключевые сценарии

  1. Пользователь регистрируется по email.
  2. Система отправляет письмо с подтверждением.
  3. После подтверждения система генерирует пароль и отправляет его пользователю.
  4. Пользователь входит в систему и получает JWT.
  5. Пользователь загружает отчет WB.
  6. Backend считает строки детализации, списывает лимиты, парсит файл и сохраняет отчет.
  7. Пользователь просматривает отчет, редактирует ручные значения, скачивает итоговый XLSX или строит сводные формы.