Convertitore
Reader
diff --git a/docs/analysis.md b/docs/analysis.md
new file mode 100644
index 0000000..ec3336c
--- /dev/null
+++ b/docs/analysis.md
@@ -0,0 +1,98 @@
+# Analisi Completa del Progetto Bookish
+
+## 1. Analisi del Codice
+
+### QualitΓ Generale
+- **LeggibilitΓ **: Buona. Codice Python pulito con nomi descrittivi. JS ben strutturato.
+- **ManutenibilitΓ **: Alta. Modulare (routes/services/static). Ogni file ha una responsabilitΓ chiara.
+- **Type Safety**: Assente (Python). JS Γ¨ vanilla senza TypeScript. Accettabile per un progetto personale.
+
+### Punti di Forza
+- App factory pattern Flask (creazione configurabile)
+- SSE nativo senza dipendenze esterne
+- Thread-safe SSE manager con lock
+- Pulizia automatica file temporanei
+- Secure filename e path sanitization
+- Fallback ricerche porta libera
+- Formati validati dinamicamente lato server + client
+
+### Punti di Debolezza
+- **Nessun logging**: Manca logging strutturato per debug
+- **Error handling**: Le eccezioni in conversion thread vengono catturate ma non loggate
+- **Nessun rate limiting**: Upload illimitati (accettabile per uso singolo)
+- **CSS in unico file**: DiventerΓ grande con l'aggiunta di feature
+- **Reader JS monolitico**: `reader.js` gestisce EPUB, PDF e testo in un unico file (puΓ² essere suddiviso)
+- **Nessun test**: Il progetto non ha test automatici
+- **Markdown renderer**: Il simpleMarkdownToHtml Γ¨ minimale (non gestisce code block, elenchi annidati, tabelle)
+
+### Pattern e Convenzioni
+- Flask Blueprints per separazione route
+- Template Jinja2 con estensione base
+- JS in IIFE (Immediately Invoked Function Expression) per isolamento scope
+- CSS organizzato per sezioni (navbar, converter, reader)
+- Config centralizzata in config.py
+
+## 2. Analisi della Sicurezza
+
+| Asse | Valutazione | Note |
+|---|---|---|
+| Path traversal | β
Protetto | `os.path.basename()` + `secure_filename()` |
+| Upload dimensioni | β
Limitato | MAX_CONTENT_LENGTH = 50MB |
+| XSS (templates) | β
Protetto | Jinja2 auto-escape |
+| XSS (reader) | β οΈ Parziale | HTML renderizzato direttamente nel text viewer |
+| Command injection | β
Safe | Pandoc chiamato via libreria, non shell |
+| Secret key | β
Config | Tramite env var BOOKISH_SECRET |
+| CSRF | β οΈ Assente | Nessun token CSRF sui form (uso personale) |
+| Autenticazione | β οΈ Assente | Volutamente, uso singolo utente |
+
+## 3. Analisi Performance
+
+- **Conversione**: Pandoc Γ¨ veloce (ebook < 1 secondo). PDF via WeasyPrint puΓ² richiedere qualche secondo.
+- **Thread**: Ogni conversione Γ¨ un thread separato. Per uso singolo non ci sono problemi.
+- **SSE**: Connessione keep-alive leggera, ~300 bytes ogni 300ms.
+- **Reader**: epub.js rende tutto lato client. File EPUB fino a 50MB senza problemi.
+- **Memoria**: L'app in idle usa ~50MB. Durante conversione PDF ~150MB (WeasyPrint).
+
+## 4. Analisi ModularitΓ
+
+```
+bookish/
+βββ routes/ β¬
οΈ Separati per dominio (convert vs reader)
+β βββ convert.py
+β βββ reader.py
+βββ services/ β¬
οΈ Logica di business isolata dal routing
+β βββ converter.py
+β βββ sse_manager.py
+β βββ formatter.py
+βββ templates/ β¬
οΈ HTML separato per pagina
+βββ static/ β¬
οΈ CSS, JS, immagini
+β βββ css/
+β βββ js/
+β βββ lib/
+```
+
+La separazione Γ¨ chiara. Unica nota: `converter.py` importa `formatter.py` β dipendenza circolare potenziale ma gestita con import differito.
+
+## 5. Possibili Miglioramenti
+
+### Breve termine
+- [ ] Aggiungere logging strutturato (Python logging + file di log)
+- [ ] Migliorare il renderer Markdown nel reader (usare marked.js via CDN)
+- [ ] Aggiungere favicon diversa per stato conversione
+- [ ] Test di base con pytest
+
+### Medio termine
+- [ ] Supporto per code block syntax highlighting nel reader
+- [ ] Drag&drop anche nella pagina reader per caricamento diretto
+- [ ] ModalitΓ notte persistente con preferenza sistema (prefers-color-scheme)
+- [ ] Aggiungere pipeline di CI/CD per test
+
+### Lungo termine
+- [ ] Supporto multi-utente con autenticazione
+- [ ] Libreria personale con cronologia conversioni (SQLite)
+- [ ] Plugin system per engine di conversione custom
+- [ ] Mobile app via PWA
+
+## 6. Conclusioni
+
+Bookish Γ¨ un'applicazione solida per il suo scopo. L'architettura Γ¨ pulita, la separazione delle responsabilitΓ Γ¨ corretta, e le scelte tecnologiche sono appropriate per un progetto self-hostato a uso singolo. Le aree di miglioramento principali sono logging, testing e completezza del reader markdown.
diff --git a/docs/architecture.md b/docs/architecture.md
new file mode 100644
index 0000000..a45619b
--- /dev/null
+++ b/docs/architecture.md
@@ -0,0 +1,114 @@
+# Architettura di Bookish
+
+## Panoramica
+
+Bookish Γ¨ un'applicazione web Flask monolitica progettata per l'uso self-hostato. Si compone di due macro-funzionalitΓ : un **convertitore di formati ebook** e un **reader web** per visualizzarli.
+
+```
+ββββββββββββ βββββββββββββββββββββββββββββββββββββββ
+β Browser ββββββΆβ Flask β
+β β β βββββββββββ ββββββββββββββββββββ β
+β HTML/CSS β β β Routes β β Services β β
+β JS/ES β β β β β β β
+β β β βconvert βββΆβconverter.py ββββΆβ Pandoc
+βepub.js β β βreader β βsse_manager.py β β WeasyPrint
+βpdf.js β β β β βformatter.py β β python-docx
+ββββββββββββ β βββββββββββ ββββββββββββββββββββ β
+ βββββββββββββββββββββββββββββββββββββββ
+ β β
+ uploads/ converted/
+ (temporaneo) (temporaneo)
+```
+
+## Stack Tecnologico
+
+| Componente | Tecnologia | Ruolo |
+|---|---|---|
+| Backend | Flask 3.x + Jinja2 | Server web, routing, template engine |
+| Conversione | Pandoc 3.x (via pypandoc) | Motore di conversione principale |
+| PDF avanzato | WeasyPrint | PDF con layout precisi da HTML |
+| DOCX avanzato | python-docx | Post-processing documenti Word |
+| Frontend | JavaScript vanilla | Nessun framework pesante |
+| Reader EPUB | epub.js 0.3 | Renderer EPUB lato client |
+| Reader PDF | pdf.js 3.x | Renderer PDF lato client |
+| Progresso | SSE (Server-Sent Events) | Barra progresso real-time |
+| Storage | Filesystem locale | `uploads/` e `converted/` |
+
+## Flusso Conversione
+
+```
+Upload file β Validazione formato β Avvio thread conversione
+ β
+ ββββββββββββββββββββββββ
+ βΌ
+ SSE Manager crea task_id
+ β
+ Frontend apre connessione SSE
+ β
+ Converter dispatcher:
+ ββ Pandoc per formati standard
+ ββ WeasyPrint per PDF avanzati
+ ββ python-docx per DOCX
+ ββ BeautifulSoup per tabelle/HTML
+ β
+ Ogni fase β update SSE progress
+ β
+ βΌ
+ File salvato in converted/
+ SSE invia download_url
+```
+
+## Flusso Reader
+
+```
+Upload file β Salva in uploads/ β Redirect a /reader/
+ β
+ Template reader.html
+ β
+ Rileva formato:
+ ββ EPUB β epub.js
+ ββ PDF β pdf.js
+ ββ Testo β HTML renderizzato
+ β
+ Interazioni tutte lato client:
+ - Temi, zoom, ricerca
+ - Segnalibri, posizione
+ - Salvataggio in LocalStorage
+```
+
+## Architettura del Codice
+
+### Routes (`bookish/routes/`)
+
+- **`convert.py`** β Blueprint `/upload`, `/progress/`, `/download/`, `/formats`
+- **`reader.py`** β Blueprint `/reader`, `/reader/`, `/reader/serve/`, `/reader/formats`
+
+### Services (`bookish/services/`)
+
+- **`converter.py`** β Dispatcher che sceglie Pandoc o pipeline custom in base alla coppia input/output. Aggiorna SSE progress ad ogni fase.
+- **`sse_manager.py`** β Gestisce task in memoria con `{task_id: {progress, status, output_file}}`. Thread-safe con lock.
+- **`formatter.py`** β WeasyPrint PDF da HTML con post-processing (tabelle, immagini via BeautifulSoup).
+
+### Frontend (`bookish/static/js/`)
+
+- **`main.js`** β Convertitore: drag&drop, form, SSE connection, download
+- **`reader.js`** β Reader: epub.js/pdf.js/text viewer, side panel, temi, ricerca, segnalibri, posizione
+
+## Decisioni Architetturali
+
+| Decisione | Motivazione |
+|---|---|
+| Thread invece di Celery | Uso singolo utente, niente Redis, minore complessitΓ |
+| SSE invece di WebSocket | Sincrono semplice, nessuna dipendenza extra, supporto nativo |
+| LocalStorage per reader | Zero backend, nessun DB necessario per lettura |
+| File temporanei con cleanup | Nessun database, i file si auto-puliscono dopo 1h |
+| JS vanilla | Nessun framework, leggero, manutenibile |
+| Pandoc via pypandoc-binary | Include Pandoc binary, nessuna installazione systema richiesta |
+
+## Limiti Attuali
+
+- **Thread in memoria**: I task di conversione muoiono se il processo Flask viene killato
+- **No autenticazione**: Uso personale, nessun multi-utente
+- **No HTTPS di base**: Da abilitare con reverse proxy (nginx/caddy)
+- **No ottimizzazione mobile**: Funziona ma non Γ¨ prioritario
+- **estione code block reader**: Reader testo ha markdown renderer minimale
diff --git a/docs/deploy.md b/docs/deploy.md
new file mode 100644
index 0000000..bf7c234
--- /dev/null
+++ b/docs/deploy.md
@@ -0,0 +1,95 @@
+# Deploy Bookish
+
+## Su Proxmox LXC (raccomandato)
+
+### 1. Crea container LXC
+
+```bash
+pct create 120 local:vault/almalinux-9-default_20240918_amd64.tar.xz \
+ --storage local-lvm \
+ --memory 1024 \
+ --swap 512 \
+ --cores 2 \
+ --net0 name=eth0,bridge=vmbr0,ip=dhcp \
+ --ostype almalinux \
+ --unprivileged 1
+pct start 120
+pct enter 120
+```
+
+### 2. Installa dipendenze
+
+```bash
+# Python e strumenti di sviluppo
+dnf install -y python3 python3-pip git python3-devel gcc \
+ pango-devel cairo-devel gdk-pixbuf2-devel
+
+# Per WeasyPrint
+dnf install -y libffi-devel redhat-rpm-config
+```
+
+### 3. Clona e setup
+
+```bash
+git clone http://192.168.0.183:8085/truetype/bookish.git
+cd bookish
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+### 4. Crea service systemd
+
+```ini
+# /etc/systemd/system/bookish.service
+[Unit]
+Description=Bookish Ebook Converter & Reader
+After=network.target
+
+[Service]
+Type=simple
+User=root
+WorkingDirectory=/opt/bookish
+ExecStart=/opt/bookish/.venv/bin/python /opt/bookish/app.py 5000
+Restart=always
+RestartSec=5
+Environment=BOOKISH_SECRET=your-secret-here
+Environment=BOOKISH_DEBUG=false
+
+[Install]
+WantedBy=multi-user.target
+```
+
+```bash
+systemctl daemon-reload
+systemctl enable --now bookish
+```
+
+## Docker (alternativa)
+
+```dockerfile
+FROM python:3.11-slim
+RUN apt-get update && apt-get install -y pandoc libpango-1.0-0 \
+ libcairo2 libpangocairo-1.0-0 libgdk-pixbuf2.0-0 && rm -rf /var/lib/apt/lists/*
+WORKDIR /app
+COPY . .
+RUN pip install --no-cache-dir -r requirements.txt
+EXPOSE 5000
+CMD ["python", "app.py", "5000"]
+```
+
+## Reverse Proxy (Caddy)
+
+```caddyfile
+bookish.tuodominio.it {
+ reverse_proxy localhost:5000
+}
+```
+
+Con Caddy l'HTTPS Γ¨ automatico.
+
+## Pulizia e Manutenzione
+
+I file in `uploads/` e `converted/` vengono puliti automaticamente dopo 1 ora. Nessun DB da manutenere.
+
+Per backup basta copiare la directory del progetto (escludendo `uploads/`, `converted/`, `.venv/`).
diff --git a/docs/wiki.md b/docs/wiki.md
new file mode 100644
index 0000000..8868c05
--- /dev/null
+++ b/docs/wiki.md
@@ -0,0 +1,78 @@
+# Wiki di Bookish
+
+## Guida all'uso
+
+### Convertitore
+
+1. Apri la homepage di Bookish
+2. Trascina un file nell'area di upload, oppure clicca per selezionarlo
+3. Scegli il formato di destinazione cliccando su un bottone
+4. Clicca **Converti**
+5. La barra di progresso mostra lo stato della conversione
+6. A conversione completata, clicca **Scarica file**
+7. Opzionale: clicca **Leggi nel reader** per visualizzare il file convertito
+
+### Formati supportati
+
+| Input | Output |
+|---|---|
+| EPUB | EPUB, MD, DOCX, PDF, TXT, HTML, FB2, LaTeX |
+| PDF | EPUB, MD, DOCX, TXT, HTML, LaTeX |
+| DOCX | EPUB, MD, PDF, TXT, HTML, LaTeX |
+| Markdown | EPUB, DOCX, PDF, TXT, HTML, LaTeX |
+| TXT | EPUB, MD, DOCX, PDF, HTML, LaTeX |
+| HTML | EPUB, MD, DOCX, PDF, TXT, LaTeX |
+| FB2 | EPUB, MD, DOCX, PDF, TXT, HTML, LaTeX |
+| LaTeX | EPUB, MD, DOCX, PDF, TXT, HTML |
+
+### Reader
+
+1. Vai su **Reader** nella navigazione
+2. Carica un ebook (EPUB, PDF, MD, TXT, HTML, FB2, DOCX)
+3. Usa la toolbar per:
+ - **β°** β Apri/chiudi indice
+ - **Aβ / A+** β Zoom font
+ - **βοΈ / π / π€** β Cambia tema (chiaro/scuro/seppia)
+ - **π** β Cerca nel testo
+ - **βΆ** β Schermo intero
+4. Naviga con frecce tastiera β β o cliccando ai lati
+5. La posizione di lettura viene salvata automaticamente
+
+### API Endpoints
+
+| Metodo | Path | Descrizione |
+|---|---|---|
+| POST | `/upload` | Carica file e avvia conversione |
+| GET | `/progress/` | SSE stream progresso |
+| GET | `/download/` | Scarica file convertito |
+| GET | `/formats?input=` | Formati disponibili per input |
+| GET | `/reader` | Pagina reader |
+| GET | `/reader/` | Reader per file specifico |
+| GET | `/reader/serve/` | Serve il file al reader |
+| GET | `/reader/formats` | Formati supportati dal reader |
+
+## Domande frequenti
+
+**D: Che qualitΓ ha la conversione?**
+R: Pandoc preserva titoli, grassetto/corsivo, elenchi, tabelle semplici e immagini. Per layout complessi (es. PDF con colonne multiple) la fedeltΓ dipende dalla complessitΓ del file originale.
+
+**D: I file vengono conservati?**
+R: No, vengono cancellati dopo 1 ora. Usa il download subito dopo la conversione.
+
+**D: Quanto spazio serve?**
+R: Minimo. L'app stessa Γ¨ ~5MB. Pandoc binary incluso ~35MB extra.
+
+**D: Posso usarlo su mobile?**
+R: Il convertitore Γ¨ responsive. Il reader funziona ma non Γ¨ ottimizzato per schermi piccoli.
+
+**D: Come cambio la secret key?**
+R: Imposta `BOOKISH_SECRET` come variabile d'ambiente prima di avviare.
+
+## Sicurezza
+
+- Uso personale β nessuna autenticazione implementata
+- File validati per estensione all'upload
+- Path traversal prevenuto con `os.path.basename()` e `secure_filename()`
+- MIME types controllati al download
+- Limite file a 50MB
+- Pulizia automatica file temporanei