glastree/MEMORY.md

# 🧠 MEMORY.md — Stato Progetto

## Goal
- Correggere tutti i bug critici identificati nell'applicazione Glastree
- Implementare nuove funzionalità richieste: cancellazione account email, fix firma editor, sincronizzazione calendario con Google Calendar / CalDAV

## Constraints & Preferences
- Laravel 13, PHP 8.4, AdminLTE 4, MySQL/MariaDB
- Zero placeholder, zero TODO, codice funzionante
- Compatibilità cross-DB MySQL ↔ SQLite

## Progress
### Done
- **Cancellata cache Laravel** (`php artisan optimize:clear`)
- **Fix BUG CRITICO 3** – `IndividuoController::update()` (riga 216): avvolto `$individuo->contatti()->delete()` dentro `if ($request->has('contatti'))`.
- **Fix BUG CRITICO 1** – `individui/edit.blade.php`: convertiti 4 form annidati in pulsanti `type="button"` + `fetch()` AJAX
- **Fix BUG CRITICO 2** – `gruppi/edit.blade.php`: convertiti 3 form annidati in pulsanti `type="button"` + `fetch()` AJAX
- **Fix BUG CRITICO 4** – `gruppi/show.blade.php`: flash messages spostati dentro `@section('content')`
- **Fix BUG CRITICO 5/6** – `eventi/show.blade.php`: rimossi div extra, XSS escape in confirm()
- **Fix BUG CRITICO 7/8** – `ImpostazioniController.php`: use Documento + JSON_CONTAINS → PHP
- **Fix BUG CRITICO 9** – `ReportController.php`: `$contatto->email` → `$contatto->valore`
- **Fix BUG CRITICO 10** – `DocumentoController.php`: morph injection prevention in massUpdate()
- **NUOVA FEATURE – Cancellazione account email**: Aggiunto metodo `destroy()` in `EmailSettingsController`, rotta `DELETE /impostazioni/email`, pulsante "Elimina Configurazione" in entrambe le viste (admin dedicata e unificata)
- **FIX – Doppia barra icone firma**: Cambiata la guardia di `createEditor()` e `initSignatureEditor()` da `container.querySelector('.ql-toolbar')` (che non funziona perché Quill crea la toolbar come sibling, non child) a flag `quillEditorInstance` in entrambe le viste
- **NUOVA FEATURE – Sincronizzazione calendario**: Implementata sincronizzazione con Google Calendar e CalDAV (Infomaniak/NextCloud):
  - Migration `create_calendario_connessioni_table` + `add_uid_esterno_to_eventi_table`
  - Model `CalendarioConnessione` con encrypt/decrypt config
  - Service `CalDavService` (PROPFIND, REPORT, calendar-query, PUT)
  - Service `GoogleCalendarSyncService` (Google Calendar API v3)
  - Controller `CalendarioConnessioneController` (CRUD + test + sync + reorder)
  - Routes RESTful per calendario-connessioni
  - UI nella tab "Calendario" delle impostazioni unificate con tabella, modale CRUD, pulsanti test/sync/elimina, Sortable drag&drop
  - Installati pacchetti: `sabre/vobject`, `google/apiclient`

### In Progress
- *(nessuno)*

### Blocked
- *(nessuno)*

## Key Decisions
- Per i form annidati si è scelto l'approccio `type="button"` + `fetch()` AJAX
- Per la cancellazione account email si usa `EmailSetting::first()->delete()` con verifica esistenza
- Per il fix Quill: variabile flag `quillEditorInstance` invece di `container.querySelector('.ql-toolbar')` perché Quill inserisce `.ql-toolbar` come elemento sibling, non child
- Per CalDAV: usato Guzzle (già in Laravel) per HTTP + `sabre/vobject` per parsing iCal
- Per Google Calendar: usato `google/apiclient` con OAuth 2.0 (refresh token)
- La sync può essere bidirezionale, solo import o solo export
- I campi sensibili delle connessioni calendario sono criptati con `Crypt`

## Next Steps
- *(nessuno)*

## Critical Context
- Le connessioni calendario supportano: Google Calendar, CalDAV (NextCloud, Infomaniak, Synology)
- La direzione di sync è configurabile per ogni connessione
- Le password/refresh token sono automaticamente criptati all salvataggio via `encryptAndSetConfig()`
- Il campo `uid_esterno` sugli eventi traccia la corrispondenza con eventi remoti

## Relevant Files
- `app/Http/Controllers/Admin/EmailSettingsController.php`: +destroy() method
- `app/Http/Controllers/CalendarioConnessioneController.php`: NEW – CRUD + test + sync
- `app/Models/CalendarioConnessione.php`: NEW – model con encrypt config
- `app/Services/CalDavService.php`: NEW – CalDAV sync
- `app/Services/GoogleCalendarSyncService.php`: NEW – Google Calendar sync
- `app/Http/Controllers/ImpostazioniController.php`: +calendarioConnessioni in index()
- `resources/views/admin/email-settings/index.blade.php`: +delete button, fix Quill guard
- `resources/views/impostazioni/index.blade.php`: +delete button, fix Quill guard, +calendario tab UI, +calendario modal, +JS funcs
- `routes/web.php`: +email destroy route, +calendario-connessioni routes
- `database/migrations/2026_06_02_000001_create_calendario_connessioni_table.php`: NEW
- `database/migrations/2026_06_02_000002_add_uid_esterno_to_eventi_table.php`: NEW