Projektová vize¶

Zadání¶

Czech-American TV je nekomerční americká televizní společnost, která vysílá své pořady na kabelové televizi v USA již 16 let.
Hlavním posláním Czech-American TV je rozšiřovat povědomí o České republice, ukázat a zviditelnit české regiony a destinace, a přiblížit české kulturní dědictví. Toto veřejné vysílání má formu pravidelných vzdělávacích pořadů, vysílaných pouze v anglickém jazyce. Celý program televize přispívá k vnímání České republiky a jejích regionů jako velmi zajímavé a bezpečné turistické destinace.
Genealogy je WordPress plugin (https://www.catvusa.com/genealogy, www.catvusa.com/tutorial), který je nutný doplnit o další rozšíření. Tato nová funkčnost by měla obsahovat historickou mapu, s různými mapovými podklady, mezi kterými lze snadno překlikávat (např. základní, letecká, turistická, ale i z různých časových období – Rakousko-Uhersko, První republika, Protektorát Čechy a Morava, Československo v období totality atp.). Dále je třeba k pluginu přidat prostředí pro administrace, kde bude možné mapové podklady spravovat, a to včetně importu dat v různých formátech.

Cíle projektu¶

Cílem je doplnění existujícího pluginu Genealogy o další funkcionalitu spojenou s historickými mapy. Také je nutný vytvořit GUI prostředí pro snadné importování dat do databáze.

Popis stakeholder¶

Zadavatel: John Honner, ředitel a zakladatel Czech-American TV.
Vývojový tým: Bc. Mukanova Zhanel, Bc. Tomáš Květoň, Bc. Jan Pizúr, Bc. Miroslav Krýsl
Mentor týmu a vedoucí předmětu: doc. Ing. Přemysl Brada Msc., Ph.D.

Požadavky na aplikaci¶

Výsledná aplikace musí splňovat:

• Bezproblémová instalace a aktivace pluginu na Wordressu
• Mít přehledné grafické uživatelské rozhraní (GUI) aplikace
• Vizualizace historických map
• Dobře čitelný a zdokumentovaný zdrojový kód

Produkční prostředí¶

• Celý projekt bude implementovaný ve dvou jazycích: JavaScript a PHP. Budou dodržované konvence psaní kódu v těchto jazycích, pro snadné použiti kódu dalšími programátory. Plugin Genealogy bude nasazen na testový webový server Czech-American TV.
• Implementace projektu bude probíhat na lokálním serveru Wamp, kde bude nainstalovány nástroj Wordpress a rozběhnutý plugin Genealogy.
• Projekt bude verzován programem git a uložen na uložišti GitHub na adrese https://github.com/catvusa/genealogy.
• Za vývojové prostředí jsme si zvolili program PhpStorm s využitím nástroje XDebug pro snadné debuggování webové aplikaci.

Funkční požadavky¶

• Vytvořit historickou mapu s různými mapovými podklady pomoci Google Maps
• Vytvořit prostředí pro snadné přidaní dat do databáze
• Upravit mapu „Genealogy map“, aby zobrazovala správná data

Mimofunkční požadavky¶

• Vytvoření uživatelské a developerské dokumentace
• Refaktorizace a dokumentace kódu
• Předání produktu proběhne na schůzi se zadavatelem - tým předá veškeré projektové dokumenty a výsledná aplikace se spustí na testovacím serveru.

Plán projektu¶

Popis a plánování samotných iteraci je rozepsaný na Wiki stránkách projektu: https://students.kiv.zcu.cz:3443/projects/aswi2021ioi/wiki
Hrubý plán projektu je následující:

• [HIGH] Naimplementovat historickou mapu pomoci Google Maps
• [HIGH] Vytvořit prostředí pro snadné přidaní dat do databáze
• [NORMAL] Vytvoření uživatelské a developerské dokumentace
• [NORMAL] Refaktorizace a dokumentace kódu
• [LOW] Upravit mapu „Genealogy map“ aby zobrazovala správná data
• [LOW] Upravit chyby s výpisem
• [LOW] Všude kde je možný udělat překlady cz-en a en-cz

Priority: [LOW] [NORMAL] [HIGH]

Popis rizik¶

Nezkušenost s technologií¶

• Nikdo z našeho tymu dřív nepracoval s nástrojem Wordpress a zkušenosti s jazyky JavaScript a PHP máme na úrovně předmětu KIV/WEB.
  • Návrh odstranění rizika: Každý z nás zkusí samostatně nahodit a spustit projekt, který jsme získali od zákazníka. Také je nutné, aby každý účastník projektu si prohlédnul kód s využitím nástroje XDebug pro pochopení funkčnosti pluginu. Možné problémy se musí řešit celým tymem.

Získaní dat pro implementaci historických map.¶

• Zákazník přeje mít stránku s Google maps, kde bude možný proklikávat různé časové období a prohlížet historické hranice států. Problém je v tom, že těžko získáme souřadnice historických hranic.
  • Návrh odstranění rizika: zkusíme najít historické mapy v podobě obrázků a ručně budeme vykreslovat polygony do Google maps.