Edukacyjny generator dokumentów prawnych
Jak działa Legal Docs Edu?
Legal Docs Edu to prototypowy system, który pomaga uczniom zrozumieć strukturę i logikę dokumentów prawnych. Aplikacja generuje dokumenty o długości maksymalnie dwóch stron (do 3500 znaków), wykorzystując silnik Google Gemini i zaprojektowany interfejs w estetyce Clean & Modern Design.
Kolorystyka i interfejs
Interfejs został zaprojektowany tak, by prowadzić wzrok wprost na centralne pole tekstowe i gotowe wzory dokumentów. Całość bazuje na Tailwind CSS, komponentach shadcn/ui oraz trybie jasnym i ciemnym obsługiwanym przez next-themes.
Czystość i minimalizm
Dużo „powietrza” i brak rozpraszaczy skupia uwagę na opisie dokumentu i przycisku „Generuj”.
Dualny motyw
Wsparcie dla jasnego i ciemnego motywu zapewnia komfort pracy na różnych urządzeniach.
Dostępność dla 8+
Duże kontrasty, czytelne nagłówki i responsywny układ wspierają młodych użytkowników.
Gotowe wzory dokumentów
Użytkownik może zacząć od pustego opisu lub skorzystać z gotowych promptów AI. Każdy wzór ma własny ikonograficzny kafel.
Każdy dokument kończy się klauzulą edukacyjną przypominającą, że treść jest materiałem dydaktycznym, nie poradą prawną.
Architektura i przepływ danych
Kluczowe elementy architektury:
- •Frontend: Next.js 14 (App Router) z komponentami shadcn/ui, walidacja formularzy przez Zod, animacje framer-motion
- •Backend: Serverless API routes na Vercel z Node.js, hashowanie bcrypt dla kodów autoryzacyjnych
- •Baza danych: Supabase PostgreSQL z tabelami: credits (UUID + hashed auth codes), analysis_results (logi użycia), failed_attempts (audit trail)
- •AI Engine: Google Gemini API (gemini-3-flash-preview) z dwuetapową walidacją
- •Bezpieczeństwo: Cloudflare Turnstile CAPTCHA, bcrypt hashing, rate limiting, detailed logging
Dwuetapowa walidacja AI:
- STAGE 1Walidacja czy prompt dotyczy dokumentu prawnego (umowa, statut, uchwała, etc.) - odpowiedź TAK/NIE
- STAGE 2Generowanie dokumentu zgodnie z techniką prawodawczą (max 3500 znaków) z klauzulą edukacyjną
Schemat działania krok po kroku
Cały proces przypomina współpracę z profesjonalnym biurem projektowym – Ty opisujesz ideę, a AI przygotowuje dokument zgodnie z rygorystycznymi normami.
Inicjacja i autoryzacja
Uczeń opisuje dokument (np. „Statut fikcyjnego państwa”) oraz wpisuje kod dostępu. Supabase sprawdza poprawność kodu i dostępne kredyty.
Przetwarzanie przez AI
Zapytanie trafia do serwera. Google Gemini analizuje polecenie zgodnie z zasadami techniki prawodawczej i przygotowuje dokument edukacyjny.
Generowanie i zabezpieczenie
Po wygenerowaniu treści system odejmuje kredyt, formatuje dokument (maks. dwie strony / 3500 znaków) i dodaje sekcję klauzul edukacyjnych.
Odbiór i edukacja
Uczeń otrzymuje gotowy dokument wraz z klauzulą edukacyjną i może go przeanalizować samodzielnie lub z nauczycielem.
Analogia:
To jak zamówienie projektu w biurze architektonicznym – podajesz pomysł, system weryfikuje dostęp i zasoby, a AI-Gemini tworzy plan zgodnie z normami „budowlanymi” (techniką prawodawczą). Gotowy projekt trafia do Ciebie razem z notatkami edukacyjnymi.
Najważniejsze ograniczenia i zasady
- ✅ Dokumenty generowane są wyłącznie w celach edukacyjnych – każda odpowiedź zawiera klauzulę ⚖️.
- ✅ Maksymalna długość dokumentu to 3500 znaków (~2 strony), co wymusza klarowność i spójność treści.
- ✅ Wszystkie zapytania przechodzą dwustopniową walidację (czy to dokument prawny + generowanie treści).
- ✅ Każdy wygenerowany dokument zmniejsza liczbę kredytów przypisanych do kodu dostępu.
- ✅ Interfejs jest w pełni responsywny i zoptymalizowany pod urządzenia mobilne.