# 🚀 Portfolio Manager - START HERE

## Lancio Veloce (TL;DR)

```bash
# Metodo più semplice: doppio click su
./portfolio-manager.sh

# Oppure da terminale
./portfolio-manager.sh
```

---

## 📦 Stato Installazione

✅ **Applicazione**: Completamente implementata e funzionante
✅ **Database**: SQLite creato in `data/portfolio.db`
✅ **Dipendenze**: Tutte installate in `.venv/`
✅ **Launcher**: Script `.sh` pronto per doppio click

---

## 🎯 Primi Passi

### 1. Lancia l'Applicazione

**Doppio click su**: `portfolio-manager.sh`

Oppure:
```bash
./portfolio-manager.sh
```

### 2. Aggiungi i Tuoi Holdings

**Tab Snapshot → Click "Add Holding"**

Esempio portafoglio 180k EUR:
- **VWCE.MI** (ETF World) - 1200 shares @ €95.50
- **MEUD.MI** (ETF Europe) - 450 shares @ €75.20
- **AZM.MI** (Stock Italy) - 176 shares @ €34.26
- **CASH** (Liquidità) - 12000 @ €1.00

### 3. Aggiorna Prezzi

**Tab Snapshot → Click "🔄 Update Prices"**

Fetcha prezzi real-time da Yahoo Finance

### 4. Registra Transazioni

**Tab Transactions → Click "Buy" / "Sell" / "Dividend"**

Ogni transazione aggiorna automaticamente holdings e P&L

### 5. Visualizza Analytics

**Tab Analytics**

- Performance totale
- Allocazione per tipo/geografia
- Risk metrics con warnings
- Top 5 holdings

---

## 📚 Documentazione

| File | Descrizione |
|------|-------------|
| [README.md](README.md) | Documentazione completa |
| [QUICKSTART.md](QUICKSTART.md) | Guida rapida uso |
| [LAUNCHER_GUIDE.md](LAUNCHER_GUIDE.md) | Setup launcher e desktop entry |
| [TROUBLESHOOTING.md](TROUBLESHOOTING.md) | Risoluzione problemi comuni |

---

## 🔧 Comandi Utili

```bash
# Verifica installazione
./check_app.sh

# Lancia applicazione
./portfolio-manager.sh

# Attiva venv manualmente
source .venv/bin/activate

# Backup database
cp data/portfolio.db data/portfolio.db.backup

# Visualizza logs
tail -f portfolio.log
```

---

## 💡 Features Principali

### Tab Snapshot
- ✅ Visualizzazione portafoglio real-time
- ✅ Update prezzi (yfinance + cache 4h)
- ✅ P&L colorato (verde +, rosso -)
- ✅ Weight % automatico
- ✅ Add/Delete holdings

### Tab Transactions
- ✅ Log completo BUY/SELL/DIVIDEND
- ✅ Filtri per Type e Ticker
- ✅ Auto-update holdings su transazioni
- ✅ Realized P&L su sell

### Tab Analytics
- ✅ Performance summary
- ✅ Allocation (Type, Geography)
- ✅ Risk warnings (>40% yellow, >60% red)
- ✅ Diversification score
- ✅ Top 5 holdings

---

## ⚠️ Note Importanti

### Tickers
Usa formato Yahoo Finance:
- ✅ `VWCE.MI` (Milano)
- ✅ `AZM.MI` (Milano)
- ❌ `VWCE` (manca exchange)

### Cash Position
Aggiungi come holding separato:
- Ticker: `CASH`
- Type: `Cash`
- Quantity: importo in EUR
- Avg Price: `1.00`

### Database
- Auto-creato al primo avvio
- Location: `data/portfolio.db`
- Backup: File → Backup Database

### Logging
- Tutti gli eventi in `portfolio.log`
- Level: DEBUG
- Utile per troubleshooting

---

## 🎨 Integrazione Desktop (Opzionale)

Aggiungi al menu applicazioni:

```bash
cp portfolio-manager.desktop ~/.local/share/applications/
update-desktop-database ~/.local/share/applications/
```

Cerca "Portfolio Manager" nel menu.

---

## 🐛 Problemi Comuni

### Qt platform plugin error
```bash
sudo apt-get install -y libxcb-cursor0
```

### Virtual environment not found
```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

### Permission denied
```bash
chmod +x portfolio-manager.sh
```

**Per altri problemi**: Vedi [TROUBLESHOOTING.md](TROUBLESHOOTING.md)

---

## 📊 Esempio Workflow Completo

1. **Lancia**: `./portfolio-manager.sh`
2. **Add Holdings** (Tab Snapshot):
   - VWCE.MI (1200 @ 95.50)
   - MEUD.MI (450 @ 75.20)
   - AZM.MI (176 @ 34.26)
   - CASH (12000 @ 1.00)
3. **Update Prices** (Tab Snapshot)
4. **Verifica P&L** (colori verde/rosso)
5. **Registra Buy** (Tab Transactions):
   - AZM.MI: 50 shares @ 32.00
6. **Verifica Snapshot** aggiornato (226 shares)
7. **Registra Dividend** (Tab Transactions):
   - AZM.MI: €150 (Q4 2025)
8. **Visualizza Analytics** (Tab Analytics):
   - Performance totale
   - Allocation 89.9% ETF / 3.4% Stock / 6.7% Cash
   - Max holding: VWCE.MI 70.2% ⚠️
9. **Chiudi App** (tutto salvato in DB)

---

## 🎯 Target Portfolio

**Obiettivo**: 180k EUR
- Core ETF: 160k (89%)
- Satellite Stock: 20k (11%)
- Cash: 12k (6.7%)

**Asset Allocation**:
- VWCE.MI: 70% (World diversification)
- MEUD.MI: 20% (Europe exposure)
- AZM.MI: 3.4% (Italy satellite)
- Cash: 6.7% (liquidity buffer)

**Deadline**: 2026-01-01 ✅

---

## ✨ Features Future (Post-MVP)

- [ ] Performance charts storici
- [ ] Benchmark comparison (FTSE MIB, S&P 500)
- [ ] Export PDF/Excel reports
- [ ] Multi-currency support
- [ ] Dark theme (QSS)
- [ ] Tax reporting (capital gains)
- [ ] Mobile companion app

---

## 🚀 Pronti a Partire!

L'applicazione è **completamente funzionante** e pronta per tracciare il tuo portafoglio 180k EUR.

**Next Step**: Doppio click su `portfolio-manager.sh` 🎉

---

**Version**: 1.0
**Tech Stack**: Python 3.12 • PyQt6 • SQLite • yfinance
**Platform**: Linux (Ubuntu/Debian tested), cross-platform ready
**License**: Personal Use