docs/README_TESTERS.md

# 🚀 GrantForge AI – Przewodnik dla Testerów Beta

Witaj w fazie beta platformy **GrantForge AI**! Twoja pomoc jest kluczowa w przygotowaniu systemu do publicznego uruchomienia. Poniższy przewodnik pomoże Ci zapoznać się ze środowiskiem testowym oraz wdrożonymi nowościami.

## 📦 Co nowego w aktualnej wersji (Faza 6)

Platforma przeszła znaczącą ewolucję. Oto kluczowe mechanizmy, które wdrożyliśmy i które wymagają szczególnej uwagi podczas testów:

1. **Advanced AI Matcher (z Human-in-the-Loop):**
   System nie tylko dopasowuje programy, ale potrafi teraz zadawać **pytania doprecyzowujące**, jeśli brakuje mu danych (np. o status MŚP, kody PKD). Zebrane odpowiedzi są wykorzystywane podczas generowania wniosku.
2. **GraphRAG i Weryfikacja MŚP:**
   Dzięki integracji z bazą grafową Neo4j oraz Rejestrem.io, system automatycznie analizuje powiązania kapitałowe (powyżej 50% / 25%) w celu weryfikacji statusu MŚP (Mikro, Małe, Średnie Przedsiębiorstwo).
3. **Multi-Agent Auditor (Reverse-Audit):**
   Nasz audytor składa się teraz z wyspecjalizowanych agentów (Prawnik, Finansista, Ekspert UE). Możesz także przeprowadzić tzw. "Reverse-Audit", czyli wgrać zewnętrzny, gotowy wniosek do oceny.
4. **Raport Spójności (Holistic Review):**
   Dodatkowa zakładka generująca głęboką analizę logiczną, finansową i zgodności z zasadą DNSH całego wygenerowanego wniosku.
5. **Eksport PDF/DOCX (Szablon Enterprise):**
   Generowanie profesjonalnie sformatowanych plików przy użyciu silnika WeasyPrint oraz dedykowanego szablonu DOCX.

---

## 🛣️ Jak zacząć testy?

1. Zaloguj się podanym kontem testowym na środowisko beta.
2. Na **Dashboardzie** wybierz opcję utworzenia nowego projektu lub przejdź do zakładki **/beta** w celu zapoznania się z szybkim onboardingiem.
3. Postępuj zgodnie z przygotowanymi scenariuszami w pliku [TEST_SCENARIOS.md](TEST_SCENARIOS.md).
4. Oczekujemy, że przejdziesz przez wszystkie scenariusze od początku do końca, zgłaszając każdą nieprawidłowość.

---

## 🚫 Jak zgłaszać błędy?

Zadbaliśmy o to, by proces zgłaszania uwag był jak najwygodniejszy:

### 1. Formularz w Aplikacji (ZALECANE)
Przejdź do podstrony **`/beta`** w aplikacji. Znajdziesz tam dedykowany formularz "Zgłoś błąd / Prześlij Feedback". 
Wypełnij krótki opis, zaznacz jakiego modułu dotyczy problem i kliknij "Wyślij".

### 2. Droga Mailowa (Fallback)
Jeśli aplikacja nie działa (np. błąd 500, problem z logowaniem) lub chcesz przesłać obszerniejszą analizę wraz z kilkoma zrzutami ekranu, napisz bezpośrednio na:
**`support@grantforge.ai`**

**W zgłoszeniu (szczególnie mailowym) podaj:**
- **Gdzie:** Jakiej zakładki / funkcji dotyczy problem (np. Advanced Matcher).
- **Kroki:** Co kliknąłeś/aś, co wpisałeś/aś przed wystąpieniem błędu.
- **Zrzut ekranu:** Bardzo pomaga w diagnozie wizualnej.
- **Oczekiwany rezultat vs Rzeczywisty:** Co się stało, a co według Ciebie powinno się stać.

---

Dziękujemy za Twój czas i zaangażowanie! Każdy zgłoszony błąd przybliża nas do stworzenia najlepszego na rynku systemu dla doradców i firm. 🙌