final 1.2.3 - file sh per generare zip

MEMORY.md

@@ -1,61 +1,70 @@
 # 🧠 MEMORY.md — Stato Progetto
 
 ## Goal
-- Risolvere login non funzionante dopo fresh install (causa: tinker senza escaping + `2>/dev/null`)
-- Sostituire tinker per creazione admin con PDO prepared statement + SQL file per schema
+- Implementare page-length selector su liste (Individui, Eventi, Email)
+- Implementare CSV import per gruppi
+- Implementare ICS import per eventi
+- Creare script build-dist.sh per distribuzione
 
-## Constraints & Preferences
-- Laravel 13, PHP 8.4, AdminLTE 4, MySQL/MariaDB (install.sql solo MySQL)
-- Zero placeholder, zero TODO, codice funzionante
-- Compatibilità cross-DB MySQL ↔ SQLite (fallback migration per SQLite)
+## Modifiche Effettuate (10 file + 3 nuovi)
 
-## Progress
-### Done
-- **Creazione `database/install.sql`** — schema MySQL completo + seed data (~1059 righe):
-  - Tutte le 45 tabelle nello stato finale (consolidate da 58 migration)
-  - Seed: 119 diocesi, 54 comuni, 8 tipologie documenti, 8 tipologie eventi, 8 ruoli, 23 permessi Spatie, 2 ruoli Spatie, 3 role preset, 5 email folders, 1 riga app_settings
-  - **NON contiene l'admin** (creato via PDO da install.php)
-  - `SET FOREIGN_KEY_CHECKS=0` per ordine tabelle, riattivato alla fine
-- **Riscritto `install.php`** — eliminata dipendenza da tinker per la creazione admin:
-  - Aggiunta funzione `createAdminUser()`: PDO prepared statement + `password_hash()` + Spatie role assignment
-  - Fresh Install Apache: importa `install.sql` via `mysql` CLI, poi crea admin via PDO
-  - Fresh Install Docker: copia `install.sql` nel container, importa via mysql CLI, crea admin via script PHP temporaneo con `var_export()` (safe)
-  - Restore: crea admin via PDO se non esiste
-  - Fallback SQLite: mantiene `php artisan migrate --seed` + tinker ma con `var_export()` per escaping
-  - Step 5 rinominato da "MIGRATION E SEED" a "SCHEMA DATABASE E DATI BASE"
-  - Step 6 usa PDO invece di tinker (MySQL)
-- **Unified MySQL setup**: singolo tentativo PDO con `dbname` nel DSN — se fallisce (1044/1045/1049), passa automaticamente in root-mode: chiede password root, crea database + utente + GRANT ALL su `localhost` e `%`
-- **Sostituito loop 30-retry** con connessione singola PDO (timeout 5s)
-- **Fix parse error**: `\$adminName` → `$adminName` in `var_export()` nel ramo SQLite
-- **Fix composer**: rimosso `sudo -u www-data` da composer (causa git dubious ownership + permission denied), aggiunto `COMPOSER_ROOT_VERSION=dev-main`; `vendor` aggiunto al chown finale
+### File modificati
+| File | Cosa |
+|------|------|
+| `app/Http/Controllers/IndividuoController.php` | perPage support (20 default, clamp [10,20,25,50,100]) |
+| `app/Http/Controllers/EventoController.php` | perPage + importIcs/importIcsStore (Sabre\VObject) |
+| `app/Http/Controllers/GruppoController.php` | import/importStore/downloadTemplate CSV gruppi |
+| `app/Http/Controllers/EmailController.php` | perPage support |
+| `app/Models/Evento.php` | `uid_esterno` aggiunto a $fillable (bug fix) |
+| `resources/views/individui/index.blade.php` | dropdown perPage in card-footer |
+| `resources/views/eventi/index.blade.php` | dropdown perPage + pulsante Importa ICS |
+| `resources/views/gruppi/index.blade.php` | pulsante Importa CSV |
+| `resources/views/email/index.blade.php` | dropdown perPage in card-footer |
+| `routes/web.php` | route gruppi/import, gruppi/template, eventi/import |
 
-### In Progress
-- *(nessuno)*
+### File nuovi
+| File | Cosa |
+|------|------|
+| `resources/views/gruppi/import.blade.php` | form upload CSV gruppi |
+| `resources/views/eventi/import.blade.php` | form upload ICS eventi |
+| `build-dist.sh` | script build distribuzione |
 
-### Blocked
-- *(nessuno)*
+## Feature
 
-## Key Decisions
-- **PDO > tinker**: `createAdminUser()` usa PDO prepared statement con `password_hash()`, niente interpolazione PHP in stringhe shell → zero escaping issues
-- **`install.sql` > migration sequenziali**: unico file SQL per fresh install, più veloce e debuggabile (si può lanciare `mysql < install.sql` a mano)
-- **`var_export()` per tinker fallback**: nei rari casi SQLite, si usa `var_export()` che produce stringhe PHP valide con escaping automatico
-- **`2>/dev/null` rimosso** dal MySQL main path (non serve più, non c'è tinker)
-- **Docker MySQL credenziali**: hardcoded `mysql:glastree:secret:glastree` (dal docker-compose.mysql.yml)
-- **Composer senza sudo**: `COMPOSER_ROOT_VERSION=dev-main` per evitare git dubious ownership; composer eseguito come utente corrente (root), non più come www-data — dopo, `chown -R www-data vendor` per permessi lettura webserver
-- **Unified MySQL setup**: PDO connect con `dbname` nel DSN → se fallisce 1044/1045/1049, root-mode: crea DB + utente + GRANT ALL su `localhost` e `%` + FLUSH
+### 1. Page-length selector
+- **3 pagine**: Individui, Eventi, Email
+- **Valori**: 10, 20, 25, 50, 100 (default 20)
+- Dropdown nel card-footer con hidden fields per preservare altri query param
 
-## Next Steps
-- *(nessuno)*
+### 2. CSV Import Gruppi
+- Stesso pattern di `IndividuoController` (import GET, importStore POST, downloadTemplate GET)
+- Colonne: nome, descrizione, parent_id, diocesi_id, indirizzo_incontro, cap_incontro, città_incontro, sigla_provincia_incontro
+- Fault-tolerant: skip righe vuote, log errori
 
-## Critical Context
-- `install.sql` è solo per MySQL. SQLite usa `php artisan migrate --seed` + `DatabaseSeeder`
-- `DatabaseSeeder` crea ancora admin `admin@glastree.local / password` ma per MySQL viene cancellato dal PDO script
-- `createAdminUser()` setta `is_admin=1`, `status='active'`, `permissions` completo, `role_preset_id=1`, e Spatie `model_has_roles` con role_id=1
-- `password_hash($pass, PASSWORD_BCRYPT)` produce hash `$2y$...` compatibile con `Hash::check()` di Laravel
-- Composer ora eseguito come utente corrente (root) con `COMPOSER_ROOT_VERSION=dev-main` per evitare git dubious ownership e permission denied su `vendor/`
-- `vendor/` aggiunto al `chown` finale in entrambi i modi (Apache e Restore) per garantire leggibilità da www-data
-- `ensureMysqlUserAndDb()` sanitizza input (rimuove `' " \0 \`) prima di passarli a SQL exec
+### 3. ICS Import Eventi
+- Usa `Sabre\VObject\Reader::read()` già in vendor/
+- Mapping: SUMMARY→nome_evento, DESCRIPTION→descrizione, DTSTART→data_specifica+ora_inizio, DTEND→durata_minuti, LOCATION→luogo_indirizzo, UID→uid_esterno
+- Dedup via uid_esterno
+- RRULE: import come evento singolo con prima occorrenza
 
-## Relevant Files
-- `database/install.sql`: NEW — schema MySQL completo + seed data (1059 righe)
-- `install.php`: MODIFIED — `createAdminUser()` + `ensureMysqlUserAndDb()` + composer fix + auto-create MySQL user
+### 4. Script build-dist.sh
+- Genera `glastree-YYYYMMDD_HHMM.tar.gz` (~26MB)
+- Include: sorgenti, vendor (production), Dockerfile, docker-compose, install.php, install.sql
+- Esclude: .git, node_modules, tests, cache, storage content, vendor/docs/tests
+
+## Installazione su server remoto
+```bash
+# Estrarre
+tar xzf glastree-20260607_2052.tar.gz
+
+# Configurare
+cp .env.example .env
+php artisan key:generate
+php artisan storage:link
+
+# Opzione A — Docker
+docker compose up -d
+
+# Opzione B — Apache nativo (MySQL)
+php install.php
+```