Progetto finanziato con fondi POR FESR 2014/2020 - ASSE PRIORITARIO I
“RICERCA SCIENTIFICA, SVILUPPO TECNOLOGICO E INNOVAZIONE”.
R.2.1 - ALLEGATO RELAZIONE TECNICO SCIENTIFICA FINALE
Un documento di specifica dei requisiti per l’infrastruttura di smart coupon
Progetto cluster SardCoin - Resp. Scient.: Prof. Michele Marchesi
In questo documento è presentata una specifica dei requisiti per il progetto cluster top-down
“SardCoin: tecnologie blockchain a supporto del turismo in Sardegna”, finanziato da Sardegna Ricerche con fondi POR-FESR Sardegna 2014-2020 e soggetto attuatore Università degli Studi di Cagliari, responsabile scientifico Prof. Michele Marchesi.
Abstract del progetto
Il progettoSardCoin ha come obiettivo la realizzazione di una piattaforma di smart coupon per la promozione del turismo in Sardegna, integrata con una blockchain permissioned per garantire trasparenza del servizio e interoperabilità con broker esterni.
La piattaforma permetterà ad aziende del terziario e del turismo, e artigiani, di registrarsi come produttori e generare coupon associati a servizi prodotti. I coupon vengono memorizzati come “smart contract” all’interno della blockchain (es: Hyperledger Fabric), ovvero riportano le modalità di riscatto e le eventuali scadenze.
In parallelo, un’interfaccia front-end, orientata ai consumatori, consentirà di registrarsi come utenti e scaricare determinati coupon. In particolare, sarà possibile effettuare il trasferimento del coupon su un’app per dispositivi mobili, in formato QR-Code. Tramite il QR-Code, l’utente potrà quindi recarsi presso il fornitore di servizi e riscattare il coupon: un dispositivo ad hoc servirà a fotografare il QR-Code e marcare il coupon come “consumato” nella blockchain.
E’ prevista inoltre la realizzazione di una carta servizi, ovvero una “card” che dà accesso ad un pacchetto di coupon. La piattaforma, inoltre, avrà REST API pubbliche e sarà disponibile con codice open-source.
Casi d’uso
I requisiti sono descritti sotto forma di casi d’uso dettagliati, che esprimono le funzionalità principali che l’infrastruttura SardCoin dovrà offrire.
Attori del sistema
- Produttore: è un utente avanzato (soggetto giuridico) iscritto al network SardCoin, che vuole registrare un determinato bene o servizio, e associarvi un coupon generato sulla piattaforma;
- Consumatore: è un utente base della piattaforma, che accede per visionare e scaricare i coupon disponibili. Può inoltre riscattare i coupon scaricati nei “punti di consumo”;
- Broker: è un utente avanzato (soggetto giuridico) abilitato alla generazione di
“pacchetti”, quindi in grado di visualizzare i coupon presenti, in grado di generarne di nuovi, e soprattutto in grado di generare coupon complessi che accorpano i servizi e le condizioni dei coupon semplici;
- Amministratore: è un utente avanzato del sistema, abilitato a gestire gli account degli altri utenti, a rimuovere coupon temporanei, ad effettuare manutenzione programmata sulla piattaforma;
- Verificatore: lavora presso i centri di consumo e si occupa di convalidare i coupon in possesso del consumatore, consentendo il riscatto del bene/servizio associato.
Casi d’uso
CdU: Registrazione dei consumatori alla piattaforma
Descrizione: La piattaforma deve consentire la registrazione di persone fisiche, al fine di operare nel circuito SardCoin come consumatori.
ID: 1
Attori primari: Consumatori
Attore secondario: Amministratore
Precondizioni:Un consumatore vuole registrarsi alla piattaforma per acquistare coupon sul circuito SardCoin.
Sequenza degli eventi:
1. Il consumatore accede al sito;
2. Il consumatore accede alla pagina di registrazione tramite un bottone;
3. Il consumatore compila un apposito form dedicato agli utenti base (non imprese);
4. Il sistema richiede una verifica dell’identità (tramite KYC).
Postcondizioni: Un nuovo account è stato creato per il consumatore.
Requisiti non funzionali: Le informazioni minime da specificare per la registrazione sono: nome, cognome, data e luogo di nascita, recapiti telefonici ed email.
CdU: Registrazione dei produttori e broker alla piattaforma
Descrizione: La piattaforma deve consentire la registrazione di soggetti giuridici (enti, imprese, ditte individuali, ecc.), al fine di operare nel circuito SardCoin come produttori o broker di coupon.
ID: 1
Attori primari: Produttori, Broker Attore secondario: Amministratore
Precondizioni:Un produttore o broker vuole registrarsi alla piattaforma per operare sul circuito SardCoin.
Sequenza degli eventi:
5. Il produttore/broker accede al sito;
6. Il produttore/broker accede alla pagina di registrazione tramite un bottone;
7. Il produttore/broker compila un apposito form dedicato alle imprese;
8. Il sistema richiede una verifica dell’identità (tramite KYC)
9. Un amministratore deve approvare la richiesta di registrazione e autorizzare l’operatività dell’account come produttore o broker.
Postcondizioni: Un nuovo account è stato creato per produttore/broker.
Requisiti non funzionali: Le informazioni minime da specificare per la registrazione sono: ragione sociale, partita IVA/codice fiscale, sede dell’impresa, nome e cognome del rappresentante legale, tipologia di impresa (produttore semplice o broker), recapiti telefonici ed email.
CdU: Generazione dei coupon
Descrizione: I produttori registrati alla piattaforma accedono ad una vista dedicata, dal quale possono generare i propri coupon, specificando il titolo, il bene/servizio offerto, l’eventuale scadenza, il luogo in cui sarà possibile consumare il coupon.
ID: 2
Attore Primario: Produttore
Precondizioni: Il produttore ha eseguito il login Sequenza degli eventi:
1. Il produttore compila un form per la generazione del coupon.
2. Il sistema genera il coupon e gli assegna lo stato “in sospeso”
Postcondizioni: Il coupon generato rimarrà “in sospeso” per 24 ore (vedi CU3).
Requisiti non funzionali: La generazione dei coupon richiederà di specificare dettagli quali: titolo del coupon, bene/servizio offerto e valore economico associato, eventuale scadenza, eventuali vincoli di consumo temporali e di luogo, prezzo del coupon.
CdU: Gestione dei coupon
Descrizione: La piattaforma consente ai produttori registrati di tenere traccia dei coupon generati, nonché visualizzare il numero di coupon attivi, scaduti o consumati. I coupon classificati come “in sospeso”, ovvero pendenti, potranno essere modificati o rimossi prima della pubblicazione (che avverrà, in automatico, entro 24 ore). Trascorso tale arco
temporale, i coupon saranno scritti sulla blockchain, dalla quale non saranno più modificabili o annullabili.
ID: 3
Attore Primario: Produttore
Attore Secondario: Amministratore
Precondizioni: Il produttore ha generato uno o più coupon Sequenza degli eventi:
1. Il produttore visualizza le informazioni relative a tutti i coupon generati (attivi, scaduti, “in sospeso” e consumati).
2. Se il produttore decide di annullare un coupon “in sospeso”
2.1. il sistema rimuove il coupon
3. Se il produttore decide di effettuare una modifica relativa a un coupon “in sospeso”
3.1. il sistema modifica il coupon
Requisiti non funzionali: I coupon “in sospeso” sono automaticamente convertiti in
“attivi” e scritti sulla blockchain, alla scadenza dell’arco temporale predefinito. Inoltre, i coupon generati non sono necessariamente visibili pubblicamente sul sito della piattaforma.
CdU: Visualizzazione coupon disponibili
Descrizione: Il consumatore registrato alla piattaforma visualizza i coupon attivi e visibili. Scegliendo un coupon, accede ai dettagli ad esso correlati.
ID: 4
Attore Primario: Consumatore Attori Secondari:
Precondizioni: Il consumatore deve aver effettuato il login Sequenza degli eventi:
1. Il consumatore accede alla pagina dei coupon disponibili;
2. Il sistema mostra i coupon visibili in modalità mappa o in modalità lista;
3. Il consumatore visualizza il coupon con i dettagli;
4. Il consumatore sceglie il coupon da acquistare
Postcondizioni: Il consumatore conosce i punti di consumo in cui
CdU: Acquisto di un coupon selezionato
Descrizione: Il consumatore, dopo aver scelto un coupon da acquistare, utilizza le proprie informazioni per completare il pagamento e ottiene una conferma dell’acquisto effettuato.
ID: 5
Attore Primario: Consumatore Attori Secondari:
Precondizioni: Il consumatore ha selezionato il coupon da acquistare Sequenza degli eventi:
1. Il sistema presenta un prospetto con il conto totale;
2. Il consumatore riempie un modulo con le informazioni per il pagamento;
3. Il sistema chiede l’autorizzazione al sistema bancario di pagamento, che autorizza l'acquisto;
4. Il sistema conferma la vendita;
5. Il sistema invia al cliente un'email di conferma con il coupon in allegato Postcondizioni: il coupon viene associato al consumatore
CdU: Visualizzazione area riservata consumatore
Descrizione: Accedendo al proprio profilo personale, il consumatore visualizza lo storico dei propri coupon (utilizzati, non ancora utilizzati e scaduti), ricevendo maggiori informazioni sulle modalità di riscatto. Potranno quindi scaricare/visualizzare il QR-Code associato ad un certo coupon.
ID: 6
Attore Primario: Consumatore Attori Secondari:
Precondizioni: Il consumatore ha effettuato il login Sequenza degli eventi:
1. Il consumatore seleziona la vista dedicata alla visualizzazione dei coupon
2. Il consumatore seleziona il coupon di cui vuole ottenere delle informazioni (ad esempio, QR code)
3. Il sistema visualizza le informazioni in dettaglio del coupon scelto
Postcondizioni: Il consumatore conosce delle informazioni legate ai coupon ricevuti, utilizzati e non.
CdU: Visualizzazione dei coupon sull’app e riscatto
Descrizione: Il consumatore, tramite un’applicazione presente sul suo smartphone, potrà utilizzare i propri coupon, identificati da un QR Code, nei punti di consumo.
ID: 7
Attore Primario: Consumatore Attori Secondari: Verificatore Precondizioni:
● Il consumatore ha dei coupon validi da riscattare e si trova nel punto di consumo associato;
● Il verificatore è provvisto di un apparato per scansionare i coupon.
Sequenza degli eventi:
1. Il consumatore accede all’applicazione e seleziona la vista dei coupon utilizzabili 2. Il consumatore seleziona il coupon da consumare, ottenendo così il QR Code
collegato a quel coupon
3. Il verificatore scansiona il QR Code con il suo apparato 4. Il sistema registra l’utilizzo del coupon
5. Il consumatore può accedere al bene/servizio oggetto del coupon Postcondizioni:
● Il coupon consumato non è più utilizzabile
● Il consumatore riceve il bene/servizio richiesto e collegato al coupon utilizzato
CdU: Pannello di amministrazione
Descrizione: Tramite un pannello di amministrazione, l’amministratore gestisce gli utenti registrati alla piattaforma (modifica e rimozione), visualizza le statistiche di utilizzo ed esegue attività di manutenzione.
ID: 8
Attore Primario: Amministratore Attori Secondari:
Precondizioni: L’amministratore ha effettuato il login
Sequenza degli eventi:
L’amministratore:
1. Accede al pannello di amministrazione
2. Gestisce tutti gli account del sistema, visualizza le statistiche di utilizzo ed effettua attività di manutenzione
Postcondizioni: Nessuna
CdU: Creazione dei pacchetti di coupon
Descrizione: da completare ID: 9
Attore Primario:
Attori Secondari:
Precondizioni:
Sequenza degli eventi:
1-
Postcondizioni:
Sequenza alternativa:
Requisiti non funzionali (facoltativi):
