Soft-delete (kosz): co jest kasowane miękko, a co nie¶
Dla kogo
Strona dla dewelopera i agenta AI. Opisuje stan po skonsolidowanym PR
„Soft delete (kosz)" (zastępuje stos #312 → #745 → #755 → #767 → #792)
i decyzje właściciela projektu z listopada 2026. Historia faz (plany,
handoffy, recenzje) została na gałęzi feat/soft-delete-06 — tutaj jest
stan docelowy, nie kronika.
Zasady (w skrócie)¶
- Kosz jest zamrożony w bazie. Trigger
bpp_kosz_straznik(BEFORE UPDATE OR DELETE, migracja0523) na każdej tabeli z koszem: zmianadeleted_at, jakikolwiekUPDATEwiersza w koszu i fizycznyDELETEwiersza w koszu są odrzucane, chyba że transakcja ustawiłabpp.kosz_operacja = 'on'— robi to wyłącznieoperacja_kosza()wdelete()/restore()/hard_delete(). Nieaktualna instancja nie „wskrzesi" rekordu,deleted_objects.update()ani surowy SQL nic nie zmienią. Błąd ma prefiksBPP_KOSZ:; admin tłumaczy go na komunikat. Wyjątek: zmiany robione przez inne triggery (dane wyliczane). - Worker PBN sprawdza stan w chwili wysyłki. Pod blokadą tuż przed rozmową z PBN czyta rekord od nowa: wysyłka rekordu z kosza i wycofanie rekordu żywego kończą się bez wysyłania („rekord w koszu" / „rekord przywrócony").
- Jedna reguła kolejki PBN, bez wyjątków. Rekord z JAKIMKOLWIEK
niezakończonym wpisem kolejki (czeka, podjęty, czeka na ponowienie;
wysyłka czy wycofanie) nie trafia do kosza i nie wraca z niego:
„Rekord jest w kolejce PBN — poczekaj, aż kolejka zakończy jego
przetwarzanie." Wiszącą wysyłkę operator może usunąć z kolejki ręcznie
(wpisy wysyłki są usuwalne; wpisy wycofania — nie). Kolejkowanie (każda
ścieżka: admin, „Wyślij do PBN w tle", sygnały, przywrócenie, „wyślij
ponownie") i kosz/przywrócenie biorą tę samą transakcyjną blokadę
rekordu (
PBN_Export_Queue.objects.zablokuj_rekord,pg_advisory_xact_lock) i pod nią sprawdzają stan: kolejkowanie odmawia rekordowi z kosza (RekordWKoszuPBN), kosz — rekordowi z wpisem; kosz czytapbn_uidz bazy (o wycofaniu nie decyduje nieaktualna instancja). Worker osobno trzyma sesyjną blokadę rekordu (klucz_blokady_rekordu), żeby dwa workery nie wysłały go naraz. - Konta z wpisami kolejki nie da się usunąć (
zamowil=PROTECT) — kto zlecił wysyłkę/wycofanie, to ślad audytu; konto się dezaktywuje. Admin pokazuje stronę „chronione obiekty". - Wszystkie migracje tego PR-a są nieodwracalne (poza
pbn_import/0013, która zmienia tylkochoices) — przed wdrożeniem kopia bazy, powrót tylko z kopii (patrz „Wdrożenie"). - Bez trwałego usuwania z kosza w adminie (wyłączone; w przyszłości
— patrz „Etap 2").
hard_delete()zostaje dla kodu (np. czyszczenie przed pełnym re-importem z PBN). - Akcje masowe admina (
zmien_hurtowo_z_historia) pomijają rekordy z kosza (są zamrożone).
Mechanizm w jednym akapicie¶
Modele z koszem dziedziczą SoftDeleteModel z pakietu
django-soft-delete
(django_softdelete). Dostają pola deleted_at, restored_at,
transaction_id i trzy menedżery:
| Menedżer | Co widzi | Kiedy używać |
|---|---|---|
objects (domyślny) |
tylko żywe wiersze | wyświetlanie, eksport, liczenie, ewaluacja |
global_objects |
żywe + kosz | import, deduplikacja, scalanie, admin (z filtrem „Kosz") |
deleted_objects |
tylko kosz | kosz w adminie, nagrobki, /api/v1/usuniete/ |
obj.delete() to UPDATE ... SET deleted_at = now() (przez
save(update_fields=...)), obj.restore() czyści znacznik,
obj.hard_delete() naprawdę kasuje wiersz (tylko z kodu — w adminie
wyłączone). Kaskady pakietu nie używamy — kasowałaby twardo dzieci
spoza kosza; każdy model ma własne delete()/restore(). Kod wspólny:
src/bpp/models/soft_delete.py; receivery (SoftDeleteLog, punktacja, PBN,
historia): src/bpp/receivers/soft_delete.py; audyt:
src/bpp/models/soft_delete_log.py; user/powód:
src/bpp/models/soft_delete_context.py; admin:
BppSoftDeleteAdminMixin w src/bpp/admin/helpers/mixins.py.
Zasada ogólna: kosz dostają rekordy, które operator świadomie „wyrzuca" i może chcieć odzyskać. Rekordy pomocnicze, które żyją i umierają z rodzicem, nie mają własnego kosza — znikają razem z rodzicem (domyślny menedżer je ukrywa) i wracają przy jego przywróceniu. Słowniki i struktura trafiają do kosza tylko jako rekordy nieużywane (guard), więc żaden żywy rekord nie wskazuje na coś z kosza.
Tabela: model → kosz?¶
Publikacje — TAK¶
| Model | delete() |
restore() |
|---|---|---|
Wydawnictwo_Ciagle, Wydawnictwo_Zwarte, Patent, Praca_Doktorska, Praca_Habilitacyjna |
Znika z objects, z bpp_rekord_mat i bpp_autorzy_mat (trigger), z ewaluacji (Cache_Punktacja_* kasowane receiverem), z API/OAI (nagrobek), z rankingu i raportów (widoki SQL filtrują deleted_at publikacji). Dzieci zostają nietknięte. Wpis SoftDeleteLog, ślad w historii, zlecenie wycofania z PBN (patrz niżej). |
Wszystko wraca: wiersz _mat i autorstwa w bpp_autorzy_mat (gałąź triggera dla OLD.deleted_at IS NOT NULL), punktacja przeliczana od nowa, zlecenie ponownej wysyłki do PBN. |
Guardy (sprawdz_czy_mozna_do_kosza):
- rekord, na który wskazuje inny rekord (żywy albo z kosza), nie trafia do
kosza — np. książka z rozdziałami, książka wskazana w zgłoszeniu jako
nadrzędna. Lista relacji jest wyprowadzana generycznie z
_meta(relacje_przychodzace) — pomijane są wyłącznie jawnie wymienione dzieci publikacji (POMIJANE_RELACJE_KOSZA); - praca z autorami z kilku uczelni nie trafia do kosza — kosz jest per instalacja, więc jedna uczelnia wyrzuciłaby rekord drugiej (i wycofała go z jej PBN). Komunikat każe usunąć z rekordu autorów swojej uczelni i zapisać rekord;
- habilitacja ma warunkowe unique „jedna żywa habilitacja na autora" —
przywrócenie drugiej kończy się komunikatem „Nie można przywrócić —
autor ma już habilitację" (
KonfliktPrzywracania, nie 500).
delete() rekordu już w koszu i restore() żywego rzucają
NiedozwolonaZmianaKosza — taki stan nie może zajść (przesunięty
deleted_at, drugi SoftDeleteLog, drugie wycofanie z PBN). Stan jest
sprawdzany w bazie pod blokadą wiersza (SELECT … FOR UPDATE,
sprawdz_stan_kosza). Admin pomija takie rekordy z komunikatem.
Tabele łączące i dzieci publikacji — NIE (decyzja właściciela)¶
| Model | Dlaczego bez kosza | Jak znika |
|---|---|---|
Wydawnictwo_Ciagle_Autor, Wydawnictwo_Zwarte_Autor, Patent_Autor |
Są częścią publikacji. Własny kosz oznaczał wiersze-śmieci po każdej edycji inline'a, warunkowe constrainty (ExclusionConstraint) i migracje największych tabel. |
BppDzieckoPublikacjiMixin: domyślny objects filtruje rekord__deleted_at IS NULL; all_objects widzi wszystko. W SQL widoki bpp_*_autorzy mają EXISTS na żywą publikację (migracja 0513). Usunięcie autora z inline'a to zwykłe, twarde kasowanie wiersza (jak przed soft-delete). |
*_Streszczenie, *_Zewnetrzna_Baza_Danych |
jw. | jw. — pod-zasoby API i „ostatnie streszczenia" ich nie pokazują. |
Nagroda, WybranaPublikacjaAutora, Publikacja_Habilitacyjna (GenericFK) |
jw. | GenericFK rozwiązuje się przez _base_manager (widzi kosz), więc filtrujemy jawnie: API nagród i profil autora (wyróżnione prace) pomijają obiekty z kosza. |
Skutek uboczny (świadomy): publikacja.autorzy_set na publikacji z kosza
jest pusty, a rekord z kosza w adminie jest tylko do odczytu — najpierw
„Przywróć". Kod, który musi zajrzeć do autorstw skasowanej publikacji (PBN,
atrybucja tenanta, guardy), używa all_objects/_base_manager
(manager_z_koszem()).
Odpięcie OSTATNIEGO autora uczelni od publikacji (twarde kasowanie wiersza
*_Autor w wydawnictwie ciągłym, zwartym albo patencie) daje nagrobek
OAI-PMH/CERIF: receiver cerif_export.signals zakłada wiersz
cerif_export.OdpietaPrzynaleznosc (publikacja × uczelnia), który trzyma
rekord w nadzbiorze przynaleznosc, i podbija ostatnio_zmieniony
publikacji (datestamp nagrobka). Gdy autor tej uczelni wróci, wiersz jest
kasowany — rekord jest znów w secie zwykłą drogą. Przepięcie istniejącego
autorstwa do jednostki innej uczelni (edycja, nie kasowanie) nagrobka nie
daje.
Autorzy — TAK, tylko „pusty" autor¶
| Model | Zasady |
|---|---|
Autor |
Liczba N: autor w koszu nie liczy się do N przy przeliczeniu — kosz/przywrócenie autora wymaga ręcznego przeliczenia N (jak ewaluacji). Guard: wskazuje na niego jakikolwiek rekord — autorstwo (także publikacji z kosza), doktorat (także jako promotor), habilitacja, projekt, redakcja źródła, autor zgłoszenia, konto użytkownika — → ProtectedError. Lista generyczna z _meta; pomijane jawnie (POMIJANE_RELACJE_KOSZA_AUTORA) tylko dane kadrowe, dane wyliczane, logi i wiersze importów/deduplikacji. Do kosza trafiają duplikaty, literówki, puste rekordy po scaleniu. |
Autor_Jednostka, Autor_Dyscyplina, Autor_Absencja, Projekt_Autor |
NIE — dane kadrowe żyją z autorem: zostają przy nim w koszu i wracają z nim. Domyślny menedżer Autor_Dyscyplina.objects ukrywa wiersze autorów z kosza (raport zerowy, dwudyscyplinowcy, liczba N, optymalizacja, metryki — autor z kosza w nich nie występuje); all_objects widzi wszystko. Metryki pomijają też wiersze udziałów autora z kosza do czasu przeliczenia N. |
Uczelnia i słowniki — TAK, tylko rekord nieużywany¶
BppSoftDeleteSlownikMixin. Guard bierze wszystkie przychodzące FK
(relacje_przychodzace) poza jawnie pominiętymi (pomijane_relacje_kosza)
i liczy powiązania przez _base_manager (czyli także te w koszu).
Jednostka — NIE ma kosza i nie kasuje się jej wcale (decyzja
właściciela): zamrożony rekord w drzewie MPTT blokowałby przeliczanie
lft/rght/tree_id sąsiadów. delete() i QuerySet.delete() rzucają
JednostkaNieDoUsuniecia („ukryj jednostkę — odznacz »Widoczna«"), admin
nie ma uprawnienia ani akcji usuwania.
| Model | Blokuje kosz | Zostaje przy rekordzie w koszu |
|---|---|---|
Uczelnia |
jednostki (także w koszu), użytkownicy z dostępem do uczelni | konfiguracja; site (domena) — uczelnia w koszu nie obsługuje domeny (get_for_site), ale trzyma Site (OneToOne NOT NULL); żeby podpiąć domenę pod inną uczelnię, usuń ją trwale z kosza |
Zrodlo |
wydawnictwa ciągłe | punktacja, dyscypliny, redakcja |
Wydawca |
wydawnictwa zwarte, doktoraty, habilitacje, aliasy, zgłoszenia | poziomy wydawcy |
Konferencja |
wydawnictwa ciągłe i zwarte | — |
Seria_Wydawnicza |
wydawnictwa zwarte | — |
Wydzial nie istnieje (usunięty w #438 — wydział to korzeń drzewa
Jednostka). FK publikacji do Konferencja i Seria_Wydawnicza zmieniły
się z CASCADE na PROTECT: skasowanie konferencji/serii nie kaskaduje
już twardo na publikacje (migracja 0510_slowniki_protect; bez zmian w bazie —
on_delete żyje tylko w ORM). Import (np. dopasowanie źródła po ISSN)
kosza słowników nie widzi przy dopasowaniu, ale nie tworzy duplikatu
wartości unikalnej trzymanej przez rekord z kosza: import PBN (wydawcy,
autorzy), importer autorów PBN i komendy import_wydawca_* sprawdzają kosz
(pbn_integrator.kosz.pomin_jesli_koliduje) — trafienie w kosz = pomiń
i zgłoś (RekordWKoszuPominietyPrzezImport), nigdy nie wskrzeszaj.
Poza koszem¶
| Model | Dlaczego |
|---|---|
słowniki systemowe (Charakter_Formalny, Jezyk, Typ_KBN, …) |
twarde kasowanie jak dotąd |
bpp_rekord_mat, bpp_autorzy_mat |
tabele cache — trigger usuwa i odtwarza wiersze |
Cache_Punktacja_* |
kasowane receiverem przy koszu, przeliczane przy restore |
PBN_Export_Queue, SentData, pbn_api.* |
kolejka i lustro PBN |
SoftDeleteLog |
audyt kosza |
Element_Repozytorium, Zgloszenie_Publikacji |
mają własny, starszy soft-delete |
Unikalne pola w koszu (slug, nazwa, ORCID, PBN UID, …)¶
Rekord w koszu zachowuje wszystkie swoje wartości unikalne (decyzja
właściciela): link /jan-kowalski/ zostaje na zawsze, nazwa, skrót, ORCID,
PBN UID, pbn_id, expertus_id, system_kadrowy_id — też.
- slug: autoslug sprawdza unikalność razem z koszem
(
AutoSlugField(manager_name="global_objects")dlaAutor,Uczelnia,Zrodlo,Wydawca), więc nowy „Jan Kowalski" dostaje po prostu kolejny slug (jan-kowalski-2). To naprawiaIntegrityErrornabpp_autor_slug_key; - pozostałe pola unikalne: wpisanie w formularzu wartości trzymanej
przez rekord z kosza kończy się błędem walidacji z linkiem do tamtego
rekordu: „Ta wartość należy do rekordu w koszu: … Zamiast wpisywać ją
tutaj, przywróć tamten rekord z kosza" (
BppUnikalnoscZKoszemMixin. validate_unique— Django sprawdza unikalność przez domyślny menedżer, który kosza nie widzi, więc bez tego byłIntegrityError/500). To samo dotyczy deduplikacji (PBN UID trzymany przez duplikat w koszu) — integracja PBN (ustaw_pbn_uid_jesli_brak) pomija taki rekord i raportuje go jak import; - przywrócenie niczego nie odzyskuje; jeśli mimo to łamie ograniczenie
(np. warunkowe „jedna żywa habilitacja"), kończy się
KonfliktPrzywracaniaz czytelnym komunikatem.
PBN a kosz¶
Egzekwowane w warstwie modelu (nie tylko w adminie): reguła z punktu 3
„Zasad" — niezakończony wpis kolejki blokuje kosz i przywrócenie
(RekordWKolejcePBN), sprawdzana pod wspólną blokadą rekordu w tej samej
transakcji co zapis kosza/przywrócenia (pbn_export_queue/operacje.py).
Aktywnego zlecenia WYCOFANIA nie da się usunąć z kolejki ani wysłać
ponownie ręcznie (WycofanieZablokowane); wpis wysyłki — można usunąć.
Ręczne operacje na kolejce. Na zleceniach wycofania nie ma ŻADNYCH
ręcznych operacji (usuń, wyślij ponownie, „spróbuj wysłać") — także po
zakończeniu: to historia. Wpisu wysyłki, który worker właśnie wysyła (trzyma
blokadę rekordu), nie da się usunąć (WpisWTrakcieWysylki). Sprzątaczka
(kolejka_wyczysc_wpisy_bez_rekordow) usuwa wyłącznie wpisy wysyłki rekordów
fizycznie nieistniejących — historia wysyłek rekordów z kosza zostaje.
Wycofanie nigdy nie kończy się błędem — zostaje w kolejce, aż się uda.
Wygasły token albo konto bez tokenu (np. techniczne bpp-system) → wpis
czeka na zalogowanie do PBN (retry_after_user_authorised); każdy inny
błąd → ponowienie z rosnącym odstępem (do 6 h,
PBN_Export_Queue.odstep_ponowienia). Do tego czasu rekord stoi w koszu,
jego oświadczenia w PBN, a przywrócić go nie można (jedna reguła kolejki).
„Nie ma czego wycofać" (PBN nie ma oświadczeń albo nie zna publikacji —
HTTP 404) jest sukcesem. Dla wpisów bpp-system ustaw temu kontu
przedstawiaj_w_pbn_jako na konto z ważnym tokenem — logowanie tamtego
konta ponowi oczekujące wycofania. Wyjątek: rekord skasowany FIZYCZNIE
(nie ma skąd odczytać PBN UID) kończy wpis błędem.
| Sytuacja | Co się dzieje |
|---|---|
| Kosz publikacji z PBN UID | Receiver zleca WYCOFANIE — usuwa oświadczenia naszej instytucji (profil instytucji). Obiektu publikacji w repozytorium PBN nie da się usunąć (jest współdzielony). Strona potwierdzenia mówi o tym wprost. |
| Kosz, gdy rekord ma jakikolwiek niezakończony wpis kolejki (czeka, podjęty, czeka na ponowienie, wysyłka po przywróceniu, wycofanie) | Odmowa: „Rekord jest w kolejce PBN — poczekaj, aż kolejka zakończy jego przetwarzanie." Wiszącą wysyłkę można usunąć z kolejki ręcznie. |
| Kolejkowanie rekordu z kosza (dowolna ścieżka, także „wyślij ponownie") | Odmowa (RekordWKoszuPBN). Wycofanie zleca sam kosz. |
| Przywrócenie, gdy wycofanie jeszcze się nie zakończyło | Odmowa (ta sama reguła). |
| Przywrócenie po zakończonym wycofaniu | Od razu zlecana wysyłka — tylko gdy rekord ma PBN UID. Do jej końca rekord znów nie trafi do kosza (ta sama reguła). |
| Import z PBN trafia na rekord, który u nas jest w koszu | Pomija i raportuje (decyzja właściciela): „W PBN jest rekord X, ale u nas jest usunięty (w koszu)". Raport: admin RekordWKoszuPominietyPrzezImport (jeden wpis na rekord i ścieżkę, z licznikiem), log (WARNING), nieścisłość record_in_trash w raporcie sesji pbn_import. Rekordów z kosza import nie wskrzesza. Rozdział książki z kosza też jest pomijany. |
| Rekord z PBN UID w adminie (FD#539) | Usuwanie zablokowane (RestrictDeletionWhenPBNUIDSetMixin), ale przycisk „Usuń" jest wyszarzony z wyjaśnieniem zamiast znikać. Akcje masowe sprawdzają to uprawnienie per rekord. |
Kolejka usuwania z PBN (poza tym PR)
Docelowo: kolejka „usuń z PBN" — wycofanie rekordu z profilu
instytucji (sam rekord w repozytorium PBN zostaje). Gdy powstanie,
blokada FD#539 może zniknąć: kasowanie rekordu z odpowiednikiem w PBN
pójdzie do kosza z automatycznym wycofaniem (przepływ z tabeli wyżej
jest na to gotowy — stan_pbn_przed_koszem, zakolejkuj_wycofanie).
Historia zmian (reversion / LogEntry)¶
Kosz i przywrócenie zawsze zostawiają ślad w historii rekordu
(_zapisz_wersje w receivers/soft_delete.py), generycznie:
reversion.is_registered(model)→ rewizja reversion zset_useriset_comment(„Przeniesiono do kosza (powód: …)" / „Przywrócono z kosza"). Dziś:AutoriUczelnia(jawnie,bpp/wersjonowanie.py, BEZ pól koszadeleted_at/restored_at/transaction_id— przywrócenie wersji nie może ominąćdelete()/restore());- w przeciwnym razie → wpis admina
LogEntry(CHANGE) z tym samym komunikatem (publikacje, słowniki). Bez usera (operacja systemowa)LogEntrynie powstaje — śladem zostajeSoftDeleteLog.
Rejestracja modelu w reversion w przyszłości automatycznie przełącza go na rewizje — kod kosza się nie zmienia. To planowany następny krok (osobny PR): rejestracja praktycznie każdego modelu edytowanego w adminie (publikacje, struktura, słowniki) — patrz Historia zmian (reversion).
Admin nie zapisuje przy koszu wpisu DELETION (rekord nie został usunięty).
Pola kosza są wykluczone z treści wersji — przywrócenie starej wersji
nie może po cichu wyjąć rekordu z kosza; dla rekordu z kosza „przywróć
wersję" jest zablokowane (najpierw „Przywróć" z kosza).
Admin¶
- Lista nad
global_objectsz filtrem „♻️ Kosz" (domyślnie: tylko żywe), zawsze ostatnim w panelu filtrów. - „Usuń" na rekordzie → strona potwierdzenia kosza (powód, PBN, pytanie o kolejkę); guard daje komunikat zamiast 500.
- Strona „Nie można przenieść do kosza" wylicza blokujące rekordy:
guard rzuca
BlokadaKosza(podklasaProtectedError) z listąGrupaBlokadyper relacja (grupa_blokady— jedno zapytanie na relację: próbkaLIMIT_POZYCJI_BLOKADY= 15 wierszy, najpierw te w koszu, plusCOUNT(*) OVER ()całości i rekordów w koszu). Pozycje linkują do strony rekordu w adminie (wiersze*_Autor— do publikacji), rekordy z kosza są oznaczone „🗑️ w koszu"; reszta to „…i jeszcze N". Etykiety grup:ETYKIETY_RELACJI_KOSZA, poza nimi — z_meta. Tak samo pokazywane są autorzy per uczelnia (praca wielouczelniana), habilitacje wskazujące publikację i wpis kolejki PBN (grupa_blokady_kolejki). - Strony kosza (potwierdzenie, blokada, akcja z powodem) używają markupu
Grappelli (
grp-module,grp-row,grp-submit-row), bez własnego CSS. - Rekord z kosza ma na dole przycisk „♻️ Przywróć" (
<pk>/przywroc/, tylko POST; te same uprawnieniadelete+changei reguły co akcja „Przywróć zaznaczone", w tym blokada kolejki PBN). - Akcje: „🗑️ Usuń do kosza (z powodem)" (uprawnienie
delete), „♻️ Przywróć zaznaczone" (delete+change). Uprawnienie sprawdzane per rekord. Trwałego usuwania z kosza w adminie nie ma. - Lista i szczegóły kolejki eksportu PBN dla rekordu z kosza pokazują „rekord w koszu" zamiast opisu.
- Rekord z kosza: tylko do odczytu, z komunikatem.
/api/v1/usuniete/pokazuje wyłącznie kosz bieżącej uczelni (instalacja wielouczelniana; brak uczelni z domeny → pusto);/api/v1/autor_jednostka/i/api/v1/poziom_wydawcy/pomijają wiersze rodziców z kosza.- Autocomplete admina nie podsuwa rekordów z kosza; przekierowanie
global-nav-redirdla rekordu z kosza daje 404 (nie zdradza sluga). - Publikacja wskazana w habilitacji (
Publikacja_Habilitacyjna, GenericFK) nie trafi do kosza — GenericFK sprawdzamy jawnie. - Scalanie autorów przepina pracę dyplomową z kosza wyłącznie w kolumnie
autora (
update), bez pełnegosave()nieaktualnej instancji.
Wdrożenie: okno serwisowe¶
Migracje bpp/0511–0523 (oraz pbn_export_queue/0011–0012,
pbn_api/0080, rozbieznosci_dyscyplin/0022, zglos_publikacje/0029,
pbn_integrator/0001, pbn_import/0013) dodają kolumny
deleted_at/restored_at/transaction_id (bez wartości domyślnej —
szybkie), częściowe indeksy budowane bez CONCURRENTLY na tabelach
publikacji i autorów (WHERE deleted_at IS NOT NULL — na starcie puste,
ale CREATE INDEX blokuje zapisy na czas skanu tabeli), przebudowują
widoki SQL i funkcje triggerów bpp_rekord_mat/bpp_autorzy_mat.
Wdrażać w oknie serwisowym — migracje muszą się domknąć, zanim nowy kod
zacznie obsługiwać ruch. Tabele łączące *_autor (największe w systemie)
nie są migrowane wcale.
Migracje nieodwracalne — przed wdrożeniem zrób kopię bazy; powrót tylko z kopii¶
Wszystkie migracje tego PR-a — bpp/0511–0523, cerif_export/0001,
pbn_api/0080, pbn_export_queue/0011–0012, pbn_integrator/0001,
rozbieznosci_dyscyplin/0022, zglos_publikacje/0029 — nie mają kroku
wstecz (decyzja właściciela). Wyjątek: pbn_import/0013 zmienia tylko
choices (cofnięcie nic nie gubi). migrate w tył przez którąkolwiek
z nich rzuca IrreversibleError, zanim cokolwiek zmieni w bazie.
Migracje z kodem (RunPython/RunSQL) po prostu nie mają
reverse_code/reverse_sql; czysto schematowe kończą się operacją
bpp.migration_util.nieodwracalna(). Powód: cofnięcie zgubiłoby dane,
których stary kod nie umie odtworzyć — rekordy w koszu wróciłyby jako
żywe, wpisy „wycofanie" w kolejce PBN zamieniłyby się w wysyłki, a
sprzątnięte wiersze _mat, skasowane widoki bpp_kronika_* i trigger
zamrożenia kosza musiałyby być odtwarzane ręcznie.
Przed wdrożeniem zrób kopię bazy; powrót do wersji sprzed kosza — tylko
z tej kopii (razem z obrazem aplikacji sprzed wdrożenia). Pilnuje tego
bpp/tests/test_soft_delete/test_migracje_nieodwracalne.py. Testy e2e
migracji pbn_api cofają i ponownie stosują wyłącznie własne migracje
(pbn_api/tests/migracje_e2e_utils.py: cofnij_tylko/zastosuj_tylko),
nie cały graf — „migrate pbn_api 0077" pociągnęłoby za sobą ten łańcuch.
Zasady dla kodu, który dopisujesz¶
- Czytasz publikacje/autorów do wyświetlenia, eksportu, liczenia →
objects/Rekord. - Dopasowujesz rekordy przy imporcie, deduplikacji, scalaniu →
manager_z_koszem(model)i zdecyduj jawnie, co zrobić z trafieniem w kosz (import PBN: pomiń i zgłoś). - Czytasz dziecko publikacji bez przechodzenia przez rodzica →
objectsdziecka już filtruje; ale lookup przez relację z innego modelu (Autor.objects.filter(wydawnictwo_ciagle_autor__…)) NIE pyta menedżera — dołóż…__rekord__deleted_at__isnull=True. GenericFK (nagrody, wyróżnione prace) — sprawdźdeleted_atobiektu. - Nowy widok SQL czytający tabele publikacji albo
*_autor→ warunek nadeleted_atpublikacji;test_kanarek_katalogowy.pypadnie, jeśli zapomnisz. - Nigdy
queryset.update(deleted_at=...)— tylko.delete()/.restore()per instancja (inaczej omijasz sygnały,SoftDeleteLog, PBN i historię). - Nowy model z koszem:
AutoSlugField(..., manager_name="global_objects")dla sluga;BppUnikalnoscZKoszemMixindaje walidację pól unikalnych; nowa relacja do modelu z koszem jest chroniona przez guard domyślnie — jeśli to dane „przy rekordzie", dopisz ją do listy pomijanych.
Świadomie zaakceptowane¶
- Wyścig guard ↔ zapis: między sprawdzeniem „nic nie wskazuje na ten słownik/publikację" a zapisem kosza równoległy zapis może dodać odwołanie (milisekundy). Nie blokujemy tego dodatkowo.
- Migracje nieodwracalne: zamiast utrzymywać kroki wstecz (widoki,
funkcje triggerów, sidecar
bpp_kronika_*), których nikt nie użyje produkcyjnie — powrót wyłącznie z kopii bazy (patrz „Wdrożenie"). - Przyszłe migracje danych na tabelach z koszem, które mają objąć
rekordy z kosza, muszą ustawić
bpp.kosz_operacja(trigger). - Zmiany słowników „przez" rekord z kosza (np. skasowanie słownika
z
SET_NULL/CASCADEdo rekordu w koszu) są odrzucane — rekord w koszu jest zamrożony.
Etap 2 (poza tym PR)¶
-
Trwałe usuwanie z kosza w adminie (opróżnianie kosza) — wymaga decyzji co do niezakończonych wycofań z PBN.
-
Rejestracja modeli w reversion (publikacje, struktura, słowniki) — kosz automatycznie przejdzie z
LogEntryna rewizje. - reversion dla relacji: autorstwa (
*_Autor) jako obiekty powiązane rewizji publikacji (follow) — razem z rejestracją publikacji; pozwoli też odtworzyć atrybucję po odpięciu autora. - Kolejka usuwania z PBN (FD#539) — patrz ramka wyżej.