glastree/MEMORY.md

🧠 MEMORY.md — Stato Progetto

Goal

• Fix login after fresh install (user created via installer can't authenticate)
• Cross-DB compatibility (MySQL ↔ SQLite) for all migrations

Constraints & Preferences

• Laravel 13, PHP 8.4, AdminLTE 3, MySQL/MariaDB/SQLite
• Comandi Artisan da terminale, nessun wizard web
• Script PHP CLI per installazione interattiva
• Zero placeholder, zero TODO, codice funzionante

Progress

Done

• Fix – RedirectResponse type error: aggiunto use Illuminate\Http\RedirectResponse; in EmailSettingsController.php
• Fix – UrlGenerationException in sender routes: sostituito route('impostazioni.sender.update', '') + id con '__ID__'.replace('__ID__', id) in admin/email-settings/index.blade.php (stessa correzione per impostazioni.sender.test)
• Fix – Messaggi email visibili dopo eliminazione configurazione: destroy() ora cancella sempre allegati su disco, cartelle email (cascata messaggi/allegati) e poi le impostazioni. Risolto bug che faceva uscire subito se EmailSetting::first() era null
• Fix – Tab guida Installazione/Backup/Docker non funzionanti: rimosso </div> di chiusura tab-content prematuro (linea 290) in help/index.blade.php — i tre tab-pane erano fuori dal container
• Guida aggiornata – rimosso wizard web installer: sostituiti tutti i riferimenti alla cartella installer/ con comandi Artisan in help/index.blade.php e help/pdf.blade.php. Passi 3-6 semplificati in un unico php install.php
• Script install.sh rimosso, sostituito da install.php (PHP CLI interattivo): modalità Apache/Docker/Restore, preflight, .env + APP_KEY, CREATE DATABASE IF NOT EXISTS, composer, package:discover, migrate --seed, admin via tinker, asset npm, permessi. Docker build + admin nel container
• Fix – Migration app_settings mancante: creata 2026_05_15_000001_create_app_settings_table.php con tutte le colonne. Aggiornate 4 migration alter esistenti con guardie Schema::hasTable() + Schema::hasColumn(). Aggiunto Schema::hasTable() in AppSetting::getSetting() per evitare eccezioni su DB fresco
• Fix – Database non creato durante install: install.php ora esegue CREATE DATABASE IF NOT EXISTS
• Fix – Remember checkbox mancante name: aggiunto name="remember" al checkbox "Ricordami" in resources/views/auth/login.blade.php
• Fix – Admin via tinker senza is_admin/permissions: tutti e 3 i tinker script in install.php ora impostano is_admin = true, status = 'active', permissions completo (tutti i moduli a livello FULL)
• Fix – 2>/dev/null rimosso da tinker/artisan commands: install.php non sopprime più stderr su tinker --execute, package:discover, storage:link, chown, cp. Eventuali errori ora sono visibili all'utente
• Fix – Controllo permessi sessione: aggiunto check esplicito is_writable(storage/framework/sessions/) in install.php con warning su potenziale errore 419 CSRF
• Fix – Migrations non cross-DB: convertiti enum() a string(50) in tutte le migration delle tabelle documenti (create + alter) per compatibilità MySQL/SQLite. Rimossa raw SQL ALTER TABLE MODIFY COLUMN. Aggiunto dropIndex() prima di dropColumn('ruolo_id') in change_ruolo_to_multi.php per compatibilità SQLite
• Fix – ExampleTest: aggiornato per matchare comportamento reale (root / fa redirect 302 a login)
• Nuovo test – Login: tests/Feature/Auth/LoginTest.php con 5 test: seeded admin login, custom admin login, wrong password, suspended user, login page loads

In Progress

• (nessuno)

Blocked

• (nessuno)

Key Decisions

• Script installazione in PHP CLI invece di bash: usa direttamente API Laravel/PDO, gestione errori con try/catch, readline per input, nessun problema di sintassi shell
• Migrazione app_settings: unica migration Schema::create() con tutte le colonne + guardie hasColumn() nelle alter esistenti invece di modificare i timestamp
• Cleanup email: eseguito sempre (anche se EmailSetting già cancellato) per gestire stato orfano
• enum() rimosso a livello DB in favore di string() + validazione app-level (consistente con AGENTS.md)
• dropIndex() esplicito prima di dropColumn() per compatibilità SQLite

Next Steps

• (nessuno)

Critical Context

• DatabaseSeeder crea admin admin@glastree.local / password con is_admin=true, status='active'
• User model ha 'password' => 'hashed' cast: nessun doppio hashing con bcrypt() + save()
• Auth::attempt() usa Hash::check() che ignora il cast hashed
• SESSION_DRIVER=file in produzione richiede permessi di scrittura su storage/framework/sessions/
• APP_ENV=production + APP_DEBUG=false nascondono errori 419 (CSRF) e 500
• Test PHPUnit usano SQLite :memory: — tutte le migration devono essere cross-DB compatibili
• SQLite non supporta: ALTER TABLE MODIFY COLUMN, ENUM type, dropColumn su colonne con indici

Relevant Files

• install.php: installer interattivo — Apache/Docker/Restore, tinker scripts admin (3 modalità)
• resources/views/auth/login.blade.php: fix name="remember" sul checkbox "Ricordami"
• app/Http/Controllers/Auth/AuthController.php: login() controlla $user->status === 'suspended'
• app/Models/User.php: cast 'password' => 'hashed', metodi isSuperAdmin/isActive
• database/seeders/DatabaseSeeder.php: crea admin di default
• tests/Feature/Auth/LoginTest.php: NEW — 5 test di login
• app/Http/Controllers/Admin/EmailSettingsController.php: fix destroy cleanup
• resources/views/admin/email-settings/index.blade.php: fix route sender update/test
• database/migrations/2026_05_12_000002_change_ruolo_to_multi.php: fix dropIndex + dropColumn
• database/migrations/*documenti*: fix enum → string (5 migration)
• database/migrations/2026_05_15_000001_create_app_settings_table.php: NEW
• database/migrations/2026_05_16_000001_add_logo_path_to_app_settings.php: guardie hasColumn
• database/migrations/2026_05_16_000002_add_app_config_to_app_settings.php: guardie hasColumn
• database/migrations/2026_05_27_000003_add_documenti_storage_to_app_settings.php: guardie hasColumn
• database/migrations/2026_06_01_100155_add_backup_settings_to_app_settings.php: guardie hasColumn
• resources/views/help/index.blade.php: fix tab-pane chiusura, rimosso wizard web installer
• resources/views/help/pdf.blade.php: rimosso wizard web installer