Documento di Progettazione Applicazione "Agorà"

Transcript

1 Ingegneria del Software 2016/2017 Applicazione "Agorà" v febbraio 2017 Antonio Emanuele Cinà Feliks Hibraj Paula Manzano Federico Marcuzzi Elia Lo Monaco Lorenzo Veronese

2 Indice 1 Introduzione Scopo del documento Glossario 1 3 Architettura del sistema Modello di gestione dei dati Scomposizione in sottosistemi Diagrammi delle classi 4 5 Diagrammi di sequenza e attività Ricerca Destinazione Cambio Modalità Modalità Eventi Visualizzazione Eventi Vicini Filtro per data Filtro per tipologia Modalità Luoghi Filtro per tipologia Scheda Marker Preferiti Aggiunta Rimozione Impostazione Notifica Interfaccia Utente Schermata iniziale Menu laterale Visualizzazione marker Scheda informativa eventi o luoghi Pagina preferiti Filtro per data

3 1 Introduzione "Agorà" è un applicazione pensata per incentivare il turismo culturale, aiutando l utente nella scelta dei contenuti di interesse storico-artistico. 1.1 Scopo del documento Il presente documento ha lo scopo di definire l architettura dell applicazione attraverso una molteplicità di diagrammi che ne analizzeranno il funzionamento a seconda dei diversi casi d uso. 2 Glossario Termini e abbreviazioni utilizzate nel presente documento: Agorà Applicazione/app Backup Database/Db DBUnico MiBACT Repository Smartphone Subsystem Uml Utente Il nome scelto per l applicazione. Applicazione software dedicata ai dispositivi di tipo mobile, quali smartphone o tablet. [Fonte:Wikipedia] In informatica indica la replicazione, su un qualunque supporto di memorizzazione, di materiale informativo archiviato in una memoria di massa per prevenire la perdita definitiva dei dati in caso di eventi malevoli accidentali o intenzionali. [Fonte:Wikipedia] In informatica, archivio di dati strutturato in modo da razionalizzare la gestione e l aggiornamento delle informazioni e da permettere lo svolgimento di ricerche complesse. [Fonte: Google] Banca dati destinata contenente informazioni del MiBACT: luoghi della cultura, eventi, comunicati stampa, appalti, Enti. Ministero dei beni e delle attività culturali e del turismo. E un ambiente di un sistema informativo, in cui vengono gestiti i metadati, attraverso tabelle relazionali.[fonte:wikipedia] Telefono cellulare con capacità di calcolo, di memoria e di connessione dati molto più avanzate rispetto ai normali telefoni cellulari, basato su un sistema operativo per dispositivi mobili. Un sottosistema è in genere una divisione funzionale di una struttura più ampia. Linguaggio di modellizzazione e specifica basato sul paradigma orientato agli oggetti, molto usato per descrivere in maniera semplice soluzioni progettuali riguardanti sistemi di varia natura (compreso quello software). Persona fisica che interagisce con l applicazione. 1 di 20

4 3 Architettura del sistema 3.1 Modello di gestione dei dati Il sistema presenta un architettura di tipo repository, è formato, cioè, da una grossa mole di dati (repository) e da diversi sottosistemi, tra di loro indipendenti. Il repository è rappresentato dal servizio DBUnico che fornisce i dati di nostro interesse, mentre i sottosistemi sono le differenti parti dell applicazione che danno la possibilità di visualizzare e salvare i dati del repository. Essendo il databse un servizio esterno all applicazione, i diversi sottosistemi non possono modificarne i dati. Vantaggi portati da un architettura repository: Efficace condivisione di grosse moli di dati Trasparenza della raccolta dati ai sottosistemi Backup, controllo degli accessi, recovery sono centralizzati Struttura pubblica, nuovi sottosistemi possono essere inseriti in modo indipendente dagli altri Lo svantaggio del modello repository è che tutti i sottosistemi sono conformi alla struttura dati fornita dal repository, quindi una sua possibile variazione dovrebbe portare ad un loro aggiornamento. Figura 1: Modello repository 2 di 20

5 3.2 Scomposizione in sottosistemi Di seguito viene proposto un diagramma rappresentativo dei singoli sottosistemi che andranno a comporre l applicazione. Descrizione delle entità: Figura 2: Astrazione sottosistemi in entità Applicazione L intero sistema: l applicazione installata sul dispositivo android. Visualizzazione Entità interna all applicazione che gestisce la visualizzazione dei dati sulla mappa, le informazioni legate agli eventi e luoghi, e la visualizzazione dei preferiti scelti dall utente Gestore Dati Entità che si interpone come façade tra il repository remoto e l applicazione. Si occupa della gestione delle connessioni e l interrogazione del repository, del parsing delle risposte, di filtrare i dati ottenuti in base alle opzioni specificate. Storage Preferiti Entità locale all applicazione che ha il compito di tener traccia degli eventi e luoghi preferiti selezionati dall utente. 3 di 20

6 4 Diagrammi delle classi Le principali entità che comporranno il modello dei dati dell applicazione sono Evento e Luogo e sono modellate per essere facilmente istanziate utilizzando i dati del database DBUnico. Figura 3: Classi del Modello 4 di 20

7 5 Diagrammi di sequenza e attività 5.1 Ricerca Destinazione Figura 4: Diagramma Sequenza [Ricerca Destinazione] Figura 5: Diagramma Attività [Ricerca Destinazione] 5.2 Cambio Modalità 5 di 20

8 Figura 6: Diagramma Sequenza [Cambio Modalità] Figura 7: Diagramma Attività [Cambio Modalità] 5.3 Modalità Eventi Visualizzazione Eventi Vicini 6 di 20

9 Figura 8: Diagramma Sequenza [Visualizzazione Eventi Vicini] Figura 9: Diagramma Attività [Visualizzazione Eventi Vicini] Filtro per data 7 di 20

10 Figura 10: Diagramma Sequenza [Filtro per data] Figura 11: Diagramma Attività [Filtro per data] Filtro per tipologia 8 di 20

11 Figura 12: Diagramma Sequenze [Filtro per tipologia] Figura 13: Diagramma Attività [Filtro per tipologia] 5.4 Modalità Luoghi Filtro per tipologia 9 di 20

12 Figura 14: Diagramma Sequenze [Filtro per tipologia] Figura 15: Diagramma Attività [Filtro per tipologia] 5.5 Scheda Marker 10 di 20

13 Figura 16: Diagramma Sequenza [Scheda Marker] Figura 17: Diagramma Attività [Scheda Marker] 5.6 Preferiti Aggiunta 11 di 20

14 Figura 18: Diagramma Sequenza [Aggiunta Preferiti] Figura 19: Diagramma Attività [Aggiunta Preferiti] Rimozione Figura 20: Diagramma Sequenza [Rimozione Preferiti] 12 di 20

15 Figura 21: Diagramma Attività [Rimozione Preferiti] Impostazione Notifica Figura 22: Diagramma Sequenza [Impostazione Notifica] 13 di 20

16 Figura 23: Diagramma Attività [Impostazione Notifica] 14 di 20

17 6 Interfaccia Utente In questa sezione verrà illustrata la progettazione dell interfaccia grafica, utilizzando degli screenshots della versione finale dell applicazione. 6.1 Schermata iniziale L immagine mostra la schermata iniziale, visualizzata all apertura dell applicazione. Per favorire una buona esperienza di navigazione il design è semplice e comprende pochi elementi come: Icona standard per indicare un menù laterale La barra di ricerca nella parte alta dello schermo Bottone standard in basso a destra che indica la possibilità di utilizzare la geolocalizzazione 15 di 20

18 6.2 Menu laterale Quando viene cliccata l icona menù appare il menù laterale. La sua funzione principale è quella di permettere di filtrare i risultati visualizzati sulla mappa. Gli elementi del menù sono: Seleziona data: permette di filtrare gli eventi per data (Sezione 6.6). Luoghi/Eventi: permette di selezionare la modalità dell applicazione; in base alla scelta saranno visualizzati sulla mappa i luoghi oppure gli eventi, con la possibilità di specificarne la tipologia. Le due immagini presentano i casi possibili. Preferiti: permette di accedere ai preferiti (Sezione 6.5). Credits: permette di ottenere informazioni sull applicazione. 16 di 20

19 6.3 Visualizzazione marker All apertura dell applicazione, in seguito ad una richiesta di geolocalizzazione oppure dopo una ricerca per posizione, vengono visualizzati i marker vicini. I marker rappresentano gli eventi o i luoghi, che soddisfano il filtro scelto nel menu laterale (riferimento 6.2). Per maggiori informazioni, i marker sono cliccabili. Quando un marker viene cliccato si apre un pop-up con alcune informazioni, quali nome, descrizione e immagine. Selezionandolo è possibile aprire la scheda informativa del relativo evento/luogo. 17 di 20

20 6.4 Scheda informativa eventi o luoghi Le immagini presentano le schermate delle schede informative di eventi(a sinistra) e luoghi(a destra). Le icone in alto permettono, rispettivamente di aggiungere il luogo o l evento ai preferiti, di impostare una notifica, di ottenere indicazioni stradali oppure di tornare alla schermata precedente. 18 di 20

21 6.5 Pagina preferiti (a) Pagina Preferiti (b) Ricerca Preferiti (c) Rimozione Preferiti La schermata dei preferiti, accessibile dal menù laterale nella pagina principale, mostra tutti gli eventi e i luoghi inseriti tra i preferiti. Si presenta come una semplice lista e da la possibilità di aprire la scheda informativa dell evento o luogo, aggiungere un promemoria (solo per gli eventi) attraverso l icona con una sveglia e cancellare il preferito, attraverso l icona con un cestino. Tramite la barra di ricerca è possibile cercare un elemento nella lista (b). Alla pressione del tasto di eliminazione di un preferito è mostrato un popup di conferma (c). 19 di 20

22 6.6 Filtro per data L immagine presenta la possibilità di filtrare gli eventi per data. Al click dell elemento del menu si apre la schermata di default di selezione della data di Android. 20 di 20