Konfiguracja

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

Zmienne środowiskowe

Ustawienia podstawowe

• DB_URL — connection string PostgreSQL (np. jdbc:postgresql://postgres:5432/quotenode)
• DB_ENCRYPTION_KEY — klucz szyfrowania aplikacji używany do danych wrażliwych, w tym zaszyfrowanych poświadczeń SMTP zapisanych w ustawieniach tenanta
• TIMING_TOKEN_SECRET — sekret HMAC dla ochrony timing-token
• PUBLIC_LINK_PASSWORD_SESSION_SECRET — sekret sesji dla chronionych hasłem linków publicznych
• CORS_ALLOWED_ORIGINS — dozwolone originy przeglądarkowe dla API
• DOMAIN — publiczna domena przy użyciu wbudowanego proxy Caddy

E-mail (SMTP)

QuoteNode obsługuje dwa modele konfiguracji SMTP:

• Preferowany dla bezpieczeństwa sekretów: konfiguracja SMTP w Ustawienia > Email SMTP po pierwszym logowaniu administratora.
• Fallback infrastrukturalny: konfiguracja domyślnego mail sendera Springa przez zmienne środowiskowe.

W aktualnej implementacji backendu ustawienia SMTP wpisane w panelu administracyjnym są zapisywane w tenant_settings, a hasło jest szyfrowane przed zapisaniem. Gdy tenant ma własny smtpHost, aplikacja używa właśnie tych ustawień zamiast domyślnego mail sendera z ENV. Jeśli tenant SMTP nie jest skonfigurowany, backend spada do konfiguracji opartej o ENV.

Wybierz ENV wtedy, gdy potrzebujesz gotowego SMTP jeszcze przed pierwszym logowaniem, zarządzasz sekretami centralnie poza aplikacją albo chcesz mieć jedną niezmienną konfigurację dla całej instancji.

Jeśli trzymasz SMTP w panelu administracyjnym, pamiętaj, że odszyfrowanie zapisanego hasła nadal zależy od DB_ENCRYPTION_KEY i od jego poprawnego backupu.

Zmienne SMTP po stronie infrastruktury:

• SMTP_HOST — nazwa hosta serwera SMTP
• SMTP_PORT — port SMTP (typowo 587 dla TLS)
• SMTP_USERNAME — login uwierzytelniania SMTP
• SMTP_PASSWORD — hasło uwierzytelniania SMTP
• SMTP_AUTH — włącz uwierzytelnianie SMTP (true / false)
• SMTP_STARTTLS — włącz STARTTLS (true / false)

Bezpieczeństwo

• AUTH_SESSION_IDLE_TIMEOUT_MIN — timeout bezczynności sesji w minutach
• SECURITY_MAX_FAILED_LOGINS_SOFT — próg nieudanych logowań dla miękkiej obrony
• SECURITY_MAX_FAILED_LOGINS_TEMP_LOCK — próg nieudanych logowań dla blokady czasowej
• SECURITY_TEMP_LOCK_MINUTES — czas trwania blokady czasowej
• 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

Email SMTP

Administrator może skonfigurować SMTP bezpośrednio w aplikacji:

• Host, port, login i hasło
• Nazwa nadawcy i adres nadawcy
• Adres reply-to
• Przełączniki SMTP auth / STARTTLS
• Tryb pracy bez e-maila, jeśli zespół wysyła wiadomości poza QuoteNode
• Test połączenia przed zapisem

Jeśli hasło jest już zapisane, interfejs utrzymuje je jako ukryte i pozwala je świadomie podmienić albo wyczyścić.

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ń.