1. Определить рабочее пространство
Рабочее пространство объединяет бизнес, его участников и подключённые магазины. Один человек может участвовать в нескольких бизнесах, но каждый из них должен оставаться самостоятельной границей доступа.
Перед анализом важно понимать, какое пространство открыто, какие магазины выбраны и за какой период рассматриваются операции. Это базовый контекст для всех последующих действий, включая фоновые обновления.
После открытия рабочего кабинета сценарий подключения должен явно связывать аккаунт площадки с выбранным бизнесом. Публичный сайт сейчас не создаёт рабочие пространства и не принимает ключи доступа.
2. Связать магазин с источником данных
Подключение маркетплейса — это связь с конкретным аккаунтом продавца, а не просто выбор логотипа площадки. Отдельно учитываются сам магазин и технический доступ к нему.
Приоритет предметной области — задачи продавца Wildberries. В общей модели также предусмотрены типы площадок Ozon и Яндекс Маркет. Наличие этих названий в архитектуре не означает, что готовые подключения уже доступны пользователям.
Точный порядок авторизации, набор необходимых разрешений и доступные типы данных должны публиковаться вместе с проверенной интеграцией. Здесь нет формы для передачи API-ключей: до открытия соответствующего сценария отправлять их на сайт не нужно.
3. Получить и сохранить исходные сведения
Один отчёт может требовать нескольких обращений к источнику. Данные приходят частями, а внешняя система может ограничивать запросы, временно отвечать с ошибкой или ещё не предоставить нужный период.
В новом ядре Makstat используется единый подход к загрузкам: сначала получить данные, сохранить исходные записи, проверить их и привести к внутренним сущностям. Источник и время получения должны оставаться различимыми.
Это нужно для последующей сверки и разбора ошибок. Если итог вызывает вопрос, важно иметь возможность вернуться к полученному набору операций, а не гадать, что именно раньше вернула площадка.
4. Отличать завершённую загрузку от полных данных
Технически завершившаяся задача ещё не означает, что получено всё необходимое. Например, процесс мог обработать только часть страниц или отклонить отдельные строки. Считать такой результат полностью проверенным было бы неверно.
Есть данные, но есть ограничения
Набор получен не полностью, часть записей требует проверки либо не завершена необходимая обработка.
Недостаточно подтверждений
Нельзя уверенно сказать, что выборка завершена и прошла все необходимые проверки.
Есть подтверждение полноты
Для загрузки выполнены установленные условия завершённости и целостности. Это состояние конкретных данных, а не бессрочная гарантия.
В архитектуре Makstat выполнение задачи и доверие к её результату рассматриваются отдельно. Этот принцип особенно важен для сравнений и финансового анализа.
5. Разобрать вопрос, а не просто открыть таблицу
Предположим, команда видит снижение результата по магазину. Последовательный разбор начинается с проверки периода и полноты данных. Затем рассматриваются динамика продаж и возвратов, состав ассортимента и изменения расходов.
После этого можно перейти к товарам, которые вносят наибольший вклад в изменение, и исследовать исходные события. Такой маршрут связывает общую картину с деталями, не заставляя пользователя каждый раз собирать анализ с нуля.
Makstat задуман как среда для этого маршрута: общий контекст, связанные сущности и понятные переходы. Выводы и действия остаются задачей команды, которая учитывает реальные условия бизнеса.
Что можно сделать уже сейчас
На этом сайте можно изучить логику Makstat, направления аналитики, финансовый подход и требования к данным. Страницы открыты без регистрации; примеры интерфейса являются иллюстрацией концепции.
Когда начнётся подключение пользователей, здесь должны появиться условия доступа, описание готовых интеграций и проверенные инструкции. До этого не требуется создавать аккаунт, передавать токены, загружать отчёты или оплачивать подписку.
Текущий этап и дальнейшие направления собраны на странице «О проекте». Если вопрос связан с конкретным понятием или ограничением, начните с ответов на частые вопросы.