Port Community System del Porto di Ravenna CONFIGURAZIONE

Transcript

1 Port Community System del Porto di Ravenna CONFIGURAZIONE

2 SOMMARIO Indicazioni generali... 3 Dipendenze software... 4 Lato server... 4 Lato client... 4 Organizzazione del sistema... 5 Struttura delle directory... 5 Struttura generale dei moduli... 6 Organizzazione Base Dati... 7 PORT COMMUNITY SYSTEM DEL PORTO DI Ravenna CONFIGURAZIONE pag. 2

3 INDICAZIONI GENERALI Il sistema è implementato sotto forma di un applicativo web realizzato attraverso l utilizzo della piattaforma LAMP. Le tecnologie lato server utilizzate sono quindi rappresentate da: Sistema operativo: Linux Base dati: MySQL (MySQL Enterprise Edition versione sp1) Web Server: Apache HTTP Server Linguaggio: PHP (versione 5.1.6) Le pagine dell'applicativo sono realizzate adottando interamente le tecniche di sviluppo Ajax ed il protocollo di scambio dati JSON al fine di fornire agli utenti un'esperienza di utilizzo più fluida rispetto agli applicativi web tradizionali basati sulla rigenerazione completa della pagina. Javascript è utilizzato pertanto estensivamente a livello client avvalendosi di librerie considerabili standard. Considerando le necessità di ambiente di esecuzione delle librerie utilizzate, l'applicativo ha un target di compatibilità dei browser limitato alle versione recenti di Internet Explorer (8 o superiore), Firefox e Chrome. Il browser di riferimento per una migliore esperienza di utilizzo è Chrome. PORT COMMUNITY SYSTEM DEL PORTO DI Ravenna CONFIGURAZIONE pag. 3

4 DIPENDENZE SOFTWARE LATO SERVER Di seguito sono elencati i principali componenti PHP utilizzati in aggiunta a quelli di una installazione LAMP standard (libreria di connessione a MySQL, ecc): FPDF ed MPDF per la generazione degli elaborati in PDF. FPDF per la creazione dei PDF da api, MPDF per la creazione dei PDF a partire da markup html componente Spreadsheet_Excel_Writer del repository PEAR per la generazione degli elaborati in formato Excel I processi di acquisizione delle Dichiarazioni Doganali create utilizzando sistemi di terze parti di proprietà o in uso agli utenti richiedono la configurazione di un server FTP e l'installazione di Python versione 2.7 per l'esecuzione degli script di elaborazione. L'esecuzione di questi processi richiede l'installazione delle librerie standard di Python per la connessione verso MySQL. Il Port Community System ha necessità per il suo funzionamento di stabilire una connessione ad un nodo telematico esterno che fornisca le funzionalità di interfacciamento e gestione flussi doganali con il sistema AIDA dell Agenzia delle Dogane. Il nodo telematico deve interfacciarsi direttamente con il Port Community System prelevandone i dati necessari alla predisposizione delle comunicazioni doganali, inviando le comunicazioni al sistema AIDA e restituendo gli esiti al Port Community System nel formato previsto. LATO CLIENT Le principali librerie javascript utilizzate sono: JQuery (versione 1.5.1). Per la manipolazione del dom. JQuery UI (versione ). Per i widget dell'interfaccia utente. Knockout.js (versione 2.2.0) per il data-binding di alcuni moduli JQuery.Datatables. Una libreria che fornisce un componente griglia da utilizzare nelle pagine JQuery.Autocomplete. Una libreria per l'autocomplete. La versione in uso è stata modificata a partire dalla versione del componente) JQote2:una libreria di templating (versione 0.9.2) Una libreria javascript sviluppata internamente che consente di gestire: o la validazione dei valori inputati dagli utenti o le griglie dati lato utente (in alternativa al componente fornito da JQuery.Datatables) o funzioni helper varie PORT COMMUNITY SYSTEM DEL PORTO DI Ravenna CONFIGURAZIONE pag. 4

5 ORGANIZZAZIONE DEL SISTEMA Il sistema è costituito da un sito web e da una serie di script Python di supporto. Il sito è suddiviso in una serie di moduli semi-indipendenti che dipendono da un modulo centrale che agisce da contenitore e legante. Il modulo centrale racchiude: i componenti di autenticazione e profilazione degli utenti (login, gestione della sessione autenticata, parametri utente) i componenti che gestiscono l'interfaccia comune del sistema (canvas e menu profilato) il sistema delle notifiche I moduli gestionali sono rappresentati per categorie da: il modulo amministrativo per la creazione e gestione dei profili utenti e la pubblicazione delle notifiche generali i moduli operativi: o la gestione delle Entry Summary Declaration o la gestione dei Manifesti Merci in Arrivo o la gestione dei Viaggi nave o la gestione degli Ordinativi di Imbarco o la gestione delle Liste di Imbarco o la gestione di Manifesti Merci in Partenza o la consultazione degli A3 i moduli per le comunicazioni con l'autorità Portuale STRUTTURA DELLE DIRECTORY La directory www rappresenta la radice documentale del sito e contiene: i file php della home-page e della login nella radice stessa. una serie di directory contenenti file di supporto del sito (immagini,css, file javascript ecc) la directory include che contiene librerie generali e le classi e le funzioni comuni a tutti i moduli. le risorse particolarmente importanti a questo livello sono rappresentate da: o classi.php. Contenente le classi di sessione del profilo utenti e funzioni generali. o include.php. Contenente i parametri di sessione. o system.php Contenente la definizione degli oggetti principali del sistema e funzioni essenziali di supporto. la directory sw al cui interno sono contenuti i moduli gestionali. Ciascuno modulo gestionale è contenuto in una propria directory. La directory swinclude a sua volta diverse sotto-directory: a3. Contiene il modulo per la consultazione delle A3 amministrazione. Contiene il modulo per l'amministrazione del sistema (creazione ditte, profilatura utenti, ecc) comm. Contiene il modulo per le comunicazioni con l'autorità Portuale. crew_list. Contiene il modulo per la gestione delle Crew List. dogana. Contiene il modulo per il caricamento diretto delle bolle doganali e per la visualizzazione dei flussi caricati. PORT COMMUNITY SYSTEM DEL PORTO DI Ravenna CONFIGURAZIONE pag. 5

6 ens2. Contiene il modulo per la gestione delle ENS. liste_imbarco. Contiene il modulo per la gestione delle Liste di Imbarco. mma_v4. Contiene il modulo per la gestione dei Manifesti delle Merci in Arrivo. mmp3. Contiene il modulo per la gestione dei Manifesti delle Merci in Partenza. odi. Contiene il modulo per la gestione degli Ordinativi di Imbarco. viaggi_nave. Contiene il modulo per la gestione dei Viaggi Nave. STRUTTURA GENERALE DEI MODULI In generale la struttura delle directory e dei file di ciascun modulo è organizzata nel modo seguente. Nella radice sono contenuti i file php che rappresentano l'interfaccia del modulo. Sono poi presenti diverse sotto-directory. la directory include. Contiene al suo interno le definizioni di classi e di funzioni specifiche del modulo in oggetto. la directory media. Contiene al suo interno le risorse specifiche di tipo web utilizzate dal modulo: immagini, file css, file e librerie javascript. Queste risorse sono in genere raggruppate per tipologia in directory separate: css, images, js. la directory ajax. Contiene al suo interno le risorse php caricate via ajax e gli script php di scambio dati/operazioni JSON/rpc. PORT COMMUNITY SYSTEM DEL PORTO DI Ravenna CONFIGURAZIONE pag. 6

7 ORGANIZZAZIONE BASE DATI Per quanto riguarda la struttura della base di seguito è indicata la ripartizione delle funzioni tra gli schemi di database utilizzati. intrasix. Contiene le classi di profilatura e di sistema comuni a tutti i moduli. Al suo interno sono quindi presenti le tabelle delle ditte, degli utenti, dei permessi, delle aree e le tabelle strutturali della piattaforma (menu, parametri ecc). intrasix_hub. Contiene i dati gestionali della piattaforma e quindi le tabelle utilizzate dai moduli indicati precedentemente. service_comm. Contiene le tabelle utilizzate dal modulo delle comunicazioni con l'autorità Portuale. service_crewlist. Contiene le tabelle utilizzate dal modulo di interscambio dati finalizzato al rilascio dei permessi temporanei di sbarco. PORT COMMUNITY SYSTEM DEL PORTO DI Ravenna CONFIGURAZIONE pag. 7