itbees-prawko-shared

Kod wspólny ZdamyPrawko: klient API (api/ i generowany fas-gen/), modele, odtwarzacz filmów z obsługą błędów, zegary egzaminu, komponenty pytań i kategorii, usługi (urządzenie, auth, pytania). To jest jedyne źródło tego kodu: aplikacja ZdamyPrawko (src/) kompiluje go wprost ze źródeł (alias itbees-prawko-shared w tsconfig.json), a strona egzaminu wewnętrznego (egzaminWewnetrzny) z pakietu npm zbudowanego stąd.

Konfiguracja wymagana od aplikacji

| Co | Jak | | --- | --- | | adres API | ApiModule.forRoot({ rootUrl }) albo { provide: ApiConfiguration, useValue: { rootUrl } }; generowane usługi fas-gen czytają go przez token API_URL (domyślnie z ApiConfiguration) | | adres serwera mediów | { provide: MEDIA_URL, useValue: environment.mediaUrl } | | zgłaszanie problemu z filmem | opcjonalnie { provide: VIDEO_PROBLEM_REPORTER, useClass: ... }; bez providera odtwarzacz otwiera własny dialog, który wysyła opis na POST {rootUrl}/IssueReport | | teksty | klucze general.video.* (odtwarzacz) w plikach i18n aplikacji | | style | node_modules/video.js/dist/video-js.css w styles aplikacji; partiale SCSS leżą w src/lib/styles (include path w angular.json) |

Odtwarzacz (app-video-player)

Zdarzenia: videoPlaybackInitiated, videoEnded, videoError (film nie wczytał się), videoStalled (słabe łącze), videoRecovered (odtwarzanie wróciło), reportProblem. Wejścia: videoOptions, videoDelay, isCounterDisplay, reportContext, reportProblemEnabled. Sam ponawia play() zgubione przez video.js, ponawia po powrocie online i oferuje „Spróbuj ponownie” oraz „Zgłoś problem”.

Pamięć podręczna mediów (MediaCacheService)

Pobiera całe pliki (filmy, zdjęcia) do pamięci i wydaje je jako adresy blob:, żeby wyświetlenie pytania nie zależało od łącza. Stanowisko egzaminu wewnętrznego wypełnia ją przed pierwszym pytaniem i dopiero potem uruchamia zegary:

const run = mediaCache.preload(questionMediaUrls(questions, mediaService, videoService));
run.progress$.subscribe((p) => ...);   // total, cached, failed, fraction 0–1, stalled, finished
await run.finished;                    // nigdy nie odrzuca; run.cancel() przerywa pobieranie

• VideoService.setVideo sam stawia kopię z cache przed źródłami sieciowymi (pole cachedFrom), app-question-details bierze z niej zdjęcia. Czego w cache nie ma, ładuje się po staremu z serwera.
• VideoService.preloadUrl zwraca adres tego formatu filmu, który odtworzy dana przeglądarka (pierwsze źródło przechodzące canPlayType) — tylko ten jest pobierany.
• Pliki idą po kilka naraz, w podanej kolejności, z pominięciem pamięci HTTP przeglądarki (cache: 'no-store'): kopia zostawiona tam przez zwykłe <img>/<video> nie ma nagłówków CORS i blokowałaby fetch. Zerwane albo zamilkłe połączenie, niedostępny serwer i błędy 5xx są ponawiane do skutku. Pomijany jest plik odrzucony przez serwer (4xx) oraz taki, którego strona nie może odczytać, choć przeglądarka umie go pokazać jako zwykłe zdjęcie lub film (brak CORS, trzy próby z rzędu) — czekanie nic tu nie zmieni, a odtwarzacz załaduje go sam.
• Adres pliku jest stały przez cały czas działania aplikacji: MediaService czyta rozmiar ekranu raz (powiększenie strony w przeglądarce zmienia devicePixelRatio, a cache szuka po adresie).
• Postęp (fraction) liczony jest w bajtach z Content-Length; nieznany jeszcze rozmiar pliku szacowany jest po plikach tego samego rodzaju (ta sama ścieżka serwera).
• Cache trzyma jeden zestaw plików: kolejne preload zwalnia pliki spoza nowej listy, clear() wszystko.
• Serwer mediów musi wysyłać nagłówki CORS (origin i serwery satelitarne je wysyłają).

Budowanie i publikacja

ng build itbees-prawko-shared          # -> dist/itbees-prawko-shared
ng build itbees-prawko-features        # kompiluje się przeciw dist/itbees-prawko-shared
ng test itbees-prawko-shared --watch=false --browsers=ChromeHeadless
cd dist/itbees-prawko-shared && npm publish

Wersję podnosi się w projects/itbees-prawko-shared/package.json; peer dependencies obejmują Angular 17–21, PrimeNG 17, Capacitor 6–8. Generator klienta API ma teraz pisać do projects/itbees-prawko-shared/src/lib/fas-gen (dawniej src/fas-gen); plik fas-gen/models/api-url.token.ts jest edytowany ręcznie (domyślna wartość tokenu).