Questo progetto riguarda lo sviluppo di un sito per gli studenti delle superiori, in grado di gestire in modo autonomo l'organizzazione delle autogestioni e un insieme di citazioni memorabili dei professori.

L'idea originale è nata dalla necessità, per l'istituto IIS Euganeo di Este (PD), di gestire le iscrizioni ai diversi corsi che compongono le autogestioni locali in modo semplice e rapido, senza dover chiedere un elenco ad ogni classe o affiggere tabelloni cartacei spesso ignorati.

Per dare una rapida occhiata al risultato, il sito dell'IIS Euganeo è online all'indirizzo http://www.itiseuganeo.altervista.org/.

Funzioni principali:

• Gestione delle proposte per i corsi, effettuate dagli studenti e da approvare dai Rappresentanti d'Istituto;
• Gestione delle iscrizioni ai corsi, completa di assegnazione casuale in caso di mancata iscrizione;
• Gestione delle citazioni, suddivise per professore;
• Gestione delle utenze degli studenti per anni differenti.

• Tabella dei contenuti
• Per iniziare
  • Prerequisiti
  • Installazione
    • Versioni
    • Github
• Contribuire
• Licenza

Prima di iniziare l'installazione, è necessario procedere al download di una versione del progetto da Github. Si consiglia inoltre di controllare che i prerequisiti del software, elencati di seguito, siano soddisfatti.

• PHP >= 5.6
• Uno dei seguenti DBMS (preferibilmente aggiornato alle versioni più recenti)
  • MySQL
  • Postgres
  • SQLite
  • SQL Server

Per procedere all'installazione è necessario seguire i seguenti punti:

1. Creare una cartella (qui denominata test) nella root del sever web installato ed estrarvi il codice sorgente della sito;

2. Creare un database vuoto (tramite PHPMyAdmin o da riga di comando);

3. Accedere a http://localhost/test dal vostro browser;

4. Ritoccare i valori interni al file config.yml per la connessione al database e le impostazioni basilari.

5. Eseguire da riga di comando la seguente istruzione per completare l'installazione del database.

   php vendor/robmorgan/phinx/bin/phinx migrate

Per mantenere un elevato grado di trasparenza riguardo al ciclo delle release, seguiamo le linee guida Semantic Versioning (SemVer) per definire le versioni del progetto. Per vedere tutte le versioni disponibili al download, visitare la pagina relativa su Github.

Nel caso si stia utilizzando le versioni direttamente ottenuta dalla repository di Github, è necessario eseguire i seguenti comandi da linea di comando per completare le dipendenze necessarie al funzionamento del progetto, sia PHP (tramite Composer) che relative agli asssets utilizzati (tramite Bower) dal sito.

php composer.phar install
php composer.phar update
npm install -g bower
npm install -g gulp
npm install
bower install
bower update
gulp

In alternativa alla sequenza di comandi precedente, è possibile utilizzare il seguente comando (richiede l'installazione di GIT e NPM, oltre che l'inserimento dell'archivio composer.phar nella cartella principale del progetto):

npm run init-project

Per ulteriori informazioni, visitare le sezioni Assets e Framework della documentazione.

Se avete suggerimenti o avete individuato malfunzionamenti, siete pregati di segnalarli tramite l'apposita sezione su Github oppure attraverso la sezione di contatto nel sito dell'IIS Euganeo.

Questo progetto è tutelato dalla licenza MIT (vedere LICENSE per ulteriori dettagli).