# Portfolio Manager - Guida Launcher

Questa guida spiega come configurare il lancio dell'applicazione con un semplice doppio click, simile ai file `.bat` di Windows.

## 📁 File Creati

### 1. `portfolio-manager.sh` - Script di Lancio
Script bash che:
- Attiva automaticamente il virtual environment
- Verifica che le dipendenze siano installate
- Lancia l'applicazione
- Mostra errori se qualcosa va storto

### 2. `portfolio-manager.desktop` - Desktop Entry
File di integrazione per il desktop environment Linux (GNOME, KDE, XFCE, etc.) che permette di:
- Aggiungere l'app al menu applicazioni
- Creare icone sul desktop
- Usare come file "eseguibile" cliccabile

---

## 🚀 Metodo 1: Doppio Click sullo Script (Più Semplice)

### Passo 1: Verifica Permessi
Lo script è già eseguibile, ma se necessario:
```bash
chmod +x portfolio-manager.sh
```

### Passo 2: Lancia con Doppio Click

**Opzione A - Dal File Manager**:
1. Apri il file manager (Nautilus, Dolphin, Thunar, etc.)
2. Naviga a `/mnt/ssd/data/python-lab/portfolio-manager/`
3. Doppio click su `portfolio-manager.sh`
4. Seleziona "Esegui" o "Esegui nel Terminale" (dipende dal file manager)

**Opzione B - Da Terminale**:
```bash
cd /mnt/ssd/data/python-lab/portfolio-manager
./portfolio-manager.sh
```

### Note
- Lo script mostra messaggi di errore se:
  - Virtual environment non trovato
  - PyQt6 non installato
  - Applicazione crasha

---

## 🖥️ Metodo 2: Integrazione Desktop (Come Applicazione Installata)

### Passo 1: Copia Desktop Entry
```bash
cp portfolio-manager.desktop ~/.local/share/applications/
```

### Passo 2: Aggiorna Database Applicazioni
```bash
# Su GNOME/Ubuntu
update-desktop-database ~/.local/share/applications/

# Su KDE
kbuildsycoca5
```

### Passo 3: Trova l'Applicazione
- Apri il menu applicazioni (GNOME Activities, KDE Application Launcher, etc.)
- Cerca "Portfolio Manager"
- Click per lanciare

### Opzionale: Aggiungi al Desktop
```bash
# Copia anche sul desktop
cp portfolio-manager.desktop ~/Desktop/
chmod +x ~/Desktop/portfolio-manager.desktop
```

### Opzionale: Aggiungi ai Preferiti
- Click destro sull'icona nel menu
- "Aggiungi ai preferiti" o "Pin to taskbar"

---

## 🎨 Personalizza Icona (Opzionale)

Il file `.desktop` usa l'icona generica `accessories-calculator`. Per usare un'icona custom:

### Passo 1: Crea o Scarica Icona
- Formato: PNG o SVG
- Dimensione: 256x256 px (consigliato)
- Nome: `portfolio-manager.png`

### Passo 2: Copia in Directory Icone
```bash
# Icone locali utente
mkdir -p ~/.local/share/icons/hicolor/256x256/apps/
cp portfolio-manager.png ~/.local/share/icons/hicolor/256x256/apps/

# Aggiorna cache icone
gtk-update-icon-cache ~/.local/share/icons/hicolor/
```

### Passo 3: Modifica Desktop Entry
Cambia la riga `Icon=` in `portfolio-manager.desktop`:
```ini
Icon=portfolio-manager
```

Poi ri-copia il file:
```bash
cp portfolio-manager.desktop ~/.local/share/applications/
```

---

## 🔧 Troubleshooting Launcher

### "Permission denied" quando lancio lo script
```bash
chmod +x portfolio-manager.sh
```

### "Virtual environment not found"
Lo script cerca `.venv/` nella stessa directory. Verifica che esista:
```bash
ls -la .venv/
```

Se mancante, crea:
```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

### Desktop entry non appare nel menu
1. Verifica che il file sia in `~/.local/share/applications/`
2. Verifica permessi: `chmod +x ~/.local/share/applications/portfolio-manager.desktop`
3. Ricarica database: `update-desktop-database ~/.local/share/applications/`
4. Logout/login o riavvia desktop environment

### Doppio click apre editor invece di eseguire
Dipende dalle impostazioni del file manager:

**Nautilus (GNOME/Ubuntu)**:
- Preferenze → Behavior → Executable Text Files → "Run them"

**Dolphin (KDE)**:
- Settings → Configure Dolphin → General → Execute Script Files

**Thunar (XFCE)**:
- Edit → Preferences → Advanced → Execute shell scripts when clicked

---

## 📋 Confronto Metodi

| Metodo | Pros | Cons | Best For |
|--------|------|------|----------|
| **Script .sh** | Semplice, mostra errori | Serve file manager configurato | Uso quotidiano |
| **Desktop Entry** | Integrazione completa, icona menu | Setup iniziale richiesto | Installazione "permanente" |
| **Terminale** | Massimo controllo, debug facile | Richiede comandi | Sviluppo/debug |

---

## 🪟 Equivalente Windows (Future)

Per Windows, creare `portfolio-manager.bat`:
```batch
@echo off
cd /d "%~dp0"
if not exist .venv (
    echo Error: Virtual environment not found!
    pause
    exit /b 1
)
call .venv\Scripts\activate.bat
python main.py
if errorlevel 1 pause
```

---

## 🎯 Quick Reference

**Lancio Veloce**:
```bash
./portfolio-manager.sh
```

**Installazione Desktop Entry**:
```bash
cp portfolio-manager.desktop ~/.local/share/applications/
update-desktop-database ~/.local/share/applications/
```

**Verifica Script**:
```bash
bash -x portfolio-manager.sh  # Debug mode
```

**Logs**:
- Application logs: `portfolio.log`
- Script errors: mostrati nel terminale

---

## ✅ Checklist Setup Completo

- [ ] Virtual environment creato (`.venv/`)
- [ ] Dipendenze installate (`pip install -r requirements.txt`)
- [ ] Script eseguibile (`chmod +x portfolio-manager.sh`)
- [ ] Desktop entry copiato (opzionale)
- [ ] Icona personalizzata (opzionale)
- [ ] Test lancio con doppio click

**Una volta completata la checklist, l'app è pronta per l'uso quotidiano!** 🚀