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 markup

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), 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), 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:

2. Verzování v Subversion

to:

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), 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:

  1. 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)
  2. 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
  3. 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:
Testtestovací scénář pro ověření funkčnosti
to:
Testtestovací 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:
Testtestovací 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ů.

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 modulu

to:

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ů.

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:
to:
  • Zapsat se do vývojářského mailing listu
26 February 2010, 17:39 by PremekBrada -
Added line 3:
Changed line 5 from:
to:
Changed lines 83-84 from:

Build modulu

to:

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ů.

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ů.

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:
  • ?
  • ? pro snazší práci při vývoji
to:
26 February 2010, 17:27 by PremekBrada -
Changed lines 11-12 from:

Bug tracker Flyspray na forge.kiv

to:

1. Bug tracker = Flyspray na forge.kiv

Changed lines 46-51 from:

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:

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ů.

  • ?
  • ? 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:
  1. modul se dokončí (dle cíle iterace) na lokálním stroji -> "BETA" tag v Subversion
  2. 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)
  3. 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:
  1. 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)
  2. 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
  3. 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:
  1. 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)
  2. 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:
  1. 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)
  2. 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:

  1. modul se dokončí (dle cíle iterace) na lokálním stroji -> "BETA" tag v Subversion
  2. 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)
  3. 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:
16 March 2009, 13:48 by PremekBrada -
Changed line 5 from:
to:
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 takto:

milníkFlash
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:
Bugjakákoli chyba, ať od uživatele nebo z interních testů
Changed lines 33-34 from:
Bugjakákoli chyba, ať od uživatele nebo z interních testů
to:
Changed lines 39-66 from:
TypeAtributyKomentář
** MILNÍK **seve:critCíl etapy-iterace; má mít nastaven Due in datum i Due in version; má mít přiřazeny dependent tasks
Featureseve:highFunkč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 takto:
milníkFlash
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
  1. 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")
  2. vytvořit milník, přiřadit mu tuto verzi a due date
  3. taskům nastavit priority vzhledem k iteraci dle tabulky výše
  4. assign - napřed genericky "ASWI, PRJ" apod + po vyřešení personálního obsazení týmu přidat konkrétní lidi
to:
TypeKomentář
** 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:CriticalFunkč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:
  1. vytvořit verzi odpovídající cíli iterace
to:
  1. 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
  1. vytvořit verzi odpovídající cíli iterace
  2. vytvořit milník, přiřadit mu tuto verzi a due date
  3. taskům nastavit priority vzhledem k iteraci dle tabulky výše
  4. 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:

Bug tracker

to:

Bug tracker Flyspray na forge.kiv

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:critCí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:critCí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:

Stručně

to:

Stručně

Changed line 5 from:
  • Používat bugtracker a verzování
to:
Changed lines 11-12 from:

Bug tracker

to:

Bug tracker

Changed lines 31-32 from:

Priority záznamů dle RFC 2119

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 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:
to:
Changed lines 17-18 from:

Plánovací tasky:

to:

Vývojáři:

  • si budou aktualizovat "teploměr" u svých tasků, které jsou:
Featureuživatelská funkčnost či vlastnost, nově chtěná
Taskinterní vylepšení, reorganizace kódu, technické úpravy
Bugjaká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

Deleted lines 37-50:
Featureuživatelská funkčnost či vlastnost, nově chtěná
Taskinterní vylepšení, reorganizace kódu, technické úpravy
Bugjaká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

26 January 2009, 11:12 by PremekBrada -
Changed line 19 from:
to:
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:
TypeAtributyKomentář
** MILNÍK **prio:flash,seve:critCíl etapy-iterace; má mít nastaven Due in datum i Due in version; má mít přiřazeny dependent tasks
Featureseve:highFunkč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).

13 May 2008, 18:31 by PremekBrada -
Added line 11:
09 April 2008, 10:40 by PremekBrada - konvence pro opencms moduly přesunuty do ImplementacniKonvence
Changed line 10 from:
to:
Changed lines 13-37 from:

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

to:

Priority záznamů dle RFC 2119

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

milníkFlash
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 - 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:

--MILNÍK--shrnutí cíle etapy (nastavena max Severity a Priority)
Featureuživatelská funkčnost či vlastnost, nově chtěná
Taskinterní vylepšení, reorganizace kódu, technické úpravy
Bugjaká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:
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ě

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

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:

Bug tracker

Changed lines 48-49 from:

Verzování

to:

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 - 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.