{{ $appName ?? 'Glastree' }}

Guida completa alla configurazione, installazione e migrazione

1. WebDAV / Nextcloud

Cos'è

WebDAV è un protocollo che permette di accedere a file su server remoti. Nextcloud lo utilizza per la sincronizzazione dei file.

Configurazione

Vai in Impostazioni → Repository e crea un nuovo repository di tipo WebDAV.

Nome utente con @ (chiocciola)

Se il tuo nome utente contiene il carattere @ (es. mario.rossi@azienda.com), segui queste regole:

• Nel campo "Base URI": l'indirizzo email deve essere URL-encoded:
  https://server.it/remote.php/dav/files/mario.rossi%40azienda.com/
  (il carattere @ diventa %40)
• Nel campo "Username": inserisci l'indirizzo email normale con la @ vera.

Il sistema gestisce automaticamente la differenza tra l'URI (che richiede %40) e l'autenticazione (che usa la @ reale).

Test connessione

Dopo aver salvato, usa il pulsante Test nella tabella dei repository per verificare che la connessione funzioni.

Importare file

Apri la sezione Documenti, clicca sul pulsante del repository nella toolbar per sfogliare i file remoti, poi clicca Salva tra i documenti su un file per importarlo come documento locale.

2. Google Drive

Cos'è

Integrazione con Google Drive per sfogliare e importare file direttamente dal tuo spazio Google Drive.

Requisiti

1. Un account Google / Google Workspace
2. Un progetto sulla Google Cloud Console con l'API Google Drive abilitata
3. Credenziali OAuth 2.0 (Client ID e Client Secret)

Passo 1: Creare il progetto Google Cloud

1. Vai su Google Cloud Console (console.developers.google.com)
2. Crea un nuovo progetto o selezionane uno esistente
3. Vai a API e servizi → Libreria
4. Cerca "Google Drive API" e abilitala
5. Vai a API e servizi → Credenziali
6. Clicca "Crea credenziali → ID client OAuth"
7. Tipo applicazione: "Applicazione Web"
8. URI di reindirizzamento autorizzato: aggiungi {{ url('/auth/google-drive/callback') }}
9. Completa la creazione e copia Client ID e Client Secret

Passo 2: Configurazione nell'app

1. Vai in Impostazioni → Repository
2. Clicca "Nuovo Repository" e seleziona tipo Google Drive
3. Inserisci un nome descrittivo (es. "Drive Lavoro")
4. Incolla Client ID e Client Secret
5. Folder ID (opzionale): se vuoi limitare l'accesso a una cartella specifica, inserisci il suo ID (lo trovi nell'URL quando apri la cartella in Google Drive: https://drive.google.com/drive/folders/ID_QUI)
6. Clicca "Autorizza Google Drive" — verrai reindirizzato a Google per concedere i permessi
7. Dopo l'autorizzazione, il refresh token verrà salvato automaticamente

Google Drive API non abilitata

Se vedi l'errore "Google Drive API non abilitata" nel test connessione, significa che l'API Drive non è stata attivata nel tuo progetto Google Cloud.

Importare file

Stessa procedura di WebDAV: apri Documenti, clicca sul repository Drive, sfoglia i file e usa Salva tra i documenti.

File Google (Documenti, Fogli, Presentazioni)

I file creati con Google Workspace (Documenti Google, Fogli Google, Presentazioni Google, Disegni Google) non possono essere scaricati direttamente perché non hanno un formato binario nativo.

Il sistema li converte automaticamente in formato Office Open XML durante l'import:

Il nome del file viene automaticamente esteso con l'estensione corretta (es. "Relazione" → "Relazione.docx").

3. Google Calendar

Cos'è

Integrazione con Google Calendar per sincronizzare gli eventi tra l'app e il tuo calendario Google. Supporta import, export e sincronizzazione bidirezionale.

Requisiti

1. Un account Google / Google Workspace
2. Un progetto sulla Google Cloud Console con l'API Google Calendar abilitata
3. Credenziali OAuth 2.0 (Client ID e Client Secret)

Passo 1: Creare il progetto Google Cloud

1. Vai su Google Cloud Console (console.developers.google.com)
2. Crea un nuovo progetto o selezionane uno esistente
3. Vai a API e servizi → Libreria
4. Cerca "Google Calendar API" e abilitala
5. Vai a API e servizi → Credenziali
6. Clicca "Crea credenziali → ID client OAuth"
7. Tipo applicazione: "Applicazione Web"
8. URI di reindirizzamento autorizzato: aggiungi https://developers.google.com/oauthplayground
9. Completa la creazione e copia Client ID e Client Secret

Passo 2: Ottenere il Refresh Token

A differenza di Google Drive, per Google Calendar il refresh token va ottenuto manualmente tramite il Google OAuth Playground:

1. Vai su Google OAuth Playground (developers.google.com/oauthplayground)
2. Clicca l'ingranaggio ⚙️ in alto a destra
3. Spunta "Use your own OAuth credentials"
4. Incolla Client ID e Client Secret creati al Passo 1
5. Nella colonna sinistra, espandi "Google Calendar API v3" e seleziona lo scope https://www.googleapis.com/auth/calendar
6. Clicca "Authorize APIs" e autorizza con l'account Google
7. Clicca "Exchange authorization code for tokens"
8. Copia il Refresh Token generato

Passo 3: Configurazione nell'app

1. Vai in Impostazioni → Calendario
2. Clicca "Nuova Connessione"
3. Inserisci un nome descrittivo (es. "Calendario Lavoro")
4. Seleziona tipo Google Calendar
5. Incolla Client ID, Client Secret e il Refresh Token ottenuto
6. Calendar ID (opzionale): lascia primary per il calendario principale, oppure inserisci l'ID di un calendario specifico
7. Seleziona la direzione di sincronizzazione (import, export o bidirezionale)
8. Clicca "Salva"

Test connessione

Dopo aver salvato, usa il pulsante Test nella tabella delle connessioni per verificare che l'autorizzazione funzioni correttamente.

Sincronizzazione

Dopo aver configurato la connessione, puoi sincronizzare gli eventi manualmente cliccando Sync. La sincronizzazione automatica viene eseguita in base all'intervallo impostato (richiede il cron di Laravel configurato).

4. Tipologie e Gestione Dati

Tipologie Documenti

Le tipologie classificano i documenti (avatar, galleria, documento, statuto, altro).

Si gestiscono in Impostazioni → Tipologie Documenti. Puoi aggiungere, rinominare, riordinare ed eliminare tipologie (tranne quelle con documenti associati).

Tipologie Individui

Classificano gli individui (es. socio, volontario, dipendente). Si gestiscono in Impostazioni → Tipologie.

Tipologie Eventi

Classificano gli eventi (es. riunione, assemblea, formazione). Si gestiscono in Impostazioni → Tipologie Eventi.

Ruoli Individui

Definiscono il ruolo o la carica di un individuo (es. presidente, segretario, tesoriere). Si gestiscono in Impostazioni → Ruoli.

Visibilità Documenti

Ogni documento può avere diversi livelli di visibilità:

• Pubblico — visibile a tutti gli utenti
• Individuo — visibile solo a uno specifico individuo
• Gruppo — visibile solo ai membri di un gruppo
• Evento — visibile solo ai partecipanti di un evento
• Mailing — visibile solo ai membri di una mailing list

Tag

I tag affiancano le tipologie con un sistema trasversale di classificazione applicabile a individui, gruppi, eventi, documenti e mailing list. A differenza delle tipologie (specifiche per ogni entità), i tag sono condivisi tra tutte le entità e permettono ricerche incrociate.

Vedi la sezione Tag e Ricerca per Tag per la gestione e l'assegnazione.

5. Email / SMTP

Configurazione Email

Vai in Impostazioni → Email per configurare la posta elettronica.

Server IMAP (Ricezione)

Usato per ricevere e leggere le email direttamente nell'app.

Server SMTP (Invio)

Usato per inviare email dall'app. Supporta account multipli (mittenti).

Gmail / Google Workspace

Mailing

Le Mailing List permettono di inviare email a gruppi predefiniti di destinatari.

• Crea una mailing list in Mailing List → Nuova
• Puoi popolare la lista da individui, gruppi o manualmente
• Invia email alla lista da Email → Nuova Email, selezionando la mailing list come destinatario

Test connessione

Dopo aver configurato i server, usa il pulsante Test Connessione per verificare che IMAP e SMTP funzionino correttamente.

6. Guida all'Installazione

Panoramica

L'installazione avviene tramite l'interattivo install.php che guida passo-passo. Supporta due modalità:

Requisiti del Server

Installazione Passo-Passo

Passo 1: Preparare il server LAMP

sudo apt update && sudo apt upgrade -y

sudo apt install -y apache2 mariadb-server php8.4 php8.4-cli \
  php8.4-mysql php8.4-xml php8.4-mbstring php8.4-curl \
  php8.4-zip php8.4-bcmath php8.4-gd php8.4-intl \
  composer git unzip

sudo a2enmod rewrite
sudo systemctl restart apache2

Passo 2: Ottenere l'applicazione

Puoi clonare il repository con git oppure estrarre il file ZIP ricevuto nella cartella /var/www/glastree.

cd /var/www

# Opzione A — Git clone
git clone <URL_REPOSITORY> glastree

# Opzione B — ZIP (se non hai git)
# unzip /percorso/del/glastree.zip -d glastree

cd glastree

Passo 3: Eseguire l'installer

Lancia l'installer interattivo che guida attraverso tutte le fasi:

php install.php

L'installer chiede: modalità (Fresh Install Apache/Docker o Restore), nome sito, dati amministratore, URL pubblico, database (MySQL o SQLite).
Esegue automaticamente: .env + APP_KEY, composer, migration/seed, admin user, asset (se npm presente), permessi.

Passo 4: Configurare Apache (solo Fresh Install)

sudo tee /etc/apache2/sites-available/glastree.conf <<APACHE
<VirtualHost *:80>
    ServerName glastree.esempio.it
    DocumentRoot /var/www/glastree/public

    <Directory /var/www/glastree/public>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog \${APACHE_LOG_DIR}/glastree_error.log
    CustomLog \${APACHE_LOG_DIR}/glastree_access.log combined
</VirtualHost>
APACHE

sudo a2dissite 000-default.conf
sudo a2ensite glastree.conf
sudo systemctl reload apache2

Configura SSL con Let's Encrypt dopo l'installazione.

Restore da Backup:

# Importa il database
# mysql -u root -p glastree < database.sql

# Ripristina i file dei documenti
# tar -xzf storage.tar.gz -C storage/

# Rigenera APP_KEY
php artisan key:generate

# Crea il collegamento storage
php artisan storage:link

Dopo l'Installazione

1. Configura SSL con Let's Encrypt:

   sudo apt install -y certbot python3-certbot-apache
   sudo certbot --apache -d glastree.esempio.it

2. Accedi con le credenziali amministratore create durante l'installazione
3. Configura l'applicazione in Impostazioni:
   • Nome applicazione e logo
   • Email (SMTP per invio, IMAP per ricezione)
   • Repository remoti (Google Drive, Nextcloud)
4. Crea utenti dal pannello Admin → Utenti
5. Configura il cron per backup automatico e sync email:

   sudo crontab -u www-data -e
   # Inserisci:
   * * * * * cd /var/www/glastree && php artisan schedule:run >> /dev/null 2>&1

Risoluzione Problemi

sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

php artisan key:generate

sudo a2enmod rewrite
# Nel VirtualHost: AllowOverride All
sudo systemctl reload apache2

7. Backup e Migrazione Server

Cos'è

Il sistema di backup crea un archivio ZIP contenente tutto il necessario per ripristinare l'applicazione su un nuovo server. Include database, file caricati e configurazione.

Cosa include il backup

Come eseguire un backup

php artisan backup:run

Backup automatico

Puoi abilitare il backup automatico dalla pagina Admin → Backup:

• Frequenza: giornaliero, settimanale o mensile
• Ora: consigliata 03:00 (notte)
• Requisito: il cron di Laravel deve essere configurato sul server

* * * * * cd {{ base_path() }} && php artisan schedule:run >> /dev/null 2>&1

Procedura di Migrazione Completa

Segui questa procedura per migrare l'applicazione su un nuovo server LAMP (Linux, Apache, MySQL, PHP).

Passo 1: Preparazione del server

sudo apt update && sudo apt upgrade -y

Passo 2: Installa LAMP + PHP 8.4

sudo apt install -y apache2 mariadb-server php8.4 php8.4-cli \
  php8.4-mysql php8.4-xml php8.4-mbstring php8.4-curl \
  php8.4-zip php8.4-bcmath php8.4-gd php8.4-intl \
  composer git unzip

sudo a2enmod rewrite

Passo 3: Ottieni l'applicazione

Puoi clonare il repository con git oppure estrarre il file ZIP ricevuto nella cartella /var/www/glastree.

cd /var/www

# Opzione A — Git clone
git clone <URL_REPOSITORY> glastree

# Opzione B — ZIP (se non hai git)
# unzip /percorso/del/glastree.zip -d glastree

cd glastree
composer install --no-dev --optimize-autoloader
npm ci && npm run build

Passo 4: Carica il backup

Copia il file backup.zip sul nuovo server e estrailo:

mkdir -p /tmp/restore
unzip backup.zip -d /tmp/restore/
ls -la /tmp/restore/
# Dovresti vedere: database.sql  .env  files/  manifest.json

Passo 5: Crea database e importa

sudo mysql -u root <<EOF
CREATE DATABASE glastree CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'glastree'@'localhost' IDENTIFIED BY 'ScegliPasswordFortep4ss!';
GRANT ALL ON glastree.* TO 'glastree'@'localhost';
FLUSH PRIVILEGES;
EOF

mysql -u glastree -p glastree < /tmp/restore/database.sql

Passo 6: Configura .env

cp /tmp/restore/.env .env
# Modifica se necessario:
#   APP_URL=https://nuovo-dominio.it
#   DB_HOST=localhost
#   DB_DATABASE=glastree
#   DB_USERNAME=glastree
#   DB_PASSWORD=ScegliPasswordFortep4ss!

#  DECIDI SULL'APP_KEY (leggi avviso sopra!)
#  php artisan key:generate   ← SOLO se non hai il .env originale

Passo 7: Ripristina file e permessi

cp -r /tmp/restore/files/* storage/app/documenti/

sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 755 storage bootstrap/cache

php artisan storage:link

Passo 8: Cache

php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache

Passo 9: Configura Apache

sudo tee /etc/apache2/sites-available/glastree.conf <<APACHE
<VirtualHost *:80>
    ServerName glastree.esempio.it
    DocumentRoot /var/www/glastree/public

    <Directory /var/www/glastree/public>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog \${APACHE_LOG_DIR}/glastree_error.log
    CustomLog \${APACHE_LOG_DIR}/glastree_access.log combined
</VirtualHost>
APACHE

sudo a2dissite 000-default.conf
sudo a2ensite glastree.conf
sudo systemctl reload apache2

Passo 10: SSL Let's Encrypt

sudo apt install -y certbot python3-certbot-apache
sudo certbot --apache -d glastree.esempio.it

Passo 11: Cron per backup automatico

sudo crontab -u www-data -e
# Inserisci:
* * * * * cd /var/www/glastree && php artisan schedule:run >> /dev/null 2>&1

Passo 12: Verifica finale

1. Apri https://glastree.esempio.it nel browser
2. Fai login con le credenziali esistenti
3. Verifica: Dashboard, Documenti, Impostazioni, Email
4. Se hai rigenerato APP_KEY: riconfigura SMTP e OAuth Google Drive

Comandi Artisan

Per installazione e ripristino usa i comandi Artisan da terminale. Vedi la sezione Installazione per la guida completa.

8. Docker

Creare un'immagine Docker con dati di base

Puoi creare un'immagine Docker pronta all'uso che include l'applicazione e i dati di base (tipologie documenti, tipologie eventi, ruoli). Scegli la configurazione in base alle tue esigenze:

1. Dockerfile (comune a entrambe le modalità)

FROM php:8.4-apache

# Abilita mod_rewrite
RUN docker-php-ext-enable opcache \
    && a2enmod rewrite

# Installa estensioni PHP (sia SQLite che MySQL)
RUN docker-php-ext-install pdo_mysql pdo_sqlite bcmath gd zip

# Installa Composer
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer

# Configura DocumentRoot per Laravel
ENV APACHE_DOCUMENT_ROOT=/var/www/html/public
RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/sites-available/*.conf \
    && sed -ri -e 's!/var/www/!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/apache2.conf /etc/apache2/conf-available/*.conf

# Copia l'applicazione
COPY . /var/www/html/

# Installa dipendenze e compila asset
RUN composer install --no-dev --optimize-autoloader \
    && mkdir -p storage/app/public \
    && mkdir -p storage/framework/cache/data \
    && mkdir -p storage/framework/sessions \
    && mkdir -p storage/framework/views \
    && mkdir -p storage/logs \
    && mkdir -p bootstrap/cache \
    && chown -R www-data:www-data storage bootstrap/cache

# Entrypoint per inizializzazione
COPY docker-entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/docker-entrypoint.sh

ENTRYPOINT ["docker-entrypoint.sh"]
CMD ["apache2-foreground"]

2. Entrypoint Script (comune)

Crea docker-entrypoint.sh. Lo script rileva automaticamente la configurazione in base alle variabili d'ambiente:

#!/bin/bash
set -e

# Se .env non esiste, lo genera dalle variabili d'ambiente
if [ ! -f .env ]; then
    cp .env.example .env

    if [ "$DB_CONNECTION" = "mysql" ]; then
        # Configura MySQL
        sed -i "s/DB_CONNECTION=mysql/DB_CONNECTION=mysql/" .env
        sed -i "s/DB_HOST=.*/DB_HOST=${DB_HOST:-mysql}/" .env
        sed -i "s/DB_PORT=.*/DB_PORT=${DB_PORT:-3306}/" .env
        sed -i "s/DB_DATABASE=.*/DB_DATABASE=${DB_DATABASE:-glastree}/" .env
        sed -i "s/DB_USERNAME=.*/DB_USERNAME=${DB_USERNAME:-glastree}/" .env
        sed -i "s/DB_PASSWORD=.*/DB_PASSWORD=${DB_PASSWORD:-secret}/" .env

        # Attende che MySQL sia pronto
        echo "Attendo MySQL..."
        until php -r "new PDO('mysql:host=${DB_HOST:-mysql};dbname=${DB_DATABASE:-glastree}', '${DB_USERNAME:-glastree}', '${DB_PASSWORD:-secret}');" 2>/dev/null; do
            sleep 2
        done
        echo "MySQL pronto."
    else
        # Configura SQLite
        sed -i 's/DB_CONNECTION=mysql/DB_CONNECTION=sqlite/' .env
        sed -i 's/DB_HOST=.*//' .env
        sed -i 's/DB_PORT=.*//' .env
        sed -i 's/DB_DATABASE=.*/DB_DATABASE=\/var\/www\/html\/database\/database.sqlite/' .env
        sed -i 's/DB_USERNAME=.*//' .env
        sed -i 's/DB_PASSWORD=.*//' .env

        touch database/database.sqlite
        chmod 664 database/database.sqlite
    fi

    # Genera APP_KEY
    php artisan key:generate --force
fi

# Esegui migration e seed se il database è vuoto
if [ ! -f .db_initialized ]; then
    php artisan migrate --force
    php artisan db:seed --force
    touch .db_initialized
fi

# Configura storage link
php artisan storage:link --force 2>/dev/null || true

exec "$@"

chmod +x docker-entrypoint.sh

3. Seed Base Dati (comune)

Per includere tipologie documenti, tipologie eventi e ruoli, crea un seeder dedicato:

php artisan make:seeder DockerBaseDataSeeder

Contenuto di database/seeders/DockerBaseDataSeeder.php:

<?php

declare(strict_types=1);

namespace Database\Seeders;

use Illuminate\Database\Seeder;
use Illuminate\Support\Facades\DB;

class DockerBaseDataSeeder extends Seeder
{
    public function run(): void
    {
        // Tipologie Documenti
        $tipologieDoc = ['documento', 'avatar', 'galleria', 'statuto', 'programma', 'locandina', 'altro'];
        foreach ($tipologieDoc as $ord => $nome) {
            DB::table('tipologie_documenti')->updateOrInsert(
                ['nome' => $nome],
                ['descrizione' => ucfirst($nome), 'ordine' => $ord + 1, 'attiva' => true]
            );
        }

        // Tipologie Eventi
        $tipologieEventi = [
            ['nome' => 'catechesi', 'descrizione' => 'Catechesi'],
            ['nome' => 'liturgia', 'descrizione' => 'Liturgia'],
            ['nome' => 'animazione', 'descrizione' => 'Animazione'],
            ['nome' => 'formazione', 'descrizione' => 'Formazione'],
            ['nome' => 'incontro', 'descrizione' => 'Incontro'],
            ['nome' => 'riunione', 'descrizione' => 'Riunione'],
            ['nome' => 'festa', 'descrizione' => 'Festa'],
            ['nome' => 'altro', 'descrizione' => 'Altro'],
        ];
        foreach ($tipologieEventi as $ord => $t) {
            DB::table('tipologie_eventi')->updateOrInsert(
                ['nome' => $t['nome']],
                ['descrizione' => $t['descrizione'], 'ordine' => $ord + 1, 'attiva' => true]
            );
        }

        // Ruoli
        $ruoli = ['presidente', 'vicepresidente', 'segretario', 'tesoriere', 'consigliere', 'volontario', 'socio', 'altro'];
        foreach ($ruoli as $ord => $nome) {
            DB::table('ruoli')->updateOrInsert(
                ['nome' => $nome],
                ['descrizione' => ucfirst($nome), 'ordine' => $ord + 1, 'attiva' => true]
            );
        }
    }
}

Registralo in database/seeders/DatabaseSeeder.php:

$this->call([
    // ... altri seeder ...
    DockerBaseDataSeeder::class,
]);

4. Docker Compose

Opzione A — SQLite (leggero)

services:
  glastree:
    build: .
    ports:
      - "8080:80"
    volumes:
      - glastree_storage:/var/www/html/storage
      - glastree_db:/var/www/html/database
    environment:
      - APP_ENV=production
      - APP_DEBUG=false
      - APP_URL=http://localhost:8080
      - DB_CONNECTION=sqlite

volumes:
  glastree_storage:
  glastree_db:

Opzione B — MySQL (standard)

services:
  glastree:
    build: .
    ports:
      - "8080:80"
    volumes:
      - glastree_storage:/var/www/html/storage
    depends_on:
      mysql:
        condition: service_healthy
    environment:
      - APP_ENV=production
      - APP_DEBUG=false
      - APP_URL=http://localhost:8080
      - DB_CONNECTION=mysql
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_DATABASE=glastree
      - DB_USERNAME=glastree
      - DB_PASSWORD=secret

  mysql:
    image: mysql:8.0
    volumes:
      - mysql_data:/var/lib/mysql
    environment:
      - MYSQL_DATABASE=glastree
      - MYSQL_USER=glastree
      - MYSQL_PASSWORD=secret
      - MYSQL_ROOT_PASSWORD=root_secret
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 5s
      timeout: 3s
      retries: 10

volumes:
  glastree_storage:
  mysql_data:

5. Build e avvio

Assicurati di essere nella cartella del progetto (ottenuta via git clone o estraendo il ZIP), poi:

# Costruisci l'immagine (comune)
docker build -t glastree:latest .

# Avvia con SQLite
docker compose -f docker-compose.yml up -d

# Oppure avvia con MySQL
# docker compose -f docker-compose.mysql.yml up -d

# Apri nel browser
open http://localhost:8080

6. Primo accesso

Al primo avvio, l'entrypoint esegue automaticamente migration e seed. Troverai già popolati:

• Tipologie Documenti: documento, avatar, galleria, statuto, programma, locandina, altro
• Tipologie Eventi: catechesi, liturgia, animazione, formazione, incontro, riunione, festa, altro
• Ruoli: presidente, vicepresidente, segretario, tesoriere, consigliere, volontario, socio, altro

Dovrai creare il primo utente amministratore via CLI:

docker exec -it glastree php artisan tinker --execute="
\$u = new \App\Models\User;
\$u->name = 'Amministratore';
\$u->email = 'admin@esempio.it';
\$u->password = bcrypt('password-forte');
\$u->is_admin = true;
\$u->permissions = ['individui' => 2, 'gruppi' => 2, 'eventi' => 2, 'documenti' => 2, 'mailing' => 2, 'viste' => 2, 'report' => 2, 'settings' => 2];
\$u->save();
echo 'Utente creato con successo!';
"

9. Tag e Ricerca per Tag

Cos'è il sistema di Tag

I tag permettono di classificare e raggruppare trasversalmente elementi di tipo diverso: individui, gruppi, eventi, documenti e mailing list. A differenza delle tipologie (specifiche per ogni entità), i tag sono condivisi tra tutte le entità.

Gestione Tag

Vai in Impostazioni → Tag per creare, modificare, riordinare ed eliminare i tag. Ogni tag ha:

• Nome — il nome visualizzato
• Colore — colore personalizzato per il badge (es. #dc3545 per rosso)
• Slug — identificatore univoco generato automaticamente dal nome

Assegnare Tag

I tag si assegnano nelle pagine di creazione e modifica di ciascuna entità — individui, gruppi, eventi, documenti, mailing list — tramite il selettore a pillole colorate. Clicca su un tag per selezionarlo (il badge diventa opaco), clicca di nuovo per deselezionarlo. Usa la barra di ricerca per filtrare i tag per nome.

Assegnazione Massiva di Tag

Puoi assegnare o rimuovere tag a più elementi contemporaneamente:

• Individui: seleziona gli individui nella tabella, apri Azioni → Assegna Tag, scegli Assegna/Rimuovi e seleziona i tag
• Gruppi: stessa procedura — seleziona i gruppi, Azioni → Assegna Tag
• Documenti: seleziona i documenti, pulsante Tag nella toolbar

Filtrare per Tag

In ogni pagina elenco (Individui, Gruppi, Eventi, Documenti, Mailing List) trovi una barra con tutti i tag. Clicca su un tag per filtrare la tabella mostrando solo gli elementi con quel tag. Clicca Cancella filtri per rimuovere il filtro.

Ricerca per Tag

La sezione Ricerca per Tag (sidebar → Ricerca per Tag) permette di trovare elementi di qualsiasi tipo in base ai tag:

• Tag singolo: seleziona un tag per vedere tutti gli elementi associati
• Tag multipli (AND): seleziona più tag (Ctrl+click) per trovare elementi che hanno tutti i tag selezionati — utile per ricerche precise (es. "animatore" + "giovane")

I risultati sono raggruppati per tipo con info-box colorati e tabelle dettagliate.