• FabianoFilippone

YCS (You Can Slenderize) Sistema per la Gestione delle Diete

Il Documento è articolato nel seguente modo:

• 1 - Analisi dei requisiti utente;
• 2 - Casi D'uso;
• 3 - Diagramma delle classi;
• 4 - Altri requisiti.

1 - ANALISI DEI REQUISITI UTENTE:

1.1 Obiettivi generali del sistema

L'obiettivo del sistema è quello di fornire un supporto ad un nutrizionista per la prescrizione di diete ai pazienti che hanno intenzione di dimagrire, consentendo al nutrizionista di seguire i pazienti in tempo reale ed a distanza. In particolare il sistema è rivolto sia al paziente che, fornendo i propri dati al nutrizionista, ottiene una dieta e sia al nutrizionista stesso che può prescrivere le diete opportune in base ai dati inseriti relativi al paziente ed effettuare un monitoraggio costante circa i progressi del paziente, cioè il monitoraggio dei pesi del paziente. Il sistema quindi guiderà il nutrizionista fornendo un supporto alla stesura della della dieta attraverso la consultazione di una banca dati relativa ad informazioni sui valori nutrizionali degli alimenti.

1.2 Categorie di utenti

1.2.1 Paziente

Il paziente è colui che utilizza il sistema per seguire una dieta assegnatagli da un nutrizionista ed inserire i dai relativi all'andamento della sua dieta (cioè i valori periodici del suo peso).

1.2.2 Nutrizionista

Il nutrizionista è colui che accede al sistema per assegnare le diete ai pazienti oppure visionarne l'andamento.

1.3 Funzionalità

Il nutrizionista registra i pazienti nel sistema fornendo loro le credenziali di accesso. Nell'inserimento inserisce, oltre ai dati anagrafici, altri dati (altezza, età, peso, costituzione fisica, tipo di attività fisica, eventuali patologie, etc) utili al nutrizionista per prescrivere la dieta. Il sistema calcola alcuni valori utili per la prescrizione della dieta, tra questi viene calcolato l'indice di massa corporeo al momento della notifica al sistema del peso reale del paziente e, al momento della registrazione di un paziente, il sistema calcola il peso ideale secondo diverse formule: Lorenz, Broca, Wan Der Vael, Berthean, Perrault, Keys, Travia. Il nutrizionista assegna una dieta al paziente per tempo finito inserendo l'elenco degli alimenti che il paziente dovrà assumere per ogni pasto e per ogni giorno della settimana, si attinge ai dati relativi agli alimenti tramite una banca dati presente nel sistema. Il nutrizionista può assegnare più diete per un paziente. Il paziente può accedere al sistema ed inserire periodicamente il proprio peso in modo che può monitorare anche egli stesso il suo andamento, oltre che il nutrizionista. Il paziente può inoltre consultare la propria dieta direttamente dal sistema senza contattare il nutrizionista. Il nutrizionista può allo stesso tempo super-visionare le diete assegnate e vedere l'andamento del peso propri pazienti. Nel sistema sono previsti 800 tipi di alimenti, che è un insieme rappresentativo del database creato dall'Istituto Nazionale di Ricerca per gli Alimenti e la Nutrizione (INRAN) contenente, per ogni alimento presente, le informazioni nutrizionali, quali ad esempio le Kcal, la classe di appartenenza, le fibre, i protidi, gli zuccheri i grassi contenuti.

2 CASI D'USO:

Di seguito vengono descritti, in maniera dettagliata, i casi d'uso seguendo il Modello proposto da Alistar Cockburn. In particolare vengono descritti i seguenti casi d'uso:

• Registrazione Paziente;
• Prescrizione Dieta;
• Comunica Peso Paziente;

2.1 CASO D'USO: REGISTRAZIONE PAZIENTE

NOME DEL CASO D'USO: REGISTRAZIONE PAZIENTE

PORTATA: YCS (You Can Slenderize)

LIVELLO: Obiettivo Utente.

ATTORE PRIMARIO: Nutrizionista.

PARTI INTERESSATI O INTERESSI:

 * Paziente: deve essere registrato nel sistema al fine di ottenere una dieta fatta da indicazioni alimentari precise che può monitorare in un qualsiasi momento. Il Paziente inoltre vuole ottenere le credenziali di accesso al sistema al fine di monitorare le proprie diete o comunicare il proprio peso.

 * Sistema:vuole memorizzare tutte le informazioni relative al Paziente per mostrarle al Nutrizionista.

 * Nutrizionista: vuole memorizzare le informazioni dei propri pazienti ed utilizzarle per la stesura della dieta.

PRECONDIZIONI: Il Nutrizionista ha tutte le informazioni del paziente al momento della registrazione, solitamente le ottiene dal Paziente in maniera verbale o mediante la lettura di un modulo cartaceo precedentemente compilato.

GARANZIA DI SUCCESSO (POST-CONDIZIONI): I dati del Paziente vengono memorizzati nel sistema in modo da renderne possibile l'accesso.

SCENARIO PRINCIPALE DI SUCCESSO (FLUSSO DI BASE):

1. Il nutrizionista accede al sistema;

2. Il sistema mostra al nutrizionista la possibilità di registrare un nuovo Paziente;

3. Il sistema chiede al nutrizionista di inserire il codice fiscale del nuovo paziente.

4. Il sistema chiede, mediante la compilazione di diversi campi, l'inserimento di  informazioni sul paziente, più specificatamente:

   I. il nutrizionista inserisce il nome del paziente;

   II. il nutrizionista inserisce il cognome del paziente;

   III. il nutrizionista inserisce la data di nascita del paziente;

   IV. il nutrizionista inserisce i numeri di telefono: cellulare e casa del paziente;

   V. il nutrizionista inserisce l'email del paziente;

   VI. il nutrizionista inserisce l'indirizzo del paziente;

   VII. il nutrizionista inserisce il sesso del paziente;

   VIII. il nutrizionista inserisce l'altezza, espressa in metri, del paziente;

   IX. il nutrizionista inserisce l'informazione relativa al tipo di attività fisica del paziente;

   X. il nutrizionista inserisce l'informazione relativa alla costituzione del paziente;

   XI. il nutrizionista inserisce l'informazione relativa ad eventuali patologie del paziente;

   XII. il nutrizionista inserisce, eventualmente, altre note sul paziente;


5. Il sistema calcola, in base alle informazioni inserite dal nutrizionista alcuni valori, più specificatamente il sistema calcola:

   I. l'età del paziente calcolata come differenza tra la data di registrazione e la data di nascita del paziente, quindi per età di riferimento si prende in considerazione l'età al momento della registrazione.

   II. Il peso ideale del paziente secondo la formula di Lorenz *;

   III. Il peso ideale del paziente secondo la formula di Broca *;

   IV. Il peso ideale del paziente secondo la formula di WanDerVael *;

   V. Il peso ideale del paziente secondo la formula di Berthean *;

   VI. Il peso ideale del paziente secondo la formula di Perrault *;

   VII. Il peso ideale del paziente secondo la formula di Keys *;

   VIII. Il peso ideale del paziente secondo la formula di Travia *;

   * Per dettagli sulle formule del peso ideale si rimanda al FORMULARIO PER IL CALCOLO DEL PESO IDEALE.

6. Il sistema mostra al nutrizionista la scheda completa del paziente, contenente tutte le informazioni: quelle inserite e quelle calcolate dal sistema.

7. Il paziente è registrato nel sistema.

ESTENSIONI (FLUSSO ALTERNATIVO):


a) In ogni momento il nutrizionista può scegliere se annullare la registrazione.

b) Tutti i dati sono obbligatori, eccetto le eventuali note, se in nutrizionista dimentica di inserire alcuni dati il sistema ripete il passo 4 e tutto ciò che ne consegue.

c) Al passo 6 il nutrizionista si accorge che alcuni dati sono stati inseriti in maniera errata, in tal caso il nutrizionista può modificare dalla scheda qualsiasi campo e procedere con il passo 7 con i dati modificati.

d) In ogni momento di inserimento dei dati il nutrizionista può perdere la comunicazione con il sistema, in tal caso il sistema non deve memorizzare nessuna informazione, è necessario ripetere tutto lo scenario ex-novo.


REQUISITI SPECIALI: L'interfaccia utente è composta da un modulo elettronico, il nutrizionista viene guidato nella compilazione.

ELENCO DELLE VARIANTI TECNOLOGICHE E DEI DATI: Il sistema calcola, e quindi mostra al nutrizionista, il calcolo del peso ideale secondo le formule di Lorenz, Broca, WanDerVael, Berthean, Perrault, keys, Travia. Per ulteriori informazioni si rimanda al “FORMULARIO PER IL CALCOLO DEL PESO IDEALE”

FREQUENZA DI RIPETIZIONE: Ipotizzando la garanzia di successo, si ripete il caso d'uso per ogni nuovo paziente.

VARIE: E' bene che sia solo il nutrizionista ad effettuare la procedura di registrazione del paziente in quanto per determinare alcuni parametri fisici del paziente sono necessarie competenze che il Paziente, generalmente, non possiede. Ad esempio per determinare la costituzione fisica del paziente.

2.2 CASO D'USO: PRESCRIZIONE DIETA

NOME DEL CASO D'USO: PRESCRIZIONE DIETA

PORTATA: YCS (You Can Slenderize)

LIVELLO: Obiettivo Utente.

ATTORE PRIMARIO: Nutrizionista.

PARTI INTERESSATI O INTERESSI:
Paziente: vuole ottenere una dieta fatta da indicazioni alimentari precise che può monitorare in un qualsiasi momento;

Nutrizionista: vuole che la prescrizione della dieta avvenga in maniera precisa e vuole un supporto da dove attingere i dati relativi agli alimenti con tutti i valori nutrizionali,

Sistema: vuole memorizzare tutte le informazioni relative alla dieta: da quale nutrizionista è prescritta, per quale paziente, da durata e ovviamente tutte le informazioni associate, il sistema vuole memorizzare queste informazioni al fine di renderle disponibili per scopi futuri anche non previsti.


PRECONDIZIONI: Il Paziente è già registrato nel sistema.

GARANZIA DI SUCCESSO (POST-CONDIZIONI): La dieta viene salvata ed prescritta al Paziente che può consultare in un qualsiasi momento.

SCENARIO PRINCIPALE DI SUCCESSO (FLUSSO DI BASE):

1. Il nutrizionista accede al sistema;

2. Il sistema mostra al nutrizionista la possibilità di creare una nuova dieta;

3. Il nutrizionista nutrizionista inserisce il codice fiscale del paziente per il quale si vuole prescrivere la diete, nel caso in cui il nutrizionista disponga di un lettore per la tessera sanitaria, può inserire il codice fiscale utilizzando il lettore elettronico;

3.1 Il nutrizionista inserisce un nome della dieta, es:"Dieta preliminare", es:"Dieta post-parto", oppure lascia il nome di default;

3.2 Il nutrizionista inserisce la data orientativa per l'inizio e per la fine della dieta;

3.3.Il sistema crea la dieta vuota e ne prevede il numero di settimane per la durata (settimane intere, da lunedì a domenica, poiché la dieta è contestualizzata settimanalmente).

4. Il sistema mostra al nutrizionista le informazioni del del paziente, tra le quali, quelle utili per la prescrizione della dieta.


5. Il nutrizionista imposta la durata della dieta in numero di settimane.

   5.1. Il nutrizionista, per ogni giorno della settimana (lunedi, martedi, mercoledì...domenica), procede nella stesura della dieta scegliendo gli alimenti da consumare per ogni pasto della giornata: colazione, spuntino, pranzo, merenda, cena.

    5.1.1 Il sistema, per ogni giorno della dieta, in base agli alimenti inseriti calcola l'apporto calorico giornaliero.

Il nutrizionista ripete il passo 6.1 fin quando non ha prescritto tutti pasti di tutti i giorni, o può fermarsi in un qualsiasi momento e poi procedere con la stesura in un momento futuro.

6. Il sistema ha memorizzato le informazioni sulla dieta, che il paziente può consultare ed il nutrizionista può modificare.

ESTENSIONI (FLUSSO ALTERNATIVO):

a) Il paziente non è registrato nel sistema in tal caso si rimanda il nutrizionista procede alla registrazione del paziente seguendo il caso d'uso “REGISTRAZIONE PAZIENTE”.

c) Durante l'inserimento degli alimenti che compongono un pasto, il nutrizionista può fare un orrore, o decidere di cambiare quell'alimento, in tal caso il sistema deve consentire di eliminare l'alimento e ricalcolare l'apporto calorico.

REQUISITI SPECIALI: L'interfaccia utente deve permettere di accedere alla banca dati del sistema contenenti informazioni nutrizionali sugli alimenti durante la stesura della della dieta.

ELENCO DELLE VARIANTI TECNOLOGICHE E DEI DATI: Il sistema mostra al nutrizionista, il calcolo del peso ideale secondo le formule di Lorenz, Broca, WanDerVael, Berthean, Perrault, keys, Travia. Per ulteriori informazioni si rimanda al “FORMULARIO PER IL CALCOLO DEL PESO IDEALE”

FREQUENZA DI RIPETIZIONE: Ipotizzando la garanzia di successo, al massimo si fa la stesura di una dieta per ogni paziente ogni settimana. La durata minima di una dieta è di una volta a settimana per ogni paziente registrato nel sistema.

VARIE: nessuna

2.3 CASO D'USO: COMUNICARE PESO PAZIENTE

NOME DEL CASO D'USO: COMUNICARE PESO PAZIENTE

PORTATA: YCS (You Can Slenderize)

LIVELLO: Obiettivo Utente.

ATTORE PRIMARIO: Paziente.

PARTI INTERESSATI O INTERESSI:
Il paziente che desidera comunicare il proprio peso e visualizzare la sua dieta corrente;

L'applicazione YCS che mostra al paziente tutte le informazioni relative al suo andamento terapeutico (lista pesi comunicati e dieta prescritta).

PRECONDIZIONI: Il nutrizionista ha registrato il paziente nell'applicazione YCS.

GARANZIA DI SUCCESSO (POST-CONDIZIONI): L'applicazione YCS memorizza il peso comunicato dal paziente.

SCENARIO PRINCIPALE DI SUCCESSO (FLUSSO DI BASE):

1. L'applicazione YCS mostra la pagina principale nella quale è possibile inserire le credenziali del paziente;

2. Il paziente invia le credenziali di autenticazione all'applicazione YCS;

3. L'applicazione YCS riceve e verifica i parametri di autenticazione;

4. L'applicazione YCS comunica al paziente che l'autenticazione è andata a buon fine;

5. Il paziente è autenticato;

6. L'applicazione YCS mostra al paziente la dieta assegnata dal nutrizionista per la settimana corrente ed il calcolo del peso ideale secondo le formule di Lorenz, Broca, WanDerVael, Berthean, Perrault, Keys e Travia;

7. Il paziente comunica il suo peso giornaliero;

8. L'applicazione YCS riceve e memorizza il peso del paziente;

9. L'applicazione YCS comunica al paziente che l'invio del suo peso è andato a buon fine;

10. L'applicazione YCS mostra al paziente la dieta assegnata dal nutrizionista per la settimana corrente ed il calcolo del peso ideale secondo le formule di Lorenz, Broca, WanDerVael, Berthean, Perrault, Keys e Travia;

11. Il paziente effettua il logout.

ESTENSIONI (FLUSSO ALTERNATIVO):

*)   La connessione con l'applicazione YCS si interrompe:
       1) L'applicazione YCS comunica al paziente la mancanza di connessione;
       2) L'applicazione YCS termina.

3a)  Il paziente ha comunicato parametri di autenticazione errati:
       1) L'applicazione YCS comunica al paziente che i parametri di autenticazione sono errati;
       2) Si esegue il passo 1.

6a)  Al paziente ancora non è stata prescritta una dieta:
       1) Il paziente non può comunicare il suo peso giornaliero e può solo effettuare il logout. Si esegue il passo 11.

10a) Il paziente decide di comunicare nuovamente il suo peso giornaliero:
       1) Si esegue il passo 7.

REQUISITI SPECIALI: Il monitor del paziente deve avere una risoluzione minima pari ad 800x600pixel e deve avere installato nel suo computer la tecnologia Java.

ELENCO DELLE VARIANTI TECNOLOGICHE E DEI DATI: Il sistema calcola e mostra al paziente il calcolo del peso ideale secondo le formule di Lorenz, Broca, WanDerVael, Berthean, Perrault, Keys, Travia. Per ulteriori informazioni si rimanda al “FORMULARIO PER IL CALCOLO DEL PESO IDEALE”

FREQUENZA DI RIPETIZIONE: All'avvio dell'applicazione YCS.

VARIE: nessuna

3 DIAGRAMMA DELLE CLASSI:

3.1 Diagramma delle classi

In questa sezione vi è allegato il diagramma delle classi.DiagrammaDelleClassi.jpeg

3.2 GLOSSARIO DEI TERMINI

Di seguito si riporta il glossario dei termini per la descrizione dei concetti presenti nel diagramma delle classi.

4 ALTRI REQUISITI

4.1 FORMULARIO PER IL CALCOLO DEL PESO IDEALE:

In riferimento a quanto riportato nel caso d'uso REGISTRAZIONE PAZIENTE,e più in generale a quanto descritto nel presente documento, si allega, il FORMULARIO PER IL CALCOLO DEL PESO IDEALEFORMULARIO.PDF, che descrive il maniera dettagliata come il sistema deve calcolare il peso ideale secondo diverse formule: Lorenz, Broca, Wan Der Vael, Berthean, Perrault, keys, Travia.