[elvystrac] r1685 - documentation upgraded
- From: elvys@xxxxxxxxxxxxxxxxxxxxxx
- To: elvystrac@xxxxxxxxxxxxx
- Date: Tue, 9 Feb 2010 10:30:41 +0100
Author: DavidK
Date: 2010-02-09 10:30:41 +0100 (Tue, 09 Feb 2010)
New Revision: 1685
Added:
others/dokumentace/technicalGuide/architecture/9z10appendix.tex
Modified:
others/dokumentace/technicalGuide/architecture/0architecture.tex
others/dokumentace/technicalGuide/architecture/1preface.tex
others/dokumentace/technicalGuide/architecture/4webapp.tex
others/dokumentace/technicalGuide/architecture/5layoutdesigner.tex
others/dokumentace/technicalGuide/architecture/7communication.tex
others/dokumentace/technicalGuide/architecture/8deployment.tex
Log:
documentation upgraded
Modified: others/dokumentace/technicalGuide/architecture/0architecture.tex
===================================================================
--- others/dokumentace/technicalGuide/architecture/0architecture.tex
2010-02-08 19:46:36 UTC (rev 1684)
+++ others/dokumentace/technicalGuide/architecture/0architecture.tex
2010-02-09 09:30:41 UTC (rev 1685)
@@ -9,7 +9,7 @@
\usepackage{multirow}
\usepackage{threeparttable}
\usepackage{longtable}
-
+\usepackage[czech]{babel}
\usepackage[left=2cm]{geometry}
\pagestyle{fancy}
% with this we ensure that the chapter and section
@@ -30,6 +30,7 @@
%\usepackage[left=2cm]{geometry}
+%\usepackage[bookmarks=true]{hyperref}
\begin{document}
@@ -66,12 +67,11 @@
%programove nastroje, patri to sem vubec?
\include{9tools}
-
-
+
\listoffigures
\clearpage
\listoftables
\clearpage
+\include{9z10appendix}
-
\end{document}
Modified: others/dokumentace/technicalGuide/architecture/1preface.tex
===================================================================
--- others/dokumentace/technicalGuide/architecture/1preface.tex 2010-02-08
19:46:36 UTC (rev 1684)
+++ others/dokumentace/technicalGuide/architecture/1preface.tex 2010-02-09
09:30:41 UTC (rev 1685)
@@ -60,4 +60,4 @@
Jelikož bylo rozhodnuto použití multiplatformního řešení ve formě Qt a C++,
volba operačního systému nebyla omezena. Vzhledem k požadavku na co nejmenší
cenu řešení,
velikosti instalace, hardwarovým nárokům a možnosti vzdálené spravy byla
zvolena cílová platforma Linux, konkrétně Ubuntu 9.04 v minimální instalaci.
-O více detailech pojednává kapitola \ref{TODO}.
\ No newline at end of file
+O více detailech pojednává kapitola \ref{TODO}.
Modified: others/dokumentace/technicalGuide/architecture/4webapp.tex
===================================================================
--- others/dokumentace/technicalGuide/architecture/4webapp.tex 2010-02-08
19:46:36 UTC (rev 1684)
+++ others/dokumentace/technicalGuide/architecture/4webapp.tex 2010-02-09
09:30:41 UTC (rev 1685)
@@ -1,42 +1,55 @@
-\chapter{Software}
+\chapter{Architektura webové strany řešení ELVYS}\label{webapp}
%asi jeste nejake kecy
-\section{Webová aplikace}
- %TODO rozdeleni na subsections, mozna dalsi includy?
- % rozdeleni na moduly, jeden z nich je statistika, dalsi
layoutdesigner...
-
- \subsection{Přehled}
- todo: napsat neco o tom, ze to je rozdelene do na sobe nezavislych webovych
modulu webServer2 a dispatcher. Taky se zminit o appletu
-
-
- \subsection{Rozdělení do modulů, sdílená aplikační logika}
- - na to taky navazuje připravenost na napsání dalšího modulu- pro
WS-API, přesunout k sobě. Odkaz na sekci, kde je popsáno, jak tu aplikacni
logiku mame vlastne oddelenou...\\
- Build je prováděn pomocí ANT-skriptů, které jsou popsány v
\ref{build_ant}\\
-
- \subsection{Bezpečnost na serveru}
- Popsat, jak je řešena autentizace, autorizaci radsi nezminovat, popsat
SSL:
- \subsubsection{webServer2} - ten SSL zatim nema
- \subsubsection{dispatcher} - tenhle taky ne
- \subsection{Popis komunikace serveru}
- \subsubsection{webServer2}
- FF, IE8, nutnost JRE pro applet
- \subsubsection{webAPI??}
- viz. dale
- \subsubsection{dispatcher}
- komunikace mezi kiosky a serverem
-
+
+
+
%%%%%%%%%%%%%%%%%%%%%%%%%%
-%% WebServer2 obecně
-%%%%%%%%%%%%%%%%%%%%%%%%%%
- \subsection{WebServer2}
- popsat architekturu weboveho serveru - JSF+Richfaces, zavislosti,...
-
- \subsection{popis datového modelu}
-
+%% webová architektura obecně
%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\section{Architektura webové části}
+Webová část řešení sestává ze 2 hlavních projektů, které obsahují, či
využívají další části.\textit{Obrázek \ref{webapp_img_components}} ukazuje
vstah projektů vyvíjených v rámci řešení ELVYS.
+
+ \begin{figure}
+ \label{webapp_img_components}
+ \begin{center}
+ \includegraphics[width=0.95\textwidth]{imgs/component_model.png}
+ \end{center}
+ \caption{Schéma projektů řešení ELVYS}
+\end{figure}
+
+ \subsection{webServer2}
+ WebServer2 je stěžejní částí webové strany řešení. Je to webová aplikace
umožňující
+ uživatelům provádět veškeré činnosti spojené s agendou plánování
dokumentů,
+ správy společností, uživatelů, zobrazování reportů a všech dalších věcí,
které by měl systém ELVYS umět podle \textit{dokumentu analýzy}. \\
+ Ke své práci využívá i
+
+ \subsubsection{rychlost}
+ Ukládání session\-state na serveru
+
+
+ \subsection{dispatcher}
+ Tato aplikace umožňuje kioskům získávat od serveru informace o
plánování.
+
+ \subsection{elvysCommons}
+ V tomto modulu se nachází sdílený kód a sdílené zdroje, které používá
jak projekt webServer2, tak projekt dispatcher.
+ \subsection{LayoutDesigner} Jedná se o java applet, grafický editor, který
je součástí webové
+ aplikace (konkrétně tedy aplikace webServer2) a umožňuje uživateli
navrhovat
+ rozvržení obrazovek pro kiosky. Podobněji se architekturou tohoto editoru
zabývá \textit{kapitola \ref{LD} (\pageref{LD})}.
+ Komunikaci mezi webovým serverem a editorem LayoutDesigner potom popisuje
\textit{kapitola \ref{interface_web_and_LD} (\pageref{interface_web_and_LD})}.
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%
%% DB, ORM
-%%%%%%%%%%%%%%%%%%%%%%%%%%
- \subsection{popis 'ORM' frameworku Hibernate}\label{hibernate}
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Databázový model a databáze}
+napsat, co se pouziva za DB
+
+
+ \subsection{popis datového modelu}
+ \subsection{popis 'ORM' frameworku Hibernate}\label{hibernate}
\subsection{nastavení hibernate}
@@ -62,11 +75,72 @@
=popsat tady postup
\subsection{Používání Hibernate Session v kódu}
+
+
%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Security
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{bezpečnost}
+
+ \subsection{Autentizace uživatelů}
+
+
+ \subsection{Automatická expirace session}
+
+
+ \subsection{Ukládání session na serveru}
+ \subsubsection{webServer2} - ten SSL zatim nema
+ \subsubsection{dispatcher} - tenhle taky ne
+ \subsection{Podpora SSL}
+ \subsection{Popis komunikace serveru}
+ \subsubsection{webServer2}
+ FF, IE8, nutnost JRE pro applet
+ \subsubsection{webAPI??}
+ viz. dale
+ \subsubsection{dispatcher}
+ komunikace mezi kiosky a serverem
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% libraries
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Použité JAR knihovny}
+Tato sekce obsahuje seznam knihoven (JAR souborů), které jsou použity pro
vytvoření řešení ELVYS.\\
+ \subsection{JAR knihovny sdílené knihovny elvysCommons }
+ projekt elvysCommons používá pouze knihovny pro
+ \subsection{JAR knihovny aplikace webServer2}
+ \begin{description}
+ \item[DB]
+ \begin{itemize}
+ \item \textbf{c3pO}
+ \end{itemize}
+ \item[]
+
+ \end{description}
+ \subsection{JAR knihovny aplikace dispatcher}
+
+
+ \subsection{JAR knihovny aplikace LayoutDesigner}
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% packages
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Napsat něco o rozdělení do balíčků (ang. packages)}
+ \subsection{Rozdělení do modulů, sdílená aplikační logika}
+ - na to taky navazuje připravenost na napsání dalšího modulu- pro
WS-API, přesunout k sobě. Odkaz na sekci, kde je popsáno, jak tu aplikacni
logiku mame vlastne oddelenou...\\
+ Build je prováděn pomocí ANT-skriptů, které jsou popsány v
\ref{build_ant}\\
+
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%
%% GUI
%%%%%%%%%%%%%%%%%%%%%%%%%%
- \subsection{GUI- JSF, Richfaces,..}
- \subsubsection{lokalizace}
+\section{GUI- JSF, Richfaces,..}
+ \subsection{lokalizace}
\paragraph{lokalizace labelu}
\paragraph{lokalizace chybových hlášek}
\subsection{vlastní zobrazovací komponenty}
@@ -85,7 +159,7 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Plánování
%%%%%%%%%%%%%%%%%%%%%%%%%%
- \subsection{Plánování obsahu kiosku}
+\section{Plánování obsahu kiosku}
tady popisu planovaci komponentu. zminim casti, ktere jsou zavisle na
typu planovani (ikdyz to sem zdanlive nepatri, ulehcim ctenari vyznani se v
plugovatelnosti typu)
zavisle casti jsou:\\
@@ -102,10 +176,6 @@
\end{itemize}
-
-
-
-
%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Plugovatelnost typů
%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -244,12 +314,8 @@
\end{itemize}
-
- \subsection{}
-
-
@@ -262,107 +328,20 @@
- \subsection{Použití JH supa-dupa toolu na měření textu}
-
- \subsection{Rozhraní přes WebServices}
- K systému v současné době není možno přistupovat přes webservices,
ale... mame oddělenou BL od prezentacni vrstvy, takže je to ready..
-
- \subsection{Dispatcher}
+ \subsection{Použití JH supa-dupa toolu na měření textu}
-
- \subsection{Applet}
-
-\textbf{Komunikace mezi webovým serverem a appletem}
-\\
-\\
-LayoutDesigner lze spustit pro
-\begin{itemize}
- \item \textbf{vytvoření nového rozvržení} - pro vytvoření nového rozvržení má
applet následující vstupní parametry
- \begin{itemize}
- \item \textbf{companyID} identifikátor společnosti
- \item \textbf{userID} identifikátor uživatelele, který s LayoutDesignerem
pracuje
- \end{itemize}
-
- \item \textbf{editaci již dříve vyvořeného rozvržení} - oproti předchozímu má
navíc parametr
- \begin{itemize}
- \item \textbf{layoutID} identifikátor rozvržení obrazovky
- \end{itemize}
-\end{itemize}
-Vstupní parametr layoutID rozhoduje o způsobu spuštění appletu.
-
-
-\paragraph{}
-Dále LayoutDesigner získává od serveru následující informace pomocí zasílání
HTTP POST požadavků
-\begin{itemize}
-\item \textbf{typy dokumentů povolené pro danou společnost}
-Applet zašle identifikátor společnosti a od serveru dostane seznam typů
dokumentů povolené pro tuto společnost. Každý typ bude v odpovědi uveden na
samostatném řádku.
-\item \textbf{podporované rozlišení obrazovek kiosků pro danou společnost}
-Applet zašle identifikátor společnosti a od server mu vrátí seznam
podporovaných rozlišení v následujícím formátu:
-poměr a seznam rozlišení v tomto poměru oddělené mezerou, jednotlivé poměry
jsou na samostaném řádku
-
- např. \verb#1,77 1920x1080 1200x675#
-\end{itemize}
-
-Ukládání rozvržení na server i načítání rozvržení pro editaci probíhá také
pomocí HTTP POST požadavků.
-\begin{itemize}
-\item \textbf{uložení rozvržení na server}
-LayoutDesigner zašle serveru identifikátor společnosti a uživatele a ukládaný
layout ve formátu xml řetězce.
-Jako odpověď dostane identifikátor, pod kterým bude rozvržení uloženo.
-Nově vytvořené rozvržení v xml identifikátor neobsahují a server jim v
odpovědi určí.
-Editovaným rozvržením se zvýší jejich revize. Pokud došlo při editování ke
změně počtu pozic, mohlo by dojít k narušení plánování, je tedy toto rozvžení
uloženo pod jiným identifikátorem.
-
-
-\item \textbf{načítání rozvržení pro editaci}
-Applet zašle identifikátor rozvržení obrazovky a identifikátor společnosti.
Jako odpověď dostane xml odpovídající požadovanému rozvržení, které je dále
parsováno a zobrazeno v LayoutDesigeru.
-\end{itemize}
-
-Applet neumožňuje listování seznamem rozvržení, pouze editaci rozvržení
vybraného na webovém serveru.
-
-
-
-
-\textbf{Zamykání rozvržení}
-\\
-
-Při editování dřívě vytvoření rozvržení je nutné, aby rozvržení editoval pouze
jeden uživatel, jinak by mohlo docházet ke konfliktům.
-To je zajištěno pomocí zamykání editovaných rozvržení. Zamykání je realizováno
pomocí HTTP POST požadavků. LayoutDesigner zašle serveru identifikátor
společnosti, uživatele a rozvržení a typ požadavku - zda chce rozvržení
zamknout, odemknout nebo zjisti, zda je zamčeno tímto uživatelem.
-Pokud je rozvržení načteno ze serveru, uzamkne se a ostaní uživatelé ho
nemohou editovat. Při ukládání se LayoutDesigner ujistí, zda má uživatel
rozvržení stále zamknuté, až poté ho uloží na server. Po zavření se rozvržení
odemkne a mohou ho začít editovat ostatní uživatelé.
-
-
-\textbf{Datové struktury}
-\\
-
-Hlavní datová struktura \textbf{Position} reprezentuje jednotlivé rozvrhované
pozice a má následující položky
-\begin{itemize}
- \item \textbf{id} - jednoznačný identifikátor pozice
- \item \textbf{monitor} - absolutní souřadnice\footnote[1]{topX - x-ová
souřadnice horního levého rohu pozice, topY - y-ová souřadnice horního levého
rohu pozice} a parametry\footnote[2]{výška a šířka pozice} pozice na obrazovce,
na které je LayoutDesigner spuštěný
- \item \textbf{elvys} - absolutní souřadnice\footnotemark[1] a
parametry\footnotemark[2] pozice na obrazovce kiosku, kde bude rozvržení
skutečně použito
- \item \textbf{isSelected} - příznak, jestli je pozice aktuálně vybraná
- \item \textbf{isSnappedToGrid} - příznak, jestli je pozice zarovnaná k mřížce
- \item \textbf{permittedDocumentTypes} - seznam typů dokumentů povolených
zobrazovat na této pozici
-\end{itemize}
-
- \subsection{Datový model}
- nějakým způsobem popsat datový model a nekam ten datový model umistit
(mozna vytisknout na A3, slozit a vlozit jako prilohu??)
-
\subsubsection{Deployment, závislosti}
spis tady popsat jenom zavislosti a udelat dalsi "vetsi" include -
deployment
- \subsection{Seznam knihoven}
- \subsubsection{webServer2}
- \subsubsection{dispatcher}
- \subsubsection{applet}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% spatne zkusenosti
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Špatné zkušenosti z vývoje}
+ \subsubsection{varchar foreign key}
-
-
- \subsection{Špatné zkušenosti z vývoje}
- \subsubsection{varchar foreign key}
-
-
-
-
Modified: others/dokumentace/technicalGuide/architecture/5layoutdesigner.tex
===================================================================
--- others/dokumentace/technicalGuide/architecture/5layoutdesigner.tex
2010-02-08 19:46:36 UTC (rev 1684)
+++ others/dokumentace/technicalGuide/architecture/5layoutdesigner.tex
2010-02-09 09:30:41 UTC (rev 1685)
@@ -1,4 +1,14 @@
-\chapter{LayoutDesigner java applet}
+\chapter{LayoutDesigner java applet}\ref{LD}
-čě+čěřčšžřýýžáýž98ýžýř
+\textbf{Datové struktury}
+\\
+Hlavní datová struktura \textbf{Position} reprezentuje jednotlivé rozvrhované
pozice a má následující položky
+\begin{itemize}
+ \item \textbf{id} - jednoznačný identifikátor pozice
+ \item \textbf{monitor} - absolutní souřadnice\footnote[1]{topX - x-ová
souřadnice horního levého rohu pozice, topY - y-ová souřadnice horního levého
rohu pozice} a parametry\footnote[2]{výška a šířka pozice} pozice na obrazovce,
na které je LayoutDesigner spuštěný
+ \item \textbf{elvys} - absolutní souřadnice\footnotemark[1] a
parametry\footnotemark[2] pozice na obrazovce kiosku, kde bude rozvržení
skutečně použito
+ \item \textbf{isSelected} - příznak, jestli je pozice aktuálně vybraná
+ \item \textbf{isSnappedToGrid} - příznak, jestli je pozice zarovnaná k mřížce
+ \item \textbf{permittedDocumentTypes} - seznam typů dokumentů povolených
zobrazovat na této pozici
+\end{itemize}
Modified: others/dokumentace/technicalGuide/architecture/7communication.tex
===================================================================
--- others/dokumentace/technicalGuide/architecture/7communication.tex
2010-02-08 19:46:36 UTC (rev 1684)
+++ others/dokumentace/technicalGuide/architecture/7communication.tex
2010-02-09 09:30:41 UTC (rev 1685)
@@ -1,8 +1,114 @@
\chapter{Popis rozhraní}
-\section{Rozhraní mezi webovou aplikací a kiosky}
-\section{Rozhraní mezi webovou aplikací a LayoutDesignerem}
-\section{Rozhraní mezi webovou aplikací a pomocnými aplikacemi}
+Tato kapitola obsahuje popis všech rozhraní nacházejících se v systému ELVYS.
+Každé z následujících rozhraní bude popsáno ve vlastní sekci v rámci této
kapitoly.
+\begin{description}
+ \item[Kapitola \ref{interface_web_and_kiosk} Rozhraní mezi webovou aplikací
a kiosky (str. \pageref{interface_web_and_kiosk})]
+ popisuje komunikaci mezi kiosky a webovým serverem.
+ \item[Kapitola \ref{interface_web_and_LD} Rozhraní mezi webovou aplikací a
LayoutDesignerem (str. \pageref{interface_web_and_LD})]
+ popisuje, jak je realizována komunikace mezi webovou aplikací a java
appletem LayoutDesignerem.
+ \item[Kapitola \ref{interface_web_and_apps} Rozhraní mezi webovou aplikací a
pomocnými aplikacemi (str. \pageref{interface_web_and_apps})]
+ popisuje rozhraní pomocných aplikací
+ \item[Kapitola \ref{interface_web} Rozhraní pro ovládání webové aplikace
webServer2 (str. \pageref{interface_web})]
+ \item[Kapitola \ref{interface_kiosk} Rozhraní pro práci s informačními
kiosky (str. \pageref{interface_kiosk})]
+\end{description}
+
+\section{Technologie použité pro komunikaci přes síť}
+ \subsection{Komunikační protokol a způsob komunikace}
+ Při návrhu komunikace mezi kiosky a webovou aplikací stáli autoři před
rozhodnutím,
+ jaký komunikační middleware či protokol použít. Zvažovali několik aspektů
komunikace:
+ \begin{itemize}
+ \item{Jednoduchý scénář komunikace}
+ \item{Server Java, klient c++} Vzhledem k tomu, že server je napsán v
jiném programovacím jazyce, než
+ klient, musí být komunikace platformě nezávislá.
+ \item{messaging}
+ \item{Web Services}
+ \footnote{http://www.w3.org/2002/ws/}
+ \end{itemize}
+ Z důvodu jednoduchého schématu
+ Kandidátem číslo jedna měly být Web Services. WebServices jsou ale pro
tento styl komunikace
+ \subsection{XML, XSD, HTTP, JAXB}
+ Tělo většiny zpráv posílaných přes internet je tvořeno XML dokumentem
nesoucím určitá data.
+ Všechny komplexnější XML\footnote{Extensible Markup Language (XML),
http://www.w3.org/XML/} dokumenty (např. jakýkoliv XXXConfig přenášený ze
serveru na kiosek) mají
+ definován formát pomocí jazyka XML Schema\footnote{XML Schema language,
http://www.w3.org/XML/Schema}
+
+\section{Rozhraní mezi webovou aplikací a
kiosky}\label{interface_web_and_kiosk}
+ \subsection{Posílání XML dat přes HTTP}
+
+ \subsection{VPN}
+ Serverová část i kiosky jsou propojeny pomocí VPN\footnote{virtual private
network (VPN), http://www.vpnc.org/}
+ a tudíž spolu komunikují pře
+
+ Více informací o použití VPN v řešení ELVYS je možno nalézt v
\textit{kapitole \ref{deployment_VPN} (\pageref{deployment_VPN})}
+
+
+\section{Rozhraní mezi webovou aplikací a
LayoutDesignerem}\label{interface_web_and_LD}
+ \textbf{Komunikace mezi webovým serverem a appletem}
+ \\
+ \\
+ LayoutDesigner lze spustit pro
+ \begin{itemize}
+ \item \textbf{vytvoření nového rozvržení} - pro vytvoření nového
rozvržení má applet následující vstupní parametry
+ \begin{itemize}
+ \item \textbf{companyID} identifikátor společnosti
+ \item \textbf{userID} identifikátor uživatelele, který s
LayoutDesignerem pracuje
+ \end{itemize}
+
+ \item \textbf{editaci již dříve vyvořeného rozvržení} - oproti
předchozímu má navíc parametr
+ \begin{itemize}
+ \item \textbf{layoutID} identifikátor rozvržení obrazovky
+ \end{itemize}
+
+ \end{itemize}
+ Vstupní parametr layoutID rozhoduje o způsobu spuštění appletu.
+
+
+ \paragraph{}
+ Dále LayoutDesigner získává od serveru následující informace pomocí
zasílání HTTP POST požadavků
+ \begin{itemize}
+ \item \textbf{typy dokumentů povolené pro danou společnost}
+ Applet zašle identifikátor společnosti a od serveru dostane seznam typů
dokumentů povolené pro tuto společnost. Každý typ bude v odpovědi uveden na
samostatném řádku.
+ \item \textbf{podporované rozlišení obrazovek kiosků pro danou společnost}
+ Applet zašle identifikátor společnosti a od server mu vrátí seznam
podporovaných rozlišení v následujícím formátu:
+ poměr a seznam rozlišení v tomto poměru oddělené mezerou, jednotlivé
poměry jsou na samostaném řádku
+
+ např. \verb#1,77 1920x1080 1200x675#
+ \end{itemize}
+
+ Ukládání rozvržení na server i načítání rozvržení pro editaci probíhá také
pomocí HTTP POST požadavků.
+ \begin{itemize}
+ \item \textbf{uložení rozvržení na server}
+ LayoutDesigner zašle serveru identifikátor společnosti a uživatele a
ukládaný layout ve formátu xml řetězce.
+ Jako odpověď dostane identifikátor, pod kterým bude rozvržení uloženo.
+ Nově vytvořené rozvržení v xml identifikátor neobsahují a server jim v
odpovědi určí.
+ Editovaným rozvržením se zvýší jejich revize. Pokud došlo při editování ke
změně počtu pozic, mohlo by dojít k narušení již existujícího plánování, je
tedy toto rozvžení uloženo pod jiným identifikátorem.
+
+
+ \item \textbf{načítání rozvržení pro editaci}
+ Applet zašle identifikátor rozvržení obrazovky a identifikátor
společnosti. Jako odpověď dostane xml odpovídající požadovanému rozvržení,
které je dále parsováno a zobrazeno v LayoutDesigeru.
+ \end{itemize}
+
+ Applet neumožňuje listování seznamem rozvržení, pouze editaci rozvržení
vybraného na webovém serveru.
+
+
+
+
+ \textbf{Zamykání rozvržení}
+ \\
+
+ Při editování dřívě vytvoření rozvržení je nutné, aby rozvržení editoval
pouze jeden uživatel, jinak by mohlo docházet ke konfliktům.
+ To je zajištěno pomocí zamykání editovaných rozvržení. Zamykání je
realizováno pomocí HTTP POST požadavků. LayoutDesigner zašle serveru
identifikátor společnosti, uživatele a rozvržení a typ požadavku - zda chce
rozvržení zamknout, odemknout nebo zjisti, zda je zamčeno tímto uživatelem.
+ Pokud je rozvržení načteno ze serveru, uzamkne se a ostaní uživatelé ho
nemohou editovat. Při ukládání se LayoutDesigner ujistí, zda má uživatel
rozvržení stále zamknuté, až poté ho uloží na server. Po zavření se rozvržení
odemkne a mohou ho začít editovat ostatní uživatelé.
+
+
+
+
+\section{Rozhraní mezi webovou aplikací a pomocnými
aplikacemi}\label{interface_web_and_apps}
\subsection{pageCounter}
\subsection{textMeter}
\subsection{videoMeter}
-
\ No newline at end of file
+\section{Rozhraní pro ovládání webové aplikace webServer2}\label{interface_web}
+\section{Rozhraní pro práci s informačními kiosky}\label{interface_kiosk}
+\section{budoucnost: WS-API}\label{interface_kiosk}
+\subsection{Rozhraní přes WebServices}
+K systému v současné době není možno přistupovat přes webservices, ale... mame
oddělenou BL od prezentacni vrstvy, takže je to ready..
+ Vzhledem k tomu, že business logika je uložena v
\ No newline at end of file
Modified: others/dokumentace/technicalGuide/architecture/8deployment.tex
===================================================================
--- others/dokumentace/technicalGuide/architecture/8deployment.tex
2010-02-08 19:46:36 UTC (rev 1684)
+++ others/dokumentace/technicalGuide/architecture/8deployment.tex
2010-02-09 09:30:41 UTC (rev 1685)
@@ -2,12 +2,21 @@
\chapter{Konfigurace, nasazení řešení a závislosti}
Celé řešení Elvys sestává ze serverové části(rozdělená na více modulů) a
klientské části.
-Popsat tady jak se to cele nasazuje
-\section{Webový server - aplikace }
+Popsat tady jak se toele nasazuje c
+
+\begin{figure}
+ \label{deployment_img}
+ \begin{center}
+ \includegraphics[width=0.95\textwidth]{imgs/Deployment.png}
+ \end{center}
+ \caption{Schéma nasazení řešení ELVYS}
+\end{figure}
+
+\section{Webový server - aplikace}
\subsection{Sestavení řešení (build) a závislosti při sestavování}
Sestavení řešení se provádí pomocí vytvořených ANT skriptů umístěných v
projektech webServer2, resp. dispatcher.
Oba tyto moduly využívají sdílený kód a zdroje umístěné v projektu
elvysCommons a modul webServer2 je navíc závislý na projektu LayoutDesigner.
- \\ TADY PRIJDE OBRAZEK zavislosti - mam ho v EA, vykopirovat ho
+ \\ TADY PRIJDE OBRAZEK zavislosti
\subsubsection{Rozbor procesu sestavování webServer2/dispatcher}
\begin{itemize}
\item volání závislostí\\
@@ -33,12 +42,18 @@
- logovani
- build(nasazeni asi ne) pomoci ANTU, nasazeni ruco
- \section{Webový server - systémové nastavení }
- Apache
- \subsection{JirkaH competency}
- - certifikáty
- - stahování souboru bude snad tou dobou uz v me kompetenci, tak to ne
- - nastaveni aplikaci pro monitoring
+ \section{Webový server - ostatní}
+
+ \subsection{VPN}\label{deployment_VPN}
+ \subsubsection{OpenVPN}
+ \subsubsection{Certifikáty}
+
+
+ \subsection{Apache}
+ \subsubsection{stahovani souboru}
+
+
+ \subsection{nastaveni aplikaci pro monitoring}
\section{Kiosky}
Added: others/dokumentace/technicalGuide/architecture/9z10appendix.tex
===================================================================
--- others/dokumentace/technicalGuide/architecture/9z10appendix.tex
(rev 0)
+++ others/dokumentace/technicalGuide/architecture/9z10appendix.tex
2010-02-09 09:30:41 UTC (rev 1685)
@@ -0,0 +1,6 @@
+\appendix
+
+\chapter{Databázový model}\label{appendix_DB_model}
+ \begin{center}
+ \includegraphics[width=1\textwidth]{imgs/dbschema.png}
+ \end{center}
Other related posts:
- » [elvystrac] r1685 - documentation upgraded - elvys
