КАК СНЯТЬ СКРИНЫ ДЛЯ АУДИТА АККАУНТА (Mac)                сборщик v1.9.2
=========================================================================

Версия сборщика написана в имени папки. Если вам прислали версию старее —
попросите свежую: старый сборщик снимает меньше, и часть аудита тогда
приходится читать глазами по картинкам.

Нужен установленный Google Chrome (google.com/chrome). Safari не подойдёт:
сборщик снимает страницы через служебный канал Chrome. Больше ничего
ставить не надо — Python сборщик при первом запуске приготовит себе сам.

ПРОВЕРЬТЕ, ЧТО CHROME ИМЕННО УСТАНОВЛЕН: откройте Finder -> «Программы»
и убедитесь, что «Google Chrome» лежит там.

Если его там НЕТ, а браузер при этом работает — значит он запускается прямо
из скачанного файла-образа и не установлен. На маке так можно работать годами
и не знать. Лечится одним движением: перетащите «Google Chrome» в «Программы».

Если он там ЕСТЬ — переустанавливать ничего не нужно, даже когда сборщик
пишет, что не нашёл его. Такое бывает, если Chrome ставили не вы (машина
пришла с ним) и папку переименовали. Запустите сборщик и пришлите файл лога —
он сам напишет, где искал; дальше разберёмся мы, а не вы.

Браузером по умолчанию Chrome делать НЕ нужно: сборщик открывает своё
отдельное окно по пути к файлу, а не через «чем открыть» — на это настройка
не влияет вообще.


1. Распакуйте присланный архив и положите папку на рабочий стол.
   Внутри два файла — «Запустить-сборщик.command» и сам сборщик.
   Держите их вместе: поодиночке они не работают.


2. ПЕРВЫЙ запуск — правой кнопкой по «Запустить-сборщик.command»,
   в меню выбрать «Открыть», в окне-предупреждении ещё раз «Открыть».

   Так делается только один раз. Дальше — обычный двойной клик.

   Если mac всё равно говорит, что файл «не удалось проверить на наличие
   вредоносного ПО»: меню Apple -> «Системные настройки» ->
   «Конфиденциальность и безопасность», пролистать вниз — там будет строка
   про наш файл и кнопка «Всё равно открыть». Нажать её и запустить снова.
   Это не поломка: у нашего внутреннего инструмента нет платной подписи
   разработчика Apple, поэтому система осторожничает.

   На чистом маке при первом запуске Apple может предложить установить
   «инструменты разработчика» — согласитесь, это бесплатно и делается один
   раз (около 10 минут), потом запустите файл снова.


3. Откроются два окна: Терминал (в нём идёт работа сборщика) и отдельный
   Chrome. Chrome отдельный намеренно — он не трогает ваш обычный браузер,
   закладки и вкладки. Если у продавца скрытый профиль, в этом окне можно
   один раз войти в Avito.

   В этом Chrome откройте СНАЧАЛА ВИТРИНУ продавца — страницу со списком
   всех его объявлений, — а потом сами объявления. Удобно колёсиком мыши
   в новые вкладки. Больше ничего делать не нужно: каждую открытую
   страницу сборщик снимает сам, прогресс виден в окне Терминала.

   Витрина обязательно первой: с неё сборщик читает, сколько у продавца
   активных объявлений. Без этого числа аудит не понимает, десять карточек
   из пятисот он смотрит или все шесть, что у продавца есть, — а это
   разные утверждения.

   СКОЛЬКО ОБЪЯВЛЕНИЙ СНИМАТЬ
   Десять. Если у продавца их меньше десяти — снимайте все, сколько есть:
   это полный комплект, доснимать нечего. Когда сняли всё, нажмите в окне
   Терминала Control+C (именно Control, не Command); на десятом объявлении
   сборщик закончит сам.

   Берите РАЗНЫЕ товары и разные категории. Десять копий одного и того же
   объявления по разным городам — это не десять карточек, а одна: разбирать
   в них нечего, аудит это увидит и скажет прямым текстом.

   ЕСЛИ ЧТО-ТО ПОШЛО НЕ ТАК — ПРИСЫЛАЙТЕ ОДИН ФАЙЛ

   Сборщик ведёт дневник прогона: «лог-сборщика.txt» в той же папке
   с результатом. В нём его собственные записи — что за система, какой
   Chrome, что он снял и на чём споткнулся. Пересказывать своими словами
   не нужно и даже вредно: пришлите файл, по нему причина видна сразу.
   При поломке сборщик сам откроет папку и подсветит этот файл — останется
   перетащить его в переписку.

   Файл маленький, текстовый. Паролей и переписок в нём нет: только пути
   на вашем маке, адреса открытых страниц и сообщения самого сборщика.

   Частные случаи, которые лечатся на месте:
   • Какая-то вкладка не снимается, и сборщик пишет про неё «пока не снимаю» —
     обновите её (Cmd+R) или просто закройте. Остальные объявления это больше
     не задерживает: сборщик возьмёт следующие и доберёт комплект до десяти.
   • «Не нашла Google Chrome», хотя Chrome открыт — проверьте «Программы»
     (см. начало инструкции). Если Chrome там есть, ничего не переустанавливайте:
     пришлите файл лога, сборщик сам напечатает, где искал и что ему ответила
     система.
   • Страница показала «Доступ ограничен: проверка безопасности» —
     нажмите в этой вкладке Cmd+R, сборщик снимет её после обновления.
   • Закрыли окно раньше времени — ничего страшного, запустите заново.


4. Когда всё снято, сборщик сам откроет папку с результатом в Finder:
   Рабочий стол/Аудит-скрины/<дата-время>

   ПРИКЛАДЫВАЙТЕ ПАПКУ ЦЕЛИКОМ — все файлы из неё вместе с manifest.json.

   Файлов будет много: длинная страница режется на части (2.jpg,
   2.part-002.jpg и так далее), у витрины их обычно 5-7. Это нормально.
   Раскладывать их по полям, сортировать и переименовывать НЕ надо —
   что к чему относится, записано в manifest.json. Без этого файла
   комплект не примут, а порядок выбора файлов не значит ничего.

   Лежащий там же «лог-сборщика.txt» — это дневник прогона (см. выше).
   Он ничему не мешает: приложите его вместе с остальным или не прикладывайте,
   на приёмку комплекта это не влияет.


Вопросы — Веронике.
