SEED APP - frontend

Prerekvizity

• GIT - testovaná verze 2.10.2
• NODE - testovaná verze 6.9.1

Příprava projektu

• Udělejte si git clone této repozitory a přesuňte se do adresáře projektu
• Ujistěte se, že máte nainstalován node.js (node --version)
• Spusťte npm install -g webpack webpack-dev-server typescript pro instalaci globálních závislostí
• Spusťte npm install -g karma-cli protractor pro instalaci globálních testovacích závislostí
• Přidejte si do souboru .npmrc v projektu řádku registry=https://kb-fast1.f-app.it/nexus/repository/npm-fast-group/ (pozor, nikoliv .npmrc.txt)

echo "registry=https://kb-fast1.f-app.it/nexus/repository/npm-fast-group/" > .npmrc

• Spusťte npm install pro instalaci závislostí pro běh aplikace
• Spusťte npm run init-conf pro vytvoření devel konfigurace projektu (více viz config module)
• Pokud chcete z tohoto seed projektu vytvořit nový projekt, pak spusťte npm run init z rootu projektu a zadávejte údaje dle pokynů (více viz. init)
• Spusťte npm start pro naběhnutí aplikace v DEV režimu
• Otevřete prohlížeč na http://localhost:8080

Tasky (build a běh aplikace)

• npm start - spuštění aplikace v DEV režimu
• npm test - spuštění testů a coverage analýzy
• npm run e2e - spuštění e2e testů (vyžaduje Javu a Chrome)
• npm run build:prod - pro přípravu souborů pro produkční nasazení
• npm run docs

Tasky (CI)

• npm run jenkins vytvoří joby v Jenkinsu (více viz jenkins)

Tasky (validace)

• npm run sonar pro spuštění analýzy souborů na chyby

Tasky (release)

• npm run bump [--major⎮--minor⎮--patch] - pro zvednutí verze projektu při verzování major.minor.patch, default patch
• npm run gulp bump-push-[develop|master] - pro otagování stávající verze a pushunutí inkrementu verze pro další vývoj do git repozitory
• npm run gulp maven:deploy:[develop|master] pro výrobu balíku z větve a nahrání do maven repozitory

Důležité adresáře a soubory

• config/ - nastavení konfigurace buildu pro různé prostředí
• dist/ - distribuovatelné aplikační zdroje
• gulp/ - tasky nástroje gulp
• node_modules/ - lokální repozitory aplikačních a vývojových modulů
• reports/ - generované reporty z testů a sonar validací
  • coverage/html/ - html stránky s vizualizací pokrytí kódu testy
• src/ - zdrojové soubory aplikace
  • app/ - aplikační kód
    • styles/ - obsahuje soubory pro stylování (logika načítání je v main.scss)
  • assets/ - doplňující zdroje jako css, i18n, obrázky
  • index.html - vstupní stránka aplikace
  • main.ts - vstupní bod aplikace
• package.json - konfigurace metadat projektu, skriptů a závislostí
• tslint.json - konfigurace validací prováděných nad typescript soubory

Časté problémy a otázky

Procesy

• build

Moduly, které projekt obsahuje

• config
• logging
• mock api
• lokalizace
• item
• core
• shared

Poznámky pro vývojáře

• Promises vs Observables