Uffici Scietà dell'infrmazine Prgett «Servizi e Tecnlgie per la PArtecipazine dei cittadini alle plitiche della per la Salute» Acrnim STARS Dcument Specifiche Tecniche Versine 1.1 Data stesura 10/02/2009 Redatt da Michele Caput, Michele Cignarale, Emily Stante, Maurizi Argnet
INDICE 1 Scp... 4 1.1 Riferimenti... 4 1.1.1 Dcumenti di Riferiment... 4 1.1.2 Bibligrafia... 4 1.2 Definizini e acrnimi... 4 2 Specifiche Tecniche... 5 2.1 Scmpsizine in mduli... 5 2.2 Interfacce tra i vari mduli e cn l'estern... 7 2.3 Funzinalità di base che pssn essere utilizzate nell svilupp di gni mdul... 7 2.4 Micranalisi... 7 2.4.1 CMA: Gestine degli Utenti... 7 2.4.2 CDA: Presentazine del Frnt-End... 9 2.4.3 CMA/CDA: Gestine dei Cntenuti Standard... 10 2.4.4 CDA: Strumenti di Cmunicazine... 18 2.4.4.1 Newsletter... 18 2.4.4.2 Frum... 18 2.4.4.3 Chat... 19 2.4.4.4 Servizi SMS... 20 2.4.4.5 Agganci a Skype... 22 2.4.5 CDA/CMA: Gestine dei Prgetti... 22 2.4.6 CDA/CMA: Gestine Sndaggi... 23 2.4.6.1 Sndaggi Web... 24 2.4.7 CDA: Cntenuti Ad Hc... 25 2.4.7.1 STARS-Presentazine... 25 2.4.7.2 Wiki... 26 2.4.7.3 Bulletin Bard... 26 2.5 Specifiche di rius... 27 3 Allegat: Use Case Diagrams... 29 Specifiche Tecniche Pag. 2 di 33
INDICE DELLE IMMAGINI Fig. 1 Cmpnent Diagram cn i mduli principali del Prtale... 6 Fig. 2 Layut del prtale... 10 Fig. 3 Class diagram per News ed Eventi... 12 Fig. 4 Class diagram per Articli... 13 Fig. 5 Class diagram per i Dcumenti... 14 Fig. 6 Class diagram per i Ft Album... 15 Fig. 7 Class diagram per le FAQ... 15 Fig. 8 Class diagram per i Link... 16 Fig. 9 Class diagram per i Blg... 17 Fig. 10 Class diagram per le Newsletter... 18 Fig. 11 Class diagram per i Frum... 19 Fig. 12 Struttura servizi Chat... 20 Fig. 13 - Class diagram per la Chat... 20 Fig. 14 Class diagram per gli SMS... 21 Fig. 15 Class diagram per i Prgetti... 23 Fig. 16 Class diagram per i Sndaggi... 25 Fig. 17 Class diagram per il cntenut Stars-Presentazine... 26 Fig. 18 Class diagram per i Bulletin-bard... 26 Fig. 19 Farm delle macchine del Prtale... 27 Fig. 20 Pila applicativa del Prtale... 28 Fig. 21 Gli Attri del Pian di Salute e del Prgett STARS... 29 Fig. 22 Use Cases nell'us e nella gestine del Prtale STARS... 30 Fig. 23 Use Cases delle interazini degli Attri cn il Prtale STARS: cas "figure" di regia e cntrll... 31 Fig. 24 Use Cases delle interazini degli Attri cn il Prtale STARS: cas "figure" di gestine, supervisine e prmzine... 32 Fig. 25 Use Cases delle interazini degli Attri cn il Prtale STARS: cas partecipanti/cittadini... 33 Specifiche Tecniche Pag. 3 di 33
1 Scp Prgett STARS 1 Scp Scp di quest dcument è quell di definire le specifiche tecniche del prgett STARS. 1.1 Riferimenti 1.1.1 Dcumenti di Riferiment Dcument ufficiale cn la descrizine del Prgett: Dcument di Prgett - Servizi e Tecnlgie per la PArtecipazine dei cittadini alle plitiche della per la Salute - STARS Prpsta ufficiale di rimdulazine delle attività: Prgett STARS - Recvery Plan STARS deliverable D01.1: Pian di Qualità STARS deliverable D01.2: Analisi dei rischi STARS deliverable D02.1: Analisi dei Prcessi STARS deliverable D03.1: Prfilazine Attri STARS deliverable D04.1: Analisi dei requisiti 1.1.2 Bibligrafia The Unified Mdeling Language User Guide di Grady Bch, James Rumbaugh, and Ivar Jacbsn, Addisn Wesley, 1999. Learning UML di Sinan Si Alhir, O'Reilly, 2003 Object-Oriented Prject Management with UML di Murray Cantr, Wiley, 1998 Dcumentazine tecnica Kaistar: Specifiche tecniche CMF - KSTAREVOL-TEC-SPEC- CMF Dcumentazine tecnica Kaistar: Manuale Utente CMF - KSTAREVOL-TEC-MAN-CMF Dcumentazine tecnica Kaistar: Specifiche Tecniche CMA - KSTAREVOL-TEC-SPEC- CMA 1.2 Definizini e acrnimi CMA: Cntent Management Applicatin, vver il sistema web di gestine dei cntenuti CDA: Cntent Delivery Applicatin, vver il Prtale prpriamente dett, visibile agli utenti Back-ffice: in quest dcument viene usat cme sinnim della CMA Frnt-End: in quest dcument viene usat cme sinnim della CDA Kaistar: framewrk Java pen surce di svilupp per realizzare siti di gestine ed ergazine dei cntenuti. La CMA e la CDA sn cstruite mediante le cmpnenti di base del Kaistar Otype: è una classe di cntenut definita nel Kaistar. Specifiche Tecniche Pag. 4 di 33
2 Specifiche Tecniche Prgett STARS Obiettiv di quest svilupp è implementare il prtale del prgett STARS cn queste caratteristiche: Ambiente di cllabrazine: il prtale deve cstituire un'area di lavr cndivisa (grupware) fra gli attri di STARS Funzinalità di E-Demcracy: per cnsentire ai cittadini e agli attri del Pian di Salute di vtare e di pubblicare i prpri cmmenti Strumenti di prmzine e cmunicazine: per facilitare le interazini e la diffusine delle infrmazini riguardanti il Pian di Salute. Si tratta di funzinalità di gestine dei cntenuti web e strumenti di cmunicazine via mail ed SMS. Il prtale è l strument di supprt principale per l'attuazine del Pian di Salute della Regine Basilicata in frma partecipata. 2.1 Scmpsizine in mduli Semplificand, identifichiam i mduli principali del prtale cn le cmpnenti evidenziate nel Cmpnent Diagram UML che segue. Specifiche Tecniche Pag. 5 di 33
Fig. 1 Cmpnent Diagram cn i mduli principali del Prtale In particlare la cmpnente CMA (Cntent Management Applicatin) rappresenta le funzinalità del Sistema Editriale mentre la CDA (Cntent Delivery Applicatin) rappresenta il prtale ver e prpri, vver le funzinalità del frnt-end. Quest mdell si applica alla prima fase del prtale in cui la gestine degli utenti viene cmpletamente implementata utilizzand il sistema di autenticazine dei redattri della CMA. Ciò significa che l'access alle aree riservate del frnt-end avviene mediante autenticazine, usand delle lgin/passwrd che crrispndn ad utenti della CMA. Un'evluzine del prtale deve invece prevedere l'agganci all'identity Prvider reginale di Basilicatanet, cn mdalità al mment ancra da definire nei dettagli. Al di là di questa variante il mdell architetturale precedente resterà valid. Specifiche Tecniche Pag. 6 di 33
2.2 Interfacce tra i vari mduli e cn l'estern Cme si evince dal diagramma precedente il frnt-end del sit è genericamente dipendente dalla CMA (back-end) per: La gestine degli utenti: l'autenticazine degli utenti sulla CDA si appggia cmpletamente sulla CMA La gestine dei cntenuti: gni servizi si basa su dei cntenuti del Kaistar. 2.3 Funzinalità di base che pssn essere utilizzate nell svilupp di gni mdul L svilupp si baserà sulla release più recente del framewrk pen surce Kaistar (cfr. www.kaistar.rg). 2.4 Micranalisi 2.4.1 CMA: Gestine degli Utenti Il prtale STARS deve essere ad access cntrllat, sia per le funzinalità della CMA che per alcune aree/funzini della CDA. Mentre il sistema di gestine dei cntenuti ha già il su sistema di cntrll degli accessi, cn il cncett degli editri, per il frnt-end dvrà essere implementat ex-nv. A regime gli utenti (sicuramente di frnt-end e raginevlmente di back-end) si autenticherann in Single Sign-On dal sistema centralizzat reginale che fa cap a Basilicatanet. Siccme al mment quest sistema ancra nn supprta il Single Sign-On usiam ma sl cme escamtage temprane la gestine degli utenti della CMA anche per il frnt-end. Per tale mtiv a livell implementativ cnviene "incapsulare" in una classe Java la lgica di autenticazine/autrizzazine della CDA, in md che quand dvrà entrare in prduzine il nuv sistema ci pssiam limitare a mdificare la classe senza fare alcuna mdifica al rest del prtale. Cme si diceva quindi, per ra la gestine degli utenti sarà quella della CMA del Kaistar, in cui esistn i due cncetti chiave dei ruli e delle cmmunity. Tramite i ruli identificherem le tiplgie principali di utenza, in funzine del md in cui essenzialmente ptrann accedere al sistema. Cn le cmmunity darem la pssibilità di definire in md più capillare i gruppi di appartenenza degli utenti. A livell funzinale prevediam 4 tiplgie di utenti, csì gerarchicamente definite: Utilizzerem i Ruli per definire queste tiplgie: Crdinatre_Prtale I V Redattre I V Autenticat I V Cittadin Crdinatre_Prtale: può gestire tutti gli Otype definiti via CMA Specifiche Tecniche Pag. 7 di 33
Redattre: può gestire sl alcuni cntenuti via CMA: in questa prima istanza permettiam sl la definizine di News ed Eventi. Autenticat: nn può gestire alcun cntenut da CMA Cittadin: nn può accedere alla CMA (di fatt in quest mment i cittadini nn si pssn autenticare quindi quest rul è frse inutile: in futur la csa sarà diversa quindi frse può cnvenire definirl. In gni cas un utente cn quest rul nn può, vviamente, gestire alcun cntenut). Nel Prtale definiam pi tre gerarchie di Cmmunity, cn i seguenti pssibili valri: Attri (rappresenta il tip di Attre nel prgett STARS) Cmitat di Regia Cmitat Scientific Cmitat di Pian Grupp di Lavr 1 (NOTA: a regime ne dvrem definire tanti quanti sarann i gruppi cstituiti. Per ra per semplicità li definiam tre identificati cn un numer) Grupp di Lavr 2 Grupp di Lavr 3 Staff di Cmunicazine Crdinament prtale Supprt Prtale Supprt Lcale MT (NOTA: ancra una semplificazine. Immaginiam per ra di avere 2 gruppi di supprt lcale, un per la prvincia di Matera e l'altr per quell di Ptenza) Supprt Lcale PZ Tutr Rispett alla definizine degli attri del Pian (cfr. allegat alla fine del dcument) si sn fatte alcune semplificazini, vver nn sn specificati gli Amministratri di Sistema e persnale tecnic (che cincidn cn gli Admin della CMA) e le varie tiplgie di Cittadini, vist che per ra nn è prevista un'autenticazine per le persne al di furi degli attri principali del Pian di Salute. Enti Azienda Sanitaria lcale di Ptenza (ASP) Azienda Sanitaria lcale di Matera (ASM) Azienda Ospedaliera Reginale "S. Carl" (AOR) IRCCS Ospedale Onclgic di Riner in Vulture Uffici Scietà dell'infrmazine Assessrat Sanità Università della Basilicata Università di Firenze Publisys Specifiche Tecniche Pag. 8 di 33
Figure Prfessinali: Dirigente/Quadr ASL Impiegat/Cllabratre ASL Primari Medic/Pediatra Assessre/Funzinari Reginale Impiegat/Cllabratre Reginale Prfessre/Ricercatre Universitari. Questa è una prima definizine di Cmmunity che si ritiene adeguata per le fasi iniziali del prgett: ptrà naturalmente essere raffinata ulterirmente cl passare del temp. Un Amministratre della CMA avrà quindi Crdinatre_Prtale cme rul e apparterrà a tutte le Cmmunity definite. I cntenuti ptrann essere sempre categrizzati per cmmunity: ad. esempi un Crdinatre_Prtale può definire un Event una Newsletter specifica per una Cmmunity - es. la ASL 1 di cui lui fa parte. Vgliam permettere anche ai Redattri di definire un meccanism più fine per definire la lgica cn cui pubblicare un cntenut. Di default infatti la CMA del Kaistar permette ai redattri sl di vedere i cntenuti creati da clr che fann parte delle stesse sue cmmunity. Se questa lgica ha sens a livell di gestine dei cntenuti nn è dett che sia adeguata invece per reglare la visibilità delle infrmazini su frnt-end. A tale scp definiam una tassnmia (Mdalità di Pubblicazine) che reglerà il md in cui i cntenuti sarann accessibili dal prtale (CDA). Tale tassnmia sarà assciata ai principali cntenuti e avrà i seguenti quattr pssibili valri: Tutti: il cntenut sarà pubblic, ciè visibile a tutti senza bisgn di autenticazine Sl Autenticati: il cntenut sarà privat: ptrà essere visibile sl agli utenti che pssn autenticarsi (ciè quelli cn rul Crdinatre_Prtale, Redattri e Autenticati). Almen una cmmunity scelta: il cntenut è visibile sl agli utenti che appartengn ad almen una delle cmmunity scelte dal redattre (sttinsieme di quelle di cui lui fa parte) Tutte le cmmunity scelte: il cntenut è visibile sl agli utenti che appartengn a tutte le cmmunity da lui scelte (sttinsieme di quelle di cui lui fa parte). Gli accunt utente sarann in questa prima fase creati dall interfaccia del back-ffice degli editri del sistema. Per ra nn è necessari prevedere un interfaccia per il frnt-end da cui gni utente può cambiare i prpri dati persnali (passwrd, indirizz, e-mail, telefn, etc..), vist che pi il sistema si appggerà all'identity Prvider reginale. Per clr che dvrann avere access alla CMA, al mment dell'autenticazine dvrà cmparire nella CDA (es. nella barra delle sezini) il link alla CMA. L'access dvrà avvenire in single signn, senza quindi reimmettere la lgin/passwrd. 2.4.2 CDA: Presentazine del Frnt-End Il layut del sit sarà strutturat nel md seguente: Specifiche Tecniche Pag. 9 di 33
Fig. 2 Layut del prtale Avrem sstanzialmente due hme page diverse: una di carattere generale nella quale sarann mstrati i cntenuti di interesse cmune ed una specifica per gli utenti autenticati. Nel Crp della hme page pubblica vengn visualizzate delle infrmazini generiche di presentazine del prgett e la lista dei più recenti cntenuti pubblicati. Nel Crp della hme page "riservata", quella vista ciè dagli utenti autenticati, visualizzerem: Un elenc cn gli aggirnamenti significativi realizzati nel prtale nel mese crrente: es. il numer dei dcumenti creati, dei prgetti definiti, etc. La lista dei messaggi velci (bllettini) pubblicati. Quest'ultim strument permette alle persne autenticate di scambiarsi velcemente messaggi di servizi. Si parlerà in dettagli di questa funzinalità nel seguit (par. 2.4.7.3 Bulletin Bard). 2.4.3 CMA/CDA: Gestine dei Cntenuti Standard Nel sistema sarann gestiti una serie di cntenuti "tradizinali", vver che si trvan cmunemente nei siti web, che definiam "standard". Essi sn: News Eventi Articli Dcumenti Ft Album Faq Specifiche Tecniche Pag. 10 di 33
Link Blg. Prgett STARS Tutti questi cntenuti ptrann sia essere ad access liber che visibili sl a determinate categrie di utenti. Cme vist in un paragraf precedente questa pzine sarà pssibile sfruttand la tassnmia "Mdalità di Pubblicazine" e il cncett di cmmunity. Queste due pzini sarann specificate rispettivamente dagli attributi Pubblicazine e Organizzazine presenti in gni singl cntenut. Definiam di seguit i Class Diagram UML per gnun dei cntenuti indicati spra. Si nti che tutti i cntenuti citati sarann sempre gestiti tramite le interfacce web della CMA del Kaistar, quindi dal sistema di back-ffice. Per quest mtiv nei class diagram che segun nn abbiam indicat esplicitamente gli attributi di default gestiti dal framewrk Kaistar nel mment in cui si crea un cntenut via CMA, vver la data di creazine del cntenut, la lgin dell'editre, etc.. Queste prprietà quindi sn sempre presenti nei cntenuti che segun. Fann eccezine i "cmmenti" dei Blg, che sarann invece inseriti direttamente tramite delle interfacce del Frnt-End, una situazine che analizzerem nel dettagli parland dei Blg. A mlti dei cntenuti pssn essere assciate due tipi di Immagini: "presentazine", che sarà un'immagine piccla, usata nelle pagine di indice, e "dettagli", che cnterrà l'immagine grande usata nella pagina di pubblicazine del cntenut. Questa scelta è diventata una cnvenzine standard negli sviluppi di STARS. News/Eventi Sn cntenuti specificatamente di tip editriale che servn per gestire la pubblicazine di ntizie e l'aggirnament del Calendari degli Eventi. Specifiche Tecniche Pag. 11 di 33
Fig. 3 Class diagram per News ed Eventi Articli Ancra un cntenut tipicamente editriale che permette di creare delle pagine di cntenut generic (una pagina HTML per capirsi) da visualizzare nel prtale. Specifiche Tecniche Pag. 12 di 33
Fig. 4 Class diagram per Articli Dcumenti I Dcumenti sn dei cntenuti "cntenitre" di file. Ogni Dcument infatti può avere assciati un più file. Inltre al dcument è assciata la Sezine di Pubblicazine, una tassnmia che permette di definire una struttura gerarchica di sezini del prtale usate per visualizzare quest genere di cntenuti. L'idea è quella di ricreare un alber di navigazine simile a quell delle "directry" Internet, cme dmz.rg Yah. Le sezini che si definiscn in questa prima fase sn: /Dcumenti /Dcumenti di definizine prgett (accessibile sl agli utenti autenticati, vver quelli cn rul Crdinatre_Prtale, Redattre e Autenticat) /Deliverable di prgett (accessibile sl agli utenti autenticati) /Presentazini /I Piani di salute in Italia /Letture. Specifiche Tecniche Pag. 13 di 33
Fig. 5 Class diagram per i Dcumenti Ft Album I Ft Album permettn di raccgliere delle immagini in album ftgrafici pubblicati via web. Autmaticamente viene gestit il resize dell'immagine per permetterne la presentazine nell'indice e nel dettagli. Specifiche Tecniche Pag. 14 di 33
Fig. 6 Class diagram per i Ft Album FAQ Si tratta di un cntenut per gestire in md semplice e strutturat una sequenza di dmande e rispste assciate ad un particlare Tema. Fig. 7 Class diagram per le FAQ Specifiche Tecniche Pag. 15 di 33
Link Prgett STARS Si tratta di un cntenut per gestire in md semplice e strutturat un elenc di Link a siti/pagine web rganizzat in un insieme di categrie. Fig. 8 Class diagram per i Link Blg I blg sarann utilizzati (via CMA) da specifiche persne: l'idea è quell di definire dei "diari via web" da assegnare a persnalità di prim pian che partecipan alla definizine del Pian, in md da "raccntare" ai cittadini le attività svlte. Al slit sarà pssibile avere dei Blg pubblici che tutti gli utenti pssn leggere e dei Blg di lavr, che ptrann essere visti sl dagli utenti autenticati, eventualmente appartenenti a specifiche cmmunity. Ad gni Blg sarann assciati i cmmenti dei lettri, che verrann inserti direttamente da frntend, usand, cme meccanism anti-spam, i Captcha (cfr. http://en.wikipedia.rg/wiki/captcha), vver delle immagini distrte di cdici generati casualmente che gli utenti dvrann riprtare nel frm. Di seguit il class-diagram che mdella il cntenut Blg. Specifiche Tecniche Pag. 16 di 33
Fig. 9 Class diagram per i Blg Cme si vede esistn tre classi/tiplgie di cntenut (d OType per usare il linguaggi del Kaistar) per gestire i Blg. Ovver: Blg: permette di definire un nuv blg Interventi: sn i messaggi di un cert blg Cmmenti: sn i cmmenti assciati ai messaggi dei blg. Cme si può ntare dal class-diagram, all'otype Cmmenti sn assciate le prprietà Nme, Email e AuthrLgin. Questa scelta implementativa la ritrverem gni vlta che un cntenut ptrà essere creat dal frnt-end. Infatti in quest cas, al cntrari delle istanze degli OType gestite via CMA, il framewrk Kaistar nn può inserire in autmatic i dati di identificazine dell'utente che ha generat il cntenut. Mlt spess ciò nn sarà nemmen pssibile, si pensi ad esempi al cas di un cmment inserit in un blg pubblic da un utente generic (Cittadin) del prtale. In quest cas quindi chiederem esplicitamente il nme e l'email della persna che ha inserit il cmment, infrmazini che sarann memrizzate negli attributi Name ed Email del cmment. Qualra l'utente che lascia il cmment sia anche autenticat il sistema è in grad di ricnscere la sua Specifiche Tecniche Pag. 17 di 33
lgin: tale infrmazine in quest cas sarà memrizzata nel camp AuthrLgin. Questa scelta sarà un standard nell svilupp del prtale STARS e verrà sempre implementata per gni cntenut creat via frnt-end. 2.4.4 CDA: Strumenti di Cmunicazine Si tratta di un insieme di servizi che permette di abilitare e facilitare la cmunicazine cn i cittadini e tra i partecipanti al prcess di definizine del Pian di Salute. Cn i meccanismi già visti nei paragrafi precedenti sarà pssibile definire degli strumenti di cmunicazine pubblici, ciè accessibili a tutti i cittadini, riservati a determinate cmmunity. 2.4.4.1 Newsletter Permettn di gestire newsletter via email. La definizine della Newsletter avviene tramite CMA, mentre invece gli utenti si pssn sttscrivere desttscrivere dalla newsletter via CDA. Per evitare l spam attiviam nel meccanism di (De)Sttscrizini un'immagine Captcha (cfr. Blg). Dal class diagram che segue si vede che si distingue nella CMA la Newsletter (ciè la sua "definizine") dalle Edizini, che rappresentan i testi che vengn inviati a tutti gli iscritti ad una specifica newsletter. Fig. 10 Class diagram per le Newsletter 2.4.4.2 Frum Attiviam nel prtale un servizi di Frum via web. Al slit sarà pssibile avere sia frum pubblici che visibili sl a determinate categrie di utenti (sl autenticati autenticati appartenenti a specifiche cmmunities). Specifiche Tecniche Pag. 18 di 33
Tramite la CMA è pssibile definire i vari Frum, ciè le aree tematiche di discussine, mentre tutti gli interventi verrann inseriti dal frnt-end. In particlare sarà pssibile gestire la "prfndità" degli interventi, vver si ptrà immettere un messaggi generic sul frum rispndere ad un specific intervent precedente. In quest'ultim cas da frnt-end la rispsta all'intervent sarà visualizzata cn un'indentazine diversa, in md da far risaltare subit all'cchi il legame fra i due "pst". Analgamente al cas dei cmmenti nei blg, in gni intervent, che viene inserit via frnt-end, memrizziam il Nme e l'email dell'autre e, se autenticat, anche la sua Lgin. Fig. 11 Class diagram per i Frum 2.4.4.3 Chat L'access alla chat deve essere pssibile sl dp un'autenticazine. Il link rimanda ad una pagina di prmzine che spiega cme funzina la chat e cme autenticarsi. Se l'utente invece è già autenticat si fa accedere direttamente alla chat. La chat sarà di tip HTML, senza sistemi esterni (es. IRC, Jabber, etc.), gestita direttamente dal Kaistar. La pagina della chat sarà divisa in un'area di messaggi e un semplice frm in bass per aggiungere un nuv messaggi. Per gni Specifiche Tecniche Pag. 19 di 33
messaggi viene visualizzat il test, la data e la lgin dell'utente. La struttura della pagina sarà la seguente: Fig. 12 Struttura servizi Chat Fig. 13 - Class diagram per la Chat 2.4.4.4 Servizi SMS Si tratta di un servizi analg alla Newsletter, in cui via CMA si abilita l'invi di cmunicazini tramite SMS a tutti gli utenti sttscritti al servizi. La registrazine al servizi avviene inviand al numer 320 2043770 un pprtun cdice di sttscrizine, es. "STARS" (in frma case insensitive) "STARS.ON". Analgamente la desttscrizine avviene mediante invi dell'sms, al slit numer, di un pprtun cdice di desttscrizine (es. "STARS.OFF"). Tramite la CMA, cme si può vedere dal class diagram seguente, è pssibile definire più servizi SMS ( Canali), ciascun attivat da specifici cdici: in realtà l'attivazine del servizi Specifiche Tecniche Pag. 20 di 33
crrispndente nn è autmatica ma andrann fatte delle cnfigurazini manuali in altri sistemi che fungn da gateway cn il frnitre del servizi SMS. Per gni Canale SMS sempre via CMA si definisce l'invi dell'sms. Fig. 14 Class diagram per gli SMS Specifiche Tecniche Pag. 21 di 33
2.4.4.5 Agganci a Skype Si tratta di un servizi audi/vide per cnferenze VIP che si appgia alla piattafrma Skype, estendend il prfil degli editri. 2.4.5 CDA/CMA: Gestine dei Prgetti Si tratta di un servizi di cllabrazine vlt a permettere il lavr in cmune su un specific task. Un prgett è cmpst da un cntenut che rappresenta una prpsta di prgett e una serie di cmpnenti di due tipi: Dcumenti Cmmenti. L'idea è che dall'area riservata del frnt-end un utente pssa creare un prgett su cui lavrare descrivend in un frm la sua prpsta. Il Prgett è quindi un cntenut creat da frnt-end, ma piché sl gli utenti autenticati avrann la facltà di creare prgetti, nn chiederem lr di inserire il nme e la mail, in derga a quant dett a prpsit dei cmmenti ai blg e agli interventi dei frum. In autmatic cmunque il sistema terrà traccia della lgin del prpnente. Il Prgett, cme gni cntenut della CMA avrà un wrkflw e ptrà essere apprvat respint. Se apprvat gli altri utenti ptrann aggiungere dei cmmenti via CDA. Un grupp di redattri si incaricherà, via CMA, di aggiungere al prgett dei dcumenti ed eventualmente delle immagini di illustrazine. Ai singli dcumenti gli utenti ptrann aggiungere dei cmmenti dal prtale. L scp è quindi quell di ricreare virtualmente le mdalità di lavr di un team di prgett. Al slit i prgetti ptrann essere pubblici resi privati tramite i meccanismi basati su cmmunities descritti nei paragrafi precedenti. Ad esempi un prgett rmai cnslidat ptrà essere (via CMA) res pubblic, mentre in fase di lavrazine può rimanere riservat sl ai membri di specifiche cmmunities. Di seguit il class diagram di definizine del cntenut. Specifiche Tecniche Pag. 22 di 33
Fig. 15 Class diagram per i Prgetti 2.4.6 CDA/CMA: Gestine Sndaggi Si vule definire tramite il prtale un meccanism per creare dei sndaggi che sia estremamente flessibile. Deve infatti permettere di definire il sndaggi e di usarl sia sul prtale che in mdalità ff-line, stt frma ad esempi di frm cartace, intervista telefnica, etc.. Via CMA dvrà essere pssibile in questi casi inserire pi i risultati del sndaggi nel database, per cnsentire l'elabrazine dei risultati. Il sndaggi sarà cmpst da un titl, un test di presentazine, un test di spiegazine e di apprfndiment e, sprattutt, da un insieme di dmande gnuna cn il prpri insieme di rispste pssibili. Vi sarann pi altre infrmazini di "crred", cme data di creazine del sndaggi, perid di validità, etc.. Al sndaggi sarann cllegate: Le rispste ammissibili I dati degli utenti che hann rispst (insieme particlarmente ricc di infrmazini in cas di sndaggi cndtti ff-line: ptrann infatti essere specificati età, sess, zna di residenza, etc.). Le specifiche rispste date dagli utenti. Le rispste ammissibili sarann di tre tipi diversi: test liber sl una rispsta tra un insieme definit al più n tra un insieme di m rispste (m>=n) prestabilite. Quindi le dmande avrann cmpnenti hard che rappresentan l insieme delle rispste predefinite, insieme vut se si tratta di test liber. Le rispste degli utenti sarann dei cntenuti che avrann due tipi di cmpnenti hard: Specifiche Tecniche Pag. 23 di 33
un per le rispste relative ai dati persnali un per le rispste relative alle dmande del sndaggi. Anche i sndaggi ptrann essere pubblici ppure riservati ad un sl grupp di utenti e cme per gli altri cntenuti sarà utilizzat il meccanism delle cmmunity. Dvrem tenere cnt anche del fatt che una vlta che il sndaggi è pubblicat le mdifiche che si ptrann apprtare sarann minime e limitate nei cntenuti: al termine dvrann essere in qualche md cngelati sia il sndaggi che le rispste racclte. L interfaccia del back-end (ciè la preview) dvrà essere fatta in md da pter essere stampata e dvrem prevedere che a cmpilare il sndaggi nn sia l utente che rispnde alle dmande ma un peratre che avrà cntattat per telefn l utente. Per i sndaggi via web dvrà essere implementat un meccanism di cntrll anche per i sndaggi liberi, per evitare che un utente vti più vlte. A regime nel prtale STARS dvrà essere permess un servizi csì cmplet. Al mment invece se ne definisce una semplificazine cstituita dal Sndaggi Web che descriviam nel seguit. 2.4.6.1 Sndaggi Web Il Sndaggi web ha assciat N pssibili rispste di cui sl una ptrà essere scelta dall'utente. Attiviam un meccanism che impedisce all'utente di vtare più vlte. Cpiand il cas dei sndaggi di Repubblica utilizziam il meccanism dei ckie, vver dp aver vtat all'utente aggiungiam un specific ckie cn valre dat dall'id del sndaggi. Se l'utente ha il ckie settat gli deve essere impedit di vtare. Nel frnt-end i risultati del sndaggi dvrann essere visualizzati crrettamente: dvrà essere riprtat il ttale dei vti e la ripartizine in percentuale tra le varie rispste. Attiverem inltre una visualizzazine grafica dei risultati del sndaggi. Di seguit riprtiam il class diagram del cntenut. Specifiche Tecniche Pag. 24 di 33
Fig. 16 Class diagram per i Sndaggi 2.4.7 CDA: Cntenuti Ad Hc 2.4.7.1 STARS-Presentazine Si tratta di un cntenut "di cmd" usat per gestire le infrmazini di presentazine del prgett. Tutti i cntenuti di quest tip sarann visualizzati in un'appsita sezine del prtale. Di seguit si presenta il class diagram di quest Otype. Specifiche Tecniche Pag. 25 di 33
Fig. 17 Class diagram per il cntenut Stars-Presentazine 2.4.7.2 Wiki Ptrebbe essere utile integrare un sistema per gestire dei Wiki, vver per permettere la redazine cndivisa di dcumenti via web (cfr. http://en.wikipedia.rg/wiki/wiki_sftware). Quest servizi si differenzia dai Prgetti in quant per essi nn c'è un lavr cndivis sui dcumenti, che vengn elabrati ff-line e pi aggiunti al prgett. Decidiam cmunque di nn implementare i Wiki in questa fase. 2.4.7.3 Bulletin Bard Il bulletin-bard è essenzialmente un frum piatt. Deve essere un meccanism snell che permette di scambiare cmunicazini velci fra gli utenti registrati. Fig. 18 Class diagram per i Bulletin-bard Specifiche Tecniche Pag. 26 di 33
Il bllettin viene inserit tramite un frm della CDA, accessibile sl agli utenti autenticati (al slit, memrizziam la lgin dell'utente nell'attribut Lgin_Autre). La visualizzazine del bllettini avverrà dalla hme page "riservata" del prtale, ciè quella visibile agli utenti dp l'autenticazine (cfr. 2.4.2). 2.5 Specifiche di rius Il prtale STARS nasce all'insegna del rius stt mlteplici punti di vista. Intant a livell architetturale ess sfrutta i sistemi hardware e sftware esistenti del prgett BAS2005 per la. Il prtale è spitat nella farm cstituita dalle seguenti macchine: Fig. 19 Farm delle macchine del Prtale A livell sftware il prtale è sviluppat usand una pila di tecnlgie pen surce, sempre utilizzate nell'ambit del prgett BAS2005 per la Regine. In particlare in cima alla "pila sftware" c'è l'ambiente Kaistar, cme mstrat nella figura seguente. Specifiche Tecniche Pag. 27 di 33
Fig. 20 Pila applicativa del Prtale Alcuni dei servizi più evluti di STARS sn cstruiti sul rius di prgetti reginali esistenti: ad esempi per il servizi di infrmazine via SMS si ricicla l'analg servizi realizzat per il prgett Patt cn i Givani. Se STARS nasce facend tesr di varie esperienza di rius, al cntemp la prgettazine dei sui servizi sarà fatta in md da pter essere riutilizzata in altri prtali reginali. Fra tutti il servizi dei Sndaggi è quell che maggirmente si presta, già in questa sua prima semplice incarnazine, ad essere inclus in altre iniziative reginali. Specifiche Tecniche Pag. 28 di 33
3 Allegat: Use Case Diagrams Fig. 21 Gli Attri del Pian di Salute e del Prgett STARS Specifiche Tecniche Pag. 29 di 33
Fig. 22 Use Cases nell'us e nella gestine del Prtale STARS Specifiche Tecniche Pag. 30 di 33
Fig. 23 Use Cases delle interazini degli Attri cn il Prtale STARS: cas "figure" di regia e cntrll Specifiche Tecniche Pag. 31 di 33