README.md

FINDYOURPET

SIMONE DI MAURO.

X81/000067

VINCENZO FILETTI

X81/000091

LINK EXPO Link expo

INTRUDUZIONE

L’applicazione ha lo scopo di permettere al proprietario di un animale disperso, di avere segnalazioni da persone esterne ai suoi conoscenti , di dove si trova l’animale. Il proprietario segnala dove ha perso l’animale, inserire delle foto, descrizione e la data della scomparsa. Gli altri utenti possono segnalare l’avvistamento dell animale e l'invio delle proprie informazioni personali al proprietario.

LIBRERIE UTILIZZATE:

Come grafica dei componenti abbiamo usato la libreria ‘NATIVE BASE’, per le mappe, i marker delle mappe, il caricamento dei font, la geolocalizzazione e le notifiche abbiamo utilizzato la libreria messa a disposizione da expo. Come banca dati abbiamo utilizzato firebase, vista la sua facilità di utilizzo, Strutturando il tutti in 3 tabelle:

• DataList: che contiene tutte le ricerche,
• ReportList: Lista di tutti i report, con riferimento all id Di DataList
• TokenUser: Token necessari per la notifica

DIAGRAMMA UML DATABASE:

STRUTTURA STORE REDUCER:

REDUCER

• AuthReducer Si occupa di gestire il login e logout effettuato dall'utente e viene richiamato dal Dispacher utilizzando le seguenti azioni:

  • loginUser, Richiamando l'evento: LOGIN_USER_LOGOUT
  • loginUserSuccess Richiamando l'evento: LOGIN_USER_SUCCESS
  • loginUserFailed Richiamando l'evento: LOGIN_USER_FAIL
  • signupUserSuccess Richiamando l'evento: SIGNUP_USER_SUCCESS
  • SignUpUser Richiamando l'evento: SIGNUP_USER_START

• PetReducer Ha il compito di gestire lo stato di caricamento quando un nuovo Pet viene aggiungo,eliminato o nel caricamento dei dati per la proiezione. Viene richiamando dal Dispacher con le seguenti azioni:

  • findListFetch Richiamando l'evento: FINDLIST_FETCH_START
  • findCreate Richiamando l'evento: FIND_ADD_START
  • findRemove Richiamando l'evento: FIND_REMOVE

• UserReducer Si occupa di salvare tutte le informazioni personale dell'utente, come la posizione, email ecc. Viene richiamato tramite le seguenti azioni:

  • setUserLocation Richiamando l'evento: USER_SET_LOCATION
  • setUserMarker Richiamando l'evento: USER_SET_MARKER
  • userProfileInformation Richiamando l'evento: USER_PROFILE_INFORMATION

• reportReducer Si occupare di tenere tutti i report per ogni singola ricerca ancora attiva e lo stato del loading durante il caricamento. Viene chiamato con le seguenti azioni:

  • fetchListReport Richiamando l'evento: REPORT_FETCH_START
  • fetchListReportSuccess Richiamando l'evento: REPORT_FETCH_SUCCESS
  • reportCreate Richiamando gli eventi: REPORT_ADD_START, REPORT_ADD_SUCCESS

REDUX MIDDLEWARES:

• Logger Middleware davvero utile nella fase di sviluppo. Permette di visualizzare in maniera dettagliata le modifiche agli stati.
• Redux Thunk Questo middleware permette di ritornare una funzione invece che un'azione. Utilizzato ampiamente nella nostra applicazione

NAVIGATOR:

Per la navigazione dei Tab abbiamo utilizzato ‘react-navigator’. Abbiamo strutturato la navigazione nel seguente modo: Abbiamo 1 TabNavigator che contiene 3 StackNavigator, dal primo Stack è possibile raggiungere gli screen: Login, Create, Pet, Signup, Report, ImageScreen, ReportList,

Dal Secondo StackNabigator è possibile raggiungere: MainScreen, Pet, e dal terzo Stack navigator si può raggiungere: List, Pet, ImageScreen, Report, ReportList.

Qui elenco tutte le funzionalità di ogni screen:

• Login: Permette il login da parte dell'utente, se l’utente non è iscritto può registrarsi.

• Create: Permette di creare una nuova ricerca, inserendo dettagli, titolo, foto e il posizionamento del marker.

• Pet: Pagina che elenca tutti i dettagli inseriti dall’utente che ha creato la ricerca.

• SignUp: Permette la registrazione all'app.

• Report: Crea la segnalazione che sarà poi notificata al proprietario.

• ImageScreeen: Nella schermata Pet al click su un'immagine caricata dall'utente viene mostrata la foto in maniera più ampia.

• ReportList: La lista di tutti i Report per la ricerca selezionata.

• MainScreen: La mappa principale con il marker di tutte le ricerche create.

• List: La lista di tutte le ricerche, in maniera meno completa è implementata pure su Profile, infatti li viene mostrata solo le ricerche che ha creato l’utente.

PROBLEMI PROGETTAZIONE:

Durante lo sviluppo abbiamo riscontrato il problema di non poter caricare le foto della libreria del proprio smartphone utilizzando expo.

Per risolvere il problema abbiamo programmato un servizio in Flask (python), caricato in un nostro server, che riceve le foto caricate dall'utente nel momento della creazione della ricerca, e automaticamente il servizio carica i dati su firebase storage.

SCREEN:

HomeScreen

LOGIN, SIGNUP

PETSCREEN

CREATEFIND

REPORTSCREEN

REPORTLIST

LOGINFORM (Dopo il login)

LISTSCEEN

PIATTAFORME UTILIZZATE:

• Github
• Trello
• Expo
• Firebase
• Gliffy