arc/docs/ozon_tasks.md

Ozon - Логика задач

← Главная | События

Описание логики всех типов задач для банка Ozon (appCode: ozon).

---

Общие механизмы (CommonScript)

Запуск приложения (runAppAndGoToHomeScreen)

1. Убивает приложение если запущено (AdbUtils::tryToKillApplication)
2. Запускает приложение (AdbUtils::tryToStartApplication)
3. Ждёт 4.5 секунды на старт
4. Цикл до 10 попыток:
   • Получает XML-дамп экрана
   • Проверяет isHomeScreen() (наличие кнопок "Перевести" + "Пополнить")
   • Закрывает баннеры: диалоги, баннер безопасности, Google Play, рекламный bottom-sheet
   • Если экран с PIN-кодом — вводит PIN (100–900мс между цифрами)
   • Ожидание 1 сек между попытками
5. При неудаче — скриншот + лог ошибки

Навигация к продуктам (goToAllProducts)

1. Закрывает баннеры на домашнем экране
2. Ищет вкладку "Финансы"
3. Тапает до 3 раз с ожиданием 1 сек

Прокрутка к кнопке (swipeToButton)

• До 10 свайпов вверх (от 3/4 высоты к 1/4 высоты экрана)
• После каждого свайпа парсит XML и ищет кнопку
• Ожидание 1 сек между свайпами

Создание банковского профиля (createBankProfileIfNeeded)

• Читает fullName и phone из BankProfileDAO
• Нормализует телефон: убирает нецифровые символы, добавляет код страны из config.ini
• Маппинг валют: RUB→643, USD→840, KRW→410, AZN→944, ARS→32
• POST (новый) или PATCH (существующий) на сервер

---

FETCH_PROFILE

Скрипт: Ozon::LoginAndCheckAccountsScript + Ozon::GetCardInfoScript

Цель

Авторизация в приложении, получение баланса, полных номеров карт и синхронизация с сервером.

Шаги LoginAndCheckAccountsScript

1. Валидация — получение DeviceInfo и BankProfileInfo из БД
2. Запуск приложения — runAppAndGoToHomeScreen() с PIN-кодом
3. Создание профиля — createBankProfileIfNeeded() (синхронизация fullName/phone)
4. Сбор аккаунтов (если не режим fetchProfileOnly):
   • Навигация к "Финансы" через goToAllProducts()
   • Парсинг видимых аккаунтов из XML
   • Upsert в MaterialDAO
   • Отправка на сервер
5. Запуск GetCardInfoScript — синхронно, для получения полных номеров карт

Шаги GetCardInfoScript

1. Навигация на домашний экран
2. Парсинг профиля (если нет в БД):
   • Тап на имя пользователя вверху экрана
   • Парсинг fullName и phone
   • Обновление BankProfileDAO
3. Загрузка карт — parseCardsOnHomeScreen() (до 5 попыток, 1.5 сек)
4. Upsert всех карт в MaterialDAO
5. Синхронизация с сервером:
   • Создание устройства (POST) если нет apiId
   • POST/PATCH банковского профиля с балансом, ФИО, телефоном
6. Получение полных номеров карт (для каждой карты):
   • Тап на карту → ожидание экрана карты (10 × 2 сек)
   • Тап "Показать" → ожидание появления номера (10 × 2 сек)
   • Regex: \d{4}[\s]\d{4}[\s]\d{4}[\s]\d{4} (с unicode-пробелами)
   • Обработка баннера "Понятно"
   • Сохранение в MaterialDAO::updateCardNumber()
   • При неудаче: статус карты → Off, лог + скриншот
7. Отправка материалов на сервер (ns.postMaterial())
8. Завершение — убийство приложения

Ответ серверу (при успехе)

{
  "type": "FETCH_PROFILE",
  "material_id": "...",
  "bank_name": "ozon",
  "data": {
    "bank_account_id": "",
    "amount": 1500000,
    "currency": 643
  }
}

amount — в копейках (баланс × 100)

---

FETCH_TRANSACTIONS

Скрипт: Ozon::GetLastTransactionsScript

Цель

Поиск конкретной транзакции по сумме и времени в истории операций банка.

Входные параметры (из JSON задачи)

• body.amount — сумма в копейках (делится на 100)
• body.created_at — время транзакции (ISO формат)

Два режима работы

Режим	Условие	Поведение
Поиск	searchAmount > 0	Ищет конкретную транзакцию
Сканирование	searchAmount == 0	Собирает все транзакции за 24 часа

Шаги (режим поиска)

1. Навигация к списку операций (navigateToTransactionList):

   • Закрытие рекламного баннера
   • Проверка домашнего экрана (перезапуск если нужно)
   • Свайп до кнопки "Все" (до 10 свайпов)
   • Ожидание экрана "Операции" (10 × 1.5 сек)

2. Поиск транзакции (searchTransaction):

   • Цикл до 15 прокруток
   • Для каждой видимой кнопки-транзакции:
     • Парсинг суммы из текста кнопки
     • Проверка совпадения: |amount - searchAmount| ≤ 0.01
     • Парсинг даты из текста, проверка: |time - searchTime| ≤ 1 час
   • При совпадении:
     • Тап на транзакцию → парсинг деталей (телефон, имя, время)
     • Вставка в TransactionDAO
     • Возврат

3. Если не найдена — возвращает "Transaction not found"

Шаги (режим сканирования)

1. Навигация к списку операций (аналогично)
2. Сканирование (scanRecentTransactions):
   • Для каждой транзакции:
     • Тап → ожидание деталей (10 × 1.5 сек)
     • Парсинг кнопки и деталей
     • Фильтр по времени: пропускает транзакции старше 24 часов
     • Получение чека:
       • Тап "Документы"
       • Ожидание "Поделиться" (20 × 1.5 сек)
       • Скриншот → OCR (Tesseract, rus+eng)
       • Извлечение ID операции через regex:
         • ID операции = ... (буквенно-цифровой)
         • № Ф-YYYY-XXXXXXX
     • Вставка в TransactionDAO
     • Возврат назад → ожидание списка

Retry-логика (EventHandler)

Результат "Transaction not found"
  └─ Прошло < 10 мин? → статус Wait, повтор через 15 сек
  └─ Прошло ≥ 10 мин? → статус Error

Между повторами другие задачи могут выполниться (см. приоритеты в events.md)

Ответ серверу (при успехе)

{
  "type": "FETCH_TRANSACTIONS",
  "material_id": "...",
  "bank_name": "ozon",
  "data": [
    {
      "bank_transaction_id": "Ф-2025-1234567",
      "amount": 50000,
      "currency": 643,
      "transaction_type": "top-up",
      "bank_participator_id": "+79001234567",
      "status": "completed",
      "extra": { "fee": 0 },
      "created_at": "2025-01-15T14:30:00.000+03:00"
    }
  ]
}

Возвращаются все транзакции аккаунта за последние 24 часа (не только найденная).

---

CREATE_TRANSACTION (bank — по номеру карты)

Скрипт: Ozon::PayByCardScript

Цель

Перевод по номеру карты получателя.

Входные параметры

• event.phone — номер карты получателя
• event.amount — сумма перевода
• event.comment — имя банка-получателя

Шаги

1. Подготовка:

   • Закрытие рекламных баннеров
   • Проверка домашнего экрана (перезапуск если нужно)
   • Закрытие: баннеры, Google Play, "Заказать карту"

2. Тап "Перевести" → ожидание 2 сек

3. Ожидание "Платежи и переводы" (10 × 1.5 сек)

4. Тап "По номеру карты" (секция OTHER_WAYS) → ожидание 2 сек

5. Ожидание "Перевод по номеру карты" (10 × 1.5 сек)

6. Ввод номера карты:

   • Поиск EditText с hint "Номер карты получателя"
   • AdbUtils::inputText(cardNumber)
   • Ожидание 2 сек

7. Ввод суммы:

   • Поиск EditText с hint "Сумма от"
   • Ввод суммы (целое число)
   • Ожидание 1 сек

8. Ожидание расчёта комиссии (15 × 1.5 сек):

   • Поиск текста "Комиссия" + парсинг суммы после него
   • Извлечение цифр из формата "45 ₽"
   • Fallback: комиссия = 0

9. Тап "Перевести" (contains-match) → ожидание 3 сек

10. Проверка результата (15 × 2 сек):

    • "Успешно" → сохранение транзакции:
      • amount = -сумма (отрицательная)
      • fee = рассчитанная комиссия
      • type = Card, status = Complete
      • timestamp = Moscow timezone
    • "Не удалось" → ошибка
    • Таймаут → "Не дождались результата"

11. Получение чека (при успехе):

    • Тап "Документы"
    • Ожидание "Поделиться" (20 × 1.5 сек)
    • Скриншот → OCR → извлечение ID операции
    • Обновление БД: receipt image + external ID

Ответ серверу

{
  "type": "CREATE_TRANSACTION",
  "material_id": "...",
  "bank_name": "ozon",
  "data": {
    "amount": -50000,
    "currency": 643,
    "transaction_type": "bank",
    "bank_participator_id": "2200123456789012",
    "status": "completed",
    "bank_transaction_id": "Ф-2025-1234567",
    "extra": { "fee": 4500 },
    "created_at": "2025-01-15T14:30:00.000+03:00"
  }
}

---

CREATE_TRANSACTION (top-up — по номеру телефона)

Скрипт: Ozon::PayByPhoneScript

Цель

Перевод по номеру телефона с выбором банка-получателя.

Входные параметры

• event.phone — номер телефона получателя
• event.amount — сумма перевода
• event.comment — имя банка-получателя (для СБП)

Шаги

1. Подготовка — аналогично PayByCard

2. Тап "Перевести" → ожидание 2 сек

3. Ожидание страницы платежей → поиск EditText (10 × 1.5 сек)

4. Навигация к "Кому перевести":

   • Тап на первый EditText → ожидание 2 сек
   • Ожидание экрана "Кому перевести" (10 × 1.5 сек)

5. Ввод номера телефона:

   • Поиск первого EditText
   • AdbUtils::inputText(phone)
   • Ожидание 2 сек

6. Выбор получателя (цикл 20 попыток):

   • Вариант A: Найдена кнопка с номером телефона → тап
   • Вариант B: Выбор банка:
     • Тап "Другой банк" (content-desc="other-bank-item")
     • Включение ADB IME клавиатуры
     • Ввод названия банка через AdbUtils::inputAdbIMEText()
     • Отключение ADB IME
     • Поиск банка в списке (10 × 1.5 сек)
     • Если банк не найден → ошибка "Банк '...' не найден"
   • Условие выхода: текст "По номеру телефона" вверху экрана (y < height/7)

7. Ввод суммы:

   • Первый EditText → ввод суммы (целое число)
   • Ожидание 1 сек

8. Тап "Продолжить" → ожидание 2 сек

9. Ожидание "Подтвердите перевод" (10 × 1.5 сек)

10. Тап "Перевести ..." (contains-match) → ожидание 3 сек

11. Проверка результата — аналогично PayByCard:

    • "Успешно" → транзакция (type = Phone)
    • "Не удалось" → ошибка
    • Получение чека через OCR

Ответ серверу

Аналогичен PayByCard, но:

• transaction_type: "top-up"
• bank_participator_id: номер телефона

---

ScreenXmlParser (Ozon)

Определение экранов

Метод	Маркеры
isHomeScreen()	Кнопки "Перевести" + "Пополнить"
isProfileScreen()	Заголовок "Аккаунт" + кнопка "Выйти"
isTransactionListScreen()	WebView с text="Операции"

Баннеры и диалоги

Тип	Обнаружение	Действие
Диалог/пуш	Кнопки закрытия, "Позже"	Тап на кнопку закрытия
Безопасность	"Мы заботимся о вашей безопасности"	Тап "Отложить"
Биометрия	"Быстрый вход"	Тап "Не сейчас"
Реклама	resource-id "design_bottom_sheet"	Тап "touch_outside" или back
Google Play	"Закрыть диалоговое окно" / "Доступно обновление"	Тап закрытия

PIN-код (tryToFindPinCode)

Метод 1: Поиск кликабельных нод с текстом ^(?:key\s+)?(\d)$ → нужны все 10 цифр

Метод 2 (fallback): Поиск сетки 4×3 из кликабельных элементов одного размера (±10px)

Парсинг карт (parseCardsOnHomeScreen)

• Ищет "Основной счёт X ₽" для общего баланса
• Парсит кнопки с текстом, оканчивающимся на 4 цифры
• Regex для суммы: ([\d\s]+(?:[.,]\d+)?)\s*₽

Парсинг транзакций

• parseTransactionButtonText() — извлекает сумму и описание из текста кнопки в списке
• parseTransactionDetail() — парсит детали: bankTime (DD.MM.YYYY, HH:mm), phone (+...), name