1. Ogólne wymagania

• Program musi uruchamiać się ręcznie, działać lokalnie na Windows.

• Używać rzeczywistej przeglądarki Chrome, uruchamiać ją z istniejącymi profilami użytkowników.

• Zabezpieczyć maksymalną imitację zachowania człowieka (opóźnienia, kliknięcia, nawigacja).

• Zabronione jest używanie trybów headless, Selenium/WebDriver, zapytań API, proxy, wielowątkowego równoczesnego uruchamiania.

• Wyniki zapisywać do pliku CSV w odpowiednich kolumnach.

• Program obsługuje do 20 kont podczas jednego uruchomienia.

2. Parametry wejściowe (plik 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 – pełna ścieżka do chrome.exe.

• profiles – tablica obiektów z dwoma parametrami: user_data_dir (katalog główny Chrome) i profile_dir (folder profilu).

• rewards_url – aktualny URL strony z nagrodami.

• csv_path – pełna ścieżka do pliku CSV z kontami.

• delay_range_seconds – tablica z dwoma liczbami, określająca minimalne i maksymalne losowe opóźnienie między działaniami (w sekundach).

3. Format pliku CSV

• Plik zawiera co najmniej następujące kolumny:

  • account — unikalny identyfikator konta (email, login lub inny).

  • code — kolumna do zapisu otrzymanego kodu (początkowo pusta).

4. Logika działania programu

1. Wczytanie konfiguracji

   • Program odczytuje settings.json.

   • Sprawdza dostępność Chrome pod ścieżką chrome_path.

   • Wczytuje listę profili.

2. Wczytanie CSV

   • Odczytuje plik CSV.

   • Wskazuje konta z pustym polem code (nieprzetworzone).

3. Przetwarzanie kont

   • Dla każdego nieprzetworzonego konta (do 20 na jedno uruchomienie) wykonuje:
     a. Uruchamia Chrome przez subprocess z parametrami:

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

     b. Łączy się z przeglądarką przez CDP (Playwright/Puppeteer).
     c. Przechodzi na stronę rewards_url.
     d. Czeka na pełne załadowanie strony.
     e. Kliknięcie przycisku Get Reward.
     f. Jeśli pojawi się okno modalne z kodem — odczytuje kod (tekstowo lub OCR, jeśli trzeba).
     g. Jeśli jest link Go to My Codes — przechodzi tam i odczytuje kod.
     h. Zapisuje kod do odpowiedniej kolumny code w pliku CSV.
     i. Zamknij przeglądarkę, nie wychodząc z profilu (przeglądarka musi być całkowicie zamknięta).
     j. Czeka losowe opóźnienie w zakresie delay_range_seconds przed kolejnym kontem.

4. Zakończenie pracy

   • Po przetworzeniu do 20 kont zapisuje zaktualizowany CSV.

   • Zakończenie działania.

5. Ważne zakazy

6. Zalecane technologie

7. Dodatkowe wymagania

• Logowanie działań dla diagnostyki (zapis do osobnego pliku log).

• Obsługa błędów: poprawne zakończenie pracy przy awariach, możliwość ponownego uruchomienia od miejsca zatrzymania.

• Zwięzły i zrozumiały interfejs wiersza poleceń (np. informowanie o aktualnym koncie, statusie przetwarzania).

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

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

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

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

Oto końcowa zaktualizowana treść specyfikacji technicznej, już z uwzględnieniem wszystkich poprawek, obejmująca jedyny sposób uzyskania kodu przez "My Codes", bez OCR i okien modalnych:

🎯 Cel

Stworzyć program desktopowy (w Pythonie lub Node.js), który automatycznie otwiera rzeczywiste profile Chrome, loguje się na 20 kontach Three+, klika Get Reward, przechodzi do My Codes, wyciąga kod w formacie TH3DC\d{9,} i dodaje go do odpowiedniego wiersza CSV.

⚙️ Funkcjonalność

• Uruchamia się ręcznie na Windows (bez automatycznego uruchamiania lub usług).

• Działa przez prawdziwy Chrome z lokalnymi profilami (user-data-dir + profile-directory).

• Nie używa trybu headless, Selenium, żądań HTTP ani proxy.

• Imituje działania ludzkie: uruchomienie przeglądarki, kliknięcia, przejścia, pauzy.

• Obsługuje do 20 kont na jedno uruchomienie (określane w konfiguracji).

• Pomija konta, które mają już kod w CSV.

🔄 Algorytm działania

Krok 1: Załadowanie konfiguracji

• Wczytuje settings.json (ścieżka do Chrome, lista profili, ścieżka CSV, opóźnienia).

• Wczytuje CSV, identyfikuje konta bez kodu.

Krok 2: Przetwarzanie każdego profilu

1. Uruchamia Chrome z podanym profilem:

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

2. Łączy się przez CDP (Playwright lub Puppeteer).

3. Otwiera rewards_url.

4. Czeka na pełne załadowanie strony.

5. Kliknięcie przycisku Get Reward (prawdziwy klik, nie .click()): rzeczywisty klik (przez Playwright/Puppeteer z mouse.move + mouse.down + mouse.up, bez .click()).

6. Czeka 3–5 sekund.

Krok 3: Odczyt kodu z My Codes

7. Przechodzi na stronę https://threeplus.three.co.uk/my-rewards
   (lub klika Go to my codes, jeśli pojawiła się po Get Reward).

8. Szukuje ostatniego kodu w formacie TH3DC\d{9,} w DOM (przez innerText / textContent).

9. Zapisuje w CSV w formacie:

   CopyEditProfile_01,TH3DC103897998490

10. Zamyka przeglądarkę (ale nie wylogowuje się z konta).

11. Czeka losowe opóźnienie (20–40 sekund).

12. Powtarza do 20 kont.

🧠 Jak dokładnie odczytywany jest kod (jasny algorytm)

• OCR, zrzuty ekranu i okna modalne nie są używane.

• Kod zawsze odczytywany jest ze strony My Codes - po kliknięciu "Get Reward"

• Wygląd kodu: TH3DC103897998490 (wzorzec: TH3DC\d{9,}).

• Odczyt: przez DOM (innerText, textContent, evaluate()).

⚙️ Konfiguracja (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]

}

📄 Format CSV

csvCopyEditaccount,code

profile_01,

profile_02,

• account — identyfikator profilu

• code — pole, do którego wpisywany będzie otrzymany kod

🚫 Zabronione

📦 Oczekiwane pliki wyjściowe

• .exe dla Windows (1 plik).

• Pełny kod źródłowy z komentarzami.

• README.md z instrukcją.

• Przykład settings.json.

🛠️ Zalecane technologie

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

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