akademiawodociagowca/DEPLOYMENT_CHECKLIST.md

Test odbiorczy po wdrozeniu

Lista do wykonania w podanej kolejnosci po uruchomieniu instancji u klienta. Kazdy punkt ma oczekiwany wynik: jesli sie nie zgadza, nie przechodz dalej, bo kolejne punkty na nim polegaja.

Czas wykonania calosci: okolo 90 minut, plus czekanie na przypomnienia i na podsumowanie (do dwoch godzin, mozna w tle).

Wszystkie punkty wykonuje sie przy WLACZONYM trybie bezpiecznym wysylki, poza sekcja I, ktora ten tryb celowo wylacza na koniec. Dzieki temu zadna wiadomosc z testow nie trafi do prawdziwych ludzi.

---

A. Przed uruchomieniem

#	Czynnosc	Oczekiwany wynik
A1	cp .env.production.example .env.production i uzupelnic	plik istnieje, chmod 600
A2	./scripts/check-config.sh --skip-db	Konfiguracja w porzadku, kod wyjscia 0
A3	Sprawdzic DNS domeny: dig +short webinary.klient.pl	adres IP serwera
A4	Sprawdzic certyfikat SSL na reverse proxy klienta	waznosc powyzej 14 dni
A5	Porty otwarte na firewallu: 80, 443	dostepne z internetu
A6	Przy VIDEO_PROVIDER=LIVEKIT: dodatkowo 7880, 7881 TCP oraz port UDP 7882 (tryb mux, jeden port dla wszystkich)	dostepne z internetu

A6 jest najczestszym przeoczeniem. Bez otwartego zakresu UDP uczestnicy wchodza do pokoju i widza liste obecnych, ale sie nie slysza. Objaw wyglada jak awaria aplikacji, a jest regula firewalla.

---

B. Uruchomienie

#	Czynnosc	Oczekiwany wynik
B1	docker compose -f docker-compose.prod.yml --env-file .env.production up -d	wszystkie kontenery Started
B2	docker compose -f docker-compose.prod.yml ps	postgres i minio healthy, backend healthy (do 90 s)
B3	docker compose logs backend | grep "KONFIGURACJA INSTANCJI" -A 20	wypis stanu, Brak ostrzezen konfiguracyjnych
B4	curl -s https://webinary.klient.pl/api/health	{"status":"UP",...}
B5	./scripts/check-config.sh (juz bez --skip-db)	kod wyjscia 0

Jesli B3 pokazuje ostrzezenia, przeczytaj je: kazde nazywa skutek, nie ustawienie. Ostrzezenie o wylaczonym trybie bezpiecznym na tym etapie oznacza, ze testy ponizej wysla prawdziwe wiadomosci.

#	Czynnosc	Oczekiwany wynik
B6	docker compose logs backend | grep -i "haslo administratora"	jednorazowe haslo (gdy ADMIN_PASSWORD bylo puste)
B7	Zalogowac sie na /logowanie i od razu zmienic haslo	wejscie do /panel, haslo zmienione

---

C. Konfiguracja przez panel

Poczta i bramka SMS nie sa w .env: ustawia sie je w panelu, bo zmiana nie moze wymagac dostepu do serwera.

#	Czynnosc	Oczekiwany wynik
C1	Ustawienia -> E-mail: host, port, login, haslo, nazwa nadawcy	zapisane
C2	Sprawdzic, ze MAIL_SAFE_MODE jest wlaczony i ma adres zastepczy	wlaczony, adres wlasny
C3	Ustawienia -> E-mail -> Test wysylki	wiadomosc dociera na adres zastepczy
C4	Ustawienia -> Aplikacja: nazwa marki, adres publiczny, strefa czasowa	zapisane
C5	Ustawienia -> Grafika: logo i ikona	widoczne w panelu i na stronie glownej
C6	Ustawienia -> Zgody: tresc regulaminu i zgod marketingowych	zapisane, CONSENT_VERSION ustawiona
C7	Przy uzyciu SMS: Ustawienia -> SMS, klucz bramki, tryb bezpieczny wlaczony	test SMS dociera na numer zastepczy

---

D. Sciezka webinarowa

#	Czynnosc	Oczekiwany wynik
D1	Panel -> Webinary -> nowy: tytul, termin w przyszlosci, limit miejsc	zapisany jako DRAFT
D2	Dodac tresc strony w edytorze, wgrac obrazek	obrazek widoczny w podgladzie
D3	Opublikowac webinar	status PUBLISHED
D4	Otworzyc /w/{slug} w oknie prywatnym	strona z trescia i formularzem zapisu
D5	Zapisac sie z wlasnego adresu, zaznaczyc zgody	ekran potwierdzenia
D6	Sprawdzic skrzynke	mail potwierdzajacy z dzialajacym linkiem i zalacznikiem invite.ics
D7	Otworzyc invite.ics w kalendarzu	wydarzenie z poprawna data i strefa
D8	Kliknac link z maila	strona wlasnego zapisu, widoczny przycisk rezygnacji
D9	Panel -> lista zapisanych	wpis widoczny, zgody z wersja i data
D10	Eksport CSV listy zapisanych	plik otwiera sie w Excelu, polskie znaki poprawne
D11	Dodac regule przypomnienia na za 5 minut i odczekac	przypomnienie dociera (na adres zastepczy)
D12	Wejsc na /spotkanie/{token} z linku	przedpokoj z tytulem i imieniem do potwierdzenia
D13	Wejsc na sale, wyslac wiadomosc na czacie	wiadomosc widoczna, autor jako imie i inicjal
D14	Zadac pytanie i zaglosowac na nie z drugiej przegladarki	licznik glosow rosnie o 1, drugi glos tej samej osoby odrzucony
D15	Panel prowadzenia: zatwierdzic pytanie	pytanie pojawia sie u uczestnika
D16	Zglosic sie do zabrania glosu, przyznac glos z panelu	mikrofon uczestnika dziala
D17	Zakonczyc webinar, zmienic termin na przeszly, odczekac SUMMARY_DELAY_MINUTES	podsumowanie dociera raz, nie dwa razy
D18	Wystawic certyfikat uczestnikowi z odnotowana obecnoscia	PDF z polskimi znakami w nazwisku
D19	Otworzyc /certyfikat/{numer} w oknie prywatnym	weryfikacja pokazuje numer, tytul, imie z inicjalem, bez adresu e-mail

D18 jest krytyczny. Certyfikat z polamanym nazwiskiem jest bezuzyteczny, a blad osadzania czcionki widac wylacznie na gotowym pliku.

---

E. Sciezka Akademii

#	Czynnosc	Oczekiwany wynik
E1	Otworzyc / w oknie prywatnym	strona glowna Akademii, przycisk Zaloguj sie
E2	Panel -> Kursy -> nowy kurs z modulem i lekcja wideo	zapisany jako DRAFT
E3	Wgrac nagranie lekcji, ustawic dlugosc	plik widoczny
E4	Opublikowac kurs, ustawic cene	widoczny na /kursy
E5	Zarejestrowac konto kursanta na /rejestracja	mail z linkiem potwierdzajacym
E6	Potwierdzic adres z linku	konto aktywne, wejscie na /moje-konto
E7	Zapisac sie na kurs darmowy	dostep od reki, kurs na pulpicie
E8	Otworzyc odtwarzacz, obejrzec lekcje do konca	lekcja oznaczona jako ukonczona, postep rosnie
E9	Przewinac nagranie w polowie	przewijanie dziala (naglowek Range)
E10	Dodac quiz do lekcji, rozwiazac go jako kursant	wynik policzony, poprawne odpowiedzi nie sa widoczne w zrodle strony przed koncem
E11	Ukonczyc wszystkie lekcje wymagane	kurs COMPLETED, certyfikat wystawiony automatycznie
E12	Sprawdzic mail o ukonczeniu	zalacznik PDF, dzialajacy link do pulpitu
E13	Panel -> Kursanci -> szczegoly	postep, zgody z historia, ostatnia aktywnosc
E14	Zalogowac sie adresem majacym konto w obu swiatach	ekran wyboru: Moje konto i Panel

---

F. Czego NIE DA SIE sprawdzic lokalnie

Te punkty musza zostac wykonane po wdrozeniu, bo lokalnie nie ma jak ich przejsc. Kazdy z nich to droga, ktora dotad nie zostala przebyta end-to-end.

F1. Notyfikacja ITN Autopay

Operator laczy sie z naszym serwerem, wiec wymaga publicznej domeny z waznym certyfikatem. Na localhost nie da sie tego wywolac.

Krok	Oczekiwany wynik
Ustawic AUTOPAY_MODE=TEST, ServiceID i klucz ze srodowiska testowego operatora	Autopay: konfiguracja kompletna w wypisie startowym
Zamowic kurs platny jako kursant	przekierowanie na bramke testowa
Zaplacic karta testowa operatora	powrot na /kurs/{slug}/platnosc
Odczekac na ITN (do kilkudziesieciu sekund)	strona sama pokazuje nadany dostep
Panel -> Zamowienia	status PAID, w dzienniku wpis notyfikacji
Powtorzyc notyfikacje z panelu operatora	dostep nadany raz, drugi komunikat potwierdzony bez zmiany
Sprobowac zaplacic kwota inna niz w zamowieniu	notyfikacja odrzucona, wpis w dzienniku

Dopiero po przejsciu wszystkich krokow przelaczyc AUTOPAY_MODE=PRODUCTION. Wypis startowy pokaze wtedy ostrzezenie o prawdziwych pieniadzach: to jest oczekiwane i ma zostac zauwazone.

F2. Nagrywanie przez Egress

Lokalnie proces zatrzymywal sie na tym, ze szablon nie subskrybowal zadnej sciezki: do domkniecia potrzebny jest publikujacy uczestnik w tej samej sieci co Egress, czego nie da sie zestawic na Docker Desktop przy jednym NODE_IP.

Krok	Oczekiwany wynik
docker compose ... --profile livekit up -d	cztery kontenery wideo dzialaja
docker compose logs livekit-egress | head -30	polaczenie z Redisem, brak bledow ICE
Zestawic spotkanie z dwoma uczestnikami, jeden publikuje obraz	obraz i dzwiek plyna w obie strony
Uruchomic nagrywanie z panelu prowadzenia	wpis w recordings ze statusem DOWNLOADING
Zakonczyc nagrywanie, odczekac	status READY, plik w MinIO
Odtworzyc nagranie z panelu, przewinac	odtwarza sie i przewija

Gdy nagrywanie nie ruszy: reczne wgranie pliku dziala i jest droga awaryjna. Nie blokuje to wdrozenia.

F3. Webhook dostawcy wideo

Krok	Oczekiwany wynik
Ustawic VIDEO_WEBHOOK_SECRET w panelu i ten sam sekret u dostawcy	zapisane
Wywolac zdarzenie u dostawcy (zakonczenie nagrania)	wpis w logu backendu, odpowiedz 200
Wyslac zadanie z blednym sekretem: curl -X POST .../api/webhooks/video/livekit -d '{}'	404, nie 403

Odpowiedz 404 jest celowa: 403 pozwalalaby sprawdzic, ktore webinary istnieja.

F4. Zajawki w komunikatorach

Wymagaja publicznego adresu: robot musi pobrac strone z internetu.

Krok	Oczekiwany wynik
Wkleic https://webinary.klient.pl/w/{slug} na Slacku albo Facebooku	zajawka z tytulem webinaru i opisem
curl -A "facebookexternalhit/1.1" https://webinary.klient.pl/w/{slug}	HTML z og:title zawierajacym tytul
To samo dla webinaru w stanie DRAFT	404, wersje robocze nie moga wyciekac

F5. Poczta wychodzaca do prawdziwych odbiorcow

Krok	Oczekiwany wynik
Sprawdzic rekordy SPF i DKIM domeny nadawcy	skonfigurowane
Wyslac test na adres w Gmailu i w Outlooku	wiadomosc nie trafia do spamu
Sprawdzic naglowki dostarczonej wiadomosci	SPF pass, DKIM pass

---

G. Kopia zapasowa

#	Czynnosc	Oczekiwany wynik
G1	./scripts/backup.sh	katalog w ./backups, pliki baza.dump i minio.tar.gz niepuste
G2	Sprawdzic INFO.txt w kopii	data, nazwa bazy, wersja obrazu
G3	Dodac wpis do crontab (patrz README)	crontab -l pokazuje wpis
G4	Odtworzyc kopie na maszynie testowej, nie na produkcji	dane zgodne ze stanem z chwili kopii

G4 jest obowiazkowy. Kopia, ktorej nigdy nie odtworzono, nie jest kopia zapasowa, tylko plikiem o nieznanej zawartosci.

---

H. Bezpieczenstwo

#	Czynnosc	Oczekiwany wynik
H1	curl -s https://webinary.klient.pl/api/admin/webinars	401, nie lista
H2	nmap -p 5432,9000,9001 webinary.klient.pl	porty zamkniete z internetu
H3	Otworzyc /swagger-ui.html	404 albo 403 (SWAGGER_ENABLED=false)
H4	Zalogowac sie 6 razy blednym haslem	blokada po 5 probie, komunikat taki sam jak przy zlym hasle
H5	Sprobowac pobrac certyfikat cudzym tokenem zapisu	404
H6	Sprawdzic /api/public/config	wylacznie nazwa marki, adres i strefa, zadnych sekretow

---

I. Przelaczenie na ruch produkcyjny

Dopiero po przejsciu wszystkich punktow powyzej.

#	Czynnosc	Oczekiwany wynik
I1	Skasowac dane testowe: webinary, kursy, zamowienia, kontakty testowe	listy puste albo z prawdziwymi danymi
I2	Nie kasowac app_settings ani konta administratora	konfiguracja zachowana
I3	Ustawienia -> E-mail: wylaczyc MAIL_SAFE_MODE	zapisane
I4	Przy uzyciu SMS: wylaczyc SMS_SAFE_MODE	zapisane
I5	Zrestartowac backend i przeczytac wypis startowy	ostrzezenie o wylaczonym trybie bezpiecznym: oczekiwane
I6	Wyslac jedna prawdziwa wiadomosc testowa do siebie	dociera na wlasciwy adres
I7	./scripts/backup.sh na czysto	kopia stanu wyjsciowego

Po I3 kazda wysylka idzie do prawdziwych odbiorcow. Od tego momentu dane testowe z terminem w przeszlosci moga uruchomic scheduler i wyslac wiadomosci do osob z bazy: dlatego I1 jest przed I3, a nie po.