Konvence projektu + týmu¶

---

Pravidla týmu¶

• Pro komunikaci používáme platformu Discord
• Weekly standup schůzky se konají pravidelně ve čtvrtek
• Každý zodpovědně vyplňuje strávený čas na storkách - ten, kdo je poslední , storku uzavírá
• Iterace budou dlouhé 2 týdny a začínat/končit budou vždy v pondělí
• Po uzavření iterace (nestanoví-li se jinak) obepisuje mentora/zadavatele vedoucí týmu

Angličtina vs čeština¶

• V angličtině
1. Zdrojový kód
2. Commit message
3. Popisky merge requestů
4. Případné připomínky na Code Review

• V češtině
1. Storky v Redmine
2. Artefakty
3. Dokumentace
4. Komunikace v týmu a s mentory/zadavetelem

GitLab¶

• Branche
1. Projekt obsahuje dvě hlavní branche - dev a main
2. Další větve feature/<num> jsou určeny pro přidávání nových featur do repozitáře
3. Větve bug/<num> slouží k fixování bugů

• Merge requesty + commity
1. Žádný kód nesmí jít přímo do main/dev větve - pro každý commit využíváme merge requesty do dev větve
2. Code Review - každý merge request musí být approvnut jiným členem z týmu
3. Při vytváření merge requestu zvolte alespoň jednoho uživatele , který vám udělá CR
4. Každý merge request by měl obsahovat stručný popis toho, co se do kódu přidalo
5. Každý merge request/commit by měl obsahovat na začátku číslo tasku (pokud není task definován, tak použít např. označení #NoUS - No User Story)
6. Do mainu se merguje až po konci iterace , kdy se demo ukazuje zákazníkovi
7. Každý merge request bude řešit pouze jednu storku - nekombinujme víc věcí dohromady!

• Formát commit message: [#číslo_tasku] Message_co_se_udelalo
• Příklady:
1. [#465465] Created form for selecting data source
2. [#1679684] Fixed issue where data source could be null

• Jak operovat s větvemi?
• Stáhnutí nejnovějších změn :
1. git checkout dev
2. git pull

• Vytvoření merge requestu (jsme ve vetvi nazev_vetve)
1. git add .
2. git commit -m "[#15134] Created new DB schema"
3. git push origin nazev_vetve
4. Přejděte do GitLabu, kde se objeví návrh na nový merge request -> zvolte merge request z vaší větve do větve dev

• Merge z devu do mainu
1. Bude se dělat ručně přes GitLab

• Jak řešit konflikty?
1. Stáhněte si nejnovější verzi devu - git checkout dev a git pull
2. Přejděte do vaší větve , na kterou chcete rebasovat - git checkout vase_vetev
3. Začněte rebasovat - git rebase dev
4. Postupně řešte konflikty a ukládejte vyřešené konflikty pomocí git add . a git commit -m "[#15134] xxx - rebase"
5. Pokračujte pomocí git rebase --continue, dokud nevyřešíte všechny konflikty

• Konvence souborů
1. Pro názvy souborů používáme CamelCase

• Konvence v kódu
1. Pro názvy atributů a metod používáme CamelCase

Redmine¶

Druhy úkolů¶

• Bug
1. Neočekávané chování
2. Neúmyslná chyba

• Enhancement
1. Rozšíření stávajících funkcionalit
2. Optimalizace kódu

• Feature
1. Přidání nové featury

• Task
1. Administrativa
2. Dokumentace
3. Artefakty
4. Analýzy

Druhy aktivit¶

• Analysis - studium, analýza problémů, návrh architektury
• Design - návrh GUI
• Implementation - implementace featur, fixování bugů
• Verification - verifikování požadavků
• Documentation - psaní dokumentací - uživatelské, programátorské, psaní dokumentačních komentářů
• Administrative - vytváření storek, schůzky

Druhy priorit¶

• Low - nejméně prioritní úkol - drobnosti
• Medium - normální úkol - psaní dokumentů, nice-to-have featury
• High - prioritní úkol - schůzky, důležité featury
• Low - nejvíce prioritní úkol - hotfixy, bugy vedoucí k pádu aplikace

Stav úkolů¶

• New - nově vytořený úkol, který ještě nebyl nikomu přiřazen
• Assigned - přiřazený úkol konkrétnímu členovi/členům