Konvence¶

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

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

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

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

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, více na Deployment

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