TeraWare

TeraWare è un progetto realizzato durante il corso di Tecnologie Software per il Web tenuto dalla prof. Rita Francse durante l'a.a. 2020/2021.

Report Bug · Pull Request

Table of Contents

• Descrizione
  • Software
• Come iniziare
  • Prerequisiti
  • Esecuzione
• Per contribuire
• Licenza

Descrizione

TeraWare è un sito web di e-commerce specializzato nella vendita di prodotti di informatica per il gaming e l'ufficio. Il frontend è realizzato interamente senza l'utilizzo di template o librerie. Per il backend con Java sono utilizzate (al momento) solo le librerie Gson di Google per la gestione di dati in formato JSON e JDBC come driver per la connessione al database MySQL.

Software

• Java EE
• MySQL
• Sass
• Tomcat 9.0

Come iniziare

Per far partire il sito sul tuo computer assicurati di installare tutti i software della sezione seguente e poi segui i passaggi per lanciare il sito.

Prerequisiti

• Compilatore Sass
• MySQL
• Eclipse for Java EE
• Tomcat
• NodeJS (opzionale)

Esecuzione

1. Clona la repo

$ git clone https://github.com/xrenegade100/TeraWare

2. Apri Eclipse for Java EE
   • File > Import > Existing projects into workspace
   • Seleziona la cartella che contiene la repo clonata
   • Clicca Finish
3. Clicca con il tastro destro sul progetto nel Project Explorer di Eclipse
   1. Clicca Configure Build Path
   2. Seleziona Classpath
   3. Sulla sinistra clicca Add Library
   4. Scegli JRE System Library e aggiungi un'istanza di Java
   5. Ripeti i passaggi iii. e iv. scegliendo Server Runtime e aggiungi un server Tomcat
   6. Sulla sinistra clicca Add External JARs e naviga in /TeraWare/site/WebContent/WEB-INF/lib/, seleziona tutti i file JAR e aggiungili.
4. Compila i file Sass (è preferibile tramite Visual Studio Code con Live Sass Compiler, aprendo la cartella site che si trova nella root della repo e poi cliccando su Watch Sass) In alternativa da un terminale:

   $ npm i
   $ npm run scss:build

   Nota che i comandi precedenti compilano i file scss e generano i file css in versione compressa. Per generare anche i file css non compressi usa:

   $ npm run scss:build -- -u

   Per cancellare tutti i file css generati usa:

   $ npm run scss:clean

5. In Eclipse naviga in WebContent > install, clicca con il tasto destro su install.jsp > Run As > Run On Server e segui i passaggi per l'installazione del sito.

Per contribuire

Ogni Pull Request è ben accetta, prima però, apri un issue per discutere dei cambiamenti che vorresti fare 😁

Licenza

MIT