Przejdź do treści

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 [email protected]
  • Google Chrome do testów
  • uruchomiony apollo/backend, domyślnie pod adresem http://localhost:8090/apollo

Uruchomienie

git clone [email protected]: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 i eslint-plugin-ember. 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 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.

Ostatnia zmiana: 2026-11-02 · Dariusz Bakowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e