1. Загальні вимоги

• Програма повинна запускатись вручну, працювати локально на Windows.

• Використовувати реальний браузер Chrome, запускати його з існуючими користувацькими профілями.

• Забезпечити максимальну імітацію поведінки людини (затримки, кліки, навігація).

• Заборонено використання headless режимів, Selenium/WebDriver, API-запитів, проксі, багатопотокового одночасного запуску.

• Результати записувати в CSV-файл у відповідні колонки.

• Програма обробляє до 20 акаунтів за один запуск.

2. Вхідні параметри (файл settings.json)

jsonCopyEdit
{

  "chrome_path": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",

  "profiles": [

    {

      "user_data_dir": "C:\\Users\\User\\AppData\\Local\\Google\\Chrome\\User Data",

      "profile_dir": "Profile 1"

    },

    ...

  ],

  "rewards_url": "https://threeplus.three.co.uk/rewards",

  "csv_path": "C:\\path\\to\\accounts.csv",

  "delay_range_seconds": [90, 240]

}

• chrome_path – повний шлях до chrome.exe.

• profiles – масив об'єктів з двома параметрами: user_data_dir (коренева директорія Chrome) і profile_dir (папка профілю).

• rewards_url – актуальна URL сторінки з винагородами.

• csv_path – повний шлях до CSV файлу з акаунтами.

• delay_range_seconds – масив з двох чисел, що задають мінімальну та максимальну випадкову затримку між діями (в секундах).

3. Формат CSV файлу

• Файл містить мінімум такі колонки:

  • account — унікальний ідентифікатор акаунта (email, login або інше).

  • code — колонка для запису отриманого коду (спочатку порожня).

4. Логіка роботи програми

1. Завантаження конфігурації

   • Програма читає settings.json.

   • Перевіряє наявність Chrome за шляхом chrome_path.

   • Завантажує список профілів.

2. Завантаження CSV

   • Читає CSV-файл.

   • Визначає акаунти з порожнім полем code (необроблені).

3. Обробка акаунтів

   • Для кожного необробленого акаунта (до 20 на один запуск) виконує:
     a. Запускає Chrome через subprocess із параметрами:

     iniCopyEdit
     --user-data-dir=<user_data_dir>  
     
     --profile-directory=<profile_dir>  
     
     --remote-debugging-port=9222
     
     

     b. Підключається до браузера через CDP (Playwright/Puppeteer).
     c. Переходить на сторінку rewards_url.
     d. Чекає повного завантаження сторінки.
     e. Натискає кнопку Get Reward.
     f. Якщо з'являється модальне вікно з кодом — зчитує код (текстовим способом або OCR, якщо треба).
     g. Якщо є посилання Go to My Codes — переходить туди та зчитує код.
     h. Записує код у відповідну колонку code CSV-файлу.
     i. Закриває браузер, не виходячи з профілю (браузер повинен бути повністю закритий).
     j. Чекає випадкову затримку в межах delay_range_seconds перед наступним акаунтом.

4. Завершення роботи

   • Після обробки до 20 акаунтів зберігає оновлений CSV.

   • Завершує роботу.

5. Важливі заборони

6. Рекомендовані технології

7. Додаткові вимоги

• Логування дій для діагностики (збереження в окремий лог-файл).

• Обробка помилок: коректне завершення роботи при збоях, можливість повторного запуску з місця зупинки.

• Лаконічний і зрозумілий інтерфейс командного рядка (наприклад, інформування про поточний акаунт, статус обробки).

Ось фінальний оновлений текст технічного завдання, вже з урахуванням всіх правок, включаючи єдиний спосіб отримання коду через "My Codes", без OCR і модальних вікон:

🎯 Мета

Створити десктопну програму (на Python або Node.js), яка автоматично відкриває реальні Chrome-профілі, заходить у 20 облікових записів Three+, натискає Get Reward, переходить у My Codes, витягує код у вигляді TH3DC\d{9,} та додає його у відповідний рядок CSV.

⚙️ Функціональність

• Запускається вручну на Windows (без автозапуску або служб).

• Працює через реальний Chrome із локальними профілями (user-data-dir + profile-directory).

• Не використовує headless-режим, Selenium, HTTP-запити або проксі.

• Імітує людські дії: запуск браузера, натискання, переходи, паузи.

• Обробляє до 20 акаунтів за запуск (вказується в конфігу).

• Пропускає акаунти, де вже є код у CSV.

🔄 Алгоритм роботи

Крок 1: Завантаження конфігурації

• Зчитує settings.json (chrome path, список профілів, CSV шлях, затримки).

• Зчитує CSV, визначає акаунти без коду.

Крок 2: Обробка кожного профілю

1. Запускає Chrome із вказаним профілем:

   iniCopyEdit--user-data-dir=<user_data_dir>
   
   --profile-directory=<profile_dir>
   
   --remote-debugging-port=9222

2. Підключається через CDP (Playwright або Puppeteer).

3. Відкриває rewards_url.

4. Чекає повного завантаження сторінки.

5. Натискає кнопку Get Reward (дійсним кліком, не .click()): дійсний клік (через Playwright/Puppeteer з mouse.move + mouse.down + mouse.up, без .click()).

6. Чекає 3–5 секунд.

Крок 3: Зчитування коду з My Codes

7. Переходить на сторінку https://threeplus.three.co.uk/my-rewards
   (або натискає Go to my codes, якщо вона зʼявилася після Get Reward).

8. Шукає останній код у форматі TH3DC\d{9,} у DOM (через innerText / textContent).

9. Зберігає у CSV у вигляді:

   CopyEditProfile_01,TH3DC103897998490

10. Закриває браузер (але не виходить з акаунта).

11. Чекає випадкову затримку (20–40 секунд).

12. Повторює до 20 акаунтів.

🧠 Як саме зчитується код (чіткий алгоритм)

• OCR, скриншот та модальні вікна не використовуються.

• Код завжди зчитується зі сторінки My Codes - після натискання "Get Reward"

• Вигляд коду: TH3DC103897998490 (шаблон: TH3DC\d{9,}).

• Читання: через DOM (innerText, textContent, evaluate()).

⚙️ Конфігурація (settings.json)

jsonCopyEdit{

  "chrome_path": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",

  "profiles": [

    {

      "user_data_dir": "C:\\Users\\User\\AppData\\Local\\Google\\Chrome\\User Data",

      "profile_dir": "Profile 1"

    }

    // ...

  ],

  "rewards_url": "https://threeplus.three.co.uk/rewards",

  "csv_path": "C:\\path\\to\\accounts.csv",

  "delay_range_seconds": [90, 240]

}

📄 Формат CSV

csvCopyEditaccount,code

profile_01,

profile_02,

• account — ідентифікатор профілю

• code — поле, куди буде вписаний отриманий код

🚫 Заборонено

📦 Очікувані файли на виході

• .exe для Windows (1 файл).

• Повний вихідний код з коментарями.

• README.md з інструкцією.

• Приклад settings.json.

🛠️ Рекомендовані технології