Konvence » Historie » Revize 16
Revize 15 (Tomáš Ballák, 2020-04-06 16:19) → Revize 16/23 (Tomáš Ballák, 2020-04-06 16:37)
h1. Konvence
h2. Redmine
* každý si sám za sebe *eviduje strávený čas*, při jeho evidenci *zvýší počet procent* v daném úkolu a *přidá poznámku* k úkolu stručnou informaci o tom, co se řešilo
* *úkoly* může *vytvářet* každý z členů týmu (typicky na začátku na iterace při jejím plánování)
* *společné úkoly* se budou uzavírat až po společné diskuzi s týmem (např. po _Weekly update_ či po jiné schůzi) a teprve poté se budou nastavovat na status *closed*
* úkoly pro menší počet členů může zavírat osoba, která úkol dokončuje
h2. Komunikační kanály
* textová komunikace *mezi členy týmu* probíhá přes *Slack* v různých kanálech (podle tématu), schůzky přes *Hangouts*
* textová komunikace *se zákazníkem a mentorem* se řeší přes *e-mail*, schůzky probíhají přes *Hangouts*
h2. Produkční a testovací prostředí
* k produkčnímu i testovacímu prostředí je možné se přihlásit jen pomocí vlastního *SSH klíče*, detaily jsou uvedeny v sekci [[Deployment]]
* autorizace pomocí hesla není z důvodu bezpečnosti povolena
h2. Repozitář zdrojového kódu
* vzdálený *repozitář zdrojového kódu* vytvářené aplikace je veden na katedrální instanci _GitLab_:
** https://gitlab.kiv.zcu.cz/aswi/aswi-2020/aswi2020sebela
h2. Konvence pro vývoj – IDE, code style
* používané *IDE*: *VSCode*
* použitá rozšíření v IDE:
** *php-intellisense*
*** odkaz: https://marketplace.visualstudio.com/items?itemName=felixfbecker.php-intellisense
*** umožňuje detailnější napovídání při psaní kódu v php
** *phpcs fixer*
*** odkaz: https://github.com/junstyle/vscode-php-cs-fixer
*** hlídá přednastavený standard pro psaní kódu
*** při jeho porušení, sám chyby opraví
* pro vývoj v php, je nastaven striktně standard *PSR-2* viz https://www.php-fig.org/psr/psr-2/
* standard je hlídán při každém @push@ do repozitáře, pomocí gitlab runneru
** při případném porušení tohoto standardu pipepline spadne a nedovolí tak deploy aplikace na produkční server
h3. Standard PSR-2
* staví na *PSR-1*
* odsazování *4 mezery*
* doporučená *délka řádky je 80 znaků*
* po deklaraci @namespace@ a po bloku s @use@ deklaracemi má být *1 prázdná řádka*
* otevírací složené závorky pro @class@ a @function@ musí být na *nové řádce* *NEPOUŽÍVÁME*
* uzavírací složené závorky pro @class@ a @function@ musí být na *nové řádce* za tělem těchto entit
* *viditelnost musí být deklarována* na všech *atributech* a *metodách*
* @abstract@ a @final@ musí být *deklarovány před viditelností*
* kontrolní struktury @if@, @while@, atd. musí mít *za sebou mezery*, *metody* a *funkce* naopak *nesmí*
* otevírací složené závorky *kontrolních struktur musí být na stejné řádce*, uzavírací na *novou řádku* za tělem struktury
* otevírací závorky pro *kontrolní struktury nesmí mít za sebou mezeru*
* uzavírací závorky pro *kontrolní struktury nesmí mít před sebou mezeru*