1. General Requirements

• The program must be launched manually, work locally on Windows.

• Use a real Chrome browser, launch it with existing user profiles.

• Ensure maximum imitation of human behavior (delays, clicks, navigation).

• The use of headless modes, Selenium/WebDriver, API requests, proxies, multi-threaded simultaneous launches is prohibited.

• Record results into a CSV file in the appropriate columns.

• The program processes up to 20 accounts per run.

2. Input Parameters (file 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 – full path to chrome.exe.

• profiles – array of objects with two parameters: user_data_dir (Chrome root directory) and profile_dir (profile folder).

• rewards_url – current URL of the rewards page.

• csv_path – full path to the CSV file with accounts.

• delay_range_seconds – array of two numbers specifying the minimum and maximum random delay between actions (in seconds).

3. CSV File Format

• The file contains at least the following columns:

  • account — unique account identifier (email, login, or other).

  • code — column for recording the received code (initially empty).

4. Program Logic

1. Loading Configuration

   • The program reads settings.json.

   • Checks for Chrome at the path chrome_path.

   • Loads the list of profiles.

2. Loading CSV

   • Reads the CSV file.

   • Identifies accounts with an empty code field (unprocessed).

3. Processing Accounts

   • For each unprocessed account (up to 20 per run), performs:
     a. Launches Chrome via subprocess with parameters:

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

     b. Connects to the browser via CDP (Playwright/Puppeteer).
     c. Navigates to rewards_url.
     d. Waits for the page to fully load.
     e. Clicks the Get Reward button.
     f. If a modal window with a code appears — reads the code (textually or via OCR if needed).
     g. If there is a Go to My Codes link — navigates there and reads the code.
     h. Records the code in the corresponding code column of the CSV file.
     i. Closes the browser without exiting the profile (browser must be fully closed).
     j. Waits for a random delay within delay_range_seconds before proceeding to the next account.

4. Termination

   • After processing up to 20 accounts, saves the updated CSV.

   • Ends the work.

5. Important Restrictions

6. Recommended Technologies

7. Additional Requirements

• Logging actions for diagnostics (saving to a separate log file).

• Error handling: proper termination on failures, ability to restart from the point of stop.

• Concise and clear command-line interface (e.g., informing about the current account, processing status).

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. Додаткові вимоги

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

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

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

This is the final updated version of the technical task text, already considering all corrections, including a single method for obtaining the code via "My Codes", without OCR and modal windows:

🎯 Goal

Create a desktop application (in Python or Node.js) that automatically opens real Chrome profiles, logs into 20 Three+ accounts, clicks Get Reward, navigates to My Codes, extracts the code in the form of TH3DC\d{9,} and adds it to the corresponding row in CSV.

⚙️ Functionality

• Runs manually on Windows (without auto-start or services).

• Works through real Chrome with local profiles (user-data-dir + profile-directory).

• Does not use headless mode, Selenium, HTTP requests, or proxies.

• Simulates human actions: launching the browser, clicking, navigating, pauses.

• Handles up to 20 accounts per run (specified in config).

• Skips accounts that already have a code in CSV.

🔄 Working Algorithm

Step 1: Load Configuration

• Reads settings.json (Chrome path, profile list, CSV path, delays).

• Reads CSV, identifies accounts without a code.

Step 2: Process Each Profile

1. Launches Chrome with specified profile:

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

2. Connects via CDP (Playwright or Puppeteer).

3. Opens rewards_url.

4. Waits for the page to fully load.

5. Clicks the Get Reward button (actual click, not .click()): a real click (using Playwright/Puppeteer with mouse.move + mouse.down + mouse.up, without .click()).

6. Waits 3–5 seconds.

Step 3: Read Code from My Codes

7. Navigate to https://threeplus.three.co.uk/my-rewards
   (or click Go to my codes if it appeared after Get Reward).

8. Searches for the last code in the format TH3DC\d{9,} in the DOM (via innerText / textContent).

9. Saves to CSV in the format:

   CopyEditProfile_01,TH3DC103897998490

10. Closes the browser (but does not log out).

11. Waits for a random delay (20–40 seconds).

12. Repeats for up to 20 accounts.

🧠 Exact Method of Reading the Code (Clear Algorithm)

• OCR, screenshots, and modal windows are not used.

• The code is always read from the My Codes page — after clicking "Get Reward"

• Code appearance: TH3DC103897998490 (pattern: TH3DC\d{9,}).

• Reading: via DOM (innerText, textContent, evaluate()).

⚙️ Configuration (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 Format

csvCopyEditaccount,code

profile_01,

profile_02,

• account — profile identifier

• code — field where the obtained code will be written

🚫 Prohibited

📦 Expected Output Files

• .exe for Windows (1 file).

• Full source code with comments.

• README.md with instructions.

• Example settings.json.

🛠️ Recommended Technologies

Ось фінальний оновлений текст технічного завдання, вже з урахуванням всіх правок, включаючи єдиний спосіб отримання коду через "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.

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