docs/BETA_TESTING.md

# Przewodnik Biznesowy i Prezentacyjny (Golden Path)

Ten dokument jest dedykowany dla interesariuszy biznesowych, konsultantów oraz inżynierów z zespołu wdrożeniowego / sprzedażowego. Ma on pomóc w sprawnym zaprezentowaniu pełnej wartości biznesowej systemu **GrantForge AI** przed potencjalnymi klientami.

## Główne Cele Aplikacji

GrantForge AI to zaawansowana platforma ekspercka do wspomagania procesu aplikowania o dofinansowanie unijne i krajowe (np. Ścieżka SMART, KPO). Wykracza daleko poza możliwości "czatbotów", integrując zaawansowane mechaniki GraphRAG, Multi-Agent Auditor oraz interaktywny dobór dotacji. System działa jako inteligentny "Co-pilot" dla doradców.

## Słowniczek Użytkowy
* **Advanced AI Matcher:** Moduł interaktywnego doboru dotacji. Jeśli brakuje danych, zadaje użytkownikowi pytania doprecyzowujące (np. o strukturę kapitałową).
* **GraphRAG (Neo4j):** Architektura grafowa zintegrowana z Rejestrem.io, pozwalająca systemowi badać ukryte powiązania kapitałowe, by weryfikować rygorystyczny status MŚP.
* **Workspace (ProjectWorkspace):** Główne środowisko pracy nad sekcjami wniosku.
* **Holistic Review (Raport Spójności):** Kompleksowa ocean całego wniosku pod kątem spójności finansowej, logicznej oraz zasady DNSH.
* **Multi-Agent Auditor:** Zespół specjalistów AI (Prawnik, Finansista, Ekspert UE) analizujący dokument na żywo w oparciu o graf powiązań i oficjalne bazy RAG.
* **Reverse-Audit:** Funkcja pozwalająca wgrać klientowi gotowy, napisany zewnętrznie wniosek w celu jego weryfikacji i "wyłapania" błędów przed złożeniem.

## Skrypt Prezentacyjny (Ścieżka Złota - Golden Path)

Dla najlepszego wrażenia na kliencie, polecamy przeprowadzić prezentację w następujący sposób:

1. **Dashboard i Wprowadzenie:**
   * Zaloguj się na środowisko. Omów bezpieczeństwo i architekturę.
   * Rozpocznij nowy projekt. Wpisz testowy NIP klienta, pokazując integrację z GUS.

2. **Advanced AI Matcher w Akcji:**
   * Po podaniu ogólnego zarysu projektu, system AI nie daje od razu wyników - zadaje 2-3 **pytania doprecyzowujące** (np. "Jaki jest planowany TRL?", "Czy wdrożenie obejmuje innowację w skali kraju?").
   * Odpowiedz na pytania na żywo.
   * Zobacz, jak system dopasowuje optymalny program (np. Ścieżka SMART) tłumacząc w %) dopasowanie na bazie udzielonych przed chwilą odpowiedzi.

3. **Weryfikacja Statusu MŚP (GraphRAG):**
   * Wywołaj weryfikację MŚP. System pobiera dane z Rejestr.io (lub z symulatora powiązań).
   * Pokaż klientowi, jak system na grafie (Neo4j) wykrywa, że firma wnioskodawcy posiada 30% udziałów w firmie X oraz 55% udziałów w firmie Y.
   * System automatycznie konsoliduje pracowników i obroty, weryfikując czy firma na pewno kwalifikuje się jako MŚP. To moment "AHA!" dla wielu doradców, którzy robią to ręcznie.

4. **Kreator i Autopilot AI (Workspace):**
   * Przejdź do edytora sekcji. Uruchom "Autopilota AI".
   * System, bazując na zebranym wywiadzie (z Matchera) i statusie MŚP, generuje zarysy najważniejszych sekcji wniosku.

5. **Multi-Agent Auditor (Raport Spójności):**
   * Uruchom Głęboką analizę (Holistic Review). 
   * Agent Finansista wychwytuje brak spójności w kwotach, a Agent Prawnik ostrzega o ryzykach związanych z limitami dla wykrytych firm powiązanych.
   * Wykorzystaj "Autofix", aby AI zaproponowało poprawki do uwag audytu.

6. **Eksport i Wynik Końcowy:**
   * Na koniec kliknij "Eksportuj do PDF" lub "DOCX".
   * Zaprezentuj piękny, ostateczny dokument ułożony w dedykowanym "Szablonie Enterprise", z nałożonym logo, metadanymi, stopką oraz poprawnym formatowaniem gotowym do edycji w Wordzie.

7. **Bonus: Reverse-Audit:**
   * Pokaż, że aplikacja potrafi też sprawdzić wgrany PDF/DOCX (obcy wniosek) wytykając jego słabe strony.

Dzięki temu flow, pokazujemy, że GrantForge AI to nie generator tekstu, ale **rozbudowana maszyna analityczna**, która redukuje ryzyko odrzucenia wniosku ze względów formalnych (MŚP) i finansowych.