Mimante/README.md

AutoBidder v4.0 - Guida Completa

AutoBidder è un'applicazione desktop per Windows realizzata con WPF e .NET 8.0, progettata per il monitoraggio e la gestione automatizzata di aste online sulla piattaforma Bidoo. L'applicazione utilizza polling HTTP per monitorare in tempo reale lo stato delle aste e inviare offerte automatiche tramite richieste HTTP dirette, senza necessità di automazione browser.

---

Indice

1. Panoramica
2. Requisiti di Sistema
3. Installazione
4. Interfaccia Utente
5. Configurazione Sessione
6. Monitoraggio Aste
7. Browser Integrato
8. Statistiche e Analisi
9. Impostazioni e Configurazione
10. Export Dati
11. Dettagli Tecnici
12. FAQ e Troubleshooting
13. Sicurezza e Responsabilità

---

Panoramica

AutoBidder offre un'interfaccia dashboard moderna con layout modulare che permette di monitorare simultaneamente più aste, visualizzare statistiche in tempo reale e configurare strategie di bidding personalizzate. L'architettura dell'applicazione è stata progettata per massimizzare le prestazioni minimizzando l'utilizzo di risorse di sistema.

Caratteristiche Principali

Monitoraggio Multi-Asta

• Gestione simultanea di un numero illimitato di aste
• Polling HTTP adattivo che regola la frequenza delle richieste in base allo stato dell'asta
• Tracking real-time di timer, prezzo corrente, ultimo offerente e numero di reset
• Statistiche dettagliate per ogni asta con log dedicato e lista utenti partecipanti

Invio Offerte Automatico

• Puntate inviate tramite richieste HTTP GET dirette agli endpoint Bidoo
• Configurazione precisa del timing con granularità al secondo (0-8 secondi countdown)
• Delay configurabile in millisecondi per ottimizzare la precisione dell'invio
• Limiti di prezzo minimo/massimo per controllo automatico delle spese
• Limite massimo di click per asta per gestire il budget di puntate

Dashboard Moderna

• Layout a griglia con 6 pannelli ridimensionabili tramite GridSplitter
• Dark theme professionale con palette colori consistente
• Log globale e log per singola asta con codifica colore per severità
• Lista utenti partecipanti con statistiche dettagliate
• Pannello impostazioni dedicato per configurazione real-time parametri asta

Browser Integrato

• WebView2 basato su Microsoft Edge Chromium
• Navigazione completa su Bidoo.com
• Aggiunta rapida aste dall'URL corrente
• Menu contestuale personalizzato per azioni rapide
• Sincronizzazione cookie con sessione applicazione

---

Requisiti di Sistema

Sistema Operativo

• Windows 10 (build 1809 o successiva)
• Windows 11 (tutte le versioni)

Software Richiesto

• .NET 8.0 Runtime o SDK
• WebView2 Runtime (solitamente già installato su Windows 11)

Hardware Consigliato

• CPU: Dual-core 2.0 GHz o superiore
• RAM: 4 GB minimo, 8 GB consigliato
• Spazio disco: 200 MB per l'applicazione
• Connessione Internet: stabile con latenza < 100ms verso server Bidoo

---

Installazione

Installazione da Sorgente

1. Verificare .NET 8.0

   dotnet --version
   

   L'output dovrebbe mostrare 8.0.x. Se non installato, scaricarlo da dot.net.

2. Clonare il Repository

   git clone https://192.168.30.23/Alby96/Mimante
   cd Mimante/Mimante
   

3. Restore Dipendenze

   dotnet restore
   

4. Build del Progetto

   dotnet build --configuration Release
   

5. Eseguire l'Applicazione

   dotnet run
   

   oppure avviare l'eseguibile da bin\Release\net8.0-windows\AutoBidder.exe

Installazione WebView2 Runtime

Se WebView2 non è già installato:

1. Scaricare da microsoft.com/edge/webview2
2. Eseguire l'installer Evergreen Bootstrapper
3. Riavviare l'applicazione

---

Interfaccia Utente

L'interfaccia di AutoBidder è organizzata in una sidebar di navigazione verticale e un'area contenuto principale che mostra diverse schede.

Sidebar Navigazione

La sidebar a sinistra contiene 5 tab principali:

• Aste Attive: Dashboard principale con griglia aste monitorate e pannelli di controllo
• Browser: Browser integrato WebView2 per navigazione su Bidoo
• Puntate Gratis: Placeholder per funzionalità di ricerca puntate gratuite (in sviluppo)
• Dati Statistici: Analisi aste chiuse e raccomandazioni strategiche (in sviluppo)
• Impostazioni: Configurazione sessione, export e impostazioni globali

Layout Dashboard Aste Attive

Il pannello Aste Attive è diviso in 6 sezioni ridimensionabili:

Sezione Superiore

• Header con info utente (username, puntate disponibili, aste vinte)
• Pulsanti controllo globale: Avvia Tutti, Pausa Tutti, Ferma Tutti, Esporta
• Griglia aste monitorate (2/3 larghezza) con colonne: ID, Nome, Latenza, Stato, Timer, Prezzo, Ultimo offerente, Click, Reset, Azioni
• Log globale (1/3 larghezza) con timestamp e codifica colore

Sezione Inferiore (dettagli asta selezionata)

• Pannello Impostazioni: URL, pulsanti Apri/Copia/Esporta, campi Timer/Delay/Min/Max Price/Max Clicks, Reset
• Pannello Utenti: DataGrid con lista utenti partecipanti, conteggio puntate, timestamp ultima offerta, Pulisci
• Pannello Log Asta: Log dedicato per asta selezionata con Pulisci

Tutti i pannelli sono ridimensionabili trascinando i separatori GridSplitter verticali e orizzontali.

---

Configurazione Sessione

Per inviare puntate automatiche è necessario fornire ad AutoBidder il cookie di sessione autenticata del tuo account Bidoo. L'applicazione non gestisce login con username/password ma richiede l'inserimento manuale del cookie di sessione.

Ottenere il Cookie di Sessione

1. Aprire Chrome e navigare su https://it.bidoo.com
2. Effettuare il login con le proprie credenziali Bidoo
3. Aprire Developer Tools premendo F12
4. Navigare alla tab "Application"
5. Nel menu laterale andare su Storage ? Cookies ? https://it.bidoo.com
6. Copiare la stringa completa di tutti i cookie (formato: cookie1=value1; cookie2=value2; ...)

Configurare il Cookie nell'Applicazione

1. Aprire la scheda Impostazioni dalla sidebar
2. Nella sezione "Configurazione Sessione" incollare la stringa cookie nel campo di testo multi-line
3. Opzionale: Cliccare "Importa dal Browser" per tentare l'import automatico dai browser installati
4. Cliccare "Salva" per salvare le modifiche

La sessione viene salvata in modo sicuro usando DPAPI (Data Protection API) di Windows, cifrata per l'account utente corrente. Il cookie non viene mai salvato in chiaro su disco.

Verifica Sessione

Dopo aver configurato il cookie, l'applicazione:

• Mostrerà il nome utente nell'header della scheda Aste Attive
• Aggiornerà automaticamente il numero di puntate disponibili
• Abiliterà i pulsanti di controllo aste

Se il cookie scade o diventa invalido, sarà necessario ripetere la procedura di configurazione.

---

Monitoraggio Aste

Aggiungere Aste

Metodo 1: Da URL o ID

1. Cliccare "Aggiungi" nella griglia aste
2. Inserire uno o più URL/ID asta (uno per riga, o separati da spazio/punto e virgola)
3. Formati supportati:
   • URL completo: https://it.bidoo.com/auction.php?a=asta_123456
   • ID asta: 123456
   • Link diretto: it.bidoo.com/...
4. Cliccare OK per aggiungere

Metodo 2: Dal Browser Integrato

1. Navigare su Bidoo nel browser integrato
2. Aprire la pagina di un'asta
3. Cliccare "Aggiungi Asta" nella toolbar del browser
4. L'asta verrà aggiunta automaticamente alla griglia

Metodo 3: Menu Contestuale Browser

1. Nel browser integrato, fare click destro su un link di un'asta
2. Selezionare "Aggiungi Asta" dal menu contestuale
3. L'asta verrà estratta e aggiunta alla griglia

Configurare Parametri Asta

Dopo aver selezionato un'asta dalla griglia, il pannello Impostazioni in basso a sinistra mostra:

Timer Click (secondi 0-8)

• Specifica il secondo del countdown al quale inviare la puntata
• 0 = invia tra 0.0s e 0.9s
• 1 = invia tra 1.0s e 1.9s
• E così via fino a 8

Delay (millisecondi)

• Delay aggiuntivo da applicare dopo aver raggiunto il timer
• Valori tipici: 0-500ms
• Usare per fine-tuning della precisione

Min EUR / Max EUR

• Limiti di prezzo per controllo automatico
• Se impostati, l'applicazione non punterà se il prezzo esce da questi limiti
• Utile per evitare offerte su aste troppo costose

Max Clicks

• Numero massimo di puntate da inviare per questa asta
• 0 = nessun limite
• Dopo aver raggiunto questo limite, l'asta viene automaticamente fermata

Controllare le Aste

Avvio/Pausa/Ferma Singola Asta

• Usare i pulsanti "Avvia", "Pausa", "Ferma" nella colonna Azioni della griglia
• Avvia: inizia il monitoring e l'invio automatico puntate
• Pausa: sospende temporaneamente senza fermare il polling
• Ferma: arresta completamente il monitoring

Avvio/Pausa/Ferma Globale

• Usare i pulsanti nell'header per controllare tutte le aste simultaneamente
• Utile per avvio rapido di sessioni multi-asta

Puntata Manuale

• Cliccare "Punta" nella colonna Azioni per inviare un'offerta immediata
• Ignora timer e limiti configurati
• Utile per test o interventi manuali urgenti

Rimuovere Aste

• Selezionare un'asta dalla griglia
• Cliccare "Rimuovi" o premere il tasto Canc
• Confermare la rimozione nel dialog
• L'asta verrà rimossa dalla lista e il monitoring sarà arrestato

Persistenza

Le aste aggiunte vengono salvate automaticamente in %AppData%\AutoBidder\saved_auctions.json e ricaricate all'avvio dell'applicazione, mantenendo tutte le configurazioni (timer, limiti, stati).

---

Browser Integrato

La scheda Browser contiene un controllo WebView2 che offre un'esperienza di navigazione completa basata su Microsoft Edge Chromium.

Toolbar Browser

• ? ?: Pulsanti indietro/avanti
• ?: Ricarica pagina
• Home: Naviga alla homepage Bidoo
• Barra indirizzo: Mostra URL corrente, permette navigazione diretta
• Vai: Naviga all'URL inserito
• Aggiungi Asta: Aggiunge l'asta della pagina corrente alla griglia

Navigazione

Il browser si comporta come un browser standard:

• Click su link per navigare
• Form funzionano normalmente (login, ricerca, ecc.)
• JavaScript abilitato
• Cookie condivisi con la sessione applicazione

Menu Contestuale

Facendo click destro su un link nel browser:

• Aggiungi Asta: Estrae l'ID asta dal link e la aggiunge alla griglia
• Copia Link: Copia l'URL negli appunti

Sincronizzazione Cookie

I cookie del browser WebView2 sono sincronizzati con la sessione dell'applicazione. Se configurato un cookie nella scheda Impostazioni, questo sarà disponibile anche nel browser integrato, permettendo la navigazione autenticata.

---

Statistiche e Analisi

La scheda Dati Statistici è attualmente in fase di sviluppo e mostrerà in futuro:

Analisi Aste Chiuse

• Import e parsing di aste chiuse da file export o scraping diretto
• Aggregazione statistica: media prezzi finali, numero medio puntate, distribuzione oraria vincite
• Visualizzazione grafici e trend

Raccomandazioni Strategiche

• Suggerimenti automatici basati su dati storici
• Applicazione automatica di configurazioni ottimali per prodotti simili
• Machine learning per previsione prezzi e probabilità di vittoria

Database Locale

• Storage in SQLite con Entity Framework Core
• Schema ottimizzato per query analitiche
• Export/import dati per backup

---

Impostazioni e Configurazione

La scheda Impostazioni è divisa in 3 sezioni principali.

Configurazione Sessione

Campo Cookie

• Area di testo multi-line per incollare la stringa cookie completa
• Formati supportati: stringa cookie raw, solo token __stattrb, cookie separati da punto e virgola

Pulsanti

• Importa dal Browser: Tenta import automatico cookie da Chrome, Edge, Firefox
• Cancella: Pulisce il campo e resetta la sessione

Info Box

• Istruzioni dettagliate su come ottenere la stringa cookie completa
• Guida passo-passo per Chrome Developer Tools

Impostazioni Export

Percorso Export

• Path del folder dove salvare i file esportati
• Pulsante "Sfoglia" per selezione tramite dialog

Formato File

• CSV: Comma-Separated Values, compatibile con Excel
• JSON: JavaScript Object Notation, formato strutturato
• XML: Extensible Markup Language, formato gerarchico

Opzioni Export

• Includi solo puntate utilizzate: Esporta solo aste su cui sono state inviate offerte
• Includi log delle aste: Aggiunge ai file export il log completo di ogni asta
• Includi storico puntate utenti: Esporta la lista utenti partecipanti con statistiche
• Includi metadata delle aste: Aggiunge informazioni dettagliate (URL, impostazioni, timestamp)
• Rimuovi aste dopo l'export: Elimina automaticamente le aste dalla griglia dopo export riuscito
• Sovrascrivi file esistenti: Permette sovrascrittura senza conferma

Impostazioni Predefinite Aste

Valori che verranno applicati automaticamente a tutte le nuove aste aggiunte:

• Timer Click (secondi): Default 0
• Delay (millisecondi): Default 50
• Prezzo Minimo (€): Default 0 (nessun limite)
• Prezzo Massimo (€): Default 0 (nessun limite)
• Max Click: Default 0 (nessun limite)

Salvataggio Impostazioni

Cliccare il pulsante "Salva" nella barra inferiore per salvare tutte le modifiche apportate alle tre sezioni. Le impostazioni vengono salvate in file JSON locali e persistono tra le sessioni.

---

Export Dati

Export Massivo

1. Cliccare "Esporta" nell'header della scheda Aste Attive
2. Confermare nel dialog
3. Tutte le aste monitorate verranno esportate secondo le opzioni configurate
4. Un messaggio confermerà il numero di aste esportate e il path dei file

Export Singola Asta

1. Selezionare un'asta dalla griglia
2. Nel pannello Impostazioni, cliccare "Esporta"
3. Solo l'asta selezionata verrà esportata

Formati Export

CSV

AuctionId,Name,Url,Status,Timer,Price,Clicks,Resets
123456,"Prodotto XYZ","https://...",Closed,0,5.50,15,3

JSON

{
  "auctions": [
    {
      "auctionId": "123456",
      "name": "Prodotto XYZ",
      "url": "https://...",
      "status": "Closed",
      "finalPrice": 5.50,
      "myClicks": 15,
      "resetCount": 3,
      "log": [...],
      "bidders": [...]
    }
  ]
}

XML

<Auctions>
  <Auction>
    <AuctionId>123456</AuctionId>
    <Name>Prodotto XYZ</Name>
    ...
  </Auction>
</Auctions>

Preferenze Export

L'ultimo formato utilizzato viene salvato automaticamente e proposto come default per export successivi. Le preferenze sono memorizzate in %AppData%\AutoBidder\exportprefs.json.

---

Dettagli Tecnici

Architettura Applicazione

Pattern Utilizzati

• Partial Classes: MainWindow diviso in 13 file per responsabilità (Commands, AuctionManagement, Logging, UIUpdates, EventHandlers, ecc.)
• UserControls Modulari: 5 controlli riutilizzabili (AuctionMonitorControl, BrowserControl, SettingsControl, StatisticsControl, SimpleToolbar)
• MVVM Light: Separazione Model-View-ViewModel per logica UI
• Service Layer: Servizi dedicati (AuctionMonitor, BidooApiClient, SessionManager, StatsService)
• Repository Pattern: PersistenceManager per storage JSON

Struttura Progetto

AutoBidder/
??? Core/                    # MainWindow partial classes
??? Controls/                # UserControls WPF
??? Dialogs/                 # Finestre dialog
??? Models/                  # Data models
??? Services/                # Business logic
??? ViewModels/              # MVVM ViewModels
??? Utilities/               # Helper utilities
??? Data/                    # EF Core contexts
??? Documentation/           # Markdown docs

Polling HTTP

Meccanismo

• Richieste HTTP GET asincrone verso endpoint API Bidoo
• Parsing risposta JSON per estrarre stato asta (timer, prezzo, bidder)
• Frequenza adattiva: polling più frequente quando timer < 10s

Latenza

• Misurata e visualizzata per ogni asta nella colonna "Latenza"
• Valori tipici: 50-200ms per rete stabile
• Utilizzata per ottimizzare timing invio puntate

Threading

• Ogni asta ha un task asincrono dedicato
• Cancellation token per gestione pulita stop/pause
• Throttling per evitare overload server

Invio Puntate

Endpoint

GET /bid.php?AID={auctionId}&sup=0&shock=0
Cookie: __stattrb={token}; ...

Parametri

• AID: ID asta
• sup: Tipo puntata (0=normale)
• shock: Shock bid (0=disabilitato)

Headers

• Cookie: Stringa cookie sessione configurata
• User-Agent: Browser-like per evitare blocchi
• Referer: URL asta corrente

Gestione Risposta

• Success: HTTP 200 con corpo contenente nuovo timer/prezzo
• Failure: Errore di rete, sessione scaduta, bid già effettuato
• Retry: Nessun retry automatico, log dell'errore

WebView2 Runtime

Versione

• Basato su Microsoft Edge Chromium
• Stesso engine usato dal browser Edge
• Aggiornamenti automatici tramite Windows Update

Isolamento

• User Data Folder separato per applicazione
• Cookie storage dedicato
• Cache locale per performance

JavaScript

• Abilitato di default
• Accesso a Web APIs moderne (Fetch, Async/Await, ecc.)
• Nessun injection di script personalizzati

Database SQLite

Schema

CREATE TABLE AuctionStatistics (
    Id INTEGER PRIMARY KEY,
    AuctionId TEXT NOT NULL,
    ProductName TEXT,
    FinalPrice REAL,
    TotalBids INTEGER,
    WinnerUsername TEXT,
    ClosedAt DATETIME,
    PollingLatencyMs INTEGER
);

CREATE TABLE ProductInsights (
    Id INTEGER PRIMARY KEY,
    ProductName TEXT UNIQUE,
    AveragePrice REAL,
    AverageBids INTEGER,
    TotalAuctions INTEGER,
    RecommendedMaxPrice REAL,
    RecommendedMaxClicks INTEGER
);

ORM

• Entity Framework Core 8.0
• Code-First migrations
• Async queries per performance

Performance

Metriche Target

• CPU: < 5% idle, < 15% attivo con 10 aste
• RAM: ~100MB base + 10MB per 100 aste
• Latenza polling: 50-200ms media
• UI responsiveness: < 16ms per frame (60fps)

Ottimizzazioni

• Lazy loading UserControls (caricamento on-demand per tab)
• DataGrid virtualizzazione (rendering solo righe visibili)
• Async/await per tutte le operazioni I/O
• Throttling polling basato su stato asta
• String pooling per log messages

---

FAQ e Troubleshooting

Q: L'applicazione non invia puntate, perché?

A: Verificare:

1. Cookie di sessione configurato e valido nella scheda Impostazioni
2. Asta selezionata e in stato "Avviato" (non pausato o fermo)
3. Timer Click configurato (0-8 secondi)
4. Limiti prezzo non superati
5. Max Clicks non raggiunto
6. Connessione internet attiva

Controllare il Log Asta per messaggi di errore specifici.

Q: Come ottengo il cookie di sessione?

A: Segui la guida dettagliata nella sezione Configurazione Sessione. In breve: Chrome ? F12 ? Application ? Cookies ? bidoo.com ? copia tutti i valori.

Q: Il cookie smette di funzionare dopo un po', perché?

A: I cookie di sessione Bidoo hanno una scadenza (tipicamente 24-48 ore). Quando scadono è necessario effettuare nuovamente login su Bidoo e copiare un nuovo cookie. L'applicazione mostra un warning nel log quando rileva cookie invalido.

Q: Posso usare AutoBidder su più computer contemporaneamente?

A: Sì, ma ogni istanza deve avere il proprio cookie di sessione. Bidoo potrebbe invalidare sessioni se rileva login multipli simultanei da IP diversi. Usa con cautela.

Q: L'applicazione consuma troppa CPU/RAM, come ridurre?

A:

• Riduci il numero di aste monitorate simultaneamente
• Aumenta intervallo polling per aste con timer > 60s (configurabile in codice)
• Chiudi tab non utilizzate (Browser, Statistiche)
• Disabilita log dettagliati per singole aste

Q: WebView2 non si carica o mostra errore, cosa fare?

A:

1. Verificare che WebView2 Runtime sia installato: Pannello di Controllo ? Programmi ? WebView2
2. Se non installato, scaricarlo da microsoft.com/edge/webview2
3. Riavviare l'applicazione dopo installazione
4. Se persiste, reinstallare WebView2 Runtime

Q: Come esporto le statistiche di tutte le aste?

A: Cliccare "Esporta" nell'header della scheda Aste Attive. Configurare le opzioni export nella scheda Impostazioni prima dell'export. I file verranno salvati nel percorso configurato.

Q: Posso importare aste da un file?

A: Attualmente no. Le aste devono essere aggiunte manualmente via URL/ID. Feature in roadmap per versioni future.

Q: L'applicazione supporta proxy o VPN?

A: L'applicazione usa le impostazioni proxy di sistema di Windows. Configurare proxy in Impostazioni Windows ? Rete ? Proxy.

Q: Posso personalizzare i colori dell'interfaccia?

A: Non tramite UI. I colori sono hard-coded nel XAML. Per personalizzazioni, modificare i file *.xaml nella cartella del progetto.

Q: L'applicazione salva le password?

A: No. AutoBidder non gestisce password. Richiede solo il cookie di sessione che viene salvato cifrato con DPAPI Windows.

---

Sicurezza e Responsabilità

Disclaimer Importante

Termini di Servizio L'uso di strumenti di automazione potrebbe violare i Termini di Servizio della piattaforma Bidoo. L'utente è l'unico responsabile dell'uso che fa di AutoBidder. Gli sviluppatori non si assumono responsabilità per sospensioni account, perdite economiche o altre conseguenze derivanti dall'uso dell'applicazione.

Sicurezza Dati

Storage Cookie

• I cookie non vengono mai salvati in chiaro su disco
• Utilizzo di DPAPI (Data Protection API) di Windows per cifratura
• Chiave di cifratura legata all'account utente corrente Windows
• Impossibile decriptare da altri account o computer

Network Security

• Tutte le comunicazioni con Bidoo avvengono tramite HTTPS
• Nessuna trasmissione dati sensibili a server terzi
• L'applicazione non "telefona a casa" o invia telemetria

Privacy

• Nessun log remoto
• Nessuna raccolta analytics
• Tutti i dati rimangono in locale sul computer dell'utente

Best Practices

1. Non condividere il cookie di sessione con nessuno
2. Logout da Bidoo dopo aver copiato il cookie per invalidare vecchie sessioni
3. Non usare su computer pubblici o condivisi
4. Backup regolari di %AppData%\AutoBidder per preservare configurazioni
5. Aggiornare regolarmente l'applicazione per patch di sicurezza
6. Usare password sicure per l'account Windows (protegge DPAPI)

Limitazioni

• AutoBidder è un tool per uso personale, non commerciale
• Non distribuire o rivendere senza autorizzazione
• Il repository è privato: non pubblicare il codice sorgente
• Non usare per competizioni o tornei dove automazione è proibita

---

Supporto e Sviluppo

Repository Privato Gitea

https://192.168.30.23/Alby96/Mimante

Issue Tracker Per bug reports, feature requests o domande tecniche, aprire una Issue nel repository.

Contatti Per supporto diretto contattare il maintainer del progetto tramite Gitea.

Contributori Il progetto accetta Pull Requests secondo le convenzioni definite nel CONTRIBUTING.md (da creare).

Licenza Progetto privato - Tutti i diritti riservati. Non distribuire senza autorizzazione esplicita del proprietario.

---

AutoBidder v4.0 - Developed with ?? using .NET 8.0 and WPF

© 2024 - Per uso personale. Non distribuire.