Slovníček

výkaz - report
oddíl - section

Změna repa

Aplikaci bylo nutné jednou přejmenovat. Pro aktualizaci gitu použijte příkaz:

git remote set-url origin [email protected]:MichalLauer/MSMTProhlizec.git

Cíl a uživatel

Aplikace slouží primárně pro členy ministerstva. Měla by být jednoduchá, intuitivní a celá v češtině.

Kód, komentáře

Kód se snaží udržet styl. Kód je nutné psát česky.

Data

Nyní se pracuje s daty, které jsou uložené na Teamsech v týmu Analytický útvar, dále v kanále a souborech...

KA 4 - Vybudování datové základny/
└── KA4 C Propojenost a systemizace získávání a ukládání dat...
    └── 7. Datový model školy/
        └── Datový model – zpracované/
            └── Oddíly/

Předpříprava

V případě, že je nutné připravit data z .xlsx do .json/.parquet, je nutné stáhnout data do data-input/vykazy a dále pokračovat podle skriptu load_report_map.R

Mergování

Branch main je protected a nejde do ní pushnout, jelikož je napojená přímo na deploy, je to tedy produkční verze. Všechny pushe musí být do branche dev, která obsahuje testovací verzi. Zde také musí projít všechny testy z Github Actions.

main - production, protected branch
└── dev - development
    └── issue-XX - fix for issue XX
    └── issue-YY - fix for issue YY

Této metodologii se říká git flow, a tento repo používá jeho zjednodušenou verzi.

Deploy

Aplikace je prozatím zde. Po prvním kliknutí je nutné nějakou dobu počkat, jelikož se aplikace musí nastartovat a občas můžou naskočit chybové hlášky. V těchto případech stačí stránku aktualizovat.

CI/CD

Po pushy na branch dev se spustí testy pomocí /.github/workflows/test.yml. Když jsou všechny test OK, lze mergovat dev -> main. S každým novým pushem do branche main se spouští /.github/workflows/deploy.yml a aplikace na webu je aktualizovaná.