Rešerše, Analýza, Nasazení, ...

.github/workflows/build.yaml

@@ -13,20 +13,27 @@ jobs:
 
       - name: Set up Enviroment
         run: |
-          sudo apt install texlive texlive-xetex texlive-extra-utils texlive-lang-czechslovak
+          sudo apt install texlive texlive-xetex texlive-extra-utils texlive-lang-czechslovak texlive-bibtex-extra
+          sudo apt install biber
           sudo apt install python-pygments
 
-      - name: Run Arara
-        run: arara main
+      - name: Run Arara -- Thesis
+        run: arara thesis
 
       - name: Rename PDF
-        run: mv main.pdf BP_Bittner_Jan.pdf
+        run: mv thesis.pdf BP_Bittner_Jan.pdf
+
+      - name: Run Arara -- Slides
+        run: arara slides
+
+      - name: Run Arara -- Cover
+        run: arara cover
 
       - name: Upload Data as Artifact
         uses: actions/upload-artifact@master
         with:
           name: bp-pdf
-          path: BP_Bittner_Jan.pdf
+          path: ./*.pdf
 
       - name: Cat Log
         if: failure()

.gitignore

@@ -1,4 +1,6 @@
-main.pdf
+thesis.pdf
+slides.pdf
+cover.pdf
 
 ## Core latex/pdflatex auxiliary files:
 *.aux

README.md

@@ -44,6 +44,8 @@ texlive
 texlive-xetex
 texlive-extra-utils
 texlive-lang-czechslovak
+texlive-bibtex-extra
+biber
 python-pygments
 ```
 
@@ -93,6 +95,8 @@ texlive
 texlive-xetex
 texlive-extra-utils
 texlive-lang-czechslovak
+texlive-bibtex-extra
+biber
 python-pygments
 ```
 

chapters/_all.tex

@@ -1,6 +1,8 @@
-\input{chapters/competitive-apps.tex}
-\input{chapters/analysis.tex}
-\input{chapters/design.tex}
-\input{chapters/implementation.tex}
-\input{chapters/testing.tex}
-\input{chapters/deployment.tex}
+\include{chapters/goals}
+\include{chapters/competitive-apps}
+\include{chapters/technology-research}
+\include{chapters/analysis}
+\include{chapters/design}
+\include{chapters/implementation}
+\include{chapters/testing}
+\include{chapters/deployment}

chapters/analysis.tex

@@ -1,8 +1,13 @@
 \chapter{Analýza}
+\label{chap:analysis}
 
-TODO text
+Tato kapitola se věnuje analýze praktické části práce,
+mobilní hře.
+V~nadcházejících podkapitolách je popsán princip hry,
+její funkční a~nefunkční požadavky
+i~jednotlivé případy užití.
 
-\input{chapters/analysis/framework.tex}
-\input{chapters/analysis/state-management.tex}
-\input{chapters/analysis/database.tex}
-\input{chapters/analysis/testing.tex}
+\input{chapters/analysis/game.tex}
+\input{chapters/analysis/functional-requirements.tex}
+\input{chapters/analysis/non-functional-requirements.tex}
+\input{chapters/analysis/use-cases.tex}

chapters/analysis/functional-requirements.tex

@@ -0,0 +1,38 @@
+\section{Funkční požadavky}
+
+Funkční požadavky popisují jednotlivé požadavky na funkcionalitu aplikace.
+Z~pohledu uživatelů aplikace popisují akce,
+které může uživatel provést.
+Jednotlivé funkční požadavky,
+či jejich uskupení,
+mohou tvořit jednotlivé nezávislé moduly aplikace.~\cite{fr_nfr}
+
+\begin{enumerate}[label=\textbf{F\arabic*}, ref=F\arabic*]
+    \myItem{Přihlášení}
+Uživatel se bude moci do aplikace přihlásit, resp. registrovat,
+pomocí účtu Google.
+    \myItem{Informace o~aplikaci}
+Aplikace obsahuje obrazovku s~informacemi o~aplikaci,
+včetně jména autora, verze, popisu a~odkazu na projekt.
+    \myItem{Vytvoření hry}
+Přihlášený uživatel může vytvořit hru.
+Současně hráč nastaví misi ke hraní.
+    \myItem{Připojení do hry}
+Přihlášený uživatel se může připojit do hry pomocí kódu.
+    \myItem{Spuštění hry}
+Po potvrzení, že jsou hráči připraveni na hru,
+mohou spustit hru s~danou misí.
+    \myItem{Ukončení hry}
+Hráč může během přípravy hry nebo hraní hry danou hru ukončit.
+    \myItem{Statistika po hře}
+Hráčům je po skončení hry zobrazena herní statistika.
+    \myItem{Zobrazení svého profilu}
+Přihlášený uživatel si může zobrazit svůj profil.
+    \myItem{Zobrazení svých statistik}
+Přihlášený uživatel si může zobrazit své souhrnné statistiky
+ze všech hraných misí.
+    \myItem{Změna nastavení}\label{req:settings}
+Přihlášený uživatel si může změnit nastavení.
+    \myItem{Odhlášení}\label{req:logout}
+Přihlášený uživatel se bude moci z~aplikace odhlásit.
+\end{enumerate}

chapters/analysis/game.tex

@@ -0,0 +1,61 @@
+\section{Popis hry}
+
+Mobilní hra je laděna satiricky do prostředí jaderné elektrárny,
+kterou musí uživatelé,
+hráči hry v~rozdílných rolích,
+zachránit od zničení.
+Hra se nazývá \emph{\myAppName}
+a~její děj se odehrává v~neznámé jaderné elektrárně.
+V~této elektrárně má většina pracovníků dovolenou,
+a~proto jsou přítomni jen dva lidé,
+technik a~manažer.
+Náhlý problém zapříčiní,
+že mezi těmito pracovníky byla zablokována cesta,
+a~tak se tito dva zaměstnanci musí domluvit pouze hlasem
+a~zařídit opravu elektrárny.
+Technik vidí všechny řídící prvky,
+manažer vidí plány a~manuály.
+Jejich cílem je tak společnou spoluprací zabránit neštěstí v~podobě exploze. 
+
+Hra je členěna do několika kapitol
+a~každá kapitola obsahuje několik statických misí.
+Mise jsou statické v~tom významu,
+že mají jasně přednastaveny prvky,
+které moduly obsahuje,
+avšak mění se jejich konkrétní nastavení.
+To zajištuje jak možnost znovuopakování,
+tak poměřování s~ostatními hráči.
+
+Každá mise,
+a~tedy konkrétní hra samotná,
+obsahuje několik modulů,
+které reprezentují určité řídící prvky elektrárny.
+To mohou být nejrůznější tlačítka či přepínače,
+ale i~speciální moduly,
+reprezentující prvky elektrárny,
+které nelze vypnout či opravit a~musí být periodicky kontrolovány,
+jako pumpa dodávající chladící vodu do reaktoru.
+Kromě modulů je potřeba ve hře okamžitě provádět akce,
+které se zobrazí.
+Akce jsou většinou jednorázové,
+kdy stačí provést danou akci.
+
+Konkrétní mise začíná po tom,
+co jsou oba pracovníci připraveni
+a~je stisknuto tlačítko \emph{AZ-5},
+které by mělo zajistit rychlé odstavení reaktoru,
+avšak z~neznámého důvodu nefunguje.
+Po skončení každé mise,
+případně souhrnně za všechny odehrané hry,
+jsou zobrazeny statistiky hry.
+Statistiky po ukončení hry zobrazí uplynulý čas,
+potřebný k~opravě.
+Souhrnné statistiky zobrazují
+celkový počet odehraných her a~poměr úspěšně splněných her.
+
+Akce jsou přerušením,
+které musí hráči okamžitě vykonat.
+Příkladem akce může být \emph{zatřeste zařízením}.
+Význam jednotlivých akcí je zjevný z~jeho názvu.
+Akce jsou využívány zejména v~pokročilejších kapitolách,
+jelikož mohou značně komplikovat hru.

chapters/analysis/non-functional-requirements.tex

@@ -0,0 +1,24 @@
+\section{Nefunkční požadavky}
+
+Nefunkční požadavky nepopisují konkrétní chování systému,
+ale spíše jeho vlastnosti a~omezení.
+Tyto vlastnosti a~omezení také přímo souvisí s~očekáváními,
+které mají uživatelé na aplikaci,
+ať už se jedná o~snadné použití funkcí,
+rychlost a~plynulost jednotlivých kroků,
+nebo například bezpečnost.~\cite{fr_nfr}
+
+\begin{enumerate}[label=\textbf{N\arabic*}, ref=N\arabic*]
+    \myItem{Multiplatformnost}
+Aplikaci lze po nasazení spustit v~současných verzích Android a~iOS.
+    \myItem{Udržitelnost a~rozšiřitelnost}
+Kód aplikace je psán přehledně,
+s~vhodnou architekturou a~vhodnými konvencemi tak,
+že je lehce udržitelný a~rozšiřitelný.
+    \myItem{Plynulost}
+Aplikace funguje na všech obrazovkých plynule
+i~na výkonnostně slabších zařízeních.
+    \myItem{Vícejazyčnost}
+Aplikace podporuje český jazyk
+a~je připravena na rozšíření o~další jazyky.
+\end{enumerate}