RAPORT TESTÓW — CYTUJ.PODZIEL.PL
Wersja: 1.0
Data: 13 lipca 2026
Status: build produkcyjny gotowy do wdrożenia

======================================================================
1. PODSUMOWANIE
======================================================================

Wynik końcowy: ZALICZONO Z OGRANICZENIAMI ŚRODOWISKOWYMI

- 200 publicznych stron;
- 202 pliki HTML łącznie z 404 i offline;
- 82 strony uruchamiające rzeczywistą aplikację;
- 40 narzędzi PL i 40 odpowiedników EN;
- 50 poradników PL i 50 poradników EN;
- 200 wpisów sitemap;
- 200 par w mapie językowej;
- 11 stylów CSL;
- 3 locale CSL;
- 33 testy formatowania styl × locale;
- 5 formatów importu sprawdzonych na produkcyjnym Workerze;
- 31 kontroli w 8 scenariuszach Chromium;
- 0 błędów audytu statycznego;
- 0 błędów konsoli w scenariuszach Chromium.

======================================================================
2. AUDYT STATYCZNY
======================================================================

Zaliczone:
- poprawna składnia i obecność title, description, canonical, hreflang;
- dokładnie jeden H1 na każdej stronie publicznej;
- lang=pl lub lang=en;
- dokładnie jeden identyfikator AdSense na stronie publicznej;
- brak publicznego adresu e-mail i mailto;
- brak strony kontaktowej;
- poprawne linki wewnętrzne;
- unikalne title i description;
- kompletne pary PL/EN;
- sitemap zgodna z liczbą stron publicznych;
- wszystkie poradniki mają co najmniej 750 słów w głównej treści;
- wymagane pliki wdrożeniowe są obecne.

Wynik audytu:
- warnings: 0;
- errors: 0.

======================================================================
3. TESTY SILNIKA CSL
======================================================================

Każdy z 11 stylów sformatowano w locale pl-PL, en-US i en-GB.
Łącznie: 33 przypadki.

Sprawdzone style:
- APA 7;
- MLA 9;
- Chicago 18 Author-Date;
- Chicago 18 Notes and Bibliography;
- ISO 690:2021 Author-Date;
- ISO 690:2021 Numeric;
- IEEE;
- Vancouver / NLM;
- Harvard — SAGE;
- OSCOLA 4;
- AMA 11.

Dla każdego przypadku wymagano niepustego cytowania oraz bibliografii.
Wynik: 33/33 zaliczone.

======================================================================
4. TESTY IMPORTU
======================================================================

Produkcyjny kod Workera uruchomiono w izolowanym środowisku JavaScript.
Sprawdzone formaty:
- BibTeX;
- RIS;
- CSL-JSON;
- CSV;
- TSV.

Każdy parser zwrócił co najmniej jeden rekord z tytułem.
Wynik: 5/5 zaliczone.

======================================================================
5. TESTY CHROMIUM
======================================================================

Wykonano 8 osobnych scenariuszy w prawdziwym Chromium:
1. strona główna i generator;
2. import CSL-JSON;
3. kontrola bibliografii;
4. wykrywanie duplikatów;
5. eksport DOCX;
6. menedżer bibliografii;
7. angielski generator APA;
8. widok mobilny 390 × 844 px.

Potwierdzono między innymi:
- rzeczywisty wynik cytowania APA;
- rzeczywisty wpis bibliograficzny;
- zmianę wyniku po przełączeniu APA na MLA;
- lokator strony;
- cytowanie narracyjne;
- ręczne dodanie książki;
- import rekordów;
- aktywne presety kontroli, duplikatów i bibliografii;
- wykrycie pewnego duplikatu;
- pobranie DOCX;
- integralność DOCX jako pakietu OOXML;
- trzy przykładowe źródła w menedżerze;
- angielski interfejs i wynik;
- brak poziomego przepełnienia na szerokości 390 px;
- brak błędów konsoli.

Wynik: 31/31 kontroli zaliczonych.

W czasie testu wykryto i poprawiono błąd delegacji kliknięć: konfiguracja
`data-tab` na głównym kontenerze przechwytywała działania przycisków.
Kod zmieniono tak, aby obsługiwał wyłącznie przyciski w `.app-tabs`.
Po poprawce ponownie zaliczono import i eksport DOCX.

======================================================================
6. DOCX
======================================================================

Plik testowy: Cytuj_Test_Bibliografia.docx
Rozmiar: 2819 bajtów.

Potwierdzone elementy:
- [Content_Types].xml;
- _rels/.rels;
- docProps/app.xml;
- docProps/core.xml;
- word/document.xml;
- word/styles.xml;
- word/_rels/document.xml.rels.

Wynik: pakiet ZIP/OOXML integralny.

======================================================================
7. SKŁADNIA I DANE
======================================================================

- citation-app.js: node --check zaliczony;
- import-worker.js: node --check zaliczony;
- site.js: node --check zaliczony;
- service-worker.js: node --check zaliczony;
- 22 pliki JSON poprawnie sparsowane.

======================================================================
8. OGRANICZENIA TESTÓW
======================================================================

Środowisko wykonawcze blokowało nawigację Chromium do localhost oraz file://.
Nie przedstawiam więc testu lokalnego HTTP jako zwykłego testu produkcyjnej domeny.

Zastosowano kontrolowane ładowanie prawdziwego produkcyjnego HTML, CSS, JS,
stylów CSL i locale do Chromium. Z powodu syntetycznego originu:
- kod produkcyjnego Workera przetestowano osobno w izolowanym runtime;
- integrację importu w Chromium sprawdzono z kontrolowanym Workerem testowym;
- trwałego IndexedDB nie zaliczono jako testu produkcyjnego;
- Service Workera nie zaliczono jako testu produkcyjnego.

Nie wykonano w środowisku końcowego testu:
- instalacji PWA przez prawdziwe HTTPS;
- trwałości IndexedDB po ponownym otwarciu domeny;
- Google AdSense i Google CMP z prawdziwymi odpowiedziami sieciowymi;
- Crossref, DataCite i Open Library z poziomu wdrożonej domeny;
- nagłówków `.htaccess` na serwerze Apache DreamHost.

======================================================================
9. TESTY WYMAGANE PO WDROŻENIU HTTPS
======================================================================

1. Otworzyć / i /en/.
2. Zapisać projekt lokalnie, odświeżyć stronę i ponownie go wczytać.
3. Zaimportować BibTeX oraz RIS przez prawdziwy Web Worker.
4. Pobrać DOCX, RTF, BibTeX, RIS i projekt Cytuj.
5. Użyć poprawnego DOI oraz ISBN.
6. Sprawdzić zachowanie dla 404, 429 i braku wyniku API.
7. Zainstalować PWA i sprawdzić ręczne formatowanie offline.
8. Sprawdzić aktualizację Service Workera.
9. Zweryfikować nagłówki CSP, cache, HTTPS i 404.
10. Uruchomić Google CMP dla EOG i sprawdzić reklamy bez CLS.
11. Sprawdzić Safari iOS oraz Chrome Android na fizycznych urządzeniach.

======================================================================
10. WNIOSEK
======================================================================

Build jest spójny, kompletny i gotowy do wdrożenia na DreamHost.
Funkcje lokalne, formatowanie CSL, importy, kontrola jakości, duplikaty,
wersja PL/EN, responsywność oraz eksport DOCX mają reprezentatywne testy.
Elementy zależne od prawdziwego originu HTTPS i usług zewnętrznych należy
sprawdzić według listy po wdrożeniu.
