# apollo-frontend

Interfejs webowy platformy Apollo dla użytkowników i programistów frontendu. Aplikacja Ember łączy się z API `apollo/backend` i serwuje interfejs przeglądarkowy.

## Stos

| Element | Wartość |
| --- | --- |
| Framework | Ember 3.28, ember-data 3.28 |
| Język | JavaScript, szablony Handlebars, style SASS |
| Uwierzytelnianie | ember-simple-auth |
| Tłumaczenia | ember-intl, pliki z `translations.logintegra.com` |
| Testy | QUnit przez `ember test` |
| Runtime | Node.js 16.20.2, npm 8.19.4 |

## Wymagania

- Git
- Node.js 16.20.2 i npm 8.19.4, zgodnie z `engines` w `package.json`
- Ember CLI 3.28, instalowany poleceniem `npm install -g ember-cli@3.28.4`
- Google Chrome do testów
- uruchomiony `apollo/backend`, domyślnie pod adresem `http://localhost:8090/apollo`

## Uruchomienie

```
git clone git@bitbucket.org:logintegraspzoo/apollo-frontend.git
cd apollo-frontend
npm install
export APOLLO_API_URL='http://localhost:8090/apollo'
ember serve
```

Na Windows adres API ustawia `$env:APOLLO_API_URL='http://localhost:8090/apollo'`.

Aplikacja odpowiada pod adresem `http://localhost:4200`, a testy w przeglądarce pod adresem `http://localhost:4200/tests`. Serwer bez przeładowywania na żywo uruchamia `ember serve --live-reload=false`.

Aplikację w Dockerze buduje `Dockerfile`. Obraz buduje aplikację raz, a przy starcie kontenera `scripts/inject-runtime-env.js` wstrzykuje zmienne środowiskowe. Port kontenera to `4200`.

## Konfiguracja

Konfigurację czyta `config/environment.js` ze zmiennych środowiskowych.

| Zmienna | Znaczenie |
| --- | --- |
| `APOLLO_API_URL` | adres API Apollo, np. `http://localhost:8090/apollo` |
| `WEBSOCKET_URL` | adres STOMP, domyślnie `APOLLO_API_URL` z dopiskiem `/stomp` |
| `TRANSLATIONS_URL` | adres zdalnych tłumaczeń |
| `FRONTEND_ENVIRONMENT` | środowisko Ember, nadpisuje domyślne |
| `SITE_24_KEY` | klucz monitoringu Site24x7 |
| `APOLLO_SITE_24_RUM_ENABLED` | `true` włącza Site24x7 RUM, domyślnie wyłączone |
| `APOLLO_FRESH_WIDGET_ENABLED` | `true` włącza widżet Fresh, domyślnie wyłączone |

## Testy i budowanie

```
ember test
ember test --server
```

```
npx eslint app
npx eslint app --fix
```

```
ember build
ember build --environment production
```

Zmienną `APOLLO_API_URL` ustawiamy przed budowaniem, bo trafia do paczki.

### Styl kodu

Kod formatuje JavaScript Standard Style skonfigurowany przez ESLint. Zasady opisują [StandardJS](<https://standardjs.com/rules.html>) i [eslint-plugin-ember](<https://github.com/ember-cli/eslint-plugin-ember/tree/v10.5.9/docs/rules>). Własne zmiany reguł leżą w węźle `rules` pliku `.eslintrc.js`.

W IntelliJ warto włączyć uruchamianie `eslint --fix` przy zapisie.

### Font Awesome

[Font Awesome](<https://fontawesome.com/>) jest hostowany w repozytorium, bo tego wymagają niektórzy klienci. Aktualizacja polega na podmianie plików w katalogach `vendor/font-awesome` i `vendor/webfonts`. Konfiguracja leży w `index.html`.

## Dokumentacja

Dodatkowe strony leżą w `docs/`. Zasady pracy nad kodem opisuje `CONTRIBUTING.md`.
