++ Add Readme + Multiple S3 Configs

2026-03-18 14:11:45 +01:00
parent d2080c936f
commit cb6536f656
9 changed files with 856 additions and 93 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -0,0 +1,208 @@
+# S3-to-Local Sync Dashboard - Multi-Sync Support
+
+## 🎉 Nuove Funzionalità (18 Marzo 2026)
+
+### 1. **Non invia le notifiche Gotify** ✅ RISOLTO
+- **Problema**: La funzione `gotify_send()` aveva un'escaping JSON incorretto
+- **Soluzione**: 
+  - Aggiunto `jq` al Dockerfile per proper JSON encoding
+  - Riscritto `gotify_send()` in `sync.sh` con corretto escaping dei caratteri speciali
+  - Aggiunta proper gestione degli errori con fallback a sed
+
+### 2. **Multiple Associazioni Sync (1:1 Bucket:Cartella)** ✅ IMPLEMENTATO
+- Ora supporta **multiple sync simultanee**
+- Ogni sync ha:
+  - Identificatore univoco (`sync1`, `sync2`, etc.)
+  - Bucket S3 dedicato
+  - Cartella locale dedicata
+  - Directory di stato separata (`/data/state/sync1`, `/data/state/sync2`)
+
+**Configurazione in `.env`:**
+```bash
+SYNC_CONFIGS='[
+  {"id": "sync1", "bucket": "backup-docs", "path": "/data/local1", "interval": 300},
+  {"id": "sync2", "bucket": "media-files", "path": "/data/local2", "interval": 600}
+]'
+```
+
+### 3. **Interfaccia Dashboard Ridisegnata** ✅ IMPLEMENTATO
+
+#### Tab Selector Dinamici
+- Mostra un tab per ogni sync configurata
+- Click per switchare tra sync
+- Visualizza log e modifiche della sync selezionata
+
+#### Grafica Responsiva e Dinamica
+- **CSS Flexbox + Grid**: si adatta perfettamente al ridimensionamento della finestra
+- **Breakpoint Mobile**: su schermi < 1200px, log e modifiche si impilano verticalmente
+- **Performance**: auto-scroll, limite di 500 righe log, lazy loading
+
+#### Organizzazione Pannelli
+**PRIMA:**
+```
+Stats Cards (4)
+   ↓
+Config
+   ↓
+Log Panel (sx) | Modifiche Recenti (dx)
+   ↓
+Storico
+```
+
+**ADESSO:**
+```
+Stats Cards (4)
+   ↓
+Config
+   ↓
+[TAB SELECTOR] sync1 | sync2 | sync3
+   ↓
+Log (sopra) | Modifiche Recenti (destra)
+   ↓
+Storico
+```
+
+### 4. **Visualizzazione Per-Sync** ✅ IMPLEMENTATO
+Ogni sync mostra i suoi dati indipendenti:
+- Status badge (Avvio, Sincronizzazione, Sincronizzato, Errore)
+- Statistiche cartella locale
+- Log in tempo reale (SSE stream dedicato)
+- Modifiche recenti
+- Storico sincronizzazioni
+
+---
+
+## 🚀 Come Usare
+
+### Modalità Singola (Default - Compatibile)
+```bash
+# Nel .env, configure il bucket singolo
+S3_BUCKET=my-bucket
+# NON mettere SYNC_CONFIGS
+
+# Avvio
+docker-compose up -d
+# La dashboard mostra una singola sync (nessun tab)
+```
+
+### Modalità Multi-Sync
+```bash
+# Nel .env:
+SYNC_CONFIGS='[
+  {"id": "sync1", "bucket": "bucket-a"},
+  {"id": "sync2", "bucket": "bucket-b"},
+  {"id": "sync3", "bucket": "bucket-c"}
+]'
+
+# Nel docker-compose.yml, aggiungi i volumi per ogni sync:
+volumes:
+  - ./data/sync1:/data/local
+  - ./data/sync2:/data/local2
+  - ./data/sync3:/data/local3
+  - sync-state:/data/state
+```
+
+Poi:
+```bash
+docker-compose up -d
+```
+
+La dashboard automaticamente:
+1. Mostra tab per ogni sync
+2. Lancia multiple istanze di `sync.sh` (una per bucket)
+3. Visualizza log + modifiche per sync selezionata
+
+---
+
+## 📊 Struttura Nuova
+
+### API Endpoints
+
+| Endpoint | Descrizione |
+|----------|-------------|
+| `/api/syncs` | Lista di tutte le sync configurate |
+| `/api/status/<sync_id>` | Stato di una specifica sync |
+| `/api/stream/<sync_id>` | SSE stream log in tempo reale |
+| `/api/changes/<sync_id>` | Modifiche recenti per una sync |
+| `/api/history/<sync_id>` | Storico sincronizzazioni |
+
+### Directory di Stato
+```
+/data/state/
+├── sync1/
+│   ├── sync.log
+│   ├── status.json
+│   ├── history.json
+│   └── recent_changes.json
+├── sync2/
+│   ├── sync.log
+│   ├── status.json
+│   ├── history.json
+│   └── recent_changes.json
+└── ...
+```
+
+---
+
+## 🔧 Note Tecniche
+
+### entrypoint.sh
+- **Singola sync**: Avvia 1 istanza di `sync.sh` (come prima)
+- **Multi-sync**: Parsa JSON di `SYNC_CONFIGS`, crea directory di stato, lancia N istanze di `sync.sh` con `STATE_DIR` diversi
+
+### sync.sh
+- Accetta `STATE_DIR` come variabile d'ambiente
+- Scrive log/status/modifiche nella directory assegnata
+- `gotify_send()` ora ha proper JSON escaping
+
+### app.py
+- Carica configurazione da `SYNC_CONFIGS`
+- Fallback a singola sync se `SYNC_CONFIGS` non è definito
+- Routes parametriche con `<sync_id>`
+
+### index.html
+- CSS Grid + Flexbox per responsive design
+- `switchSync(id)` per cambiare tab
+- Mantiene stato separato per ogni sync
+- Auto-update ogni 5-10-15s
+
+---
+
+## ✅ Checklist Implementazione
+
+- [x] Notifiche Gotify - Fixed JSON escaping + jq
+- [x] Multiple sync - Parsing SYNC_CONFIGS + multiple STATE_DIR
+- [x] UI multi-tab - Switch dinamico tra sync
+- [x] CSS responsivo - Flexbox/Grid con breakpoints
+- [x] Log/Modifiche orizzontali - Layout a due colonne
+- [x] Per-sync data - API routes con sync_id
+- [x] Docker multi-sync - entrypoint con Python JSON parser
+- [x] Compatibilità backward - Fallback a singola sync
+
+---
+
+## 🐛 Bug Risolti
+
+1. **Notifiche Gotify non inviate**
+   - Causa: Escaping JSON non corretto in `printf`
+   - Fix: Uso di `jq` con proper escaping
+   
+2. **Grafica non responsiva**
+   - Causa: CSS max-width fisso, layout non flexible
+   - Fix: CSS Grid/Flexbox con responsive breakpoints
+
+---
+
+## 📝 Prossimi Miglioramenti Suggeriti
+
+- [ ] API per aggiungere/rimuovere sync dinamicamente
+- [ ] Statistiche aggregate di tutte le sync
+- [ ] Throttling bandwidth globale (non per-sync)
+- [ ] Health check per ogni sync
+- [ ] Export dati sincronizzazioni in CSV
+- [ ] Webhooks per sync completate
+
+---
+
+**Version**: 2.0.0 (Multi-Sync)  
+**Last Updated**: 18 Marzo 2026