FAQ - emielregis2/SmartFlowAI GitHub Wiki

FAQ - Często Zadawane Pytania

Znajdź odpowiedzi na najczęściej zadawane pytania o SmartFlowAI! 🤔

🚀 Podstawowe pytania

❓ Co to jest SmartFlowAI?

SmartFlowAI to aplikacja webowa, która analizuje procesy biznesowe przez ChatGPT-4o i generuje konkretne rekomendacje automatyzacji. Pomaga firmom zidentyfikować wąskie gardła i zaproponować rozwiązania technologiczne.

❓ Czy SmartFlowAI jest darmowy?

Aplikacja jest open source i można ją uruchomić za darmo lokalnie. Jednak wymaga:

  • Klucza OpenAI API (płatny - ~$0.01-0.03 za analizę)
  • Konta Supabase (darmowe do 500MB bazy danych)

❓ Jakie są wymagania systemowe?

  • Python 3.11+
  • 4GB RAM (minimum)
  • Połączenie internetowe (dla API OpenAI)
  • Przeglądarka (Chrome, Firefox, Safari, Edge)

❓ Czy mogę używać SmartFlowAI komercyjnie?

Tak! Aplikacja jest na licencji MIT, więc możesz:

  • ✅ Używać komercyjnie
  • ✅ Modyfikować kod
  • ✅ Dystrybuować
  • ✅ Sprzedawać jako usługę

🔧 Instalacja i konfiguracja

❓ Jak uzyskać klucz OpenAI API?

  1. Przejdź na platform.openai.com
  2. Zarejestruj się lub zaloguj
  3. Przejdź do API Keys
  4. Kliknij "Create new secret key"
  5. Skopiuj klucz (zaczyna się od sk-)

Koszt: ~$0.01-0.03 za jedną analizę procesu

❓ Jak skonfigurować Supabase?

  1. Przejdź na supabase.com
  2. Utwórz nowy projekt (darmowy)
  3. Przejdź do Settings → API
  4. Skopiuj URL i anon key
  5. Przejdź do SQL Editor
  6. Uruchom skrypt supabase_setup.sql

❓ Gdzie umieścić klucze API?

Utwórz plik .streamlit/secrets.toml:

SUPABASE_URL = "https://twoj-projekt.supabase.co"
SUPABASE_ANON_KEY = "twoj_anon_key"
SUPABASE_SERVICE_ROLE_KEY = "twoj_service_role_key"
OPENAI_API_KEY = "sk-twoj_openai_klucz"
DEMO_MODE = false

❓ Błąd "Invalid API key" - co robić?

  1. Sprawdź klucze - Upewnij się, że są poprawne
  2. Usuń spacje - Klucze nie mogą mieć spacji na początku/końcu
  3. Sprawdź Supabase - Czy projekt jest aktywny?
  4. Restart aplikacji - Ctrl+C i uruchom ponownie

🤖 Analiza AI

❓ Ile kosztuje jedna analiza?

OpenAI GPT-4o:

  • Podstawowa: ~$0.01 (15-30 sekund)
  • Pogłębiona: ~$0.02 (30-60 sekund)
  • Ekspercka: ~$0.03 (60-90 sekund)

Przykład: 50 analiz miesięcznie = ~$1-1.50

❓ Jak długo trwa analiza?

  • Podstawowa: 15-30 sekund
  • Pogłębiona: 30-60 sekund
  • Ekspercka: 60-90 sekund

Czas zależy od obciążenia serwerów OpenAI.

❓ Czy AI ma dostęp do internetu?

Tak! ChatGPT-4o może wyszukiwać aktualne informacje z 2025 roku, w tym:

  • Ceny narzędzi automatyzacji
  • Nowe integracje i API
  • Aktualne trendy w branży
  • Porównania rozwiązań

❓ W jakich językach działa AI?

Aplikacja jest w języku polskim, ale AI rozumie i odpowiada w:

  • 🇵🇱 Polski (główny)
  • 🇬🇧 Angielski
  • 🇩🇪 Niemiecki
  • 🇫🇷 Francuski
  • I innych językach

❓ Czy AI pamięta poprzednie analizy?

Nie. Każda analiza jest niezależna. AI nie ma dostępu do:

  • Poprzednich procesów użytkownika
  • Danych innych użytkowników
  • Historii konwersacji

📊 Funkcjonalności

❓ Czy mogę edytować procesy po analizie?

Tak! Możesz:

  • ✅ Edytować nazwę procesu
  • ✅ Modyfikować opis
  • ✅ Zmieniać analizę AI
  • ✅ Ponownie analizować z nowymi parametrami

❓ Jak eksportować wyniki?

SmartFlowAI oferuje:

  • 📄 PDF - Profesjonalny raport (do 10 procesów)
  • 📋 Schowek - Pełny tekst wszystkich procesów
  • 💾 Tekst - Plik .txt do pobrania

❓ Czy mogę udostępnić wyniki zespołowi?

Tak! Możesz:

  • Eksportować PDF i wysłać mailem
  • Skopiować tekst do Slack/Teams
  • Udostępnić link do pliku tekstowego
  • Wydrukować raport

❓ Ile procesów mogę dodać?

Bez limitu! Ograniczenia:

  • Supabase darmowy: 500MB bazy (tysiące procesów)
  • OpenAI: Limit API według Twojego planu
  • Aplikacja: Brak technicznych ograniczeń

🔒 Bezpieczeństwo i prywatność

❓ Czy moje dane są bezpieczne?

Tak! SmartFlowAI używa:

  • Supabase - Enterprise-grade bezpieczeństwo
  • Row Level Security - Każdy użytkownik widzi tylko swoje dane
  • HTTPS - Szyfrowane połączenia
  • Hashed passwords - Hasła są zahashowane

❓ Czy OpenAI ma dostęp do moich procesów?

Tak, ale:

  • OpenAI nie przechowuje danych po analizie
  • Dane nie są używane do trenowania modeli
  • Nie ma dostępu do innych Twoich procesów
  • Możesz usunąć procesy w każdej chwili

❓ Czy mogę usunąć swoje dane?

Tak! Możesz:

  • Usunąć pojedyncze procesy
  • Usunąć całe konto (skontaktuj się z administratorem)
  • Eksportować dane przed usunięciem

❓ Gdzie są przechowywane dane?

  • Baza danych: Supabase (AWS, Europa/USA)
  • Aplikacja: Streamlit Cloud (USA)
  • AI: OpenAI (USA)

🚀 Wydajność i skalowanie

❓ Czy aplikacja jest szybka?

Tak! Typowe czasy:

  • Logowanie: <1 sekunda
  • Lista procesów: 1-2 sekundy
  • Analiza AI: 15-90 sekund (zależy od poziomu)
  • Export PDF: 2-5 sekund

❓ Ile użytkowników może używać jednocześnie?

Streamlit Cloud:

  • Darmowy plan: ~10-20 użytkowników jednocześnie
  • Płatny plan: Bez ograniczeń

Lokalne uruchomienie: Zależy od serwera

❓ Czy mogę uruchomić na własnym serwerze?

Tak! SmartFlowAI można uruchomić na:

  • VPS (DigitalOcean, Linode)
  • Cloud (AWS, Google Cloud, Azure)
  • Docker (konteneryzacja)
  • Kubernetes (skalowanie)

🛠️ Rozwój i wsparcie

❓ Czy mogę dodać nowe funkcje?

Tak! SmartFlowAI to open source:

  • Fork repozytorium na GitHub
  • Dodaj nowe funkcje
  • Utwórz Pull Request
  • Podziel się z społecznością

❓ Jak zgłosić błąd?

  1. Przejdź na GitHub Issues
  2. Kliknij "New Issue"
  3. Opisz problem szczegółowo
  4. Dodaj zrzuty ekranu (jeśli możliwe)
  5. Podaj kroki do reprodukcji

❓ Czy będą nowe funkcje?

Planowane funkcje:

  • 🔄 Automatyczne monitorowanie wdrożonych rozwiązań
  • 📊 Analiza ROI po wdrożeniu
  • 👥 Współpraca zespołowa nad procesami
  • 🔗 API dla integracji z innymi systemami
  • 📱 Aplikacja mobilna

❓ Jak mogę pomóc w rozwoju?

  • ⭐ Gwiazdka na GitHub
  • 🐛 Zgłaszanie błędów
  • 💡 Propozycje funkcji
  • 🔧 Pull Requests
  • 📖 Dokumentacja
  • 💬 Feedback od użytkowników

💼 Biznesowe pytania

❓ Czy SmartFlowAI zastąpi konsultantów?

Nie! SmartFlowAI to narzędzie, które:

  • Wspiera konsultantów w analizie
  • Przyspiesza proces identyfikacji rozwiązań
  • Standardyzuje podejście do automatyzacji
  • Nie zastępuje ludzkiej ekspertyzy i doświadczenia

❓ Dla jakich firm jest SmartFlowAI?

Idealne dla:

  • Małe firmy (1-50 osób) - Proste automatyzacje
  • Średnie firmy (50-200 osób) - Zaawansowane integracje
  • Konsultanci - Narzędzie do analizy klientów
  • Agencje - Standardyzacja procesów

Mniej odpowiednie dla:

  • Bardzo duże korporacje (1000+ osób) - Potrzebują custom solutions
  • Firmy bez procesów cyfrowych - Najpierw digitalizacja

❓ Jaki jest ROI z automatyzacji?

Typowe oszczędności:

  • Czas: 70-95% redukcja czasu na proces
  • Błędy: 80-95% mniej błędów
  • Koszty: 20-50% redukcja kosztów operacyjnych
  • ROI: 200-500% w pierwszym roku

Przykład: Automatyzacja fakturowania za 500 zł/mies może zaoszczędzić 40h/mies = 4000 zł wartości czasu.

Nie znalazłeś odpowiedzi? Sprawdź Rozwiązywanie Problemów lub utwórz Issue na GitHub!