Corso di Ingegneria del Software 2. Progetto basato su mock-up realizzato a lezione. Berlato Stefano, matricola 172811, Giacomo Zara, matricola 172265. Il progetto consiste in un semplice sito internet, la cui funzione è raccogliere annunci di affitti rivolti agli studenti di Trento. A questo scopo è possibile registrarsi come utente e creare-modificare-eliminare inserzioni. E' fornita una funzionalità di ricerca per luogo (centro città, collina, ...), tipologia di sistemazione, disponibilità (in termini di tempo e posti liberi) e altri filtri. La scheda informativa di un annuncio contiene varie foto e descrizione, più i contatti (email, telefono...) di chi ha postato l'annuncio.
Live Demo Heroku: https://infinite-island-97642.herokuapp.com/
Da un punto di vista strutturale, il sito è articolato come riportato nel file "architecture.graphml" (visibile ed editabile con Yed, anche online).
VIEW. Lato client sono presenti:
- 'home_page.html', attraverso la rotta "/" in GET. Fornisce due funzionalità base, ricerca e login/register.
- 'search_insertions.tpl', attraverso la rotta "/search" in GET. Mostra i risultati di una ricerca e i vari filtri disponibili.
- 'insertion_page.tpl', attraverso la rotta "/card" in GET. Rende disponibile descrizione, contatti dell'affittatore, foto e localizzazione nella mappa dell'inserzione selezionata.
- 'user.tpl', attraverso le rotte
- "/register"
- "/login"
- "/add_insertion"
- "/modify_insertion"
- "/delete_insertion" Rende disponibile i dati dell'utente (contatti), un form di controllo (add-modify-delete) e la lista delle inserzioni attualmente attive
CONTROL. Lato server sono presenti:
- 'index.js'. Si occupa della creazione del server e di smistare le rotte.
- 'search_controller.js'. Si occupa della ricerca delle inserzioni (lista e singola). Ha le rotte:
- "/search" GET. Controlla i parametri e ritorna 'search_insertions.tpl' con i dati ricavati dal DB_manager.
- "/card" GET. Controlla i parametri e ritorna 'insertion_page.tpl' con i dati ricavati dal DB_manager.
- 'user_controller.js'. Si occupa degli utenti che vogliono inserire annunci. Ha le rotte:
- "/login" POST. Controlla i parametri e ritorna 'user.tpl' con i dati ricavati dal DB_manager.
- "/register" POST. Controlla i parametri, inserisce il nuovo utente e ritorna 'user.tpl' con i dati ricavati dal DB_manager.
- "insertions_controller.js". Si occupa di gestire add-modify-delete delle inserzioni. Ha le rotte:
- "/add_insertion". Controlla i parametri e aggiunge l'inserzione. Ritorna 'user.tpl'.
- "/modify_insertion". Controlla i parametri e modifica l'inserzione. Ritorna 'user.tpl'.
- "/delete_insertion". Controlla i parametri ed elimina l'inserzione. Ritorna 'user.tpl'.
MODEL. Lato server sono presenti:
- 'DB_manager.js'. Modulo che gestisce i dati. Espone funzioni per la manipolazione degli utenti e inserzioni. In dettaglio:
- add_user(User). Aggiunge il nuovo utente al database. Ritorna un codice numerico per indicare l'esito dell'operazione.
- verify_user(User). Verifica se l'utente appartiene al database. Riempie l'oggetto con i dati dell'utente se presente, altrimenti riempie con valori null. Ritorna un codice numerico.
- add_insertion(Insertion). Inserisce l'inserzione al database. Ritorna un codice numerico.
- modify_insertion(Insertion). Modifica l'inserzione del database. Ritorna un codice numerico.
- delete_insertion(Insertion). Elimina l'inserzione dal database. Ritorna un codice numerico.
- search_insertions(Insertions,filters). Opera una ricerca con i filtri: house_typology, rooms_typology, locality, available_rooms, price_per_person. Ritorna un codice numerico.
- get_insertion(Insertion). Riempie il parametro di tutti i dati dell'inserzione (null se non presente). Ritorna un codice numerico.
Tabelle database:
- Users (nickname primary key, password, email, phone_number, profile_photo_path)
- Insertions (title primary key, description, available_rooms, rooms_typology, house_typology, free_from (DD_MM_YYYY format), address, locality, price_per_person, photo_path, nickname foreign key)
rooms_typology -> ["single_room", "double_room"] house_typology -> ["boarding_house", "apartment"] locality -> ["povo", "mesiano", "villazzano", "san_dona", "trento"] NB: if you add a class in the above ones, remember to add it also into the DB_manager.js file, in the search_insertions_in_db method
Codici numerici: 1 ok -1 match not found -2 read file error -3 write file error -4 read photo from request error -5 save photo in file system error