Hlavní menu

Nástroje

WebKiv / PravidlaProVyvojare

View (print) - Edit page | Recent changes - Page history

Updated 10 September 2010, 11:05 by PremekBrada

WebKiv.PravidlaProVyvojare History

Hide minor edits - Show changes to output

10 September 2010, 11:05 by PremekBrada -
Added lines 90-96:
!!! Pojmenování a verzování modulů a jejich .zip souborů

Moduly pro web KIV mají čísla verzí ve formátu @@M.m.p.e@@ kde první dvě pozice (Major a Minor) určují verzi funkčnosti (dle dohody vývojářů, prj managera, a pokud možno dle souladu s [[cílovou verzí v milníku ve Flyspray -> https://forge.kiv.zcu.cz/bugs/index.php?do=index&project=5&string=&project=5&search_name=&type[0]=10&sev[0]=&pri[0]=&due[0]=&reported[0]=&cat[0]=44&status[0]=open&percent[0]=&opened=&dev=&closed=&duedatefrom=&duedateto=&changedfrom=&changedto=&openedfrom=&openedto=&closedfrom=&closedto=&do=index&order=status&sort=desc]]), třetí pozice (Patch) indikuje opravy chyb bez přidání fčnosti, a čtvrtá pozice (Export) je ponechána k nastavování OpenCms při exportu modulu.

* před exportem modulu pro uložení jeho buildu vývojář v OpenCms nastaví v datech modulu (Administration > Module management > Edit module) verzi na @@M.m.p.0@@ tj. nastaví major a minor dle dohody a číslo exportu na nula, a do Description napíše aktuální datum a čas vydání
* výsledný .zip uložený v Subversion bude mít tedy název @@cz.zcu.kiv.modul_M.m.p.X.zip@@ a po importu do OpenCms bude mít verzi ''M.m.p.X'' kde "X" je nezajímavé číslo vzniklé při exportu (nejčastěji z lokálního OpenCms) vývojářem.
Changed lines 105-111 from:
'''Pojmenování a verzování modulů a jejich .zip souborů:'''

Moduly pro web KIV mají čísla verzí ve formátu @@M.m.p.e@@ kde první dvě pozice (Major a Minor) určují verzi funkčnosti (dle dohody vývojářů, prj managera, a pokud možno dle souladu s [[cílovou verzí v milníku ve Flyspray -> https://forge.kiv.zcu.cz/bugs/index.php?do=index&project=5&string=&project=5&search_name=&type[0]=10&sev[0]=&pri[0]=&due[0]=&reported[0]=&cat[0]=44&status[0]=open&percent[0]=&opened=&dev=&closed=&duedatefrom=&duedateto=&changedfrom=&changedto=&openedfrom=&openedto=&closedfrom=&closedto=&do=index&order=status&sort=desc]]), třetí pozice (Patch) indikuje opravy chyb bez přidání fčnosti, a čtvrtá pozice (Export) je ponechána k nastavování OpenCms při exportu modulu.

* před exportem modulu pro uložení jeho buildu vývojář v OpenCms nastaví v datech modulu (Administration > Module management > Edit module) verzi na @@M.m.p.0@@ tj. nastaví major a minor dle dohody a číslo exportu na nula, a do Description napíše aktuální datum a čas vydání
* výsledný .zip uložený v Subversion bude mít tedy název @@cz.zcu.kiv.modul_M.m.p.X.zip@@ a po importu do OpenCms bude mít verzi ''M.m.p.X'' kde "X" je nezajímavé číslo vzniklé při exportu (nejčastěji z lokálního OpenCms) vývojářem.
to:
10 September 2010, 10:56 by PremekBrada -
Added lines 22-23:
Aktuální práce jsou identifikovány ohvězdičkovanými verzemi, tj. např. "Due in version = *Common 2.0" .
26 July 2010, 18:12 by PremekBrada -
Changed lines 51-52 from:
!! [[#verzovani]] 2. Verzování v Subversion
to:
!! [[#verzovani]] 2. Úložiště v Subversion
26 July 2010, 18:11 by PremekBrada -
Changed lines 64-65 from:
TODO: Nekde by mela v top-level strukture modulu byt sdilena konfigurace pro pripojeni do db.
to:
Konfigurace OpenCms je v top-level adresáři @@opencms-libs@@ spolu s potřebnými .jar soubory knihoven. {-TODO: Nekde by mela v top-level strukture modulu byt sdilena konfigurace pro pripojeni do db.-}
Changed lines 86-87 from:
* pod @@pages/@@ rovnou JSPčka (ne tedy např. {-@@pages/osoby/neco.jsp@@-})
to:
* pod @@pages/@@ rovnou JSPčka (ne tedy např. {-@@pages/osoby/neco.jsp@@-}) pro modul Osoby
Changed lines 92-102 from:
* v Subversion *musí* být uložen každý "zbuildovaný" .zip modulu -- repository je referenční místo, odkud se moduly berou pro instalaci na ostrý web
* každá verze modulu, která je určena pro nasazení (byť i jen v testovacím režimu např. na beta.kiv) *musí mít tag* v Subversion a tento tag v sobě musí obsahovat příslušné číslo verze modulu
* .zip soubor modulu pro uložení v Subversion vzniká pouze a jedině exportem otestovaného a fungujícího modulu z (lokálního) OpenCms, nikoli ručním "zazipováním" nebo třeba ant scriptem

Pojmenování a verzování modulů a jejich .zip souborů:

Moduly pro web KIV mají čísla verzí ve formátu @@M.m.e@@ kde první dvě pozice (Major a Minor) určují verzi funkčnosti (dle dohody vývojářů, prj managera, a pokud možno dle souladu s cílovou verzí v milníku ve Flyspray) a třetí pozice (Export) je ponechána k nastavování OpenCms při exportu modulu.

* před exportem modulu pro uložení jeho buildu vývojář v OpenCms nastaví v datech modulu (Administration > Module management > Edit module) verzi na @@M.m.0@@ tj. nastaví major a minor dle dohody a číslo exportu na nula, a do Description napíše aktuální datum a čas vydání
* výsledný .zip uložený v Subversion bude mít tedy název @@cz.zcu.kiv.modul_beta_M.m.0.zip@@ (pro akceptaci tj. testování na beta.kiv) resp. @@cz.zcu.kiv.modul_M.m.0.zip@@ (po akceptaci) a po importu do OpenCms bude mít verzi ''beta_M.m.0'' resp. ''M.m.0''.
to:
* v Subversion *musí* být uložen každý "zbuildovaný" .zip modulu -- repository je referenční místo, odkud se moduly berou pro instalaci na ostrý web;
* každá verze modulu, která je určena pro nasazení (byť i jen v testovacím režimu např. na beta.kiv) *musí mít tag* v Subversion a tento tag v sobě musí obsahovat příslušné číslo verze modulu -- např. @@/temata/tags/temata_1.2.0/@@;
* .zip soubor modulu pro uložení v Subversion vzniká pouze a jedině exportem otestovaného a fungujícího modulu z (lokálního) OpenCms, nikoli ručním "zazipováním" nebo třeba ant scriptem (a je základní slušností ho před commitem zkusit naimportovat do čistého OpenCms, aby vývojář věděl, že mu to funguje).

'''Pojmenování a verzování modulů a jejich .zip souborů:'''

Moduly pro web KIV mají čísla verzí ve formátu @@M.m.p.e@@ kde první dvě pozice (Major a Minor) určují verzi funkčnosti (dle dohody vývojářů, prj managera, a pokud možno dle souladu s [[cílovou verzí v milníku ve Flyspray -> https://forge.kiv.zcu.cz/bugs/index.php?do=index&project=5&string=&project=5&search_name=&type[0]=10&sev[0]=&pri[0]=&due[0]=&reported[0]=&cat[0]=44&status[0]=open&percent[0]=&opened=&dev=&closed=&duedatefrom=&duedateto=&changedfrom=&changedto=&openedfrom=&openedto=&closedfrom=&closedto=&do=index&order=status&sort=desc]]), třetí pozice (Patch) indikuje opravy chyb bez přidání fčnosti, a čtvrtá pozice (Export) je ponechána k nastavování OpenCms při exportu modulu.

* před exportem modulu pro uložení jeho buildu vývojář v OpenCms nastaví v datech modulu (Administration > Module management > Edit module) verzi na @@M.m.p.0@@ tj. nastaví major a minor dle dohody a číslo exportu na nula, a do Description napíše aktuální datum a čas vydání
* výsledný .zip uložený v Subversion bude mít tedy název @@cz.zcu.kiv.modul_M.m.p.X.zip@@ a po importu do OpenCms bude mít verzi ''M.m.p.X'' kde "X" je nezajímavé číslo vzniklé při exportu (nejčastěji z lokálního OpenCms) vývojářem.
26 July 2010, 18:02 by PremekBrada -
Changed line 44 from:
||!*** MILNÍK *** ||Cíl etapy-iterace; má mít nastaven Due in datum i Due in version; má mít přiřazeny dependent tasks ||
to:
||!*** MILNÍK *** ||Cíl etapy-iterace; má mít nastaven Due in datum i Due in version; ideálně přiřazeny dependent tasks ||
Added lines 47-48:
Pro moduly: Milník se statusem "In development" je aktuálně ve vývoji, status "Assigned" je možné použít jako "jo tohle budeme chtít a plánujeme to jako další verzi"; status "New" je potenciální budoucí milník.
15 April 2010, 13:58 by PremekBrada -
Changed lines 99-100 from:
* výsledný .zip uložený v Subversion bude mít tedy název @@cz.zcu.kiv.modul_beta_M.m.0.zip@@ (pro akceptaci tj. testování na beta.kiv) resp. @@cz.zcu.kiv.modul_M.m.0.zip@@ (po akceptaci) a po importu do OpenCms bude mít verzi ''M.m.0''.
to:
* výsledný .zip uložený v Subversion bude mít tedy název @@cz.zcu.kiv.modul_beta_M.m.0.zip@@ (pro akceptaci tj. testování na beta.kiv) resp. @@cz.zcu.kiv.modul_M.m.0.zip@@ (po akceptaci) a po importu do OpenCms bude mít verzi ''beta_M.m.0'' resp. ''M.m.0''.
15 April 2010, 13:58 by PremekBrada -
Changed lines 99-100 from:
* výsledný .zip uložený v Subversion bude mít tedy název @@cz.zcu.kiv.modul_M.m.0.zip@@ a po importu do OpenCms bude mít verzi ''M.m.0''.
to:
* výsledný .zip uložený v Subversion bude mít tedy název @@cz.zcu.kiv.modul_beta_M.m.0.zip@@ (pro akceptaci tj. testování na beta.kiv) resp. @@cz.zcu.kiv.modul_M.m.0.zip@@ (po akceptaci) a po importu do OpenCms bude mít verzi ''M.m.0''.
08 April 2010, 13:08 by PremekBrada -
Changed lines 94-98 from:
Pojmenování a verzování

Protože každý export z OpenCms inkrementuje poslední číslo identifikátoru verze, platí:

* moduly v Subversion mají čísla ve formátu @@M.m.e@@ kde první dvě pozice (Major a Minor) určují verzi funkčnosti (dle dohody vývojářů, prj managera, a pokud možno dle souladu s cílovou verzí v milníku ve Flyspray)
to:
Pojmenování a verzování modulů a jejich .zip souborů:

Moduly pro web KIV mají čísla verzí ve formátu @@M.m.e@@ kde první dvě pozice (Major a Minor) určují verzi funkčnosti (dle dohody vývojářů, prj managera, a pokud možno dle souladu s cílovou verzí v milníku ve Flyspray) a třetí pozice (Export) je ponechána k nastavování OpenCms při exportu modulu.
08 April 2010, 13:04 by PremekBrada -
Changed line 91 from:
* každá verze modulu, která je určena pro nasazení (byť i jen v testovacím režimu např. na beta.kiv) *musí mít tag* v Subversion
to:
* každá verze modulu, která je určena pro nasazení (byť i jen v testovacím režimu např. na beta.kiv) *musí mít tag* v Subversion a tento tag v sobě musí obsahovat příslušné číslo verze modulu
08 April 2010, 13:03 by PremekBrada -
Changed lines 88-102 from:
Postup při release modulu a soulad vývoje, tagování a názvu modulu je:

# modul se dokončí (dle cíle iterace) na lokálním stroji ->
** "BETA" tag v Subversion
** @@cz.zcu.kiv.MODULENAME-M.m-BETA.zip@@ balík modulu (ve jméně se inkrementuje @@M@@ nebo @@m@@ číslo verze dle cíle iterace -- např. @@cz.zcu.kiv.produkty-1.2-RC.zip@@ z původního @@1.1.zip@@)
# beta se ověří a opraví na @@beta.kiv.zcu.cz@@, vzniká release kandidát ->
** "RC" tag
** v datech modulu (Administration > Module management > Edit module) se modulu do Description napíše datum a čas vydání
** @@cz.zcu.kiv.MODULENAME-M.m-RC.zip@@ balík modulu
# nasadí na @@www.kiv.zcu.cz@@ a doladí se případné problémy, vzniká release ->
** "RELEASE" tag
** @@cz.zcu.kiv.MODULENAME-M.m.zip@@ balík (bez "RELEASE", např. @@cz.zcu.kiv.produkty-1.2.zip@@).

Ten datum a čas vydání v Description je nakonec jediný "trvalý" údaj, který přežije všechnu manipulaci s modulem v OpenCms (exporty, importy, modifikace). Je proto důležitý při hlášení chyb apod.
to:
Základní pravidla:

* v Subversion *musí* být uložen každý "zbuildovaný" .zip modulu -- repository je referenční místo, odkud se moduly berou pro instalaci na ostrý web
* každá verze modulu, která je určena pro nasazení (byť i jen v testovacím režimu např. na beta.kiv) *musí mít tag* v Subversion
* .zip soubor modulu pro uložení v Subversion vzniká pouze a jedině exportem otestovaného a fungujícího modulu z (lokálního) OpenCms, nikoli ručním "zazipováním" nebo třeba ant scriptem

Pojmenování a verzování

Protože každý export z OpenCms inkrementuje poslední číslo identifikátoru verze, platí:

* moduly v Subversion mají čísla ve formátu @@M.m.e@@ kde první dvě pozice (Major a Minor) určují verzi funkčnosti (dle dohody vývojářů, prj managera, a pokud možno dle souladu s cílovou verzí v milníku ve Flyspray)
* před exportem modulu pro uložení jeho buildu vývojář v OpenCms nastaví v datech modulu (Administration > Module management > Edit module) verzi na @@M.m.0@@ tj. nastaví major a minor dle dohody a číslo exportu na nula, a do Description napíše aktuální datum a čas vydání
* výsledný .zip uložený v Subversion bude mít tedy název @@cz.zcu.kiv.modul_M.m.0.zip@@ a po importu do OpenCms bude mít verzi ''M.m.0''.
07 April 2010, 12:01 by PremekBrada -
Changed lines 36-37 from:
||!Test ||testovací scénář pro ověření funkčnosti ||
to:
||!Test ||testovací scénář pro ověření funkčnosti -- JakPsatTestovaciTasky ||
25 March 2010, 14:11 by PremekBrada -
Added line 95:
** v datech modulu (Administration > Module management > Edit module) se modulu do Description napíše datum a čas vydání
Added lines 101-102:
Ten datum a čas vydání v Description je nakonec jediný "trvalý" údaj, který přežije všechnu manipulaci s modulem v OpenCms (exporty, importy, modifikace). Je proto důležitý při hlášení chyb apod.
25 March 2010, 13:29 by PremekBrada -
Added line 27:
* po úpravách ověří, zda něco jinde nerozbili, projitím testovacích scénářů (viz Flyspray typ tasku "Test")
Changed lines 36-37 from:
to:
||!Test ||testovací scénář pro ověření funkčnosti ||
01 March 2010, 18:41 by PremekBrada -
Deleted lines 61-71:
!!! Struktura modulu

Je založena na OpenCms struktuře a z pohledu Subversion struktury vymyšlena taková, aby na ní šel dělat vývoj (viz také OpenCMS.VyvojModuluPodEclipse) a zároveň v ní byly dostupné hotové buildy nasazených modulů.
* [[Attach:struktura-modulu-pro-vyvoj--2009.png]] -- používaná struktura
* [[Attach:struktura-modulu-pro-vyvoj--2010-navrh.png]] -- návrh nové struktury pro snazší práci při vývoji

Pár pravidel:
* nevytvářet zbytečné adresáře -- např. @@templates/@@ pokud modul neobsahuje šablonové JSP
* pod @@pages/@@ rovnou JSPčka (ne tedy např. {-@@pages/osoby/neco.jsp@@-}

Changed lines 72-73 from:
!! [[#build]] Build modulu
to:
!! [[#build]] 3. Struktura a build modulu

!!! Struktura modulu

Struktura KIV modulů je založena na std OpenCms struktuře a z pohledu Subversion struktury vymyšlena taková, aby na ní šel dělat vývoj (viz také OpenCMS.VyvojModuluPodEclipse) a zároveň v ní byly dostupné hotové buildy nasazených modulů.
* [[Attach:struktura-modulu-pro-vyvoj--2009.png]] -- používaná struktura
* [[Attach:struktura-modulu-pro-vyvoj--2010-navrh.png]] -- návrh nové struktury pro snazší práci při vývoji

Pár pravidel:
* nevytvářet zbytečné adresáře -- např. @@templates/@@ pokud modul neobsahuje šablonové JSP
* pod @@pages/@@ rovnou JSPčka (ne tedy např. {-@@pages/osoby/neco.jsp@@-})

!!! Build a release
26 February 2010, 17:40 by PremekBrada -
Changed line 3 from:
* Zapsat se do [[http://groups.google.cz/group/kiv-web-dev -> vývojářského mailing listu]]
to:
* Zapsat se do [[http://groups.google.cz/group/kiv-web-dev | vývojářského mailing listu]]
26 February 2010, 17:39 by PremekBrada -
Added line 3:
* Zapsat se do [[http://groups.google.cz/group/kiv-web-dev -> vývojářského mailing listu]]
Changed line 5 from:
* Používat [[bugtracker -> #bugtracker]] a [[verzování -> #verzovani]]
to:
* Používat postupy pro [[bugtracker -> #bugtracker]], [[verzování -> #verzovani]], [[build -> #build]]
Changed lines 83-84 from:
!! Build modulu
to:
!! [[#build]] Build modulu
26 February 2010, 17:32 by PremekBrada -
Changed lines 50-53 from:
!!! Struktura modulu v úložišti

Verzují se, resp. v Subversion repo mají separátní top-level
adresáře
to:
Verzují se, resp. v Subversion repo mají separátní top-level adresáře (v nich pak je std subversion struktura)
Deleted lines 55-58:
V techto adr je std subversion struktura, v ní pak pro moduly struktura taková, aby na ní šel dělat vývoj (viz také OpenCMS.VyvojModuluPodEclipse) a zároveň v ní byly dostupné hotové buildy nasazených modulů.
* [[Attach:struktura-modulu-pro-vyvoj--2009.png]] -- používaná struktura
* [[Attach:struktura-modulu-pro-vyvoj--2010-navrh.png]] -- návrh nové struktury pro snazší práci při vývoji
Added lines 61-71:
!!! Struktura modulu

Je založena na OpenCms struktuře a z pohledu Subversion struktury vymyšlena taková, aby na ní šel dělat vývoj (viz také OpenCMS.VyvojModuluPodEclipse) a zároveň v ní byly dostupné hotové buildy nasazených modulů.
* [[Attach:struktura-modulu-pro-vyvoj--2009.png]] -- používaná struktura
* [[Attach:struktura-modulu-pro-vyvoj--2010-navrh.png]] -- návrh nové struktury pro snazší práci při vývoji

Pár pravidel:
* nevytvářet zbytečné adresáře -- např. @@templates/@@ pokud modul neobsahuje šablonové JSP
* pod @@pages/@@ rovnou JSPčka (ne tedy např. {-@@pages/osoby/neco.jsp@@-}

26 February 2010, 17:28 by PremekBrada -
Changed lines 60-62 from:
* [[Attach:struktura-modulu-pro-vyvoj--2009.png -> používaná struktura]]
* [[Attach:struktura-modulu-pro-vyvoj--2010-navrh.png -> návrh nové struktury]] pro snazší práci při vývoji
to:
* [[Attach:struktura-modulu-pro-vyvoj--2009.png]] -- používaná struktura
* [[Attach:struktura-modulu-pro-vyvoj--2010-navrh.png]] -- návrh nové struktury pro snazší práci při vývoji
26 February 2010, 17:27 by PremekBrada -
Changed lines 11-12 from:
!! [[#bugtracker]] Bug tracker [[Flyspray na forge.kiv -> https://forge.kiv.zcu.cz/bugs/index.php?tasks=all&project=5]]
to:
!! [[#bugtracker]] 1. Bug tracker = [[Flyspray na forge.kiv -> https://forge.kiv.zcu.cz/bugs/index.php?tasks=all&project=5]]
Changed lines 46-51 from:
!! [[#verzovani]] Verzování

Subversion přístupné pres Orion login+heslo na URL https://forge.kiv.zcu.cz/svn-www-kiv/.

Verzovat se budou, resp. v Subversion repo budou mit separatni top-level
adresare
to:
!! [[#verzovani]] 2. Verzování v Subversion

Úložiště přístupné pres Orion login+heslo na URL https://forge.kiv.zcu.cz/svn-www-kiv/.

!!! Struktura modulu v úložišti

Verzují se, resp. v Subversion repo mají separátní top-level
adresáře
Changed lines 59-60 from:
V techto adr uz std subversion struktura.
to:
V techto adr je std subversion struktura, v ní pak pro moduly struktura taková, aby na ní šel dělat vývoj (viz také OpenCMS.VyvojModuluPodEclipse) a zároveň v ní byly dostupné hotové buildy nasazených modulů.
* [[Attach:struktura-modulu-pro-vyvoj--2009.png -> používaná struktura]]
* [[Attach:struktura-modulu-pro-vyvoj--2010-navrh.png -> návrh nové struktury]] pro snazší práci při vývoji
Added lines 68-69:
!!! Práce s úložištěm při vývoji
Changed lines 72-73 from:
* Při commitu povinně psát komentáře !!!
to:
** Důvod: případné "uživatelské" jméno s diakritikou boří některé Subversion klienty, zejména cmdline a Tortoise, ve kterých pak nejde udělat checkout/update.
* Při commitu povinně psát komentáře !!! (pokud možno s referencí na Flyspray task ve formátu @@FS#123@@)
Changed lines 76-80 from:

!!! Postup při release modulu

Soulad vývoje, tagování a názvu modulu je:
to:
** POZN: možná opustíme, viz návrh nové struktury

!! Build modulu

Postup při release modulu a soulad vývoje, tagování a názvu modulu je:
26 February 2010, 16:53 by PremekBrada -
Changed lines 70-71 from:
!!! Postup při relese modulu
to:
!!! Postup při release modulu
Changed lines 74-77 from:
# modul se dokončí (dle cíle iterace) na lokálním stroji -> "BETA" tag v Subversion
# ověří a opraví na @@beta.kiv.zcu.cz@@, vzniká release kandidát -> "RC" tag, @@cz.zcu.kiv.MODULENAME-M.m-RC.zip@@ balík modulu (ve jméně se inkrementuje @@M@@ nebo @@m@@ číslo verze dle cíle iterace -- např. @@cz.zcu.kiv.produkty-1.2-RC.zip@@ z původního @@1.1.zip@@)
# nasadí na @@www.kiv.zcu.cz@ a doladí se případné problémy, vzniká release -> "RELEASE" tag, @@cz.zcu.kiv.MODULENAME-M.m.zip@@ balík (např. @@cz.zcu.kiv.produkty-1.2.zip@@).
to:
# modul se dokončí (dle cíle iterace) na lokálním stroji ->
** "BETA" tag v Subversion
** @@cz.zcu.kiv.MODULENAME-M.m-BETA.zip@@ balík modulu (ve jméně se inkrementuje @@M@@ nebo @@m@@ číslo verze dle cíle iterace -- např. @@cz.zcu.kiv.produkty-1.2-RC.zip@@ z původního @@1.1.zip@@)
# beta se ověří a opraví na @@beta.kiv.zcu.cz@@, vzniká release kandidát ->
** "RC" tag
** @@cz.zcu.kiv.MODULENAME-M.m-RC.zip@@ balík modulu
# nasadí na @@www.kiv.zcu.cz@@ a doladí se případné problémy, vzniká release ->
** "RELEASE" tag
** @@cz.zcu.kiv.MODULENAME-M.m.zip@@ balík (bez "RELEASE", např. @@cz.zcu.kiv.produkty-1.2.zip@@).
26 February 2010, 16:50 by PremekBrada -
Changed lines 75-77 from:
# ověří a opraví na @@beta.kiv.zcu.cz@@, vzniká release kandidát -> "RC" tag, @@cz.zcu.kiv.MODULENAME-M.m-RC.zip@@ balík modulu (ve jméně se inkrementuje @@M@@ nebo @@m@@ číslo verze dle cíle iterace)
# nasadí na @@www.kiv.zcu.cz@ a doladí se případné problémy, vzniká release -> "RELEASE" tag, @@cz.zcu.kiv.MODULENAME-M.m.zip@@ balík.
to:
# ověří a opraví na @@beta.kiv.zcu.cz@@, vzniká release kandidát -> "RC" tag, @@cz.zcu.kiv.MODULENAME-M.m-RC.zip@@ balík modulu (ve jméně se inkrementuje @@M@@ nebo @@m@@ číslo verze dle cíle iterace -- např. @@cz.zcu.kiv.produkty-1.2-RC.zip@@ z původního @@1.1.zip@@)
# nasadí na @@www.kiv.zcu.cz@ a doladí se případné problémy, vzniká release -> "RELEASE" tag, @@cz.zcu.kiv.MODULENAME-M.m.zip@@ balík (např. @@cz.zcu.kiv.produkty-1.2.zip@@).
26 February 2010, 16:46 by PremekBrada -
Changed line 24 from:
* když začnou na nějakém dělat, změní stav na "In development" a případně upraví hodnotu odhadu pracnosti (skrytá pod Operating system),
to:
* když začnou na nějakém dělat, změní stav na "In development" a případně upraví hodnotu odhadu pracnosti,
Changed lines 69-70 from:
* Po dokončení iterace/přírůstku otagovat příslušné moduly atd.
to:

!!! Postup při relese modulu

Soulad vývoje, tagování a názvu modulu je:

# modul se dokončí (dle cíle iterace) na lokálním stroji -> "BETA" tag v Subversion
# ověří a opraví na @@beta.kiv.zcu.cz@@, vzniká release kandidát -> "RC" tag, @@cz.zcu.kiv.MODULENAME-M.m-RC.zip@@ balík modulu (ve jméně se inkrementuje @@M@@ nebo @@m@@ číslo verze dle cíle iterace)
# nasadí na @@www.kiv.zcu.cz@ a doladí se případné problémy, vzniká release -> "RELEASE" tag, @@cz.zcu.kiv.MODULENAME-M.m.zip@@ balík.
26 November 2009, 13:15 by Miroslav Kral -
Changed line 65 from:
to:
* Při prvním přístupu do svn přes Eclipse a plugin SVNKit budete dotázáni na zadání jména autora. Povinně zadejte svůj '''orion login''', nesmí se zde zadat jméno(login) s diakritikou. Pokud jste náhodou již toto provedli, smažte v adresáři "Eclipse Home"/configuration/org.eclipse.core.runtime soubor '''.keyring''' a znovu spusťte Eclipse. Při přístupu do SVN budete opět dotázáni na jméno autora.
15 October 2009, 13:08 by PremekBrada -
Changed lines 66-67 from:
* Při commitu *povinně psát komentáře* !!!
* Před commitem změn src/*.java modulu: zbuildovat .jar tříd pro modul, uložit ho do lib/ adresáře -- pak teprve commit
to:
* Při commitu povinně psát komentáře !!!
* Před commitem změn @@src/.java@@ modulu: zbuildovat @@.jar@@ tříd pro modul, uložit ho do @@lib/@@ adresáře -- pak teprve commit
15 October 2009, 13:07 by PremekBrada -
Added lines 67-68:
* Před commitem změn src/*.java modulu: zbuildovat .jar tříd pro modul, uložit ho do lib/ adresáře -- pak teprve commit
** výsledek: v svn jsou vždy v souladu zdrojáky a přeložené třídy k nasazení do OpenCms
02 July 2009, 21:57 by PremekBrada -
Added line 6:
** a pokud možno také používat OpenCmsBestPractices a OpenCmsTestovaniModulu
16 March 2009, 13:48 by PremekBrada -
Changed line 5 from:
* Při psaní kódu modulů dodržovat ImplementacniKonvence
to:
* Při psaní kódu modulů dodržovat ImplementacniKonvence a ArchitekturaModulu
13 March 2009, 11:26 by PremekBrada -
Changed lines 54-55 from:
to:
* datový model a SQL DDL skripty
Changed lines 58-59 from:
Nekde by mela v top-level strukture modulu byt sdilena konfigurace pro pripojeni do db.
to:
Co se _neverzuje_:
* projektové apod soubory pro IDE (např .project pro Eclipse), které má každý vývojář jiné

TODO: Nekde by mela v top-level strukture modulu byt sdilena konfigurace pro pripojeni do db.
03 March 2009, 23:50 by PremekBrada -
Changed line 23 from:
* když začnou na nějakém dělat, změní stav na "In development",
to:
* když začnou na nějakém dělat, změní stav na "In development" a případně upraví hodnotu odhadu pracnosti (skrytá pod Operating system),
Changed lines 25-26 from:
* když mají hotovo, změní stav na "Requires testing" a dají "Request closure"
to:
* když mají hotovo, změní stav na "Requires testing", nastaví odhad pracnosti na skutečně strávený čas a teploměr na 90%, a dají "Request closure"
26 January 2009, 14:37 by PremekBrada -
Changed lines 12-13 from:
Základní pravidla a best practices pro práci s Flyspray-em.
to:
Základní pravidla a best practices pro práci s Flyspray-em. Vždy platí priority tasků dle [[RFC 2119 -> http://www.faqs.org/rfcs/rfc2119.html]] takto:

||border=1 width=70% cellspacing=0
||milník ||Flash ||
||MUST čili release blocker (prioritu má task) ||High ||
||SHOULD čili pokud není impl v release je třeba zdůvodnit (prioritu může mít release) ||Normal ||
||MAY čili když se nestihne, nic moc se neděje (prioritu má release) ||Low ||
Added line 30:
||!Bug ||jakákoli chyba, ať od uživatele nebo z interních testů ||
Changed lines 33-34 from:
||!Bug ||jakákoli chyba, ať od uživatele nebo z interních testů ||
to:
Changed lines 39-66 from:
||Type ||Atributy ||Komentář ||
||!*** MILNÍK *** ||seve:crit ||Cíl etapy-iterace; má mít nastaven Due in datum i Due in version; má mít přiřazeny dependent tasks ||
||!Feature ||seve:high ||Funkční modul (růžové pozadí); má mít přiřazeny dependent tasks; typicky se jejich část řeší v nějaké iteraci ||

* Milník má nastaven max Severity a Priority (aby byl vždy nahoře ;-). V názvu milníku nechť je stručně uveden cíl a rámcový datum dosažení, viz Plan.
* Ke každému milníku je definována future Version v Project management
* Všechny tasky, které jsou naplánovány do iterace, mají dle předchozích dvou bodů nastaveno Due in version. (Optimálně by milník měl mít nastavenu dependency na podřízené tasky, ale to je hodně práce.)
* Stav milníku je pak možno sledovat na Roadmap stránce.

* Priority tasků dle [[RFC 2119 -> http://www.faqs.org/rfcs/rfc2119.html]] takto:

||border=1 width=70% cellspacing=0
||milník ||Flash ||
||MUST čili release blocker (prioritu má task) ||High ||
||SHOULD čili pokud není impl v release je třeba zdůvodnit (prioritu může mít release) ||Normal ||
||MAY čili když se nestihne, nic moc se neděje (prioritu má release) ||Low ||

Iteration planning s Flysprayem:

* využít co nejvíc default fčnost - řazení tasků je default sestupně dle severity, stránka Roadmap ukazuje cosi jako burndown pro verze

# vytvořit verzi odpovídající cíli iterace (název dle cíle, ne dle toho kdo bude dělat - tj. např. "Produkty upgr" nikoli "PIA LS 2008-2009")
# vytvořit milník, přiřadit mu tuto verzi a due date
# taskům nastavit priority vzhledem k iteraci dle tabulky výše
# assign - napřed genericky "ASWI, PRJ" apod + po vyřešení personálního obsazení týmu přidat konkrétní lidi


to:
||Type ||Komentář ||
||!*** MILNÍK *** ||Cíl etapy-iterace; má mít nastaven Due in datum i Due in version; má mít přiřazeny dependent tasks ||
||!Feature se Severity:Critical ||Funkční modul; má mít přiřazeny dependent tasks; typicky se jejich část řeší v nějaké iteraci ||

Detaily viz IteracniPlanovaniVeFlysprayi.
26 January 2009, 14:25 by PremekBrada -
Changed line 54 from:
# vytvořit verzi odpovídající cíli iterace
to:
# vytvořit verzi odpovídající cíli iterace (název dle cíle, ne dle toho kdo bude dělat - tj. např. "Produkty upgr" nikoli "PIA LS 2008-2009")
26 January 2009, 14:24 by PremekBrada -
Changed lines 50-60 from:
to:
Iteration planning s Flysprayem:

* využít co nejvíc default fčnost - řazení tasků je default sestupně dle severity, stránka Roadmap ukazuje cosi jako burndown pro verze

# vytvořit verzi odpovídající cíli iterace
# vytvořit milník, přiřadit mu tuto verzi a due date
# taskům nastavit priority vzhledem k iteraci dle tabulky výše
# assign - napřed genericky "ASWI, PRJ" apod + po vyřešení personálního obsazení týmu přidat konkrétní lidi


26 January 2009, 14:03 by PremekBrada -
Changed lines 10-11 from:
!! [[#bugtracker]] [[Bug tracker -> https://forge.kiv.zcu.cz/bugs/index.php?tasks=all&project=5]]
to:
!! [[#bugtracker]] Bug tracker [[Flyspray na forge.kiv -> https://forge.kiv.zcu.cz/bugs/index.php?tasks=all&project=5]]
26 January 2009, 14:03 by PremekBrada -
Changed lines 12-13 from:
*Vývojáři:*
to:
Základní pravidla a best practices pro práci s Flyspray-em.

!!! Vývojáři
Changed lines 28-29 from:
*Leader:*
to:
!!! Leader
26 January 2009, 14:02 by PremekBrada -
Changed lines 14-15 from:
* si budou aktualizovat "teploměr" u svých tasků, které jsou:
to:
* dělají jen tasky, které mají přiřazené,
* když začnou na nějakém dělat, změní stav na "In development",
* si budou aktualizovat "teploměr" u svých tasků,
* když mají hotovo, změní stav na "Requires testing" a dají "Request closure"

Vývojářské typy tasků:
26 January 2009, 11:56 by PremekBrada -
Changed lines 31-34 from:
* Všechny tasky, které jsou naplánovány do iterace, mají dle toho nastaveno Due in version. Optimálně by milník měl mít nastavenu dependency na podřízené tasky.
to:
* Ke každému milníku je definována future Version v Project management
* Všechny tasky, které jsou naplánovány do iterace, mají dle předchozích dvou bodů nastaveno Due in version. (Optimálně by milník měl mít nastavenu dependency na podřízené tasky, ale to je hodně práce.)
* Stav milníku je pak možno sledovat na Roadmap stránce.
26 January 2009, 11:45 by PremekBrada -
Deleted line 0:
Changed line 27 from:
||!*** MILNÍK *** ||prio:flash,seve:crit ||Cíl etapy-iterace; má mít nastaven Due in datum i Due in version; má mít přiřazeny dependent tasks ||
to:
||!*** MILNÍK *** ||seve:crit ||Cíl etapy-iterace; má mít nastaven Due in datum i Due in version; má mít přiřazeny dependent tasks ||
Changed line 30 from:
* Milník má nastaven max Severity a Priority (aby byl vždy nahoře ;-). V názvu milníku nechť je stručně uveden cíl a rámcový datum dosažení, viz Plan.
to:
* Milník má nastaven max Severity a Priority (aby byl vždy nahoře ;-). V názvu milníku nechť je stručně uveden cíl a rámcový datum dosažení, viz Plan.
26 January 2009, 11:17 by PremekBrada -
Changed lines 1-7 from:
Obsah stránky:
* [[Moduly v OpenCms -> PravidlaProVyvojare#moduly]]
* [[Bugtracker -> PravidlaProVyvojare#bugtracker]]
* [[Verzování -> PravidlaProVyvojare#verzovani]]

!! Stručně
to:

!!! Stručně
Changed line 5 from:
* Používat [[bugtracker -> https://sofa.fav.zcu.cz/bugs/index.php?tasks=all&project=5]] a [[verzování -> https://forge.kiv.zcu.cz/svn-www-kiv/]]
to:
* Používat [[bugtracker -> #bugtracker]] a [[verzování -> #verzovani]]
Changed lines 11-12 from:
!! [[#bugtracker]] Bug tracker
to:
!! [[#bugtracker]] [[Bug tracker -> https://forge.kiv.zcu.cz/bugs/index.php?tasks=all&project=5]]
Changed lines 31-32 from:
Priority záznamů dle [[RFC 2119 -> http://www.faqs.org/rfcs/rfc2119.html]]
to:
* Milník má nastaven max Severity a Priority (aby byl vždy nahoře ;-). V názvu milníku nechť je stručně uveden cíl a rámcový datum dosažení, viz Plan.
* Všechny tasky, které jsou naplánovány do iterace, mají dle toho nastaveno Due in version. Optimálně by milník měl mít nastavenu dependency na podřízené tasky.
* Priority tasků dle [[RFC 2119 -> http://www.faqs.org/rfcs/rfc2119.html]] takto:
Changed lines 41-43 from:
* Milník má nastaven max Severity a Priority (aby byl vždy nahoře ;-). V názvu milníku nechť je stručně uveden cíl a rámcový datum dosažení, viz Plan.
* Všechny tasky, které jsou naplánovány do iterace, mají dle toho nastaveno Due in version. Optimálně by milník měl mít nastavenu dependency na podřízené tasky.
to:
26 January 2009, 11:14 by PremekBrada -
Changed line 8 from:
* Používat PouzivaneTechnologie
to:
* Dodržovat PouzivaneTechnologie
Changed lines 17-18 from:
Plánovací tasky:
to:
*Vývojáři:*

* si budou aktualizovat "teploměr" u svých tasků, které jsou:

||border=1 width=70% cellspacing=0
||!Feature ||uživatelská funkčnost či vlastnost, nově chtěná ||
||!Task ||interní vylepšení, reorganizace kódu, technické úpravy ||
||!Bug ||jakákoli chyba, ať od uživatele nebo z interních testů ||

*Leader:*

* používá plánovací tasky takto:
Changed lines 35-39 from:

Pracovní tasky:

Platí, že Priority:High = MUST, Priority:Normal = SHOULD, Priority:Low = MAY (zejména vzhledem k iteraci definované Due in version a odpovídajícím milníkem).
to:
Priority záznamů dle [[RFC 2119 -> http://www.faqs.org/rfcs/rfc2119.html]]
Deleted lines 37-50:
||!Feature ||uživatelská funkčnost či vlastnost, nově chtěná ||
||!Task ||interní vylepšení, reorganizace kódu, technické úpravy ||
||!Bug ||jakákoli chyba, ať od uživatele nebo z interních testů ||

*Vývojáři:*

* si budou aktualizovat "teploměr" u svých tasků.


*Leader:*

Priority záznamů dle [[RFC 2119 -> http://www.faqs.org/rfcs/rfc2119.html]]

||border=1 width=70% cellspacing=0
26 January 2009, 11:12 by PremekBrada -
Changed line 19 from:
||border=1 width=70% cellspacing=0
to:
||border=1 cellspacing=0
26 January 2009, 11:12 by PremekBrada -
Changed lines 17-18 from:
Typy záznamů v bugtrackeru:
to:
Plánovací tasky:
Changed lines 20-29 from:
||!--MILNÍK-- ||shrnutí cíle etapy ||
to:
||Type ||Atributy ||Komentář ||
||!*** MILNÍK *** ||prio:flash,seve:crit ||Cíl etapy-iterace; má mít nastaven Due in datum i Due in version; má mít přiřazeny dependent tasks ||
||!Feature ||seve:high ||Funkční modul (růžové pozadí); má mít přiřazeny dependent tasks; typicky se jejich část řeší v nějaké iteraci ||


Pracovní tasky:

Platí, že Priority:High = MUST, Priority:Normal = SHOULD, Priority:Low = MAY (zejména vzhledem k iteraci definované Due in version a odpovídajícím milníkem).

||border=1 width=70% cellspacing=0
13 May 2008, 18:31 by PremekBrada -
Added line 11:
* Při psaní front-endu aplikací používat VzhledoveKonvence
09 April 2008, 10:40 by PremekBrada - konvence pro opencms moduly přesunuty do ImplementacniKonvence
Changed line 10 from:
* Při psaní kódu modulů dodržovat ImplementacniKonvence a instrukce zde
to:
* Při psaní kódu modulů dodržovat ImplementacniKonvence
Changed lines 13-37 from:
!! [[#moduly]] Moduly v OpenCms

!!! Struktura

:Držet se OpenCms konvencí: Podadresáře @@resources@@, @@pages@@, @@lib@@, @@classes@@ atd. (viz třeba @@org.opencms.frontend.photoalbum@@ nebo @@org.opencms.frontend.layoutpage@@).
:Název: Musí mít ve VFS předponu @@cz.zcu.kiv@@ následovanou inteligentním jménem modulu.

!!! Výkonný kód

:V JSP stránkách: Snažit se využít POJO a JSTL pro JSP stránky. Vlastní značky (taglib) vytvářet jen v odůvodněných případech a po schválení vedením projektu.
:Zdrojové Java třídy: Musí být dobře pojmenovaném v balíku (dle názvu modulu do kterého patří) umístěném pod @@cz.zcu.kiv.opencms@@.
:Přístup do DB: Používat Spring JDBC, třídy v balíku pod @@cz.zcu.kiv.db@@, podle ArchitekturaDaoVrstvy.

!!! Lokalizace (L10N)

:Kam L10N řetězce: Využívat možností OpenCms (properties VFS objektu, jazykové mutace XML strukturovaných dat). Pro JSP použít @@<c:if>@@ nebo @@<c:switch>@@ -- předpoklad je že v JSP bude málo textů závislých na jazyce, proto nebudou používány @@.properties@@ lokalizační bundly.
:Editační JSP stránky: Pro vlastní KIV aplikace budou vždy pouze v CZ (prezentační stránky jsou česky a/nebo anglicky).
:Jak se zjistí aktuální locale: TBD

!!! Zabezpečení, autentikace a autorizace

:Autentikace: (ověření jména/hesla) Zatím (3/2008) přes OpenCms, v budoucnu přes Kerberos (viz ZabezpecenePrihlaseni).
:Autorizace: (kdo kam může) Řešit prostředky OpenCms (Permissions na VFS objektu) nikoli v aplikační logice.
:Zjištění aktuálně přihlášeného uživatele: Pro potřeby JSP aplikačních stránek - TBD.
to:
09 April 2008, 10:37 by PremekBrada -
Changed lines 55-56 from:
Priority záznamů dle [[RFC 2119 -> www.faqs.org/rfcs/rfc2119.html]]
to:
Priority záznamů dle [[RFC 2119 -> http://www.faqs.org/rfcs/rfc2119.html]]
09 April 2008, 10:37 by PremekBrada -
Deleted lines 39-40:
*Leader:*
Changed line 43 from:
||!--MILNÍK-- ||shrnutí cíle etapy (nastavena max Severity a Priority) ||
to:
||!--MILNÍK-- ||shrnutí cíle etapy ||
Deleted lines 47-49:
* V názvu milníku nechť je stručně uveden cíl a rámcový datum dosažení, viz Plan.
* Všechny tasky, které jsou naplánovány do iterace, mají dle toho nastaveno Due in version. Optimálně by milník měl mít nastavenu dependency na podřízené tasky.
Added lines 52-65:

*Leader:*

Priority záznamů dle [[RFC 2119 -> www.faqs.org/rfcs/rfc2119.html]]

||border=1 width=70% cellspacing=0
||milník ||Flash ||
||MUST čili release blocker (prioritu má task) ||High ||
||SHOULD čili pokud není impl v release je třeba zdůvodnit (prioritu může mít release) ||Normal ||
||MAY čili když se nestihne, nic moc se neděje (prioritu má release) ||Low ||

* Milník má nastaven max Severity a Priority (aby byl vždy nahoře ;-). V názvu milníku nechť je stručně uveden cíl a rámcový datum dosažení, viz Plan.
* Všechny tasky, které jsou naplánovány do iterace, mají dle toho nastaveno Due in version. Optimálně by milník měl mít nastavenu dependency na podřízené tasky.
09 April 2008, 10:34 by PremekBrada -
Deleted lines 39-40:
[[Určuje náš život -> https://sofa.fav.zcu.cz/bugs/index.php?tasks=all&project=5]] - co do kdy je třeba udělat.
Changed lines 42-50 from:
* Ke každému iteračnímu cíli je definován task s type=Milník a maximálními hodnotami Severity a Priority (aby byl vždycky nahoře :-) . V názvu milníku nechť je stručně uveden cíl a rámcový datum dosažení, viz Plan.
to:
Typy záznamů v bugtrackeru:

||border=1 width=70% cellspacing=0
||!--MILNÍK-- ||shrnutí cíle etapy (nastavena max Severity a Priority) ||
||!Feature ||uživatelská funkčnost či vlastnost, nově chtěná ||
||!Task ||interní vylepšení, reorganizace kódu, technické úpravy ||
||!Bug ||jakákoli chyba, ať od uživatele nebo z interních testů ||

* V názvu milníku nechť je stručně uveden cíl a rámcový datum dosažení, viz Plan.
09 April 2008, 10:28 by PremekBrada -
Deleted line 0:
Changed line 10 from:
* Moduly psát podle instrukcí zde
to:
* Při psaní kódu modulů dodržovat ImplementacniKonvence a instrukce zde
09 April 2008, 10:22 by PremekBrada -
Changed lines 1-2 from:
Vývoj je přírůstkový a cca iterativní - co přírůstek to iterace (zatím). Každý přírůstek má well defined cíl a datum dokončení, viz [[Plan]].
to:
Added lines 7-13:
!! Stručně

* Používat PouzivaneTechnologie
* Používat [[bugtracker -> https://sofa.fav.zcu.cz/bugs/index.php?tasks=all&project=5]] a [[verzování -> https://forge.kiv.zcu.cz/svn-www-kiv/]]
* Moduly psát podle instrukcí zde
* Když nevím, hledat v [[manuálech -> RedSys#manualy]]
Deleted lines 15-16:
-> Pro vývoj viz VyvojModuluPodEclipse.
Changed lines 27-28 from:
Lokalizace (L10N)
to:
!!! Lokalizace (L10N)
07 April 2008, 18:41 by PremekBrada -
Changed lines 50-51 from:
Subversion přístupné pres Orion login+heslo na URL -- TBD .
to:
Subversion přístupné pres Orion login+heslo na URL https://forge.kiv.zcu.cz/svn-www-kiv/.
Changed lines 55-57 from:
to:
* globální dokumentace
* grafické návrhy a šablony
12 March 2008, 14:34 by PremekBrada -
Changed lines 1-4 from:
Vývoj je přírůstkový a cca iterativní - co přírůstek to iterace (zatím). Každý přírůstek má well defined cíl a datum dokončení, viz Plan.

!! Moduly v OpenCms
to:
Vývoj je přírůstkový a cca iterativní - co přírůstek to iterace (zatím). Každý přírůstek má well defined cíl a datum dokončení, viz [[Plan]].

Obsah stránky:
* [[Moduly v OpenCms -> PravidlaProVyvojare#moduly]]
* [[Bugtracker -> PravidlaProVyvojare#bugtracker]]
* [[Verzování -> PravidlaProVyvojare#verzovani]]

!! [[#moduly]] Moduly v OpenCms
Changed lines 12-13 from:
:Struktura: držet se OpenCms konvencí - podadresáře @@resources@@, @@pages@@, @@lib@@, @@classes@@ atd. (viz třeba @@org.opencms.frontend.photoalbum@@ nebo @@org.opencms.frontend.layoutpage@@).
to:
!!! Struktura

:Držet se OpenCms konvencí: Podadresáře @@resources@@, @@pages@@, @@lib@@, @@classes@@ atd. (viz třeba @@org.opencms.frontend.photoalbum@@ nebo @@org.opencms.frontend.layoutpage@@).
Changed lines 17-18 from:
Výkonný kód
to:
!!! Výkonný kód
Changed lines 29-30 from:
Zabezpečení, autentikace a autorizace
to:
!!! Zabezpečení, autentikace a autorizace
Changed lines 35-36 from:
!! Bug tracker
to:
!! [[#bugtracker]] Bug tracker
Changed lines 48-49 from:
!! Verzování
to:
!! [[#verzovani]] Verzování
Added lines 65-66:
----
Zpět na RedSys
12 March 2008, 14:31 by PremekBrada -
Changed lines 7-16 from:
*Struktura:* držet se OpenCms konvencí - podadresáře @@resources@@, @@pages@@, @@lib@@, @@classes@@ atd. (viz třeba @@org.opencms.frontend.photoalbum@@ nebo @@org.opencms.frontend.layoutpage@@).

Název: Musí mít ve VFS předponu @@cz.zcu.kiv@@ následovanou inteligentním jménem modulu.

Zdrojové Java třídy: Musí být dobře pojmenovaném v balíku (dle názvu modulu do kterého patří) umístěném pod @@cz.zcu.kiv.opencms@@.

Pro přístup do DB používat Spring JDBC, třídy v balíku pod @@cz.zcu.kiv.db@@ -- viz ArchitekturaDaoVrstvy.

Snažit se využít POJO a JSTL pro JSP stránky. Vlastní značky (taglib) vytvářet jen v odůvodněných případech a po schválení vedením projektu.
to:
:Struktura: držet se OpenCms konvencí - podadresáře @@resources@@, @@pages@@, @@lib@@, @@classes@@ atd. (viz třeba @@org.opencms.frontend.photoalbum@@ nebo @@org.opencms.frontend.layoutpage@@).

:Název: Musí mít ve VFS předponu @@cz.zcu.kiv@@ následovanou inteligentním jménem modulu.

Výkonný kód

:V JSP stránkách: Snažit se využít POJO a JSTL pro JSP stránky. Vlastní značky (taglib) vytvářet jen v odůvodněných případech a po schválení vedením projektu.
:Zdrojové Java třídy: Musí být dobře pojmenovaném v balíku (dle názvu modulu do kterého patří) umístěném pod @@cz.zcu.kiv.opencms@@.
:Přístup do DB: Používat Spring JDBC, třídy v balíku pod @@cz.zcu.kiv.db@@, podle ArchitekturaDaoVrstvy.

Lokalizace (L10N)

:Kam L10N řetězce: Využívat možností OpenCms (properties VFS objektu, jazykové mutace XML strukturovaných dat). Pro JSP použít @@<c:if>@@ nebo @@<c:switch>@@ -- předpoklad je že v JSP bude málo textů závislých na jazyce, proto nebudou používány @@.properties@@ lokalizační bundly.
:Editační JSP stránky: Pro vlastní KIV aplikace budou vždy pouze v CZ (prezentační stránky jsou česky a/nebo anglicky).
:Jak se zjistí aktuální locale: TBD

Zabezpečení, autentikace a autorizace

:Autentikace: (ověření jména/hesla) Zatím (3/2008) přes OpenCms, v budoucnu přes Kerberos (viz ZabezpecenePrihlaseni).
:Autorizace: (kdo kam může) Řešit prostředky OpenCms (Permissions na VFS objektu) nikoli v aplikační logice.
:Zjištění aktuálně přihlášeného uživatele: Pro potřeby JSP aplikačních stránek - TBD.
11 March 2008, 09:10 by PremekBrada -
Changed lines 13-14 from:
Pro přístup do DB používat Spring JDBC, třídy v balíku pod @@cz.zcu.kiv.redsys@@ -- viz ArchitekturaDaoVrstvy.
to:
Pro přístup do DB používat Spring JDBC, třídy v balíku pod @@cz.zcu.kiv.db@@ -- viz ArchitekturaDaoVrstvy.
11 March 2008, 09:08 by PremekBrada -
Changed lines 13-14 from:
Pro přístup do DB používat Spring JDBC.
to:
Pro přístup do DB používat Spring JDBC, třídy v balíku pod @@cz.zcu.kiv.redsys@@ -- viz ArchitekturaDaoVrstvy.
05 March 2008, 15:34 by PremekBrada -
Added lines 5-6:
-> Pro vývoj viz VyvojModuluPodEclipse.
25 January 2008, 16:49 by PremekBrada -
Added lines 3-14:
!! Moduly v OpenCms

*Struktura:* držet se OpenCms konvencí - podadresáře @@resources@@, @@pages@@, @@lib@@, @@classes@@ atd. (viz třeba @@org.opencms.frontend.photoalbum@@ nebo @@org.opencms.frontend.layoutpage@@).

Název: Musí mít ve VFS předponu @@cz.zcu.kiv@@ následovanou inteligentním jménem modulu.

Zdrojové Java třídy: Musí být dobře pojmenovaném v balíku (dle názvu modulu do kterého patří) umístěném pod @@cz.zcu.kiv.opencms@@.

Pro přístup do DB používat Spring JDBC.

Snažit se využít POJO a JSTL pro JSP stránky. Vlastní značky (taglib) vytvářet jen v odůvodněných případech a po schválení vedením projektu.
Deleted lines 44-48:
!! Moduly v OpenCms

Musí mít ve VFS předponu @@cz.zcu.kiv@@ následovanou inteligentním jménem modulu.

02 January 2008, 13:32 by PremekBrada -
Changed lines 26-27 from:
Nekde by mela v top-level strukture fav modulu maji byt sdilena konfigurace pro pripojeni do db.
to:
Nekde by mela v top-level strukture modulu byt sdilena konfigurace pro pripojeni do db.
02 January 2008, 13:32 by PremekBrada -
Added lines 1-37:
Vývoj je přírůstkový a cca iterativní - co přírůstek to iterace (zatím). Každý přírůstek má well defined cíl a datum dokončení, viz Plan.

!! Bug tracker

[[Určuje náš život -> https://sofa.fav.zcu.cz/bugs/index.php?tasks=all&project=5]] - co do kdy je třeba udělat.

*Leader:*

* Ke každému iteračnímu cíli je definován task s type=Milník a maximálními hodnotami Severity a Priority (aby byl vždycky nahoře :-) . V názvu milníku nechť je stručně uveden cíl a rámcový datum dosažení, viz Plan.
* Všechny tasky, které jsou naplánovány do iterace, mají dle toho nastaveno Due in version. Optimálně by milník měl mít nastavenu dependency na podřízené tasky.

*Vývojáři:*

* si budou aktualizovat "teploměr" u svých tasků.

!! Verzování

Subversion přístupné pres Orion login+heslo na URL -- TBD .

Verzovat se budou, resp. v Subversion repo budou mit separatni top-level
adresare
* jednotlivé moduly

V techto adr uz std subversion struktura.

Nekde by mela v top-level strukture fav modulu maji byt sdilena konfigurace pro pripojeni do db.

*Vývojáři:*

* Při commitu *povinně psát komentáře* !!!
* Po dokončení iterace/přírůstku otagovat příslušné moduly atd.

!! Moduly v OpenCms

Musí mít ve VFS předponu @@cz.zcu.kiv@@ následovanou inteligentním jménem modulu.