Pokyny k projektu

Hodnocení a prezentace projektů
- body za projekt budou přiděleny na základě splnění základních požadavků (projekt jde přeložit a spustit, obsahuje požadované náležitosti apod.) a prezentace
- prezentaci projektu budou přítomni všichni členové týmu, výjimečně lze pověřit jen vybrané členy (např. kolize se zkouškou)
- tým si vybere v IS vhodný termín (viz varianty termínu Prezentace projektu) a vedoucí týmu se na tento termín zaregistruje
- prezentace budou probíhat v místnosti A218, bude připraven notebook s pracovní kopií vašeho repozitáře
- připravte si základní demonstraci vašeho projektu na 5 minut:
  1. přihlášení uživatele na server
  2. vytvoření nové sítě, její editace (pár míst a jeden přechod) a uložení na server
  3. vytvoření nového uživatele a jeho přihlášení na server
  4. výběr, zobrazení a editace dvou sítí
  5. výběr sítě a spuštění její simulace
  6. výběr sítě a krokování simulace
- další demonstrace podle aktuální situace
- body za prezentaci budou přiděleny ihned
- body za splnění základních požadavků včetně komentáře budou k dispozici nejpozději den před prezentací v adresáři hodnoceni na svn
- poznámka: pokud je to možné, přineste s sebou notebook s připraveným (!) projektem, kdyby došlo ke komplikacím během předvádění projektu

Podmínky vypracování projektu
- Pro realizaci projektu použijte Java SE 6
- Pro grafické uživatelské rozhraní použijte JFC/Swing.
- Pro překlad a spuštění projektu bude použita aplikaci ant.
- Projekt bude tvořen následující kořenovou adresářovou strukturou (bude odpovídat také struktuře adresáře projekt v svn):
```
src/          - (adres.) zdrojové soubory (hierarchie balíků)
examples/     - (adres.) připravené datové soubory
build/        - (adres.) přeložené class soubory
doc/          - (adres.) vygenerovaná programová dokumentace
dest-client/  - (adres.) umístění výsledného jar archivu (+ dalších potřebných) po kompilaci pro klientskou aplikaci, tento adresář bude představovat adresář spustitelné aplikace
dest-server/  - (adres.) umístění výsledného jar archivu (+ dalších potřebných) po kompilaci pro serverovou aplikaci, tento adresář bude představovat adresář spustitelné aplikace
lib/          - (adres.) externí soubory a knihovny (balíky třetích stran, obrázky apod.), které vaše aplikace využívá
readme.txt    - (soubor) základní popis projektu (název, členové týmu, ...)
rozdeleni.txt - (soubor) soubor obsahuje rozdělení bodů mezi členy týmu (pokud tento soubor neexistuje, předpokládá se rovnoměrné rozdělení, viz hodnocení projektu)
build.xml     - (soubor) build file pro aplikaci ant
```
- Všechny zdrojové soubory musí obsahovat na začátku dokumentační komentář se jmény autorů a popisem obsahu.
- Součástí projektu bude programová dokumentace. Dokumentace se vygeneruje při překladu aplikace a bude uložena v adresáři doc.
- Pokud vaše řešení vyžaduje další externí soubory (jiné balíky apod.), umístěte je do adresáře lib.
- Přeložení aplikace:
  - v kořenovém adresáři se provede příkazem ant compile
  - zkompilují se zdrojové texty, class soubory budou umístěny v adresáři build
  - vytvoří se programová dokumentace a uloží se do adresáře doc
  - vytvoří se dva jar archivy s názvy ija2012-client.jar (v adresáři dest-client) a ija2012-server.jar (v adresáři dest-server) a do těchto adresářů se vytvoří/nakopírují další potřebné soubory a archivy
- Spuštění klientské aplikace:
  - spouštět se bude vytvořený archiv jar
  - v kořenovém adresáři se provede příkazem ant client
- Spuštění serverové aplikace:
  - spouštět se bude vytvořený archiv jar
  - v kořenovém adresáři se provede příkazem ant server
Podmínky odevzdání projektu
- Jako základní zdroj pro hodnocení bude využit aktuální obsah (nejvyšší revize) vašeho repozitáře v svn.
  - Pro obsah adresářů platí:
    - Adresáře build, doc, dest-client a dest-server budou prázdné.
    - V adresáři examples budou ukázkové datové soubory (pokud je zadání vyžaduje).
    - V adresáři lib budou umístěny externí knihovny a soubory (pokud je vaše řešení vyžaduje).
- Obsah kořenového adresáře také zabalte do archivu zip
  - Název archivu bude xlogin_vedouciho.zip (po rozbalení archivu vznikne adresářová struktura definovaná výše).
  - Archiv xlogin_vedouciho.zip odevzdá pouze vedoucí týmu do informačního systému, termín Projekt.
  - Pro obsah adresářů platí totéž jako u repozitáře s jednou výjimkou:
    - při vytváření archivu pro uložení do informačního systému ponechte adresář lib prázdný - pokud vaše řešení externí knihovny či soubory vyžaduje, vytvořte v adresáři lib skript s názvem get-libs.sh, který po spuštění uvedené knihovny stáhne z internetu (předpokládejte prostředí Unix/Linux a přítomnost nástroje wget).
Hodnocení projektu
- Projekt je hodnocen na stupnici 0-100 procent. Po ohodnocení dojde k přepočtu bodů jednotlivým členům týmu, a to rovnoměrně
  - nominální zisk každého člena je 100%
  - hodnocení každého člena týmu lze přerozdělit v rozsahu -50% až +50%, v tom případě uveďte procentuální přerozdělení v souboru rozdeleni.txt, formát:
```
xloginXX: 50
xloginYY: 150
```
  - pokud máte dojem, že některý člen týmu nepracuje a nezaslouží si ani 50% z hodnocení, je nutno toto řešit individuálně s dr. Kočím před odevzdáním projektu
  - při přerozdělení může být vzata v úvahu aktivita jednotlivých členů (práce s svn repozitářem)
- Hodnocení zahrnuje kvalitu OO návrhu, kvalitu implementace, dodržování stylu psaní programu (odsazování, kvalita komentářů, vhodné identifikátory) a především funkčnost programu.
- Při návrhu postupujte tak, aby výsledný program byl dobře použitelný. Hodnotit se bude nejen to, zda splňuje kladené požadavky, ale také JAK je splňuje.
- Pro získání zápočtu musí mít každý člen týmu (po příp. korekcích v rámci týmu) alespoň 50% hodnocení.
- Doporučuji po vytvoření archivu přenést a vyzkoušet přeložitelnost a spuštění aplikace v jiném prostředí (např. merlin.fit.vutbr.cz).
- Pokud nepůjde projekt přeložit, bude hodnocen 0%!

Radek Kočí (koci AT fit.vutbr.cz)

Link to this Page

. last edited on 18 June 2012 at 11:23 am by localhost