Files
Mimante/README.md
Alberto Balbo 717dc44b3b Aggiornamento alla versione 3.0.0
- Rimosse funzionalità legacy legate a WebView2.
- Introdotto uno stile globale per i pulsanti.
- Semplificata l'interfaccia con gestione tramite griglia unica.
- Aggiunti comandi per avviare, mettere in pausa e fermare aste.
- Introdotta gestione manuale dei cookie tramite dialog.
- Aggiunti dialog per configurare sessione e aggiungere aste.
- Migliorata la persistenza con salvataggio sicuro (DPAPI).
- Rifattorizzate statistiche per utilizzare `BidHistory` e `BidderStats`.
- Ottimizzato il polling per ridurre il carico di sistema.
- Aggiornata esportazione CSV con dati più dettagliati.
- Introdotti nuovi modelli dati per utente e banner aste.
- Rimossi file di test manuale e codice obsoleto.
- Aggiornata documentazione per riflettere le modifiche.
- Aggiunta nuova icona dell'applicazione.
- Migliorata la sicurezza eliminando il salvataggio in chiaro dei cookie.
2025-10-28 12:45:08 +01:00

6.7 KiB

AutoBidder - Guida completa all'uso

AutoBidder è uno strumento desktop per Windows (WPF, .NET 8) pensato per automatizzare le offerte sul sito Bidoo.com. Questa guida descrive caratteristiche, installazione, configurazione, modalità operative, strategie avanzate, dettagli tecnici e risoluzione dei problemi.

Version .NET


Sommario

  • Caratteristiche principali
  • Requisiti di sistema
  • Installazione e avvio
  • Guida rapida (primi passi)
  • Gestione aste tramite griglia
  • Strategie e consigli pratici
  • Dettagli tecnici: Polling e Click HTTP
  • Impostazioni e persistenza
  • Esportazione e diagnostica
  • FAQ e risoluzione problemi
  • Changelog sintetico

Caratteristiche principali

  • Monitoraggio in tempo reale di tutte le aste tramite griglia unica
  • Polling adattivo solo HTTP per ridurre uso di CPU e RAM
  • Click HTTP diretto (reverse engineered) con cookie manuale
  • Persistenza della lista aste (auctions.json) e esportazione CSV delle statistiche
  • UI dark theme moderna con griglia in tempo reale, dettagli asta, log e contatori

Requisiti di sistema

  • Windows 10 (1809+) o Windows 11
  • .NET 8.0 Runtime
  • RAM: 4 GB (consigliati 8 GB)
  • Connessione internet stabile

Installazione e avvio

  1. Assicurarsi di avere .NET 8.0 Runtime installato: dotnet --version (output: 8.0.x)
  2. Clonare il repository (privato):
    • git clone https://192.168.30.23/Alby96/Mimante
  3. Costruire il progetto:
    • dotnet restore
    • dotnet build --configuration Release
  4. Eseguire l'app:
    • dotnet run (dalla cartella del progetto) oppure avviare AutoBidder.exe in bin\Release\net8.0-windows

Guida rapida (primi passi)

  1. Avvia l'app: l'interfaccia principale mostra la griglia delle aste monitorate.
  2. Configura la sessione: copia il cookie __stattrb dal browser (F12 > Application > Cookies) e inseriscilo tramite il dialog di configurazione.
  3. Aggiungi aste: usa il pulsante + Aggiungi per inserire URL o ID delle aste da monitorare.
  4. Configura impostazioni per ogni asta (Timer Click, Min/Max Price, Max Clicks, Max Resets, Ritardo).
  5. Premi Avvia Tutti per attivare il monitoraggio e le puntate automatiche.

Gestione aste tramite griglia

  • Tutte le aste sono gestite tramite una griglia unica.
  • Puoi avviare, mettere in pausa, fermare o puntare manualmente su ogni asta direttamente dalla griglia.
  • Non esistono più modalità "Asta Singola" o "Multi-Asta": tutto è gestito in modo uniforme.

Strategie consigliate

  • Monitoraggio massivo: aggiungi molte aste tramite URL o ID, imposta Timer Click basso e limiti di prezzo.
  • Asta ad alto valore: Timer Click 0-1, Ritardo 0ms.
  • Caccia all'affare: Max Price basso, monitora molte aste con Timer Click 0.

Approfondimento tecnico

Polling adattivo

  • Il monitoraggio avviene solo tramite chiamate HTTP dirette alle API di Bidoo.
  • Nessun WebView2 viene utilizzato, nemmeno come fallback.
  • Il polling si adatta al timer dell'asta per ottimizzare la frequenza delle richieste.

Click HTTP diretto

  • Al momento dell'azione, il client costruisce una GET verso l'endpoint reverse engineered di Bidoo tipo: GET https://it.bidoo.com/bid.php?AID=81204347&sup=0&shock=0
  • Richiede i cookie di sessione (__stattrb) che vengono copiati manualmente dal browser.
  • Latenza tipica: 10-30ms.
  • Non esiste più alcun fallback WebView2: tutte le puntate sono gestite solo via HTTP.
  • I cookie vengono inseriti manualmente dall'utente tramite dialog.
  • Non vengono mai salvati su disco in chiaro.
  • Se il cookie scade, è necessario copiarlo nuovamente dal browser.

Persistenza e file locali

  • Lista aste manuali salvata in: %AppData%\AutoBidder\auctions.json
  • La lista viene ricaricata automaticamente all'avvio dell'app.
  • Esportazione CSV: la funzionalità Export CSV genera un file contenente statistiche per ogni asta (nome, ID, URL, timer, prezzo, strategy, click/resets, impostazioni per-asta).

Impostazioni principali

  • Timer Click (0-8): secondo del countdown al quale si desidera effettuare il click (0 = 0.0-0.9s)
  • Max Clicks / Max Resets: limiti operativi (0 = illimitato)
  • Min/Max Price: evita puntate fuori dal range desiderato
  • Ritardo (ms): delay aggiuntivo prima di inviare il click

Interfaccia e controlli

  • Griglia centrale: mostra tutte le aste monitorate con controlli per avviare, mettere in pausa, fermare e puntare manualmente.
  • Log in tempo reale per ogni asta con dettagli di latenza, risposta server e fallimenti.

Diagnostica ed esportazione

  • Abilita log dettagliato prima di aprire issue o per analisi locali
  • Usa Export CSV per conservare storici e confrontare strategie
  • Mantieni screenshot del pannello log per report più chiari

FAQ e risoluzione dei problemi

  • "Non vedo Click HTTP riuscito": assicurati di aver inserito correttamente il cookie dal browser e che la sessione sia valida.
  • "Aste non rilevate": aggiungi manualmente gli URL o ID delle aste.
  • "Il programma non si avvia": verifica .NET 8.0 Runtime installato e che il build sia andato a buon fine.
  • "Click non funzionano": verifica Timer Click, limiti di prezzo, connessione internet e validità del cookie.

Avvisi e responsabilità

  • L'automazione potrebbe violare i Termini di Servizio di Bidoo. L'uso è a rischio e responsabilità dell'utente.
  • Non salvare credenziali su disco: l'app non memorizza login, usa solo il cookie manuale.
  • Cookie e dati di sessione rimangono in memoria e vengono rimossi alla chiusura dell'app.

Changelog sintetico (ultime versioni)

  • v3.0: Solo HTTP, nessun WebView2, cookie manuale, interfaccia unica su griglia
  • v2.10: Click HTTP diretto, sincronizzazione cookie automatica, miglioramenti prestazionali
  • v2.9: Persistenza automatica, UI improvements, export CSV
  • v2.8: Polling adattivo e strategie ibride

Supporto

  • Repository privato Gitea: https://192.168.30.23/Alby96/Mimante
  • Per problemi tecnici aprire issue nel repository privato (se abilitato) o contattare il manutentore del progetto.

Note tecniche per sviluppatori

  • Progetto target: .NET 8.0 (WPF)
  • Aree chiave del codice:
    • Services\BidooApiClient.cs — gestione Click HTTP e parsing risposte
    • Services\AuctionMonitor.cs — loop di polling
    • Services\SessionManager.cs — gestione cookie manuale
    • Utilities\PersistenceManager.cs — salvataggio/ricaricamento auctions.json
    • ViewModels\AuctionViewModel.cs + XAML corrispondenti — visualizzazione e binding UI

Contributi

  • Questo repository è privato. Per contribuire, aprire PR verso branch main e seguire le convenzioni del progetto.

Licenza

  • Privato — non distribuire senza autorizzazione del proprietario.

Buona fortuna con le aste e usa AutoBidder responsabilmente.