k0nsult.dev · Succession Recovery & Inheritance Exchange
SPADKI
DAROWIZNY
RECOVERY
DAROWIZNY
RECOVERY
Legal-tech + recovery-tech + family-trace orchestration. Platforma do kwalifikacji spraw
spadkowych i darowizn, identyfikacji uprawnionych, odzyskiwania majątku i obsługi spraw
krajowych oraz transgranicznych w UE.
Intake
→
Eligibility
→
Claim Engine
→
Family Trace
→
Recovery Desk
→
Partner
→
Settlement
Problemy które rozwiązujemy
6
Core use-cases B2C
Moduły systemu
13
M1–M13 full stack
Termin na oświadczenie
6M
od dowiedzenia się o powołaniu
Jurysdykcja UE
650
Rozporządzenie nr 650/2012
6 Problemów Platformy
Core use-cases · B2C entry points
P-01
Czy należy mi się spadek?
Kwalifikacja kręgu spadkobierców, typ roszczenia, pilność terminu, brakujące dokumenty, rekomendowana ścieżka.
P-02
Przyjąć czy odrzucić spadek?
Screening długów, kalkulator ryzyka, ścieżka: sąd / notariusz / konsul. Generator dokumentów i alerty terminów.
P-03
Czy mam roszczenie o zachowek?
Kalkulator zachowku, analiza darowizn doliczalnych, substrat, tryb dochodzenia, draft wezwania.
P-04
Gdzie jest majątek po zmarłym?
Recovery Desk — identyfikacja, kategoryzacja i ścieżka odzyskiwania składników majątkowych od osób trzecich i instytucji.
P-05
Szukam krewnych / beneficjentów
Family Trace — graf rodzinny, poszukiwanie uprawnionych, partner genealogiczny, compliance RODO.
P-06
Darowizna zgodna z prawem
Donation Desk — typ darowizny, kwalifikacja podatkowa, SD-Z2/SD-3, terminy zgłoszeń, archiwum.
Typy Kont i Segmenty
B2C · B2B · B2G · Internal roles
Segment
B2C — Obywatel
- Spadkobiercy w Polsce i za granicą
- Osoby dochodzące zachowku
- Obdarowani — przyjęcie darowizny
- Opiekunowie majątku po śmierci
- Wykonawcy testamentów
- Rodziny w sporze spadkowym
- Polonia — sprawy transgraniczne PL↔UE
Segment
B2B — Partner
- Kancelarie prawne
- Kancelarie notarialne
- Biura genealogiczne
- Firmy asset recovery
- Zarządcy sukcesyjni
- Pośrednicy nieruchomości
- Firmy porządkujące majątek po zgonie
Segment
B2G / Institutional
- Banki i zakłady ubezpieczeń
- Domy pomocy / placówki
- Zarządcy lokali i nieruchomości
- Gminy i depozytariusze
- Archiwa i rejestry publiczne
- Fundusze rodzinne
- Operatorzy mienia po zgonie
Fazy Wdrożenia
Polska → DACH/Benelux → UE-wide
Ryzyka Kluczowe
Prawne · Operacyjne · Techniczne
⚠ Prawne
Compliance Legal
- Błędna kwalifikacja spadkobiercy
- Złe wyliczenie zachowku
- Nieuprawnione przetwarzanie danych krewnych
- Zbyt szerokie dane o majątku
- Błędna obsługa spraw zagranicznych
⚠ Operacyjne
Ryzyko Ops
- Fałszywe zgłoszenia do systemu
- Konflikty rodzinne eskalowane przez platformę
- Niska jakość dokumentów wejściowych
- Trudność walidacji tożsamości
- Partnerzy niskiej jakości
⚠ Techniczne
Ryzyko Tech
- Wyciek dokumentów wrażliwych
- Nieautoryzowany dostęp do akt
- Błędne wersjonowanie dokumentów
- Brak ścieżki audytowej
- Błędne alerty terminów
Rekomendacja Strategiczna
Najlepsza kolejność: Polska — spadki + zachowek + darowizna + dokumenty + partnerzy, następnie recovery desk i genealogia, potem UE cross-border i ECS. White-label dla kancelarii jako warstwa premium. To jest realny, komercyjny i defensywnie zgodny kierunek wdrożenia.
13 Modułów Systemu
M1–M13 · pełna architektura produktu
M1 · Case Intake
Intake Sprawy
Dynamiczny formularz z autozapisem draftu, wybór typu sprawy, upload dokumentów, walidacja pól, generacja Case ID, first risk score, routing do kolejki.
M2 · Eligibility Engine
Silnik Kwalifikacji
Klasyfikacja typu sprawy, scoring wstępny, wyliczenie terminu (6M), sugestia ścieżki, wykrycie braków formalnych, flaga transgraniczna i sporu.
M3 · Claim Engine
Silnik Roszczeń
Kalkulator zachowku, analiza darowizn doliczalnych, ścieżka dochodzenia, draft wezwania, ocena prawdopodobieństwa zasadności roszczenia.
M4 · Family Trace
Poszukiwanie Krewnych
Graf rodzinny, wykrycie braków, zlecenie trace do partnera genealogicznego, status odnalezienia, raport trace, walidacja tożsamości. Pełny RODO compliance.
M5 · Recovery Desk
Odzyskanie Majątku
Identyfikacja i kategoryzacja składników, status posiadania i sporu, ścieżka polubowna/formalna/sądowa, settlement tracking, partner recovery.
M6 · Donation Desk
Darowizny
Wybór rodzaju darowizny, kwalifikacja podatkowa, checklista SD-Z2/SD-3, terminy zgłoszeń, wzory dokumentów, przypomnienia, archiwum.
M7 · Cross-Border EU
Panel Transgraniczny
Oznaczenie jurysdykcji, prawo właściwe (Rozp. 650/2012), ECS workflow, mapowanie kraju, partnerzy zagraniczni, tłumaczenia dokumentów.
M8 · Document Vault
Vault Dokumentów
Upload, OCR, tagowanie, wersjonowanie, foldery spraw, legal hold, immutable audit, e-sign ready exports, sharing scope.
M9 · Partner Marketplace
Marketplace Partnerów
Katalog partnerów, filtrowanie według specjalizacji, przydział leadów, scoring partnera, SLA, success fee, white-label workflow.
M10 · Payments
Płatności i Rozliczenia
Płatności jednorazowe, subskrypcje, success fee, prowizje partnerów, payouty, faktury, historia rozliczeń.
M11 · Notifications
System Powiadomień
Email, SMS, push, in-app, operator alerts. Zdarzenia: termin, brakujący dokument, zmiana statusu, przypisanie partnera, eskalacja.
M12 · Admin & Governance
Governance Panel
RBAC, audit logs, policy management, SLA rules, jurisdiction rules, template management, partner onboarding, fraud flags, privacy requests.
M13 · AI Layer
Warstwa AI
OCR i ekstrakcja z dokumentów, klasyfikacja spraw, wykrywanie braków, streszczenia akt, drafty pism. Bez samodzielnych decyzji prawnych wiążących.
Role i Uprawnienia
Zewnętrzne · Wewnętrzne · RBAC
ROLE ZEWNĘTRZNE
citizen_basic
Obywatel Basic
- Rejestracja i logowanie
- Intake sprawy
- Podstawowy screening
- Upload dokumentów
citizen_pro
Obywatel Pro
- Raport rozszerzony
- Kalkulacja roszczenia
- Panel statusów
- Komunikacja z partnerem
lawyer_partner
Kancelaria
- Odbieranie leadów
- Prowadzenie sprawy
- Generowanie dokumentów
- Aktualizacja statusów
notary_partner
Notariusz
- Walidacja formalna
- Obsługa oświadczeń
- Checklisty notarialne
- Statusy dokumentów
genealogist_partner
Genealog
- Tree building
- Trace workflow
- Raport ustaleń
- Status odnalezienia
recovery_partner
Recovery
- Odzyskiwanie aktywów
- Panel roszczeń majątkowych
- Negocjacje / ugody
- Raporty postępu
ROLE WEWNĘTRZNE
operator_l1
Operator L1
- Intake triage
- Weryfikacja kompletności
- Tagowanie i routing kolejki
operator_l2
Operator L2
- Pogłębiona analiza
- Kontakt z klientem
- Przygotowanie dla partnera
legal_reviewer
Legal Reviewer
- Review dokumentów
- Klasyfikacja prawna
- Zatwierdzanie draftów
compliance_reviewer
Compliance
- RODO / zgody / podstawa prawna
- Retencja i dostęp do danych
- Audyt czynności
case_supervisor
Supervisor
- SLA monitoring
- Priorytety i rozdział partnerów
- Zamknięcie spraw
Typy Składników Majątku
Recovery Desk · Asset categorization
ASSET-01
Cash & Rachunki
Środki pieniężne, rachunki bankowe, depozyty, konta oszczędnościowe. Ścieżka: pełnomocnictwo + postanowienie + instytucja.
ASSET-02
Ruchomości
Rzeczy ruchome, pojazdy, sprzęt, kolekcje, biżuteria. Odbiór od osób trzecich i depozytariuszy.
ASSET-03
Nieruchomości
Mieszkania, domy, lokale, grunty, gospodarstwa. Workflow: dział spadku, wycena, zarząd.
ASSET-04
Udziały & Prawa
Udziały, akcje, obligacje, prawa majątkowe, wierzytelności, prawa autorskie, krypto, prawa cyfrowe.
Workflow End-to-End
5 scenariuszy · ścieżki A–E
Scenariusz A — „Czy należy mi się spadek?"
1
Rejestracja i logowanie
Użytkownik zakłada konto · citizen_basic · 2FA · akceptacja regulaminu i polityki prywatności · zgoda przetwarzania danych
→ user.status = active · consent logged
2
Formularz Intake
Dane zmarłego · data śmierci · kraj · relacja rodzinna · znany majątek · długi · testament · darowizny · pilność
→ case.status = submitted · case_id generowany
3
Eligibility Engine v1
Klasyfikacja: spadkobierca ustawowy / testamentowy · wyliczenie terminu · urgency_level · brakujące dokumenty[]
→ case_type, deadline_at, recommended_next_steps[]
4
Raport i Rekomendacja
System wskazuje: prawdopodobny typ roszczenia · poziom pilności · brakujące dokumenty · następny krok. Opcja zakupu raportu.
→ citizen może kupić raport (49–149 PLN) lub zlecić analizę
5
Przekazanie do Partnera
Wybór z Marketplace: kancelaria / notariusz / genealog. Przypisanie, SLA, komunikacja, status sprawy.
→ case.status = assigned_to_partner
Scenariusz B — „Chcę odrzucić spadek"
1
Termin krytyczny
System liczy termin 6 miesięcy od dowiedzenia się o powołaniu · natychmiastowy alert urgency = HIGH
→ deadline_at · alert EMAIL+SMS
2
Checklista dokumentów
System generuje checklistę: akt zgonu · akt urodzenia · PESEL · dokumenty majątkowe · dowód relacji
→ checklist[] · missing_documents[]
3
Ścieżka formalna
System wskazuje tryb: sąd rejonowy / notariusz / konsul (zagranica). Generator draftu oświadczenia.
→ draft oświadczenia · adres sądu / notariusza
4
Operator Weryfikuje
Operator L1 sprawdza kompletność dokumentów i poprawność ścieżki przed finalizacją
→ human-in-loop przed złożeniem
5
Potwierdzenie
Użytkownik oznacza wykonanie · sprawa zamknięta · archiwum · reminder dla pozostałych spadkobierców
→ case.status = resolved · audit log
Scenariusz C — „Szukam krewnych uprawnionych do spadku"
1
Tworzenie Drzewa Rodzinnego
Partner lub user zakłada sprawę · system buduje graf relacji · identyfikuje luki w kręgu spadkobierców
→ family_graph created · gaps identified
2
Zlecenie Genealoga
Zlecenie trafia do partnera genealogicznego · dokumentowanie źródeł i kroków · compliance: legal basis + purpose limitation + RODO
→ trace_task = in_progress · audit trail
3
Identyfikacja i Kontakt
Po odnalezieniu: kontakt, walidacja tożsamości, włączenie osoby do sprawy jako claimant
→ trace_status = match_found · identity_pending
4
Przekazanie do Recovery / Kancelarii
Kompletna rodzina uprawnionych trafia do kancelarii lub notariusza w celu przeprowadzenia działu spadku
→ case → partner_assignment
Scenariusz D — „Muszę odzyskać majątek po zmarłym"
1
Zgłoszenie Składnika
Typ składnika: cash / bank / movable / immovable / shares / documents. Kategorizacja i wstępna wycena.
→ asset.status = identified
2
Upload Dowodów
Dokumenty potwierdzające: akt zgonu, tytuł prawny, dowód relacji, dokumenty składnika majątkowego
→ evidence_pending → complete
3
Ścieżka Recovery
System proponuje: kontakt polubowny → formal notice → ugoda → sąd. Przypisanie recovery_partner.
→ holder_contacted · formal_notice_sent
4
Rozliczenie Success Fee
Po skutecznym odzyskaniu: settlement, success fee naliczany automatycznie, payout do partnera
→ asset.status = recovered · settlement
Scenariusz E — „Darowizna — przekazanie i przyjęcie"
1
Wybór Typu Darowizny
Pieniężna / rzeczowa / rodzinna / nieruchomość. Strony: darczyńca → obdarowany. Relacja rodzinna.
→ donation.type · parties validated
2
Kwalifikacja Podatkowa
Sprawdzenie grupy podatkowej · zwolnienia (SD-Z2) · obowiązek zgłoszenia · termin · kalkulator podatku
→ tax_status · filing_deadline
3
Dokumenty i Archiwum
Checklisty i wzory dokumentów · formularz SD-Z2 lub SD-3 · podpisanie · archiwizacja w Document Vault
→ documents.signed · donation.archived
4
Zamknięcie i Reminder
Potwierdzenie zgłoszenia · przypomnienie przed terminem · dostęp do archiwum i potwierdzenia
→ case.status = closed
Statusy Workflow
Case lifecycle · full state machine
| Status | Opis | Następne stany | Trigger |
|---|---|---|---|
| draft | Niezakończony formularz intake | submitted | Autozapis |
| submitted | Intake wysłany, czeka na triage | under_triage | User confirm |
| under_triage | Operator L1 analizuje | awaiting_documents, eligibility_completed | Operator action |
| awaiting_documents | Brakujące dokumenty — czeka na upload | under_triage | 3/7/30 day alerts |
| eligibility_completed | Silnik kwalifikacji zakończony | awaiting_partner | Engine output |
| awaiting_partner | Czeka na przypisanie partnera | assigned_to_partner | Supervisor |
| assigned_to_partner | Partner zaakceptował sprawę | in_progress | Partner accept |
| in_progress | Sprawa aktywnie prowadzona | awaiting_response, escalated | Partner update |
| negotiation | Faza ugody / settlement | resolved, escalated | Recovery desk |
| escalated | Eskalacja — wymaga interwencji | in_progress | Flag trigger |
| resolved | Sprawa rozwiązana | closed | Settlement |
| closed | Zamknięta — archiwum | archived | Supervisor |
Macierz Compliance
Co wdrażać · warunkowo · czego nie wdrażać
Podstawy Prawne
PL: KC — termin 6M na przyjęcie/odrzucenie spadku od dowiedzenia się o powołaniu.
Rejestr Spadkowy i NORT prowadzone przez KRN. Ustawa o podatku od spadków i darowizn — SD-Z2, SD-3.
| UE: Rozporządzenie nr 650/2012 — prawo właściwe, Europejski Certyfikat Spadkowy.
Portal e-Justice — formularze ECS. | RODO: dane żyjących krewnych chronione,
deceased profiles — brak pełnej ochrony RODO dla danych zmarlego, ale przetwarzane są dane żyjących.
Zielone — Wdrażać od razu
Kwalifikator sprawy spadkowej (Eligibility Engine)
GO · MVP
Standard legal-tech · brak wdrożeniowych ryzyk prawnych
Kalkulator terminów (6M od dowiedzenia się)
GO · MVP
Aktualne reguły KC · Alerty 3/7/30 dni
Łączenie spadkobierców z kancelariami (Marketplace)
GO · MVP
Regulamin platformy + AML/KYC partnerów
Łączenie poszukujących krewnych z genealogami
GO · MVP
Zgody + umowy powierzenia + audyt dostępu
Panel roszczeń o zachowek
GO · MVP
Tylko analiza i obsługa procesu — nie decyzja prawna
Moduł darowizn (SD-Z2, SD-3, kwalifikacja)
GO · MVP
Formularze podatki.gov.pl · terminy zgłoszeń
Document Vault — upload, OCR, legal hold
GO · MVP
Szyfrowanie, signed URLs, audit immutable
Generator pism — draft wezwania, oświadczenia
GO · MVP
Human review przed wysyłką — nie automat
Transgraniczny panel EU (650/2012, ECS checklist)
GO · P2
Stabilna rama UE · partner lokalny wymagany
Żółte — Tylko specjalistycznie
Skaner zwrotów z banku po śmierci
WARUNKOWO
Wyłącznie legalne kanały: pełnomocnictwo + postanowienie + instytucja. Nie open scanner.
Odzyskiwanie środków z rachunków
WARUNKOWO
Formalna podstawa prawna + partner specjalistyczny + human decision
Spory o ruchomości od osób trzecich
WARUNKOWO
Operator L2 + partner recovery + dowód relacji do sprawy
Skaner Rejestrów Notarialnych (NORT)
WARUNKOWO
Wyłącznie przez notariusza-partnera lub uprawniony workflow KRN
Globalny skaner spadków
WARUNKOWO
Tylko publiczne źródła + partnerzy lokalni w danym kraju
Automatyczne „odzyskiwanie" bez review
WARUNKOWO
Człowiek decyzyjny na każdym kroku — AI only assists
Czerwone — Nie wdrażać
Masowe skanowanie prywatnych aktywów / rachunków
NIE
Niedopuszczalne — brak podstawy prawnej
Publiczna baza danych rodzin i majątku
NIE
Zbyt wysokie ryzyko — naruszenie prywatności i RODO
Profiling żyjących krewnych bez podstawy prawnej
NIE
Ryzyko RODO/UODO · konieczna legal basis dla każdego zasobu
„Wykrywanie ukrytych rachunków" bez umocowania
NIE
Wysokie ryzyko prawne i reputacyjne
Automatyczne wysyłanie roszczeń do instytucji
NIE
Wymagana autoryzacja użytkownika i review operatora
Dokumenty Compliance
Minimalny zestaw polityk i procedur
Polityki Główne
Policy Pack
- Polityka Prywatności
- Regulamin Platformy
- Regulamin Partnera
- Polityka Retencji Danych
- Polityka Dostępu do Dokumentów
- Procedura Legal Hold
DPIA
Oceny Skutków
- DPIA — Moduł Family Trace
- DPIA — Moduł Recovery Desk
- Rejestr czynności przetwarzania
- Wzory umów powierzenia
- Wzory zgód i oświadczeń
- Procedura incydentów
Partner Compliance
Partner Pack
- Procedura weryfikacji partnera
- AML/KYC onboarding
- DPA z każdym partnerem
- Procedura family-trace
- Procedura recovery
- SLA + scoring partnera
Reguły Biznesowe
Business rules · triggers · guards
| # | Warunek | Akcja systemu |
|---|---|---|
| R-01 | Data śmierci znana + user dopiero dowiedział się o powołaniu | Termin liczony od daty deklarowanej + flaga legal_review_required |
| R-02 | Majątek w innym kraju UE | cross_border = true · uruchomienie jurisdiction analysis |
| R-03 | Odzyskanie składnika od osoby trzeciej | Wymaga: dowód relacji + podstawa prawna + review partnera lub L2 |
| R-04 | Trace dotyczy żyjących krewnych | Ograniczony dostęp do danych + legal basis log + każde ujawnienie audytowane |
| R-05 | Status: awaiting_documents | D+3: reminder · D+7: reminder + flag operatora · D+30: auto-archive proposal |
| R-06 | AI generuje draft pisma | Zawsze wymaga zatwierdzenia przez human (operator L2 lub legal_reviewer) przed wysyłką |
| R-07 | Partner nie zaakceptował sprawy w SLA | Eskalacja do case_supervisor · propozycja alternatywnego partnera |
Model Monetyzacji
B2C · B2B · Enterprise · Success-based
B2C — Obywatel
Consumer
- Free — screening podstawowy0 PLN
- Raport sprawy49–149 PLN
- Analiza zachowku199 PLN
- Pakiet dokumentów + opieka199–699 PLN
- Success fee — odzyskanie% od wartości
B2B — Partner
Professional
- Abonament kancelariiod 499/mies.
- Lead feeper lead
- Fee za kwalifikację sprawyper case
- Success fee — przekazana sprawa% prowizja
- White-label workflownegocjacja
Enterprise
SaaS Instytucje
- Licencja rocznacustom
- Seat-based accessper seat/rok
- Dedicated workflowcustom
- API do partneracustom
- Private tenancyenterprise
Success-based
Recovery Model
- Odzyskane środki pieniężne% od kwoty
- Odzyskane ruchomości% od wyceny
- Odzyskane nieruchomości% (negocj.)
- Family Trace — odnalezionyflat fee
- Skutecznie zamknięty zachowek% od kwoty
KPI Platformy
Operacyjne · Produktowe · Compliance
90%
Intake → Eligibility
Target completion rate
72h
Czas do 1. kontaktu
SLA od złożenia sprawy
85%
% spraw z pełnym dowodem
Przed przekazaniem do partnera
100%
Audit log pokrycie
Każda akcja zalogowana
25%
Free → Pro conversion
Target B2C
60%
Pro → Partner handoff
Sprawy z partnerem
40%
Recovery success rate
Odzyskany składnik majątkowy
0
Incydenty RODO
Target miesięczny
Przewagi Rynkowe
Differentiators · market positioning
Unikalny Bundle
Jedyna platforma łącząca spadki, darowizny, genealogię i recovery w jednym systemie. Warstwa krajowa + UE w jednym miejscu.
Legal-tech + Ops
Nie tylko portal informacyjny — pełny workflow operacyjny z document vault, partner network i success-based monetization.
Cross-border EU
Realna obsługa Polonii w DACH, Beneluxie i Irlandii — kompletna ścieżka ECS z partnerami lokalnymi.
White-label B2B
Kancelarie i notariusze mogą oferować platformę pod własną marką — otwiera kanał B2B enterprise.
Silnik Terminów
Automatyczne alerty terminów, które klienci regularnie przegapiają — kluczowa wartość unikalna dla B2C.
Nisza Recovery
„Platforma odzyskiwania majątku po śmierci" — pozycja premium, najmocniejsza komercyjnie nisza.
Backlog Dev — 9 Sprintów
Sprint 0–8 · MVP → Launch Ready
Sprint 0 · Fundament
Setup & Infrastructure
- Repo setup (monorepo /apps/web /apps/api)
- CI/CD — GitHub Actions
- Auth skeleton — JWT + refresh
- DB schema v1 — PostgreSQL
- Design system + Tailwind config
- Logging + error tracking (Sentry)
- Env separation + secrets management
- Redis queue — BullMQ setup
Sprint 1 · Auth & Intake
Login + Case Intake
- Login / Register / 2FA / MFA
- Citizen dashboard
- Case intake v1 — dynamiczny formularz
- Create / list / view cases
- Document upload v1
- Case draft autosave
- Consent tracking
- Email verification flow
Sprint 2 · Silnik
Eligibility + Operator
- Eligibility Engine v1
- Kalkulator terminów 6M
- Checklist Engine
- Deadline reminders (D+3/7/30)
- Operator queue + triage
- Audit log v1
- Case status workflow
- Notification service — email/SMS
Sprint 3 · Claims & Partners
Claim Engine + Marketplace
- Claim Engine v1 (zachowek, darowizny)
- Donation Desk v1
- Partner catalog + onboarding
- Partner assignment workflow
- SLA monitoring
- Payment flow basic
- Invoice generation
- Draft generator pism
Sprint 4 · Family Trace
Genealogy & Relatives
- Family Trace v1
- Family graph builder
- Relative management
- Trace tasks queue
- Genealogist partner workflow
- Confidence score engine
- RODO compliance layer dla trace
- Identity verification flow
Sprint 5 · Recovery
Recovery Desk
- Recovery Desk v1
- Assets module (8 typów)
- Settlement flow basic
- Recovery partner workflow
- Formal notice generator
- Timeline tracking
- Ugoda / polubowny track
- Success fee engine
Sprint 6 · Cross-Border
EU Desk & Jurisdictions
- Cross-border v1
- Jurisdiction rules engine
- ECS workflow (checklist)
- Translated case flags
- Foreign partner assignment
- Document translation workflow
- Country-specific rules DB
- Multi-language i18n setup
Sprint 7 · Governance
Admin & Compliance
- Admin governance panel
- RBAC full implementation
- Compliance workflows
- Legal hold v2 — immutable
- Retention jobs automation
- Privacy requests (RODO)
- Export packs (DPIA)
- Fraud flags engine
Sprint 8 · Launch
Hardening + Launch Ready
- Security hardening + pentest prep
- Full QA pass
- Analytics dashboard
- KPI dashboards
- Performance optimization
- Load testing
- White-label config
- Launch readiness checklist
Definicja MVP
In Scope · Out of scope · Acceptance criteria
MVP Scope — In
Co jest w MVP
- Auth (login/register/2FA/MFA)
- Case Intake + Eligibility Engine
- Document Vault v1 (upload, OCR, vault)
- Kalkulator terminów + alerty
- Checklist Generator
- Partner Marketplace + assignment
- Basic Claim Engine (zachowek, darowizna)
- Operator Panel + triage queue
- Audit log + notifications
- Basic Payments
MVP Scope — Out
Co jest poza MVP
- Deep foreign integrations
- Automated institutional connectors
- Advanced Recovery automation
- Heavy AI decisioning
- Full enterprise tenancy
- Family Trace (Sprint 4)
- Recovery Desk (Sprint 5)
- Cross-border EU (Sprint 6)
- White-label full (Sprint 7–8)
- Multi-language (Sprint 6+)
Acceptance Criteria
Citizen · Operator · Partner · Compliance
Citizen
Użytkownik
- Założenie sprawy w <10 min
- Dodanie dokumentów
- Widzi termin i braki
- Widzi status sprawy
- Może opłacić raport / usługę
Operator
Operator
- Widzi kolejki spraw
- Może przypisać sprawę
- Może zmienić status
- Widzi audit trail
- Widzi brakujące elementy
Partner
Partner
- Może odebrać sprawę
- Może uzupełnić status
- Może wgrać raport
- Może rozliczyć usługę
Compliance
Compliance
- Każda akcja zalogowana
- Każdy dostęp do dok. zalogowany
- Można uruchomić legal hold
- Ograniczona retencja i eksport
Architektura Techniczna
Model danych · API endpoints · Tech stack
Frontend
Web App
- React + TypeScript
- Vite · PWA mobile-first
- TanStack Query
- Zustand / Redux Toolkit
- Tailwind CSS
- i18n multi-language
Backend
API Server
- Node.js + NestJS
- TypeScript strict
- REST API modular
- Background jobs — BullMQ
- Redis queue + cache
- Structured logging
Data & Storage
Persistence
- PostgreSQL — primary DB
- Redis — queue + session
- S3-compatible object storage
- Signed URLs dla plików
- Encryption at rest
- Backup daily + offsite
Infrastructure
Infra & DevOps
- Fly.io / Railway EU region
- GitHub Actions CI/CD
- Sentry error tracking
- Docker containers
- ENV separation (dev/stg/prod)
- Secrets management
Model Danych
16 głównych encji · PostgreSQL schema
users
- idPK
- typeenum
- emailvarchar
- phonevarchar
- password_hashtext
- statusenum
- mfa_enabledbool
- created_attimestamptz
cases
- idPK
- public_case_novarchar
- owner_user_idFK
- case_typeenum
- statusenum
- urgency_levelenum
- deadline_attimestamptz
- cross_borderbool
- estimated_valuenumeric
- country_primaryvarchar
deceased_profiles
- idPK
- case_idFK
- first_namevarchar
- last_namevarchar
- birth_datedate
- death_datedate
- last_residence_countryvarchar
- known_testamentbool
claims
- idPK
- case_idFK
- claim_typeenum
- claim_statusenum
- estimated_valuenumeric
- risk_levelenum
- next_actiontext
assets
- idPK
- case_idFK
- asset_typeenum
- countryvarchar
- estimated_valuenumeric
- possession_statusenum
- dispute_statusenum
- holder_typeenum
relatives
- idPK
- case_idFK
- full_namevarchar
- relation_typeenum
- alive_statusbool
- trace_statusenum
- confidence_scorefloat
documents
- idPK
- case_idFK
- document_typeenum
- file_urltext
- file_hashvarchar
- version_noint
- legal_holdbool
- sensitivity_levelenum
audit_events
- idPK
- actor_idFK
- actor_typeenum
- case_idFK
- event_typeenum
- payload_jsonjsonb
- ipinet
- created_attimestamptz
API Endpoints
REST · 12 grup · pełna specyfikacja
Auth
POST/api/auth/registerNowe konto
POST/api/auth/loginLogin
POST/api/auth/refreshRefresh token
POST/api/auth/mfa/verifyMFA verify
GET/api/auth/meCurrent user
Cases
POST/api/casesNowa sprawa
GET/api/casesLista spraw
GET/api/cases/:idSzczegół
PATCH/api/cases/:idAktualizacja
POST/api/cases/:id/submitWyślij intake
GET/api/cases/:id/timelineTimeline
Intake & Eligibility
POST/api/intake/startNowy draft
POST/api/intake/:draftId/saveAutozapis
POST/api/cases/:id/eligibility/runUruchom silnik
GET/api/cases/:id/eligibilityWynik kwalifikacji
GET/api/cases/:id/checklistChecklista
Claims
POST/api/cases/:id/claims/analyzeAnaliza roszczeń
GET/api/cases/:id/claimsLista roszczeń
PATCH/api/claims/:claimIdUpdate
POST/api/claims/:claimId/generate-letterDraft pisma
POST/api/claims/:claimId/escalateEskalacja
Donations
POST/api/cases/:id/donationsNowa darowizna
GET/api/cases/:id/donationsLista darowizn
POST/api/donations/:id/check-taxKwalifikacja podatkowa
GET/api/donations/:id/checklistSD-Z2/SD-3 checklist
Family Trace
GET/api/cases/:id/family-graphGraf rodziny
POST/api/cases/:id/relativesDodaj krewnego
POST/api/cases/:id/family-trace/requestZlecenie trace
GET/api/cases/:id/family-trace/statusStatus trace
POST/api/cases/:id/family-trace/reportRaport genealoga
Assets & Recovery
POST/api/cases/:id/assetsNowy składnik
GET/api/cases/:id/assetsLista składników
POST/api/cases/:id/recovery/startStart recovery
POST/api/cases/:id/recovery/settlementUgoda
POST/api/cases/:id/recovery/escalateEskalacja
Documents
POST/api/cases/:id/documents/uploadUpload
GET/api/cases/:id/documentsLista
POST/api/documents/:id/legal-holdLegal hold
POST/api/documents/:id/extractOCR extract
Partners & Cross-border
GET/api/partnersKatalog partnerów
POST/api/cases/:id/assign-partnerPrzypisz partnera
POST/api/cases/:id/cross-border/analyzeAnaliza cross-border
GET/api/jurisdictionsReguły jurysdykcji
GET/api/jurisdictions/:countryCodeKraj-specific
Admin
GET/api/admin/casesWszystkie sprawy
GET/api/admin/queuesKolejki operatora
GET/api/admin/auditAudit log
GET/api/admin/kpisKPI dashboard
PATCH/api/admin/cases/:id/assignPrzypisanie operatora
Bezpieczeństwo i Security
Required · Must-have · Szczególne
Wymagane Obligatoryjnie
Security Baseline
- RBAC — full tenant-aware access rules
- File malware scan na upload
- Encryption at rest + in transit
- Signed URLs dla plików
- CSRF / XSS / CORS hardening
- Rate limiting + brute-force protection
- Device / session revocation
- Audit log — immutable stream
- Document hash verification
- 2FA / MFA obowiązkowe dla partnerów
Szczególne Zabezpieczenia
Special Controls
- Maskowanie danych żyjących krewnych
- Oddzielny scope dostępu partnerów
- Legal hold — immutable documents
- Eksport akt tylko scoped per user
- Peer review dla akcji wysokiego ryzyka
- Need-to-know access dla dokumentów
- Separacja danych instytucji (B2G)
- Audit dla każdego ujawnienia danych trace
- AI output — human review gate
- DPIA review przed każdym nowym modułem
Struktura Repo
Monorepo · /apps /packages /docs
/apps
/web — React PWA frontend
/api — NestJS backend
/packages
/ui — Design system komponentów
/config — Shared config (ESLint, TS, etc.)
/types — Shared TypeScript types
/shared — Shared business logic
/docs
/product — PRD, user flows, role matrix
/api — API contract, endpoint spec
/compliance — DPIA, privacy model, DPA
/architecture — DB schema, arch diagrams
/runbooks — Incident, backup, release
/scripts — DB seed, migration, setup
/infrastructure — Docker, Fly.io, CI config
/web — React PWA frontend
/api — NestJS backend
/packages
/ui — Design system komponentów
/config — Shared config (ESLint, TS, etc.)
/types — Shared TypeScript types
/shared — Shared business logic
/docs
/product — PRD, user flows, role matrix
/api — API contract, endpoint spec
/compliance — DPIA, privacy model, DPA
/architecture — DB schema, arch diagrams
/runbooks — Incident, backup, release
/scripts — DB seed, migration, setup
/infrastructure — Docker, Fly.io, CI config