From 1b552ef6be2199944f7e66601c076ffd34d1b1e1 Mon Sep 17 00:00:00 2001
From: Thomas Zilio <Dasc3er@users.noreply.github.com>
Date: Fri, 7 Aug 2020 11:05:08 +0200
Subject: [PATCH] Descrizione sulle classi di importazione

---
 modules/aggiornamenti/src/UpdateHook.php | 3 +++
 modules/anagrafiche/src/Import/CSV.php   | 5 +++++
 modules/articoli/src/Import/CSV.php      | 5 +++++
 modules/backups/src/BackupHook.php       | 3 +++
 modules/primanota/src/Mastrino.php       | 6 ++++++
 5 files changed, 22 insertions(+)

diff --git a/modules/aggiornamenti/src/UpdateHook.php b/modules/aggiornamenti/src/UpdateHook.php
index b28ca6b07..d2a96bd28 100755
--- a/modules/aggiornamenti/src/UpdateHook.php
+++ b/modules/aggiornamenti/src/UpdateHook.php
@@ -7,6 +7,9 @@ use Hooks\CachedManager;
 use Modules;
 use Update;
 
+/**
+ * Hook dedicato all'individuazione di nuove versioni del gestionale, pubblicate sulla repository ufficiale di GitHub.
+ */
 class UpdateHook extends CachedManager
 {
     protected static $client = null;
diff --git a/modules/anagrafiche/src/Import/CSV.php b/modules/anagrafiche/src/Import/CSV.php
index aec0d85f6..36bc18154 100644
--- a/modules/anagrafiche/src/Import/CSV.php
+++ b/modules/anagrafiche/src/Import/CSV.php
@@ -5,6 +5,11 @@ namespace Modules\Anagrafiche\Import;
 use Importer\CSVImporter;
 use Modules\Anagrafiche\Anagrafica;
 
+/**
+ * Struttura per la gestione delle operazioni di importazione (da CSV) delle Anagrafiche.
+ *
+ * @since 2.4.17
+ */
 class CSV extends CSVImporter
 {
     public function getAvailableFields()
diff --git a/modules/articoli/src/Import/CSV.php b/modules/articoli/src/Import/CSV.php
index c65fa5195..cdedf73c2 100644
--- a/modules/articoli/src/Import/CSV.php
+++ b/modules/articoli/src/Import/CSV.php
@@ -7,6 +7,11 @@ use Modules\Articoli\Articolo;
 use Modules\Articoli\Categoria;
 use Modules\Iva\Aliquota;
 
+/**
+ * Struttura per la gestione delle operazioni di importazione (da CSV) degli Articoli.
+ *
+ * @since 2.4.17
+ */
 class CSV extends CSVImporter
 {
     public function getAvailableFields()
diff --git a/modules/backups/src/BackupHook.php b/modules/backups/src/BackupHook.php
index bac7f9a34..dedc0a371 100755
--- a/modules/backups/src/BackupHook.php
+++ b/modules/backups/src/BackupHook.php
@@ -5,6 +5,9 @@ namespace Modules\Backups;
 use Backup;
 use Hooks\Manager;
 
+/**
+ * Hook dedicato alla gestione del backup giornaliero automatico, se abilitato da Impostazioni.
+ */
 class BackupHook extends Manager
 {
     public function isSingleton()
diff --git a/modules/primanota/src/Mastrino.php b/modules/primanota/src/Mastrino.php
index 3f9986d97..99cfc22fc 100755
--- a/modules/primanota/src/Mastrino.php
+++ b/modules/primanota/src/Mastrino.php
@@ -6,6 +6,12 @@ use Common\Model;
 use Modules\Fatture\Fattura;
 use Modules\Scadenzario\Scadenza;
 
+/**
+ * Struttura ausiliaria dedicata alla raggruppamento e alla gestione di un insieme di Movimenti, unificati attraverso il numero di mastrino.
+ *
+ * Questa classe non è utilizzabile come normale modello Eloquent poichè non prevede operazioni di modifica a livello di database.
+ * La creazione di un record può essere utilizzata per la gestione di un insieme di Movimenti, mentre l'eliminazione provoca la rimozione in cascata dei Movimenti associati al Mastrino.
+ */
 class Mastrino extends Model
 {
     public $incrementing = false;