KSeF RAYO 2.0.36 — archiwum dokumentów i kopie zapasowe

INSTALACJA
Istniejąca instalacja: opublikuj zawartość PACZKA_PUBLIKACYJNA.zip w katalogu
updates serwera licencji (ZIP klienta, manifest.json, SHA256). Uruchom aktualizację
w aplikacji i ponownie uruchom program. To wydanie nie wymaga zmiany aplikacji serwera.
Nowy komputer: użyj CZYSTA_INSTALACJA.zip, nie kopiuj starego środowiska .venv.
Przed aktualizacją zachowaj dotychczasową instalację i dane.

NOWOŚCI
1. Przyjęcie w dniu P_1: „Przesłana w dniu wystawienia”. Nie sugeruje użycia offline24.
   Pozostałe komunikaty są oceną dat względem terminu odniesienia, nie wyborem trybu.
2. Interwały inbox / monitor zapisują się po Enter lub opuszczeniu pola.
   Inbox: 5–86400 s, monitor: 60–86400 s. Zmiana od kolejnego oczekiwania.
3. Operacje > Archiwum i kopie zapasowe: wybierz katalog archiwum.
   Co minutę program kopiuje do 100 przyjętych rekordów z numerem KSeF i ścieżką UPO.
   Starsze faktury są uzupełniane partiami. Błędy są w logu; kolejna próba po godzinie.
   Dokument bez UPO nie jest jeszcze kompletnym kandydatem do archiwum.
   Oryginały pozostają na miejscu. Nie zmieniamy XML ani UPO.
   Układ: firma-ID / NIP / oddział / rok / miesiąc / numer-KSeF.
   Data folderu: P_1, a dla starszych wpisów bez P_1 data dodania rekordu.
   Zawartość: faktura.xml, upo.xml, metryka.json, historia.json, sha256.json.
   Historia zawiera nagłówki zdarzeń z chwili archiwizacji; bez treści z tokenami/URL.
   Ten sam numer KSeF w tym samym folderze nie tworzy kolejnej kopii; inny XML
   powoduje alarm konfliktu. Nie scala ani nie usuwa rekordów wysyłek w bazie.
   Archiwum jest zapisywane jako niezmienny pakiet przez aplikację; to nie nośnik WORM.
4. Wyszukaj fakturę filtrami głównej tabeli i zaznacz wiersz. W oknie archiwum:
   „Sprawdź / archiwizuj” weryfikuje pliki i SHA256; „Eksportuj” tworzy ZIP dokumentu.
   Istniejące przyciski podglądu faktury/UPO pozostają dostępne.
   Archiwum nie generuje dodatkowego PDF; podstawą są oryginalny XML i UPO.

BACKUP
W oknie archiwum wybierz katalog na innym urządzeniu dla codziennej kopii.
Program musi być uruchomiony: pierwsza kontrola po minucie od startu, następnie
raz dziennie po udanym backupie; błędy ponawiane nie częściej niż co godzinę.
Można też wykonać kopię ręcznie. Wynik jest w logu, data ostatniego sukcesu w oknie
(po ponownym otwarciu). Stare kopie nie są automatycznie kasowane.
Kopia obejmuje:
- spójny snapshot SQLite przez API backup i kontrolę integralności;
- XML/UPO zarejestrowanych faktur oraz pliki pobranych faktur wskazane w bazie;
- zarejestrowane pakiety archiwum;
- wskazane w profilach certyfikaty/klucze, klucz szyfrowania profili;
- istniejące .env, ustawienia interwałów, cache licencji i identyfikator instalacji.
Brak wskazanego dokumentu/certyfikatu powoduje błąd, a nie pozornie udany backup.
ZIP ma sumy SHA256 i jest sprawdzany przed uznaniem go za kompletny.
Backup zawiera poufne dane i klucze. ZIP nie jest szyfrowany — wybierz dysk/katalog
z ograniczonym dostępem, najlepiej szyfrowany. Eksport jednej faktury nie zawiera kluczy.

OGRANICZENIA KOPII
Nie jest to kopia całego KOMPLEKSU: nie obejmuje RV.DBF/RV.CDX, inbox oczekującego
na import, kolejki RV, niezarejestrowanych plików ani wszystkich PDF/logów na dysku.
Te katalogi należy objąć osobnym backupem stanowiska/serwera.
Nie jest to transakcyjny snapshot równoczesnych zmian wszystkich plików zewnętrznych.
Archiwum dotyczy przyjętych faktur wychodzących; pobrane faktury obejmuje backup.

ODTWARZANIE
„Sprawdź i odtwórz kopię do nowego katalogu” sprawdza ZIP/SHA256, SQLite i wypakowuje
nowy podkatalog ODTWORZONO_... . Nie zastępuje żadnej działającej instalacji.
database.sqlite3: oryginalny snapshot.
database_preview.sqlite3: ścieżki dokumentów do odtworzonego katalogu, automatyzacja
oraz zgoda na wysyłanie produkcyjne wyłączone. Przeczytaj ODTWARZANIE.txt.
Przełączenie instalacji wymaga zamknięcia programu, zachowania obecnej bazy,
odtworzenia klucza company_profiles.key i konfiguracji według manifest.json oraz
sprawdzenia ścieżek KOMPLEKS, mapowania dysków i licencji. Nie uruchamiaj równolegle
dwóch automatów dla tej samej firmy. Numer KSeF i stan historycznych wysyłek zachowane.

WERYFIKACJA WYDANIA
68 testów automatycznych, w tym 8 nowych: duplikat, konflikt, brak pliku,
uszkodzenie/niebezpieczna ścieżka ZIP, backup/odtworzenie i zachowanie bieżącej bazy,
zmiana katalogu, ponawianie błędów, ustawienia i komunikat tej samej daty.
Kompilacja modułów i kontrola paczek ZIP. Testy używają atrap niektórych zależności;
nie zastępują testu GUI na Windows, dostępu SMB i antywirusa na stanowisku klienta.
