Konfiguracja

QuoteNode jest konfigurowany przez zmienne środowiskowe (infrastruktura) oraz panel administracyjny (ustawienia biznesowe).

Zmienne środowiskowe

Ustawienia podstawowe

• DATABASE_URL — connection string PostgreSQL (np. jdbc:postgresql://db:5432/quotenode)
• SECRET_KEY — używany do szyfrowania sesji i generowania tokenów. Minimum 32 znaki.
• APP_BASE_URL — publiczny URL instancji (np. https://app.quotenode.dev). Używany w linkach publicznych do ofert i w e-mailach.

E-mail (SMTP)

Skonfiguruj, aby umożliwić wysyłkę ofert i powiadomień:

• SMTP_HOST — nazwa hosta serwera SMTP
• SMTP_PORT — port SMTP (typowo 587 dla TLS)
• SMTP_USER — login uwierzytelniania SMTP
• SMTP_PASSWORD — hasło uwierzytelniania SMTP
• SMTP_FROM — adres e-mail nadawcy (np. [email protected])
• SMTP_TLS — włącz TLS (true / false)

Bezpieczeństwo

• SESSION_LIFETIME — czas trwania sesji w sekundach (domyślnie: 3600)
• BRUTE_FORCE_MAX_ATTEMPTS — nieudane próby logowania przed blokadą (domyślnie: 5)
• BRUTE_FORCE_COOLDOWN — czas blokady w sekundach (domyślnie: 1800)
• IP_WHITELIST — lista dozwolonych adresów IP oddzielonych przecinkami (opcjonalnie)
• ENCRYPT_PII — włącza szyfrowanie danych osobowych na poziomie kolumn (AES-256-GCM) w bazie danych (true / false, domyślnie: false). Po włączeniu imiona, e-maile, telefony i NIP-y klientów są szyfrowane w spoczynku. Wymaga DB_ENCRYPTION_KEY. Szczegóły i kompromisy na stronie Bezpieczeństwo.

Panel administracyjny

Po zalogowaniu jako administrator przejdź do Ustawienia, aby skonfigurować:

Firma i branding

• Nazwa firmy — wyświetlana na ofertach, PDF i w e-mailach
• Logo — PNG lub SVG, używane w nagłówkach ofert, PDF i na stronie publicznej
• Kolor główny i kolor akcentujący — stosowane do ofert, PDF i strony publicznej
• Adres firmy, telefon, e-mail — wyświetlane w stopce oferty i warunkach handlowych
• Dane rejestrowe — NIP, KRS, sąd rejestrowy (wyświetlane w stopce PDF)

Domyślne ustawienia ofert

• Domyślny okres ważności — ile dni nowe oferty są ważne (domyślnie: 30)
• Domyślny tryb cen — netto, brutto lub netto+VAT+brutto
• Domyślna waluta — waluta bazowa dla nowych ofert
• Warunki handlowe — warunki płatności, gwarancji, dostawy (wstępnie wypełnione w każdej nowej ofercie)

Waluty i kursy

• Włączone waluty — które waluty są dostępne w ofertach
• Źródło kursów — ręczne lub automatyczne (integracja NBP/ECB planowana)
• Waluta bazowa — używana w raportach lejka i przeliczeniach wielowalutowych

Konfiguracja VAT

• Grupy VAT — zdefiniuj dostępne stawki (23%, 8%, 5%, 0%, zwolniony)
• Domyślna grupa VAT — stosowana do nowych produktów i niestandardowych pozycji

Powiadomienia

Preferencje powiadomień per użytkownik dla każdego typu zdarzenia:

• Kanały: W aplikacji, e-mail lub oba
• Częstotliwość: Natychmiast, zestawienie dzienne lub wyłączone
• Zdarzenia: Oferta otwarta, zaakceptowana, odrzucona, odpowiedź, wygasająca, PDF gotowy

Użytkownicy i role

• Admin — pełny dostęp do wszystkich ustawień i danych
• Manager — może przeglądać wszystkie oferty i raporty, zarządzać zespołem
• Handlowiec — może zarządzać własnymi klientami i ofertami
• Widz — dostęp tylko do odczytu do przypisanych danych

Kreator wdrożeniowy

Przy pierwszym logowaniu administrator jest prowadzony przez kreator krok po kroku, który obejmuje dane firmy, przesłanie logo, konfigurację SMTP i utworzenie początkowych użytkowników. Kreator jest dostępny ponownie z panelu ustawień.