717dc44b3b
- 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.
143 lines
6.7 KiB
Markdown
143 lines
6.7 KiB
Markdown
# 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.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
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.
|
|
|
|
### Sincronizzazione cookie
|
|
- 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. |