Miglioramento documentazione

README.md

@@ -135,11 +135,11 @@ Le impostazione di base per il codice sono disponibili attraverso [editor config
 Maggiori informazioni sulla configurazione e sul plugin sono disponibili nel sito <http://editorconfig.org>.
 
 Per eseguire i test del progetto è necessario seguire le seguenti istruzioni (https://codeception.com/docs/modules/WebDriver):
-- Scaricare (Selenium Server)[https://docs.seleniumhq.org/download/]
+- Scaricare (Selenium Server)[https://docs.seleniumhq.org/download/] e salvarlo come `selenium-server-standalone.jar`
 - Scaricare (ChromeDriver)[https://sites.google.com/a/chromium.org/chromedriver/getting-started]
     - Su Windows, aggiungere l'eseguibile al PATH
 - Configurare localmente Codeception nel file `codeception.yml`
-- Eseguire da riga di comando:
+- Eseguire su shell differenti i seguenti comandi:
 ```bash
 npm run tests-server
 npm run tests-OSM

tests/_support/Helper/Acceptance.php

@@ -7,6 +7,12 @@ namespace Helper;
 
 class Acceptance extends \Codeception\Module
 {
+    /**
+     * Effettua il login dalla pagina principale.
+     *
+     * @param string $username
+     * @param string $password
+     */
     public function login($username, $password)
     {
         $t = $this->getAcceptanceModule();
@@ -19,6 +25,12 @@ class Acceptance extends \Codeception\Module
         $this->clickAndWait('Accedi');
     }
 
+    /**
+     * Clicca sul pulsante e attende la conclusione del caricamento.
+     *
+     * @param $link
+     * @param $context
+     */
     public function clickAndWait($link, $context = null)
     {
         $t = $this->getAcceptanceModule();
@@ -28,6 +40,12 @@ class Acceptance extends \Codeception\Module
         $t->waitForElementNotVisible('#main_loading');
     }
 
+    /**
+     * Clicca sul pulsante e attende la conclusione del caricamento del modal.
+     *
+     * @param $link
+     * @param $context
+     */
     public function clickAndWaitModal($link, $context = null)
     {
         $t = $this->getAcceptanceModule();
@@ -37,6 +55,13 @@ class Acceptance extends \Codeception\Module
         $t->waitForElementVisible('.modal');
     }
 
+    /**
+     * Imposta il valore di un select gestito dal framework Select2.
+     *
+     * @param $selector
+     * @param $option
+     * @param int $timeout seconds. Default to 1
+     */
     public function select2($selector, $option, $timeout = 5)
     {
         $select2 = $this->getModule('\Helper\Select2');

tests/acceptance/AnagraficheCest.php

@@ -2,19 +2,30 @@
 
 class AnagraficheCest
 {
+    /**
+     * Crea una nuova anagrafica di tipo Cliente.
+     *
+     * @param AcceptanceTester $t
+     */
     public function addWorks(AcceptanceTester $t)
     {
+        // Effettua l'accesso con le credenziali fornite
         $t->login('admin', 'admin');
 
+        // Seleziona il modulo da aprire
         $t->clickAndWait('Anagrafiche', '.sidebar');
 
+        // Apre la schermata di nuovo elemento
         $t->clickAndWaitModal('.btn-primary', '#tabs');
 
+        // Completa i campi per il nuovo elemento
         $t->fillField('Ragione sociale', 'TEST');
         $t->select2('#idtipoanagrafica', '1');
 
+        // Effettua il submit
         $t->clickAndWait('Aggiungi', '#add-form');
 
+        // Controlla il salvataggio finale
         $t->see('Dati anagrafici');
     }
 }