Handlowiec nie widzi leada po zdjęciu blokady — diagnostyka RLS i uprawnień
Poradnik techniczny · Kacper Bernecki
Problem: po usunięciu pola „zablokowany” (blocked) lub flagi statusu w CRM handlowiec wciąż nie widzi rekordu. To typowy objaw warstwy kontroli dostępu na poziomie wiersza (Row-Level Security), błędnych uprawnień lub rozbieżności między tokenem użytkownika a warunkiem polityki. Zamiast jedynie odblokować rekord, trzeba sprawdzić polityki RLS w bazie, przypisanie właściciela rekordu, mapping claims w tokenie JWT używanym przez aplikację oraz czy nie ma dodatkowych filtrów po stronie API/ORM. Poniższy tekst prowadzi przez różnicową analizę, konkretne kroki diagnostyczne i testy w środowisku Supabase/Postgres oraz listę typowych pułapek do sprawdzenia.
Jak rozpoznać przyczynę
Sprawdź, czy na tabeli leadów RLS jest włączone (row_security = on). Jeśli RLS wyłączone, problem może leżeć po stronie aplikacji lub cache. Jeśli włączone, kolejnym podejrzanym są polityki SELECT: warunek USING decyduje, czy wiersz jest widoczny, a WITH CHECK decyduje o INSERT/UPDATE. Często warunek odwołuje się do claimów jwt (auth.uid, role) i zmiana flagi blocked nie wpływa na expr.
Zbadaj token sesji handlowca i wartości claims (sub, role, user_id). Popularny błąd to mismatch pola właściciela w tabeli (owner_id) i claimu w tokenie (auth.uid albo sub). Innym częstym przypadkiem jest niezaktualizowany token po zmianie roli: JWT może nadal zawierać starą rolę, więc row spełnia USING tylko dla nowej roli.
Na koniec sprawdź, czy API warstwy pośredniej (REST, GraphQL, ORM) nie stosuje dodatkowych filtrów (np. where: { assigned_to: currentUser }) lub czy klient nie cache'uje wyników. Również transakcje lub brak commit po zmianie statusu mogą sprawić, że zmiana nie jest widoczna dla innego połączenia.
Rozwiązanie krok po kroku
1. Potwierdź, że RLS jest włączone: w psql uruchom SELECT relrowsecurity FROM pg_class WHERE relname='leads'; jeśli true, kontynuuj; jeśli false, sprawdź uprawnienia GRANT i logikę aplikacji.
2. Zaloguj się jako handlowiec w kontekście bazy (symuluj JWT/SET ROLE). W Supabase użyj policy test tool lub w psql: SET LOCAL role = 'anon' nie wystarczy — zamiast tego uruchom zapytanie z odpowiednim jwt_claims lub użyj RLS-tables test harness. Odczytaj current_setting('jwt.claims') jeśli stosowane.
3. Odczytaj polityki RLS: SELECT pol.polname, pol.polpermissive, pg_get_expr(pol.polqual, pol.polrelid) AS using, pg_get_expr(pol.polwithcheck, pol.polrelid) AS withcheck FROM pg_policy pol JOIN pg_class c ON pol.polrelid=c.oid WHERE c.relname='leads'; Przeanalizuj wyrażenia USING i WITH CHECK względem pola blocked i owner_id.
4. Porównaj owner_id/assigned_to w wierszu z wartościami w tokenie: SELECT id, owner_id, assigned_to, blocked FROM leads WHERE id = <ilead>; następnie zweryfikuj jwt.claims.sub i /lub role w tokenie. Jeśli wartości się nie zgadzają, albo polityka odwołuje się do innego pola, to przyczyna.
5. Sprawdź, czy token handlowca zawiera aktualne role: w Supabase -> Authentication -> Users -> zobacz JWT lub w syslogach. Jeśli rola zmieniona niedawno, wymuś odświeżenie tokena (re-login). Test: wykonaj żądanie z nowym tokenem i porównaj odpowiedź.
6. Przetestuj zapytania bez RLS: tymczasowo wyłącz RLS dla tej tabeli lub wykonaj zapytanie jako superuser: SET ROLE postgres; SELECT ... FROM leads WHERE id=...; jeśli rekord widoczny, przyczyna to polityka RLS; jeśli dalej niewidoczny, sprawdź filtracja aplikacji lub stan rekordu.
7. Sprawdź warstwę aplikacyjną: w logach backendu zidentyfikuj zapytania SQL generowane przez ORM (np. Prisma, Hasura); upewnij się, że nie ma dodatkowego WHERE (assigned_to = null) lub paginacji, oraz że nie ma błędnej projekcji, która ukrywa rekordy.
Jak sprawdzić, czy problem zniknął
Test 1: symulacja ręczna — zaloguj się jako handlowiec, odśwież token, uruchom SELECT id FROM leads WHERE id=<problemowy> w kontekście tego tokenu (lub użyj supabase policy simulator). Wynik powinien zmienić się z pustego na jeden wiersz; jeśli nie, sprawdź wyrażenie USING.
Test 2: superuser bypass — wykonaj SELECT jako superuser (SET ROLE postgres) aby potwierdzić, że rekord istnieje i pole blocked ustawione poprawnie. Jeśli superuser widzi rekord, to błąd dotyczy RLS/policy/claims; jeśli nie widzi, problem po stronie danych lub transakcji.
Czego nie robić
Nie zakładaj, że zdjęcie pola blocked usuwa inne warunki polityki — policy USING może sprawdzać assigned_to lub statusy powiązane; zmiana jednego pola nie gwarantuje widoczności.
Nie testuj tylko z kontem admina — superuser zawsze widzi rekord, to fałszywe poczucie rozwiązania. Testuj z rzeczywistym JWT handlowca lub policy simulator.
Nie zapominaj o cache i tokenach — brak odświeżenia JWT po zmianie roli lub cachowanie odpowiedzi frontend może maskować efekt naprawy.