# Warren AI - Reports Archive

Questa directory contiene i report HTML storicizzati generati dagli scan settimanali.

## Struttura Directory

```
reports/
├── latest/                              # ← Ultimi report (sempre aggiornati)
│   ├── warren_scan_IT_latest.html
│   ├── warren_scan_FR_latest.html
│   ├── warren_scan_DE_latest.html
│   └── warren_scan_USA_latest.html
│
├── 2025-11-24/                          # ← Scansione domenica 24 Nov 2025
│   ├── warren_scan_IT_20251124_0900.html
│   ├── warren_scan_FR_20251124_0900.html
│   ├── warren_scan_DE_20251124_0900.html
│   └── warren_scan_USA_20251124_0900.html
│
├── 2025-12-01/                          # ← Scansione domenica 1 Dic 2025
│   ├── warren_scan_IT_20251201_0900.html
│   ├── warren_scan_FR_20251201_0900.html
│   ├── warren_scan_DE_20251201_0900.html
│   └── warren_scan_USA_20251201_0900.html
│
└── README.md                            # ← Questo file
```

## Retention Policy

**Storico**: Ultimi **90 giorni** (automaticamente ripuliti)

**Latest**: Sempre mantenuti (ultimi 4 file per ogni mercato)

## Git Tracking

**Tracciato**: Solo `latest/` (per backup ultimi report)

**Ignorato**: Tutte le directory storiche `YYYY-MM-DD/` (troppo voluminoso)

## Uso

### Accesso Rapido
```bash
# Apri ultimo report Italia
open reports/latest/warren_scan_IT_latest.html

# Apri ultimo report Francia
open reports/latest/warren_scan_FR_latest.html
```

### Confronto Storico
```bash
# Confronta raccomandazioni tra 2 settimane
diff reports/2025-11-24/warren_scan_IT_20251124_0900.html \
     reports/2025-12-01/warren_scan_IT_20251201_0900.html
```

### Analisi Trend
```python
# Script esempio per analisi trend
import glob
from bs4 import BeautifulSoup

# Trova tutti i report IT storici
it_reports = sorted(glob.glob("reports/*/warren_scan_IT_*.html"))

for report_path in it_reports:
    # Parse HTML e estrai raccomandazioni STRONG BUY
    with open(report_path) as f:
        soup = BeautifulSoup(f, 'html.parser')
        strong_buys = soup.find_all('tr', class_='strong-buy')
        print(f"{report_path}: {len(strong_buys)} STRONG BUY")
```

## Backup

I report in `latest/` sono tracciati in Git come backup. Per un backup completo:

```bash
# Backup locale con compressione
tar -czf warren_reports_backup_$(date +%Y%m%d).tar.gz reports/

# Backup su cloud (esempio rsync)
rsync -avz reports/ user@backup-server:/backups/warren-ai/reports/
```

## Manutenzione

### Cleanup Manuale (se necessario)
```bash
# Rimuovi report più vecchi di 180 giorni
find reports/ -type d -name "20*" -mtime +180 -exec rm -rf {} \;

# Verifica spazio occupato
du -sh reports/*/ | sort -h
```

### Statistiche
```bash
# Conta report per mercato
ls -1 reports/latest/ | wc -l  # Dovrebbe essere 4

# Conta settimane archiviate
ls -1d reports/20*/ | wc -l

# Spazio totale occupato
du -sh reports/
```

## Troubleshooting

### Report Mancante in latest/
Se `latest/` non contiene un mercato:
```bash
# Riesegui scan per quel mercato
python warren_scan.py --market IT
```

### Troppo Spazio Occupato
Riduci retention policy modificando `warren_scan.py`:
```python
retention_days = 30  # Default: 90
```

### Report Corrotto
I report sono file HTML statici. Se corrotto:
1. Controlla ultima copia buona in storico `YYYY-MM-DD/`
2. Riesegui scan per rigenerare

---

**Generato automaticamente da**: `warren_scan.py`
**Retention**: 90 giorni
**Formato**: HTML statico (no database, portable)