Mimante/README.md

# ?? AutoBidder - Bidoo Automation Tool

> **Programma intelligente per automatizzare le offerte su Bidoo.com**  
> Monitora le aste in tempo reale e piazza offerte precise al secondo ottimale per massimizzare le probabilità di vincita.

![Version](https://img.shields.io/badge/version-2.7-blue)
![.NET](https://img.shields.io/badge/.NET-8.0-purple)
![Platform](https://img.shields.io/badge/platform-Windows-lightgrey)
![License](https://img.shields.io/badge/license-Private-red)

---

## ?? Indice

- [Caratteristiche Principali](#-caratteristiche-principali)
- [Requisiti di Sistema](#-requisiti-di-sistema)
- [Installazione](#-installazione)
- [Guida Rapida](#-guida-rapida)
- [Modalità Operative](#?-modalità-operative)
- [Funzionalità Avanzate](#-funzionalità-avanzate)
- [Impostazioni](#?-impostazioni)
- [FAQ](#-faq)
- [Changelog](#-changelog)
- [Documentazione Dettagliata](#-documentazione-dettagliata)

---

## ?? Caratteristiche Principali

### ? Automazione Intelligente
- **Click ultra-precisi** al secondo esatto del timer
- **Polling dinamico** (20-400ms) basato sul timer dell'asta
- **Lettura diretta** delle variabili JavaScript di Bidoo
- **Multi-click paralleli** per massima affidabilità

### ?? Due Modalità Operative

#### ?? Modalità Asta Singola
- Monitoraggio **intensivo** di una singola asta
- Statistiche in tempo reale (click, reset, prezzo)
- Elenco completo degli utenti competitori
- Log dettagliato di ogni operazione

#### ?? Modalità Multi-Asta
- Monitoraggio **simultaneo** di tutte le aste preferite
- **Auto-switch** sull'asta con timer più basso
- Gestione **indipendente** per ogni asta:
  - Impostazioni personalizzate (timer, prezzi)
  - Pausa/Riprendi per-asta
  - Log e statistiche separate
- Griglia in tempo reale con aggiornamenti istantanei

### ?? Interfaccia Moderna
- **Dark theme** professionale GitHub-style
- **Layout ridimensionabile** con GridSplitter
- **Visualizzazione dual-panel** (controlli + browser)
- **Indicatori visivi** di stato (verde = tua puntata, arancione = pausa)

### ?? Sicurezza
- Navigazione **limitata a Bidoo.com**
- **Blocco automatico** di link esterni
- **Validazione URL** su tutti i domini Bidoo internazionali

---

## ?? Requisiti di Sistema

### Minimi
- **Sistema Operativo:** Windows 10 (1809+) o Windows 11
- **Framework:** .NET 8.0 Runtime
- **RAM:** 4 GB
- **Spazio Disco:** 100 MB
- **Connessione Internet:** Stabile e veloce

### Consigliati
- **RAM:** 8 GB o superiore
- **Processore:** Quad-core o superiore
- **Connessione:** Fibra/ADSL (latenza < 50ms)

---

## ?? Installazione

### 1. Prerequisiti
```bash
# Scarica e installa .NET 8.0 Runtime Desktop
# https://dotnet.microsoft.com/download/dotnet/8.0
```

### 2. Clone Repository (Privato)
```bash
git clone https://192.168.30.23/Alby96/Mimante
cd Mimante\Mimante
```

### 3. Build
```bash
dotnet restore
dotnet build --configuration Release
```

### 4. Esecuzione
```bash
dotnet run
# oppure avvia AutoBidder.exe dalla cartella bin\Release\net8.0-windows
```

---

## ?? Guida Rapida

### Primo Avvio (Modalità Multi-Asta)

1. **Apertura automatica**  
   ? Il programma si apre direttamente sui **Preferiti di Bidoo**

2. **Aggiungi aste ai preferiti**  
   Naviga su Bidoo e clicca ? sulle aste che vuoi monitorare

3. **Avvia monitoraggio**  
   Clicca **"Avvia"** ? Le aste vengono scansionate automaticamente

4. **Seleziona un'asta** (opzionale)  
   Click sulla griglia ? Visualizza dettagli, log e utenti

5. **Personalizza** (opzionale)  
   Imposta Timer Click, Min/Max prezzo per ogni asta

6. **Osserva**  
   Il programma punta automaticamente sull'asta più vicina al momento del click

---

## ??? Modalità Operative

### ?? Asta Singola

**Quando usarla:**
- Focus totale su **un'asta specifica**
- Massima precisione e controllo
- Analisi dettagliata della competizione

**Workflow:**
```
1. Click "Asta Singola"
2. Naviga all'asta su Bidoo
3. Imposta Timer Click (0-8 secondi)
4. Click "Avvia"
5. Il programma punta al secondo esatto
```

**Impostazioni disponibili:**
- ?? **Timer Click:** Secondo del timer per puntare (0-8)
- ?? **Max Clicks:** Limite massimo di click (0 = illimitato)
- ?? **Max Resets:** Limite di reset dell'asta (0 = illimitato)
- ?? **Min/Max Price:** Range di prezzo accettabile
- ? **Ritardo (ms):** Delay aggiuntivo prima del click
- ??? **Multi-Click:** Click multipli paralleli per affidabilità

**Visualizzazione:**
- Contatori click/reset in tempo reale
- Prezzo corrente aggiornato
- Elenco utenti con numero puntate
- Log operazioni dettagliato

---

### ?? Multi-Asta

**Quando usarla:**
- Monitorare **10+ aste contemporaneamente**
- Puntare automaticamente sulla **più conveniente**
- Gestire più strategie simultaneamente

**Workflow:**
```
1. Click "Multi-Asta" (già attivo di default)
2. Le aste preferite vengono rilevate automaticamente
3. Click "Avvia"
4. Il programma sceglie autonomamente dove puntare
```

**Strategia automatica:**
```
1. Legge timer di tutte le aste
2. Identifica quella con timer più basso
3. Verifica limiti prezzo (se impostati)
4. Verifica se in pausa
5. Punta al momento giusto
```

**Griglia Aste - Colonne:**
- ?? **Asta:** Nome prodotto
- ?? **Timer:** Tempo rimanente (aggiornamento real-time)
- ?? **Prezzo:** Prezzo corrente
- ??? **Clicks:** Tue puntate su questa asta
- ?? **Resets:** Numero di reset rilevati
- ?? **Ultimo:** Ultimo utente che ha puntato

**Indicatori visivi:**
- ?? **Verde:** Tua ultima puntata
- ?? **Arancione:** Asta in pausa
- ?? **Blu:** Asta selezionata

---

## ??? Funzionalità Avanzate

### ?? Gestione Per-Asta (Multi-Asta)

**Seleziona un'asta** dalla griglia per accedere a:

#### Pannello Dettagli
```
???????????????????????????????????????
? ?? [Nome Asta]  [Pausa] [Riprendi] ?
???????????????????????????????????????
? Timer Click: [0]  Min€: [10]  Max€: [150] ?
???????????????????????????????????????
? Utenti su questa asta: 5            ?
? ???????????????????????????????    ?
? ? user1    12 puntate         ?    ?
? ? user2     8 puntate         ?    ?
? ? Tu        3 puntate         ?    ?
? ???????????????????????????????    ?
? ??????????????????????????????????? ?
? Log asta                            ?
? ???????????????????????????????    ?
? ? 10:23 - Click #1            ?    ?
? ? 10:24 - Reset #1            ?    ?
? ???????????????????????????????    ?
???????????????????????????????????????
```

#### Funzioni
- ?? **Pausa:** Stoppa temporaneamente questa asta (le altre continuano)
- ?? **Riprendi:** Riattiva l'asta
- ?? **Impostazioni:** Timer, Min/Max prezzo **solo per questa asta**
- ?? **Utenti:** Elenco ordinato per numero puntate
- ?? **Log:** Storico eventi specifico dell'asta

---

### ?? Analisi Competizione

**Griglia Utenti (Asta Singola):**
```
????????????????????????????????????
? Utente          Puntate  Ultima  ?
????????????????????????????????????
? user1           25       10:34   ?
? user2           18       10:33   ?
? Tu              12       10:35   ?  ? Le tue
? user3            3       10:30   ?
????????????????????????????????????
```

**Griglia Utenti Per-Asta (Multi-Asta):**
```
????????????????????????
? Utente    Puntate    ?
????????????????????????
? user1       5        ?
? user2       3        ?
? Tu          2        ?
????????????????????????
```

**Cosa puoi scoprire:**
- ?? Chi punta di più (competitor principale)
- ?? Livello di competizione sull'asta
- ? Pattern temporali delle puntate
- ?? Bot sospetti (troppi click)

---

## ?? Impostazioni

### Impostazioni Globali (Asta Singola)

| Impostazione | Range | Default | Descrizione |
|--------------|-------|---------|-------------|
| **Max Clicks** | 0-? | 0 | Limite click totali (0 = illimitato) |
| **Max Resets** | 0-? | 0 | Limite reset asta (0 = illimitato) |
| **Min Price €** | 0-? | 0 | Prezzo minimo per puntare (0 = no limite) |
| **Max Price €** | 0-? | 0 | Prezzo massimo (0 = no limite) |
| **Timer Click** | 0-8 | 0 | Secondo del timer per click |
| **Ritardo (ms)** | 0-2000 | 0 | Delay aggiuntivo prima del click |
| **Multi-Click** | On/Off | Off | Click multipli paralleli |

### Impostazioni Per-Asta (Multi-Asta)

| Impostazione | Descrizione |
|--------------|-------------|
| **Timer Click** | Momento del click **solo per questa asta** |
| **Min €** | Prezzo minimo **solo per questa asta** |
| **Max €** | Prezzo massimo **solo per questa asta** |
| **Pausa/Riprendi** | Stato **solo per questa asta** |

---

## ?? Controlli UI

### Pulsanti Principali

| Pulsante | Scorciatoia | Funzione |
|----------|-------------|----------|
| **Asta Singola** | - | Attiva modalità asta singola |
| **Multi-Asta** | - | Attiva modalità multi-asta |
| **Avvia** | - | Avvia automazione |
| **Pausa** | - | Pausa globale (tutte le aste) |
| **Stop** | - | Ferma automazione |

### Navigazione Browser

| Pulsante | Funzione |
|----------|----------|
| **Indietro** | Torna alla pagina precedente |
| **Aggiorna** | Ricarica la pagina corrente |
| **Vai** | Naviga all'URL inserito |

### Ridimensionamento

- **Pannello sinistro:** Trascina il separatore verticale ?
- **Griglia aste:** Trascina il separatore orizzontale ? (sopra dettagli)
- **Utenti/Log:** Trascina il separatore ? (tra utenti e log)

---

## ?? Strategie Consigliate

### Asta Singola - Oggetto di Valore Alto
```
Timer Click: 0-1 (molto aggressivo)
Max Price: [valore massimo disposto]
Multi-Click: ON
Ritardo: 0ms
```
**Perché:** Massima velocità su asta competitiva

### Multi-Asta - Aste a Basso Costo
```
Timer Click per asta: 2-3 (conservativo)
Min Price: 1€
Max Price: 20€
Pausa aste troppo alte
```
**Perché:** Punta solo su occasioni convenienti

### Multi-Asta - Caccia all'Affare
```
Max Price molto basso (es: 10€)
Timer Click: 0 (aggressivo)
Monitora 20+ aste
```
**Perché:** Prima o poi una scende sotto la soglia

---

## ? FAQ

### Come funziona il Timer Click?
Il **Timer Click** indica a quale **secondo** del countdown vuoi che il programma clicchi.  
- **Timer Click = 0** ? Clicca tra 0.0s e 0.9s
- **Timer Click = 1** ? Clicca tra 1.0s e 1.9s
- **Timer Click = 2** ? Clicca tra 2.0s e 2.9s

?? **Consiglio:** 0-1 per massima aggressività, 2-3 per essere conservativi

### Perché l'asta si resetta?
Un **reset** avviene quando qualcuno vince l'asta (timer arriva a 0). Il timer riparte e l'asta continua.  
Il programma **rileva automaticamente** i reset e mostra il vincitore.

### Posso puntare su più aste contemporaneamente?
**No**, il programma (in Multi-Asta) punta solo sull'asta con **timer più basso** in ogni momento.  
Questo massimizza l'efficienza evitando sprechi.

### Cosa succede se imposto Min/Max Price?
Il programma **salta il click** se il prezzo è fuori dal range:
- Prezzo < Min ? ?? Click bloccato
- Prezzo > Max ? ?? Click bloccato
- Nel range ? ? Click eseguito

### Come metto in pausa una singola asta?
1. Passa a **Multi-Asta**
2. **Seleziona** l'asta dalla griglia
3. Click **"Pausa"** nel pannello dettagli
4. Solo quella asta viene fermata, le altre continuano

### Il Multi-Click migliora le probabilità?
**Sì!** Invia **2 click paralleli** a 20ms di distanza per compensare lag di rete.  
?? Usa solo in Asta Singola su connessioni instabili.

### Posso usare AutoBidder su più computer?
**Tecnicamente sì**, ma **non consigliato**:
- Rischio di competere contro te stesso
- Spreco di click
- Ban potenziale da Bidoo

### È rilevabile da Bidoo?
Il programma **emula comportamento umano**:
- Usa il browser Microsoft Edge (WebView2)
- Click via JavaScript nativo
- Timing realistico

?? **Disclaimer:** Usa a tuo rischio. Bidoo potrebbe avere sistemi anti-bot.

---

## ?? Changelog

### v2.7 (Corrente) - Layout Verticale
- ? **Separazione verticale** Utenti/Log con GridSplitter
- ? **Margini ottimizzati** rispetto al bordo principale
- ? **MinHeight** garantito (80px) per entrambe le sezioni

### v2.6 - UI Polish & Auto-Navigation
- ? **Margini simmetrici** tra pannelli
- ? **Navigazione automatica** ai Preferiti all'avvio (Multi-Asta)
- ? **Smart URL check** evita reload inutili

### v2.5 - Bidders Per-Auction
- ? **Griglia utenti per-asta** con numero puntate
- ? **Layout 50/50 ridimensionabile** (Utenti | Log)
- ? **Aggiornamento real-time** quando qualcuno punta

### v2.4 - UI Refinements
- ? **Pausa/Riprendi per-asta** separati
- ? **Visual feedback** (aste in pausa colorate)
- ? **GridSplitter ingrandito** (12px) per migliore UX

### v2.3 - Multi-Auction Improvements
- ? **Log e bidders separati** per ogni asta
- ? **Impostazioni indipendenti** per-asta
- ? **Evidenziazione** riga verde quando è la tua puntata

### v2.2 - Per-Auction Management
- ? **Pannello dettagli asta selezionata**
- ? **Pausa individuale** (non globale)
- ? **Impostazioni personalizzate** per ogni asta

### v2.1 - Multi-Auction Core
- ? **Modalità Multi-Asta** implementata
- ? **Scansione automatica** aste preferite
- ? **Auto-switch** sull'asta con timer più basso
- ? **Griglia real-time** con 6 colonne

### v2.0 - Major Refactor
- ? **Dark theme** GitHub-style
- ? **Dual-panel layout** ridimensionabile
- ? **WebView2** integrato
- ? **Sicurezza navigazione** (solo Bidoo)

### v1.x - Initial Release
- ? **Automazione base** asta singola
- ?? **Lettura timer** da DOM
- ??? **Click automatico** al secondo target

---

## ?? Documentazione Dettagliata

### File di Documentazione (nella cartella progetto)

| File | Descrizione |
|------|-------------|
| `PROJECT_SUMMARY.md` | Panoramica completa del progetto |
| `CHANGELOG.md` | Storico completo delle modifiche |
| `QUICK_REFERENCE.md` | Riferimento rapido comandi |
| `MULTI_AUCTION_GUIDE.md` | Guida dettagliata modalità Multi-Asta |
| `MULTI_AUCTION_GRID_GUIDE.md` | Funzionamento griglia aste |
| `IMPLEMENTATION_SUMMARY.md` | Dettagli tecnici implementazione |

### Versioni Dettagliate

| File | Versione | Contenuto |
|------|----------|-----------|
| `v2.7_VERTICAL_LAYOUT.md` | 2.7 | Separazione verticale Utenti/Log |
| `v2.6_UI_POLISH.md` | 2.6 | Margini e auto-navigazione |
| `v2.5_BIDDERS_PER_AUCTION.md` | 2.5 | Griglia utenti per-asta |
| `v2.4_UI_REFINEMENTS.md` | 2.4 | Pausa per-asta e feedback visivi |
| `v2.3_MULTI_AUCTION_IMPROVEMENTS.md` | 2.3 | Log/bidders separati |
| `v2.2_PER_AUCTION_MANAGEMENT.md` | 2.2 | Gestione aste individuali |
| `v2.1_README.md` | 2.1 | Modalità Multi-Asta core |

---

## ?? Sicurezza e Privacy

### Navigazione Limitata
- ? **Solo domini Bidoo** consentiti (bidoo.com, .it, .fr, .es, .de)
- ? **Link esterni bloccati** automaticamente
- ? **Validazione URL** su ogni navigazione

### Dati Locali
- ? **Nessun dato inviato** a server esterni
- ? **Log solo in memoria** (mai salvati su disco)
- ? **Nessun tracking** o analytics

### Credenziali Bidoo
- ?? **Non salvate** dal programma
- ?? **Gestite da WebView2** (come Edge browser)
- ?? **Cancella cache browser** per logout completo

---

## ?? Supporto

### Problemi Comuni

**Il programma non si avvia:**
```bash
# Verifica .NET 8.0 installato
dotnet --version
# Output atteso: 8.0.x
```

**Click non funzionano:**
- Verifica di essere **loggato su Bidoo**
- Controlla impostazioni **Timer Click**
- Verifica **connessione internet stabile**

**Aste non rilevate (Multi-Asta):**
- Assicurati di essere sulla **pagina Preferiti**
- Clicca ? sulle aste per aggiungerle ai preferiti
- Clicca **"Avvia"** per avviare la scansione

**Navigazione bloccata:**
- Stai cercando di aprire un link **non-Bidoo**
- Solo i domini Bidoo sono consentiti per sicurezza

### Contatti

- ?? **Email:** [Alby96]
- ?? **Issues:** Repository privato Gitea
- ?? **Git:** `https://192.168.30.23/Alby96/Mimante`

---

## ?? Disclaimer

?? **Uso a Proprio Rischio**

Questo software è fornito "così com'è" senza garanzie di alcun tipo.  
L'uso di bot/automazione potrebbe **violare i Termini di Servizio di Bidoo**.

**Responsabilità dell'utente:**
- ? Verificare compatibilità con ToS Bidoo
- ? Usare in modo responsabile
- ? Non abusare del sistema
- ? Non creare account multipli
- ? Non utilizzare per frode

**L'autore non è responsabile per:**
- Ban o sospensioni account Bidoo
- Perdite finanziarie
- Malfunzionamenti del software
- Uso improprio del programma

---

## ?? Licenza

**Privato** - Non redistribuire senza autorizzazione

© 2024 Alby96. Tutti i diritti riservati.

---

## ?? Conclusione

**AutoBidder** è uno strumento potente per ottimizzare le tue strategie su Bidoo.  

### Punti di Forza
- ? **Precisione al millisecondo** nei click
- ? **Gestione multipla aste** simultanea
- ? **Controllo totale** su ogni parametro
- ? **Analisi competizione** dettagliata
- ? **Interfaccia intuitiva** e moderna

### Usa con Saggezza
- ?? Imposta **limiti di prezzo** ragionevoli
- ?? Non puntare su **troppe aste** contemporaneamente
- ?? Monitora il **budget** speso
- ?? **Pausa** le aste diventate troppo costose

---

**Buona fortuna con le tue aste! ????**

*Happy Bidding!*