Opis Przedmiotu Zamówienia dla zadania pn.

Opis Przedmiotu Zamówienia dla zadania pn. Opracowanie dokumentacji powykonawczej systemu pn. Inteligentny System Sterowania Opracowanie Patryk Zakrzewski Zarząd Dróg Wojewódzkich w Krakowie styczeń 2015r. 1

1. Wstęp. Przedmiotem zamówienia jest wykonanie dokumentacji posiadanych przez Zamawiającego aplikacji stanowiących system informatyczny zarządzający systemem ITS pn. Inteligentny System Sterowania Ruchem Regionu Podhalańskiego (ISSRRP), oraz wykonanie innych czynności z tym związanych wskazanych w niniejszym OPZ. 2. System ISSRRP (informacje o systemie). ISSRRP stworzony został w 2011r. w ramach Małopolskiego Regionalnego Programu Operacyjnego na lata 2007-2013 (MRPO 2007-2013). Szczegółowe informacje dotyczące systemu ISSRRP znajdują się w załącznikach do niniejszego OPZ stanowiących dokumentację techniczną całego systemu ISSRRP a także jego poszczególnych elementów. System funkcjonuje na drogach wojewódzkich i krajowych przebiegających przez powiaty nowotarski i tatrzański Województwa Małopolskiego (urządzenia ITS systemu umieszczone są także w ciągu dróg powiatowych). System stworzony został w celu realizacji idei rozproszenia ruchu z drogi krajowej nr 47 na drogi wojewódzkie obszaru objętego projektem. System działa w oparciu o urządzenia RTMS typu 4 oraz urządzenia ANPR, jako urządzenia dostarczające informacje do systemu na temat natężenia ruchu i ilości pojazdów poruszających się po drogach. W efekcie, na tablicach informacji drogowej (VMS) systemu ISSRRP oraz w portalu wtatry.eu podawane są informacje o czasie dojazdu do miejscowości docelowych wraz ze wskazaniem warunków ruchu Tablice VMS posiadają fizyczny podział na obszar graficzny RGB i obszar tekstowy BW. Obszar RGB używany jest do przekazywania informacji o warunkach ruchu i czasie dojazdu do miejscowości docelowej drogą główną i alternatywną. W szczególnych przypadkach na obszarze tym wyświetlane są informacje tylko 2

i wyłącznie dotyczące jednej drogi a wynika to z miejsca lokalizacji tablicy i układu drogowego. Obszar BW używany jest do wyświetlenia informacji w postaci nazwy miejscowości. Obszar BW posiada dwa elementy, na których możliwym jest wyświetlanie treści, przy komunikatach dotyczących czasu dojazdu używany jest tylko jeden obszar. Rysunek 1 - wzór tablicy VMS systemu ISSRRP Obszar RGB posiada matrycę o wymiarze 100x100cm, obszar BW posiada matryce o wymiarze 240x100 cm z tym, że jest ona rozdzielona obszarem nie aktywnym (kolor szary na rys nr 1). Ponadto, w systemie ISSRRP znajdują się także kamery HD, które w sposób ciągły z zachowaniem definiowalnego interwału czasu przekazują obraz statyczny z miejsc gdzie są umieszczone. System składa się także ze stacji meteorologicznych o parametrach wskazanych w załącznikach do OPZ. Wszystkie dane gromadzone przez urządzenia umieszczone na obszarze objętym projektem poprzez transmisje danych 3G/EDGE przesyłane są do serwera systemu i dostępne w aplikacji systemowej, która umieszczona jest na stacji roboczej w Regionalnym Centrum Nadzoru Ruchu (RCNR). Elementem systemu ISSRRP jest także mobilne centrum nadzoru ruchu (MCNR) realizowane przez samochód terenowy KIA Sportage. 3

System ISSRRP na mocy porozumienia zawartego przez Zamawiającego i GDDKiA zintegrowany jest z systemem Czasu Przejazdu GDDKiA funkcjonującym na drodze krajowej nr 7 (odcinek Rabka Zdrój Zakopane). Integracja wykonana jest na poziomie baz danych systemów (wymiana danych jednostronna -> z systemu Czasu Przejazdu do systemu ISSRRP). AS aplikacja serwerowa AK aplikacja kliencka BD baza danych US urządzenia systemu AZ aplikacje zewnętrzne SI strona internetowa wtatry.eu AM aplikacje mobilne 3. Zakres przedmiotu zamówienia. 3.1 Szczegółowa dokumentacja techniczna. Wykonawca zobowiązany będzie do opracowania szczegółowej dokumentacji technicznej (w języku polskim) opisującej zasadę działania aplikacji systemu (aplikacja serwerowa i aplikacja kliencka systemu). Poprzez szczegółową dokumentacje należy rozumieć dokładny i wyczerpujący opis zawierający, co najmniej: 3.1.1 Opis zasady działania aplikacji serwerowej. W ramach powyższej dokumentacji należy wykonać opis działania AS w zakresie, co najmniej zależności pomiędzy AS AK, AS BD, AS US, AS AZ, AS SI, AS AM. Opracowana dokumentacja winna umożliwić zrozumienie działania AS w w/w zakresie. Powiązania, relacje i zależności należy opisać a także przedstawić graficznie w postaci schematów (UML). 4

3.1.2 Opis zasady działania aplikacji klienckiej. W ramach powyższej dokumentacji należy wykonać opis działania AK w zakresie, co najmniej zależności pomiędzy AK AS, AK BD, AK US, AK AZ, AK SI, AK AM. Opracowana dokumentacja winna umożliwić zrozumienie działania AK w w/w zakresie. Powiązania, relacje i zależności należy opisać a także przedstawić graficznie w postaci schematów (UML). 3.1.3 Opis bazy danych. W ramach powyższej dokumentacji należy wykonać kompletny opis bazy danych systemu ISSRRP w tym dokonać analizy sposobu replikacji bazy na potrzeby bazy SI. Należy także wykonać opis integracji bazy danych systemu ISSRRP z system Czasu Przejazdu. Powiązania, relacje i zależności należy opisać a także przedstawić graficznie w postaci schematów (UML). Wykonawca zobowiązany będzie do opracowania szczegółowej dokumentacji technicznej bazy danych systemu ISSRRP. Baza danych wykonana jest w systemie MySQL, Zamawiający udostępni Wykonawcy dostęp do bazy danych. Dokumentacja winna opisywać wszystkie relacje i zdarzenia występujące w bazie danych oraz opisywać metodykę pozyskiwania danych do bazy z źródeł danych (urządzenia ITS) oraz opisywać metodykę integracji z systemem GDDKiA. Ponadto dokumentacja winna opisywać metodykę prezentacji danych z bazy systemu (portal wtatry.eu, system informatyczny, tablice VMS). 3.1.4 Opis komunikacji aplikacji serwerowej i klienckiej z poszczególnymi urządzeniami systemu. W ramach powyższej dokumentacji należy wykonać kompletny opis komunikacji poszczególnych grup urządzeń ITS systemu ISSRRP z aplikacją serwerową i kliencką. Opracowana dokumentacja winna umożliwić zrozumienie funkcjonowania komunikacji w systemie. Powiązania, relacje i zależności należy opisać a także przedstawić graficznie w postaci schematów (UML). 5

3.1.5 Opis zasady działania poszczególnych (wszystkich) funkcji aplikacji serwerowej. W ramach powyższej dokumentacji należy wykonać kompletny opis zasady działania wszystkich dostępnych w AS funkcji wykonywanych za pomocą dostępnych w aplikacji narzędzi. Powiązania, relacje i zależności należy opisać a także przedstawić graficznie w postaci schematów (UML). 3.1.6 Opis zasady działania poszczególnych (wszystkich) funkcji aplikacji klienckiej. W ramach powyższej dokumentacji należy wykonać kompletny opis zasady działania wszystkich dostępnych w AK funkcji wykonywanych za pomocą dostępnych w aplikacji narzędzi. Powiązania, relacje i zależności należy opisać a także przedstawić graficznie w postaci schematów (UML). 3.1.7 Opis znaczenia i funkcji poszczególnych bibliotek (dll) użytych w systemie informatycznym. Aplikacja serwerowa i kliencka odwołują się do następujących bibliotek umieszczonych w tym samym katalogu: AK: AxInterop.NCXViewLib.1.0.dll AxInterop.XDVIEWLib.1.0.dll AxInterop.XDVIEWLib.4.74.dll Interop.NCXViewLib.1.0.dll Interop.XDVIEWLib.1.0.dll Interop.XDVIEWLib.4.74.dll ISSCommonFunctions.dll ISSLog.dll LanguageLib.dll MySqlData.dll VMSChinaDLL.dll 6

AS: AxInterop.XDVIEWLib.1.0.dll AxInterop.XDVIEWLib.4.74.dll Interop.XDVIEWLib.1.0.dll Interop.XDVIEWLib.4.74.dll ISSCommonFunctions.dll ISSLog.dll LanguageLib.dll MySQL.VisualStudio.dll RtmsG4ProtocolDLL.dll RtmsMySqlDotNetDLL.dll VMSChinaDLL.dll VMSDarmonProtocol.dll AS w podkatalogu (MeteoSerwer): MySql.Data.dll MySql.Data.Entity.dll MySql.Web.dll W ramach powyższej dokumentacji należy wykonać opis na podstawie, którego będzie można zrozumieć znaczenie i funkcje w/w bibliotek w systemie ISSRRP. Powiązania, relacje i zależności należy opisać a także przedstawić graficznie w postaci schematów (UML). 7

3.1.8 Opis znaczenia i funkcji poszczególnych aplikacji zewnętrznych użytych w systemie informatycznym niezbędnych do działania aplikacji serwerowej i klienckiej. W katalogach AK i AS znajdują się następujące aplikacje: AK: ISSFileTransfer.exe MeteoViewer.exe AS w podkatalogu (MeteoSerwer): MeteoSerwer.exe PipeTestClient.exe W ramach powyższej dokumentacji należy wykonać opis na podstawie, którego będzie można zrozumieć znaczenie i funkcje w/w aplikacji funkcjonujących w ramach systemu ISSRRP. Powiązania, relacje i zależności należy opisać a także przedstawić graficznie w postaci schematów (UML). Na serwerze systemu, w ramach systemu ISSRRP funkcjonują aplikacje firmy CitySync Wykonawca nie jest zobowiązany do opracowania dokumentacji aplikacji i bazy danych wchodzących w skład oprogramowania CitySync. 3.1.9 Dokumentacja kodu źródłowego aplikacji serwerowej i klienckiej. Wykonawca zobowiązany jest do opracowania dokumentacji kodu źródłowego aplikacji klienckiej i serwerowej. W tym celu, Wykonawca za pomocą własnych środków zobowiązany jest dokonać dekompilacji AK i AS, i w razie takiej konieczności wskazanych w pkt. 3.17 bibliotek aplikacji. Po dokonaniu dekompilacji Wykonawca zobowiązany będzie do wprowadzenia w treść kodu źródłowego usystematyzowanego nazewnictwa funkcji oraz wprowadzenia komentarzy do kodu adekwatnie do opracowanej jego dokumentacji. Powiązania, relacje i zależności należy opisać a także przedstawić graficznie w postaci schematów (UML). W dokumentacji należy opracować podrozdziały, w których Wykonawca za pomocą opisu i za pomocą graficznego przedstawienia, przedstawi na zasadzie krok po 8

kroku jak wprowadzać zmiany w istniejącej aplikacji (dotyczy aplikacji klienckiej i serwerowej), i jak wprowadzać do aplikacji nowe obiekty. Poprzez wprowadzenie zmian w aplikacji należy rozumieć wykonanie określonych czynności mających na celu zmianę istniejących lub usunięcie określonych istniejących funkcji / funkcjonalności z aplikacjach, a następnie po wykonaniu tych czynności i dokonaniu kompilacji otrzymanie prawidłowo działającej aplikacji. Poprzez wprowadzenie nowych obiektów należy rozumieć wykonanie określonych czynności mających na celu rozszerzenie funkcjonalności aplikacji o nowe obiekty tego samego typu i rodzaju, co istniejące lub innego typu i rodzaju, co istniejące, a następnie po wykonaniu tych czynności i dokonaniu kompilacji otrzymanie prawidłowo działającej aplikacji. W zakresie wprowadzania do aplikacji nowych obiektów, w dokumentacji należy wprowadzić rozróżnienie, na co najmniej następujące scenariusze postępowania (SP): SP1 wprowadzenie nowego odcinka (drogi) do systemu dotyczy graficznego zobrazowania w aplikacji, SP2 wprowadzenie nowego obiektu (tego samego typu i rodzaju, co istniejące) umieszczenie symbolu obiektu na graficznym zobrazowaniu, zdefiniowanie zawartości dla obiektu (np. stacja SPRD + SMW+TID), uzyskanie funkcjonalności dla tego obiektu jak w chwili obecnej w systemie, SP3 zmiana lokalizacji obiektu na graficznym zobrazowaniu w aplikacji, 9

Zamawiający we własnym zakresie uzyskał kod źródłowy aplikacji klienta systemu, którego część dla zobrazowania stanowi załącznik nr 2 do niniejszego OPZ. 3.1.10 Wykonanie instalatora aplikacji klienckiej. Wykonawca zobowiązany jest wykonać instalator aplikacji klienckiej. Instalator winien umożliwić instalację aplikacji oraz umożliwić konfigurację tej aplikacji w taki sposób, aby po jej uruchomieniu nie było wymagane ponowne konfigurowanie. W tym celu należy aplikację kliencką wzbogacić o funkcję definiowania sposobu połączenia z serwerem (dla stacji roboczych pracujących w tej samej sieci (LAN) co serwer systemu, oraz dla stacji roboczej pracującej poza tą siecią (LAN) a komunikujących się z serwerem za pomocą GSM (karta SIM pracującą w prywatnym APN systemu ISSRRP). Wobec powyższego przy uruchomieniu aplikacji winno pojawić się okno dialogowe, w którym użytkownik winien wybrać sposób komunikacji z serwerem (LAN/GSM), wraz z możliwością zmiany ustawień wymaganych do prawidłowej komunikacji aplikacji klienckiej z serwerem w trybie pracy zarówno LAN jak i GSM. 3.1.11 Dokumentacja funkcjonowania algorytmu obliczania czasu przejazdu i wyświetlania informacji na tablicach TID. System ISSRRP za pomocą tablic (TID) przekazuje kierującym informacje o warunkach ruchu oraz o czasie dojazdu do określonej miejscowości. Wykonawca systemu ISSRRP nie dostarczył Zamawiającemu dokumentacji opisującej funkcjonujący algorytm obliczania czasu dojazdu oraz określający warunki ruchu. Wykonawca w systemie zdefiniował sposób, w jaki na tablicach TID prezentowane są treści dotyczące czasu dojazdu a do pamięci tablic TID wprowadził określony zestaw plików graficznych wywoływanych w zależności od miejsca lokalizacji tablicy (układ graficzny dróg) oraz w zależności od warunków ruchu i czasu przejazdu (kolor elementów układu graficznego). Wykonawca niniejszego zamówienia zobowiązany jest do wykonania dokumentacji technicznej dotyczącej funkcjonowania w systemie ISSRRP algorytmu obliczania czasu przejazdu oraz algorytmu odpowiedzialnego za wyświetlanie określonych informacji w powiazaniu z algorytmem obliczania czasu przejazdu i warunków ruchu 10

przedstawić w sposób wyczerpujący zasadę działania systemu i skutki emisję określonego komunikatu. Dokumentacja opracowania w tym zakresie przez Wykonawcę musi w sposób wyczerpujący opisywać w/w algorytmy oraz umożliwić Zamawiającemu wprowadzenie zmian w tych algorytmach a także wprowadzenia zmian w sposobie wyświetlania treści na tablicach TID (dzięki dekompilacji). Ponadto, Zamawiający planuje w najbliższym czasie dokonać zmiany w systemie w postaci wprowadzenia nowych tablic w miejsce istniejących (DK47 w m. Chabówka oraz Nowy Targ) i zmiany lokalizacji niektórych tablic (istniejące tablice z DK47 w m. Chabówka i Nowy Targ zostaną zlokalizowane w innych miejscach skrzyżowania na obszarze objętym projektem ISSRRP). Nowe tablice posiadały będą inne rozmiary oraz należy uwzględnić fakt, że mogą one być innego producenta niż obecne. Wobec powyższego Wykonawca w dokumentacji winien wprowadzić analizę dotyczącą koniecznych zmian/modyfikacji w systemie, jakie należy wykonać przy zmianie lokalizacji istniejących tablic i wprowadzeniu nowych tablic. W zakresie nowych tablic schemat komunikatów pozostanie bez zmian, zmianie ulegnie układ graficzny elementów komunikatu (jak na rysunku poniżej). 11

UWAGA: system ISSRRP do wyliczania czasu przejazdu pośrednio korzysta z danych pochodzących z urządzeń ANPR. Wykonawca nie jest zobowiązany do opracowania dokumentacji w zakresie urządzeń ANPR oraz aplikacji firmy CitySync działających na serwerze systemu ISSRRP oraz lokalnie w urządzeniach ANPR, a jedynie w dokumentacji systemu należy wskazać wszystkie zależności, odniesienia i funkcje systemu związane z funkcjonującymi w ramach systemu aplikacjami firmy CitySYnc. 3.1.12 Analiza funkcjonowania systemu ISSRRP. Wykonawca systemu ISSRRP zobowiązany był do opracowania analizy funkcjonowania systemu ISSRRP na koniec okresu administrowania systemem (grudzień 2013r.). Wykonawca systemu ISSRRP nie opracował w/w analizy. Wykonawca niniejszego zamówienia zobowiązany jest opracować analizę funkcjonowania systemu ISSRRP, jako systemu informatycznego oraz w odniesieniu do jego funkcji, a także w odniesieniu do gromadzonych danych i ich użyteczności. Analiza winna wskazywać na ewentualne konieczne do wprowadzenia zmiany w algorytmach systemu, sposobie funkcjonowania systemu, sposobie pozyskiwania, transmisji i agregacji danych. Analiza winna wskazywać konkretne zdarzenia systemowe zidentyfikowane przez Wykonawcę, jako działające w sposób niewłaściwy lub które wg Wykonawcy można zmodyfikować w celu optymalizacji działania systemu. Analiza winna zawierać precyzyjny kosztorys Wykonawcy, poszczególne pozycje dotyczyły będą wskazanych w analizie zdarzeń. 4 Format dokumentacji. 4.1 Dokumentacja papierowa. Wykonawca zobowiązany będzie przekazać Zamawiającemu opracowaną dokumentacje w formie papierowej. Dokumentacja winna stanowić wydruki dwustronne (kolorowe) na papierze w formacie A-4. Każda strona winna być ponumerowana i zawierać nagłówek opisujący. Dokumentację należy fizycznie podzielić na rozdziały, które dotyczyły będą poszczególnych elementów systemu ISSRRP. W razie konieczności rozdziały należy podzielić pod rozdziały. Dokumentacja winna zawierać spis treści i słownik użytych pojęć. 12

Dokumentacja kodu źródłowego aplikacji winna być opracowana w sposób zbliżony lub tożsamy z dostarczonym kodem źródłowym należy zachować kolorystykę linii kodu i komentarzy. Dokumentację należy dostarczyć w trzech egzemplarzach. 4.1 Dokumentacja elektroniczna. Wykonawca zobowiązany jest dostarczyć Zamawiającemu dokumentację wskazaną w pkt. 4.1. OPZ w wersji elektronicznej w formacie *.docx oraz *.PDF. W zakresie pliku PDF winien być to plik PDF wielostronicowy. 5. Pliki źródłowe. Wykonawca zobowiązany jest dostarczyć Zamawiającemu komplet, uzyskanych w procesie dekompilacji i produkcji, plików źródłowych dla wszystkich zdekompletowanych przez Wykonawcę plików systemu ISSRRP. W dokumentacji należy wskazać narzędzia programistyczne oraz inne narzędzia użyte przez Wykonawcę oraz narzędzia wymagane do dokonania kompilacji w celu uzyskania plików wykonywalnych (*.exe). 6. Zachowanie poufności informacji. Wykonawca zobowiązany będzie do zachowania w poufności pozyskanych w ramach zamówienia danych i rozwiązań informatycznych, w tym otrzymanych od Zamawiającego plików systemu ISSRRP. 7. Realizacja przedmiotu zamówienia. Wykonawca zobowiązany będzie do stworzenia we własnym zakresie i z wykorzystaniem własnych zasobów sprzętowych i własnego oprogramowania, środowiska testowego i produkcyjnego (z udziałem urządzeń ITS systemu ISSRRP) na potrzeby realizacji przedmiotu zamówienia. Zamawiający umożliwi zdalny dostęp do serwera systemu ISSRRP Wykonawcy na potrzeby przeprowadzania niezbędnych testów i innych czynności związanych z przedmiotem zamówienia. 13

Spis załączników do OPZ: 1. Dokumentacja systemu ISSRRP 2. Wyciąg z kodu źródłowego aplikacji klienta systemu ISSRRP 3. SDK urządzeń systemu ISSRRP 4. Przykładowa dokumentacja powykonawcza urządzeń systemu ISSRRP 14