#!/usr/bin/env bash
  #
  # @project       : Domuscan App
  # @filename      : verifica_ambiente.sh
  # @author        : Damiano | <dagneni@gmail.com>
  # @description   : Verifica che l'ambiente (sviluppo, staging o produzione) disponga di
  #                  PHP, delle estensioni e degli strumenti a riga di comando richiesti.
  #                  Ogni requisito indica la fase del piano pilota da cui diventa obbligatorio:
  #                  con --fase N i requisiti delle fasi successive sono solo avvisi.
  #                  Termina con codice 1 se manca almeno un requisito obbligatorio.
  #                  Con --ruolo server git e composer sono solo avvisi: sul server il codice
  #                  arriva in un pacchetto già completo di vendor/ (piano 261113, decisioni 6 e 7).
  # @creation date : 06-10-2026
  # @last update   : 13-11-2026
  #
  # @version: 0.4.0
  #
  # Uso: strumenti/verifica_ambiente.sh [--fase N] [--ruolo sviluppo|server]
  #      (predefiniti: tutte le fasi, 1-6; ruolo sviluppo)

set -u

# Versione minima di PHP: 8.3 (le librerie candidate richiedono almeno 8.2,
# il cui supporto di sicurezza termina il 31/12/2026, prima della produzione)
readonly VERSIONE_MINIMA_PHP="8.3.0"
readonly ULTIMA_FASE=6

# Estensioni PHP: nome, fase da cui sono obbligatorie, motivo
readonly ESTENSIONI_RICHIESTE=(
  "pdo_mysql:1:database MariaDB (D12)"
  "sodium:1:firma Ed25519 del sigillo (D5) e cifratura del Vault"
  "mbstring:1:gestione testi UTF-8, richiesta da php-qrcode"
  "openssl:1:invio email con TLS, estrazione delle fatture firmate .p7m"
  "fileinfo:2:riconoscimento del tipo dei file acquisiti"
  "dom:3:parsing FatturaPA XML"
  "simplexml:3:parsing FatturaPA XML"
  "libxml:3:parsing FatturaPA XML"
  "iconv:4:conversione di codifica dei testi estratti"
  "zlib:5:lettura e scrittura PDF (FPDF/FPDI)"
  "gd:5:immagini dei QR Code (FPDF)"
)

fase_verificata=$ULTIMA_FASE
ruolo="sviluppo"
numero_mancanti=0
numero_avvisi=0

  #
  # @description: Legge gli argomenti della riga di comando
  # @param string $@ Argomenti dello script
  # @return void
  #
function leggiArgomenti() {
  while [ $# -gt 0 ]; do
    case "$1" in
      --fase)
        if ! [[ "${2:-}" =~ ^[1-6]$ ]]; then
          echo "Uso: $0 [--fase N]  (N da 1 a ${ULTIMA_FASE})" >&2
          exit 2
        fi
        fase_verificata="$2"
        shift 2
        ;;
      --ruolo)
        if ! [[ "${2:-}" =~ ^(sviluppo|server)$ ]]; then
          echo "Uso: $0 [--fase N] [--ruolo sviluppo|server]" >&2
          exit 2
        fi
        ruolo="$2"
        shift 2
        ;;
      *)
        echo "Argomento non riconosciuto: $1" >&2
        exit 2
        ;;
    esac
  done
}

  #
  # @description: Stampa l'esito positivo di un controllo
  # @param string $1 Nome del requisito
  # @param string $2 Dettaglio (versione, percorso)
  # @return void
  #
function segnalaPresente() {
  printf "  [OK]       %-22s %s\n" "$1" "$2"
}

  #
  # @description: Stampa un requisito obbligatorio mancante e ne incrementa il contatore
  # @param string $1 Nome del requisito
  # @param string $2 Motivo per cui è richiesto
  # @return void
  #
function segnalaMancante() {
  printf "  [MANCANTE] %-22s %s\n" "$1" "$2"
  numero_mancanti=$((numero_mancanti + 1))
}

  #
  # @description: Stampa un avviso su un requisito facoltativo e ne incrementa il contatore
  # @param string $1 Nome del requisito
  # @param string $2 Messaggio
  # @return void
  #
function segnalaAvviso() {
  printf "  [AVVISO]   %-22s %s\n" "$1" "$2"
  numero_avvisi=$((numero_avvisi + 1))
}

  #
  # @description: Segnala un requisito assente come mancante se è già obbligatorio nella fase
  #               verificata, altrimenti come avviso
  # @param string $1 Nome del requisito
  # @param int    $2 Fase da cui il requisito è obbligatorio
  # @param string $3 Motivo per cui è richiesto
  # @return void
  #
function segnalaAssente() {
  if [ "$2" -le "$fase_verificata" ]; then
    segnalaMancante "$1" "$3"
  else
    segnalaAvviso "$1" "$3 (obbligatorio dalla fase $2)"
  fi
}

  #
  # @description: Confronta due versioni nel formato X.Y.Z
  # @param string $1 Versione da verificare
  # @param string $2 Versione minima
  # @return int 0 se $1 >= $2, 1 altrimenti
  #
function versioneAlmeno() {
  [ "$(printf '%s\n%s\n' "$2" "$1" | sort -V | head -n 1)" = "$2" ]
}

  #
  # @description: Restituisce il primo comando disponibile tra quelli indicati
  # @param string $@ Nomi dei comandi alternativi
  # @return string Nome del comando trovato (vuoto se nessuno)
  #
function primoComandoDisponibile() {
  local comando
  for comando in "$@"; do
    if command -v "$comando" > /dev/null 2>&1; then
      echo "$comando"
      return
    fi
  done
}

  #
  # @description: Verifica la presenza di PHP, la versione minima e le estensioni richieste
  # @return void
  #
function verificaPhp() {
  echo "PHP"
  if ! command -v php > /dev/null 2>&1; then
    segnalaMancante "php" "interprete PHP >= ${VERSIONE_MINIMA_PHP} (D1)"
    segnalaMancante "estensioni PHP" "non verificabili senza PHP"
    return
  fi

  local versione_php
  versione_php=$(php -r 'echo PHP_VERSION;')
  if versioneAlmeno "$versione_php" "$VERSIONE_MINIMA_PHP"; then
    segnalaPresente "php" "$versione_php"
  else
    segnalaMancante "php" "versione $versione_php < ${VERSIONE_MINIMA_PHP}"
  fi

  local moduli_php
  moduli_php=$(php -m | tr '[:upper:]' '[:lower:]' | tr -d '\r')
  local voce nome_estensione fase motivo
  for voce in "${ESTENSIONI_RICHIESTE[@]}"; do
    nome_estensione="${voce%%:*}"
    fase="${voce#*:}"
    fase="${fase%%:*}"
    motivo="${voce#*:*:}"
    if printf '%s\n' "$moduli_php" | grep -qx "$nome_estensione"; then
      segnalaPresente "ext-$nome_estensione" ""
    else
      segnalaAssente "ext-$nome_estensione" "$fase" "$motivo"
    fi
  done
}

  #
  # @description: Verifica gli strumenti a riga di comando usati dalla pipeline documentale
  # @return void
  #
function verificaStrumentiDocumentali() {
  echo "Strumenti documentali"

  # pdftotext deve essere quello di Poppler: serve l'opzione -bbox per le coordinate.
  # Il pdftotext di Xpdf (incluso ad esempio in Git per Windows) non la supporta.
  if command -v pdftotext > /dev/null 2>&1; then
    local aiuto_pdftotext
    aiuto_pdftotext=$(pdftotext -h 2>&1)
    if printf '%s' "$aiuto_pdftotext" | grep -q -- "-bbox"; then
      segnalaPresente "pdftotext (Poppler)" "$(command -v pdftotext)"
    else
      segnalaAssente "pdftotext (Poppler)" 4 "trovato $(command -v pdftotext), ma senza -bbox (probabilmente Xpdf)"
    fi
  else
    segnalaAssente "pdftotext (Poppler)" 4 "estrazione testo e coordinate dai PDF"
  fi

  if command -v qpdf > /dev/null 2>&1; then
    segnalaPresente "qpdf" "$(qpdf --version 2>&1 | head -n 1)"
  else
    segnalaAssente "qpdf" 5 "normalizzazione dei PDF prima dell'overlay (limite FPDI gratuito)"
  fi

  if command -v tesseract > /dev/null 2>&1; then
    segnalaPresente "tesseract" "$(tesseract --version 2>&1 | head -n 1)"
    if tesseract --list-langs 2>&1 | tr -d '\r' | grep -qx "ita"; then
      segnalaPresente "tesseract lingua ita" ""
    else
      segnalaAssente "tesseract lingua ita" 4 "dati di lingua italiana per l'OCR"
    fi
  else
    segnalaAssente "tesseract" 4 "OCR selettivo delle pagine scansionate"
  fi

  if command -v openssl > /dev/null 2>&1; then
    segnalaPresente "openssl" "$(openssl version 2>&1)"
  else
    segnalaAssente "openssl" 3 "verifica e estrazione delle fatture .p7m"
  fi
}

  #
  # @description: Verifica gli strumenti di database, versionamento e dipendenze
  # @return void
  #
function verificaStrumentiSupporto() {
  echo "Database e supporto"

  local client_database dump_database
  client_database=$(primoComandoDisponibile mariadb mysql)
  if [ -n "$client_database" ]; then
    segnalaPresente "$client_database" "$("$client_database" --version 2>&1 | head -n 1)"
  else
    segnalaAssente "mariadb" 1 "client MariaDB per verifiche e ripristini (D12)"
  fi

  dump_database=$(primoComandoDisponibile mariadb-dump mysqldump)
  if [ -n "$dump_database" ]; then
    segnalaPresente "$dump_database" "$("$dump_database" --version 2>&1 | head -n 1)"
  else
    segnalaAssente "mariadb-dump" 1 "backup del database"
  fi

  # Backup (strumenti/backup.sh): cifratura, compressione e archivio
  if command -v gpg > /dev/null 2>&1; then
    segnalaPresente "gpg" "$(gpg --version 2>&1 | head -n 1)"
  else
    segnalaAssente "gpg" 1 "cifratura dei backup con la chiave pubblica del responsabile"
  fi

  if command -v gzip > /dev/null 2>&1; then
    segnalaPresente "gzip" "$(gzip --version 2>&1 | head -n 1)"
  else
    segnalaAssente "gzip" 1 "compressione dei backup"
  fi

  if command -v tar > /dev/null 2>&1; then
    segnalaPresente "tar" "$(tar --version 2>&1 | head -n 1)"
  else
    segnalaAssente "tar" 1 "archivio del Vault nei backup"
  fi

  # Facoltativo: serve solo se BACKUP_REMOTO è impostato (per ora no, decisione 5 del piano 261113)
  if command -v rclone > /dev/null 2>&1; then
    segnalaPresente "rclone" "$(rclone version 2>&1 | head -n 1)"
  else
    segnalaAvviso "rclone" "copia dei backup fuori dal server (facoltativa, solo con BACKUP_REMOTO)"
  fi

  # Sul server non servono: il pacchetto di rilascio contiene già vendor/ (prepara_rilascio.sh)
  if command -v git > /dev/null 2>&1; then
    segnalaPresente "git" "$(git --version 2>&1)"
  elif [ "$ruolo" = "server" ]; then
    segnalaAvviso "git" "non serve sul server: il codice arriva nel pacchetto di rilascio"
  else
    segnalaAssente "git" 1 "versionamento del codice"
  fi

  if command -v composer > /dev/null 2>&1; then
    segnalaPresente "composer" "$(composer --version --no-ansi 2>&1 | head -n 1)"
  elif [ "$ruolo" = "server" ]; then
    segnalaAvviso "composer" "non serve sul server: vendor/ è già nel pacchetto di rilascio"
  else
    segnalaAssente "composer" 1 "installazione delle librerie approvate (PHPMailer, D10)"
  fi
}

leggiArgomenti "$@"

echo "Verifica ambiente Domuscan — fase ${fase_verificata} — ruolo ${ruolo} — $(uname -s) — $(date '+%d-%m-%Y %H:%M')"
echo
verificaPhp
echo
verificaStrumentiDocumentali
echo
verificaStrumentiSupporto
echo
echo "Requisiti mancanti: ${numero_mancanti} · Avvisi: ${numero_avvisi}"

if [ "$numero_mancanti" -gt 0 ]; then
  exit 1
fi
exit 0
