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
engineswpackage.json - Ember CLI 3.28, instalowany poleceniem
npm install -g [email protected] - Google Chrome do testów
- uruchomiony
apollo/backend, domyślnie pod adresemhttp://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¶
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