4.2.2 Inserimento dipendenze dal repository nexus di Linea Comune

Transcript

1 1 REQUISITI TECNOLOGICI DI DISPIEGAMENTO SERVIZI ON LINE SUL CENTRO SERVIZI TECNOLOGICO LINEA COMUNE Aggirnament del 16 NOVEMBRE 2017 Premessa 1. Requisiti tecnlgici generali 1.1 Applicazini Java 1.2 Applicazini php 1.3 Database 2. Architettura del servizi 3. Struttura della rete del CST 3. 1 Requisiti tecnlgici applicativi di FE 3.2 Requisiti tecnlgici applicativi di BE 3.3 Autenticazine utenti 3.5 Sistema di gestine cntenuti 3.6 Funzini applicative (privilegi peratri) 3.6 Repsitry 3.7 Prgettazine servizi: gestine errri applicativi 4. Requisiti tecnlgici per sviluppi ex-nv 4.1 Svilupp Servizi nline 4.2 Frnt End PLPCE VAADIN Inseriment dipendenze dal repsitry nexus di Linea Cmune PLPCE AngularJS 4.3 Back End Linea Cmune SPa 1

2 2 Premessa I servizi applicativi dispiegati sul Centr Servizi Territriale (CST) devn rispettare i requisiti descritti nel presente dcument. I requisiti pssn essere di due tipi: Obbligatri, cntrassegnati dal simbl*: i servizi che nn rispettan tali requisiti nn sarann dispiegabili nel centr servizi tecnlgic. Raccmandat, cntrassegnat dal simbl (R); i servizi che nn rispettan il requisit nn determinan la impssibilità di essere dispiegati, ma richiedn una analisi apprfndita da parte del grupp tecnic di Linea Cmune che si riserverà di cnfermare la pssibilità di dispiegament a sua insindacabile giudizi. 1. Requisiti tecnlgici generali 1.1 Applicazini Java Oracle Java versin 1.7.x superire* Tmcat 7 superire* Lgging: lg4j 1.2.x superire (R) La directry lib della webapp nn deve cntenere le seguenti librerie*: driver database* mail jar* servlet api* L applicazine che necessita di cmunicare cn applicativi esterni di backffice altri applicativi di terze parti deve prevedere esclusivamente il prtcll HTTP/HTTPS e supprtare l utilizz di prxy in uscita e reverse prxy in ingress (R) 1.2 Applicazini php La versine di riferiment di PHP è la 5.x superire* 1.3 Database Pstgresql versine 10 superire (R) 2. Architettura del servizi Ogni applicativ deve essere cmpst da due cmpnenti, una parte di frnt-end (FE) (presentazine infrmazine e parte interattiva utente) e una parte di back-end (BE) (scambi messaggi cn il back ffice). Di seguit il diagramma che riassume il fluss dati. (R) Linea Cmune SPa 2

3 3 3. Struttura della rete del CST L applicazine deve essere dispiegabile nella rete di mid-end del Centr Servizi, nel rispett dell architettura descritta graficamente nell immagine. (R) 3.3 Autenticazine utenti L integrazine cn il sistema di autenticazine di Linea Cmune si basa sull standard OAuth2 (vedi allegat tecnic Openamauth2specificatin.v1.dt)* 3.4 Integrazine cn sistemi infrastrutturali L applicativ che debba ffrire funzinalità di pagamenti cn carte di credit deve interfacciarsi cn i relativi sistemi in esercizi press il CST, cn esclusine di altri sistemi esterni, secnd le specifiche definite nel dcument sistema pagament estern (dispnibile al link Linea Cmune SPa 3

4 4 L applicativ che debba ffrire funzinalità di Agenda prentazini deve interfacciarsi cn i relativi sistemi in esercizi press il CST, cn esclusine di altri sistemi esterni, secnd le specifiche definite nel dcument prentazini accessibile su richiesta. (R) 3.5 Sistema di gestine cntenuti Il sistema di gestine cntenuti di riferiment è Drupal ( versine 7.x. (R) 3.6 Funzini applicative (privilegi peratri) Le funzini di backffice che richiedan access autenticat da parte degli peratri devn essere catalgabili in md da integrarsi cn il sistema di gestine privilegi secnd le specifiche definite nel dcument Privilegi peratre (dispnibile al link Repsitry Per gni servizi il cdice srgente iniziale, csì cme tutte le sue successive mdifiche, laddve revist dall incaric, deve essere caricat sul sistema di versining dedicat di Linea Cmune, attualmente GIT* 3.7 Prgettazine servizi: gestine errri applicativi In fase di prgettazine definitiva del servizi, devn essere definiti e dcumentati dal frnitre i pssibili errri applicativi ritenuti imprtanti, valutand per questi la creazine di un cdice univc (id errre + id pratica) da riprtare nei lg applicativi. A crred di questa classificazine dvrà essere realizzata pprtuna dcumentazine perativa. (R) 4. Requisiti tecnlgici per sviluppi ex-nv A cmpletament di quant dett spra, per l svilupp di applicazini nuve, vengn aggiunti i seguenti vincli. 4.1 Svilupp Servizi nline Di seguit i vincli tecnlgici che valgn per tutte le cmpnenti sviluppate: Oracle Java versin 1.8.x superire* Tmcat 8 superire* Lgging: lg4j 2 (R) 4.2 Frnt End (R) Il frnt end dvrà avere le caratteristiche previste dal dcument di specifiche PLPCE (dispnibile al link riassunte in estrema sintesi dalle seguenti: capacità multiente: tramite interpretazine dell url (parametr path) l applicativ deve cntestualizzare la sessine verticalmente rispett ad un ente. In particlare dvrà: persnalizzare il tema persnalizzare l header Linea Cmune SPa 4

5 5 persnalizzare il fter persnalizzare i testi tutti i testi devn essere letti ad gni sessine dalla cmpnente infrastrutturale FEA prprietaria di Linea Cmune attravers il prpri Back End di servizi. La cmpnente FEA è descritta nel dcument FEA (dispnibile al link tutti i cllegamenti cn il prpri back end ed eventuali altre cmpnenti del CST (per esempi la reprtistica, identità, base privilegi peratre, etc) devn essere cnfigurabili tramite file di cnfigurazine il cntrll di attivazine/disattivazine del servizi per l ente viene cntrllat tramite cllegament alla cmpnente infrastrutturale del Catalg Servizi (dispnibile al link Per quant riguarda le tecnlgie di svilupp, il grupp di lavr può scegliere tra due strade pssibili: PLPCE VAADIN In quest cas è previst l utilizz di un framewrk, di prprietà di Linea Cmune in VAADIN 7, che cpre l implementazine di tutte le integrazini previste dal CST e di attivare e cnfigurare tali cllegamenti cn semplici cnfigurazini. Gli sviluppatri dvrann cncentrarsi sl sull svilupp degli step (cntenut) previsti dal servizi. In cnseguenza all utilizz del framewrk, devn essere rispettati i seguenti vincli: Framewrk PLPCE di Linea Cmune* VAADIN 7 superire* Linea Cmune frnirà tutte le indicazini necessarie all utilizz del framewrk, riprtate in breve in quest dcument, e un prgett base cmpletamente cnfigurat e funzinante da cui partire. In riferiment all inseriment di dipendenze dal repsitry nexus di Linea Cmune si riprta un esempi di dipendenze in prgett maven (pm.xml) da nexus Lineacmune: <!-- dipendenza per autenticazine --> <grupid>it.lineacmune.authenticatin</grupid> <artifactid>lineacmune-auth</artifactid> <versin>1.6.0.release</versin> <!-- dipendenze mdul plpce per vaadin 7 --> <grupid>it.lineacmune.plpce</grupid> <artifactid>plpce-cre</artifactid> <versin>1.1</versin> <grupid>it.lineacmune.plpce</grupid> <artifactid>plpce-util</artifactid> <versin>1.0</versin> <!-- dipendenza per reprtistica --> <grupid>it.lineacmune.reprtistica</grupid> <artifactid>sp2cn-reprtistica</artifactid> <versin>1.0</versin> <!-- dipendenza fea rest --> <grupid>it.lineacmune.fearest</grupid> <artifactid>fearest</artifactid> <versin>2.0.release</versin> Linea Cmune SPa 5

6 6 aggiungere indirizz nexus tra i repsitries <repsitries> <repsitry> <id>linearep</id> <url> </repsitry> </repsitries> mettend nei settings.xml del mvn, stt il tag <servers> <server> <id>linearep</id> <username>mvnlinea</username> <passwrd>[pssw da richiedere in avvi di prgett]</passwrd> </server> PLPCE AngularJS Cn pprtuna giustificazine e quindi cn l apprvazine di Linea Cmune, un nuv prgett può essere sviluppat cn il framewrk AngularJS in cppia cn Spring Bt. In tal cas nn essendci un layer già prnt, il frnitre si ccuperà di sviluppare tutte le integrazini necessarie vers i sistemi del CST. I vincli tecnlgici sn: AngularJS 4 superire* Spring Bt 1.5 superire* 4.3 Requisiti tecnlgici applicativi di BE Utilizz di Spring framewrk 3.x (R) Il prgett deve essere di tip Maven prject e prfilat (prduzine e staging)* Il Maven packaging deve essere di tip war * Interfaccia cn DBMS: presenza di strat ORM Hibernate 4.x superire* L applicativ deve esprre un interfaccia di tip RESTful prevedend rispste in frmat JSON e XML* 4.4 Requisiti tecnlgici applicativi di FE Il prgett deve essere di tip Maven prject e prfilat (prduzine e staging) (R) Il Maven packaging deve essere di tip war * L applicativ deve interagire cn il BE tramite i seguenti prtclli*: REST jsn* REST xml* Linea Cmune SPa 6