grantforge-api / docs /README_TESTERS.md
GrantForge Bot
Deploy to Hugging Face
afd56bc
# 🚀 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. 🙌