Dokumentacja

Ten plik pełni rolę przewodnika po dokumentacji projektu. Zebrane niżej materiały są podzielone tematycznie, ale każdy plik ma własny link i jednoakapitowy opis.

Uwaga: część dokumentów jest nowszą wersją innych (np. drzewo decyzji UX w języku polskim jest wersją 2.0 rozbudowaną względem wersji angielskiej).

📊 Analiza rynku, konkurencji i model biznesowy

Ta sekcja zawiera kompleksową analizę rynku polskich generatorów dokumentów prawnych oraz strategiczne rekomendacje biznesowe dla projektu.

Kluczowe dokumenty:

• Analiza konkurencji na polskim rynku
  Szczegółowa analiza polskiego rynku generatorów dokumentów prawnych (Pergamin, Umownik, Enty.io, LEOLEX, Baseline, wFirma itd.) oraz segmentów rynku, w których konkurenci działają; stanowi kontekst dla decyzji produktowych i cenowych.

• Innowacyjne funkcjonalności dające przewagę konkurencyjną
  Propozycja 8 funkcjonalności (Visual Contract Blueprint, AI Negotiation Copilot, Risk Exposure Heat Map, Blockchain Proof-of-Origin, Multi-Jurisdictional Compliance, Predictive Analytics, Expert Marketplace itd.), które tworzą realny „moat” produktowy względem konkurentów.

• Krytyczna analiza biznesowa projektu
  Dogłębna ocena modelu biznesowego „AI Legal Document Generator”: segmenty rynku, wartość proponowanego rozwiązania, analiza konkurencyjna, COGS związane z użyciem LLM, ryzyka prawne i technologiczne oraz rekomendacje dotyczące MVP, RAG i rozszerzeń B2B.

• Model biznesowy i analiza finansowa
  Skoncentrowany opis modeli cenowych (pay-per-document, subskrypcja SaaS, fixed fee/value-based), strumieni przychodów, struktury kosztów (w tym szczegółowe COGS) oraz przykładowej unit economics dla dokumentów szablonowych i premium z AI.

🧱 Architektura techniczna i workflow prawny

Ta sekcja przedstawia techniczną architekturę systemu oraz workflow prawny, który stanowi fundament całego rozwiązania.

Kluczowe dokumenty:

• Opis architektury SLC (Simple–Lovable–Complete)
  Najbardziej kompletna dokumentacja architektury systemu: podejście SLC, pipeline generowania dokumentów, mikroserwisy NestJS, integracja z LLM, RAG, płatnościami, infrastrukturą (Kubernetes, Keycloak, GraphQL) oraz szczegółowa roadmapa wdrożenia.

• Dokumentacja techniczna – model C4 (C1/C2)
  Zwięzły opis architektury w modelu C4 (diagram kontekstu i kontenerów) dla AI Legal Document Generator; rekomendowane jako szybki wizualny wstęp przed wejściem w pełny opis SLC Architecture.

• Systemowy opis workflow prawnego
  Koncepcyjny opis, jak z perspektywy prawa modelować umowy jako dane: model domenowy (Party, Object, Obligation, Risk itd.), kwalifikacja prawna relacji, essentialia/elementy typowe, modułowe „klocki” klauzul, integracja z przepisami bezwzględnie obowiązującymi oraz transparentne uzasadnienie każdej klauzuli.

🎛 UX i doświadczenie użytkownika

Ta sekcja przedstawia projektowanie doświadczenia użytkownika oraz interfejs aplikacji desktopowej.

Kluczowe dokumenty:

• Drzewo decyzji UX (wersja PL 2.0 – rozszerzona)
  Główna, najnowsza wersja drzewa decyzji UX w języku polskim: kompletna podróż użytkownika (8 kroków), powiązanie z koncepcjami workflow prawniczego, szczegółowe diagramy Mermaid oraz wskazówki dotyczące mobile-first, dostępności i optymalizacji kosztów przetwarzania AI.

• UX decision tree (wersja EN 1.0)
  Angielska wersja drzewa decyzji UX opisująca strukturę formularzy, ocenę ryzyka, klasyfikację typu umowy, składanie modułów i przegląd dokumentu; przydatna jako materiał referencyjny dla osób nie mówiących po polsku lub do komunikacji z zespołami międzynarodowymi.

• Desktop UI Views
  Zestaw widoków interfejsu użytkownika aplikacji desktopowej, wizualizujący kluczowe ekrany procesu generowania dokumentów (formularze, podgląd dokumentu, eksport).

🧾 Prezentacje i materiały ogólne

Ta sekcja zawiera prezentacje i materiały, które można wykorzystać w komunikacji z interesariuszami.

Kluczowe materiały:

• Prezentacja – AI Legal Document Generator
  Slajdowa prezentacja projektu zawierająca skróconą narrację biznesową i techniczną – nadaje się do wykorzystania w rozmowach z interesariuszami, inwestorami lub potencjalnymi partnerami.

---

🔁 Uwagi dotyczące wersjonowania i duplikatów

• Analiza biznesowa i finansowa jest rozwijana głównie w dokumentach Business Analysis oraz Business Model; przy dodawaniu nowych szczegółów analitycznych najlepiej rozbudowywać właśnie te dwa dokumenty, zamiast powielać treści w innych plikach.
• Opis architektury technicznej w modelu C4 znajduje się zarówno w Technical Documentation, jak i (w rozszerzonej formie) w SLC Architecture; jako dokument kanoniczny warto traktować SLC Architecture, a „technical‑documentation” zostawić jako krótki wizualny wstęp.
• Dla drzew decyzyjnych UX dokument kanoniczny stanowi wersja polska 2.0 (UX Decision Tree PL); wersja angielska powinna być traktowana jako materiał pomocniczy/marketingowy, a nie główne źródło prawno‑produktowej prawdy.