SAVA — ładowanie

System Kalkulacji — logowanie

👁

System KalkulacjiDrewniane domy prefabrykowane
1 EUR =
🏗️ Dane projektu
?
📋 Wycena etapów budowy
📊 Podsumowanie
%
Elementy konstrukcji0,00 zł
Etapy budowy0,00 zł
Koszt własny łącznie0,00 zł
Marża (30%)0,00 zł
Cena przed rabatem0,00 zł
Cena dla klienta0,00 zł

📁 Historia ofert
📦 Zestawienie materiałów prefabrykowanych — zamówienie
Na podstawie wybranych elementów w kalkulatorze

Wybierz elementy w kalkulatorze, aby zobaczyć zestawienie materiałów.

🧱 Cennik 2.0 (receptury materiałowe)

Pełna kontrola nad materiałami, panelami i recepturami. Zmiana ceny materiału automatycznie aktualizuje wszystkie panele które go używają.

📋 Specyfikacja projektu — etapy budowy
Źródło: arkusz CRM z kalkulatora

Poniższa specyfikacja opisuje zakres prac w każdym etapie budowy domu prefabrykowanego SAVA. Możesz ją dołączyć do oferty PDF jako załącznik zakresu prac. Klikając na opis lub szczegół możesz go edytować pod konkretnego klienta.

📋 Dane oferty

Dane klienta

UL.

📊 Kalkulacja

Wybierz elementy w kalkulatorze.

👁️ Podgląd PDF
📄

Wybierz elementy w kalkulatorze.

🏢 Dane firmy

SAVA Group Sp. z o.o.

ul. Domaniewska 47/1, 02-672 Warszawa

📞 +48 22 243 68 03

✉️ warszawa@savagroup.pl


NIP: 5262381626 | KRS: 0000188875 | REGON: 016097814
Zakład: ul. Mazowiecka 9, 09-100 Płońsk

📖 Instrukcja użytkowania

🧮 1. Wycena krok po kroku

  1. Wprowadź dane projektu w karcie "Dane projektu" (powierzchnie, kondygnacje). 💡 Zamiast wpisywać ręcznie — kliknij 📄 Wczytaj z PDF/JPG (AI) i wgraj 3–5 stron projektu. Szczegóły: sekcja 6. Import PDF (AI).
  2. Rozwiń kolejno etapy ETAP 0 do ETAP 9 i zaznacz potrzebne pozycje. Większość metrów wypełni się automatycznie z pól Dane projektu — patrz sekcja 3. Auto-fill m².
  3. Sprawdź komunikaty walidacyjne (czerwone): "przekroczono +X m²" / "brakuje -X m²" — sygnalizują rozjazd między projektem a zaznaczeniem. Zlokalizuj i napraw.
  4. Ustaw marżę i ewentualny rabat w panelu po prawej. Patrz sekcja 5. Marża i rabat.
  5. Przejdź do zakładki 📄 Oferta PDF, wypełnij dane klienta, wybierz wersję specyfikacji (skrócona / pełna), wygeneruj PDF.
  6. Zapisz ofertę — pojawi się w Historii ofert i możesz do niej wrócić w każdej chwili.

📐 2. Pola Dane projektu

Trzy kluczowe powierzchnie (rozróżniaj!):
  • Pow. zabudowy (Ag) — rzut parteru po zewnętrznym obrysie ścian. Jeden „cień" budynku z góry.
  • Pow. całkowita (Pc) — suma wszystkich kondygnacji (parter + piętro + poddasze + garaż wbudowany), też po obrysie zewnętrznym.
  • Pow. użytkowa (Pu) — TYLKO mieszkalna: BEZ garażu, kotłowni, klatki, balkonów, strychów. Najmniejsza z trzech.
💡 Zasada: Pu < Ag ≤ Pc. W charakterystyce energetycznej projektu: Pn ≈ Pc, Af ≈ Pu lub Pn.
  • Pow. ścian zewnętrznych / wewnętrznych / dachu / stropów / okien — szukaj w "Zestawieniu przegród" projektu. Jeśli brak — pomijaj, system policzy z zaznaczonych paneli.
  • Liczba kondygnacji — zwykle 1 (parter) lub 2 (parter + poddasze użytkowe).
  • Wysokość kondygnacji — z przekroju budynku (typowo 2.50–2.97 m).

🧮 3. Auto-fill metrów kwadratowych

System automatycznie wypełnia pola metrów na podstawie wpisanych powierzchni — zaoszczędzasz dziesiątki kliknięć:

Pole projektuAuto-wypełnia
Pow. zabudowyFundament, wylewka, ogrzewanie
Pow. użytkowaOkna, instalacje elektryczne, wentylacja, rekuperacja
Pow. ścian zewn.Panele sz (ściany zewn.), elewacja
Pow. ścian wewn.Panele sd (ściany działowe)
Pow. dachuPanele pd (panele dachowe)
Pow. stropówPanele ps (panele stropowe)
Suma m² z ETAP 2+3Transport (ETAP 9), montaż finalny
⚙ Indywidualny przelicznik — jeśli ręcznie zmienisz wartość w polu metrów, pojawi się złoty badge i auto-fill nigdy więcej nie nadpisze tej wartości. ✅ Aby przywrócić auto-fill: odznacz checkbox panelu i zaznacz ponownie — badge zniknie.

🏗️ 4. Etapy 0–9

  • ETAP 0indywidualne: projekt konstrukcyjny (kwota), drewno klejone (m³ × cena), drewno dodatkowe (m³ × 1630 zł), stal (t × 450 zł). Wpisz wartość ręcznie przy każdej pozycji.
  • ETAP 1 — fundament (auto z Pow. zabudowy)
  • ETAP 2 — ściany zewn., działowe, panele stropowe i podłogowe (auto z pól projektowych)
  • ETAP 3 — dach: panele dachowe + attyki (auto z Pow. dachu)
  • ETAP 4 — elewacja (auto z Pow. ścian zewn.)
  • ETAP 5 — instalacje (część auto z Pu, część manualnie — wpisz kwotę przy specjalnych pracach)
  • ETAP 6 — wykończenia wewnętrzne
  • ETAP 7 — okna, drzwi (Q1, Q2 z formuły: ścian zewn + 2× wewn + dach + stropy)
  • ETAP 8 — prace dodatkowe (manualne kwoty — wpisz indywidualnie)
  • ETAP 9 — transport i montaż finalny (auto z m² paneli)

💰 5. Marża i rabat

  • Marża — Twój zysk procentowy nad ceną bazową. Domyślnie 0%. Maksimum bez limitu.
  • Rabat dla klienta — możesz dać % lub kwotę zł. ⚠️ Limit: rabat nie może być większy niż Twoja marża (system zablokuje).
  • Klient w PDF widzi tylko: cena bazowa × (1 + marża%) − rabat = CENA CAŁKOWITA NETTO. Marża jest ukryta.

📄 6. Import PDF / JPG (AI)

Funkcja używa AI do automatycznego odczytania danych z projektu architektonicznego — wypełnia pola Dane projektu.

✅ Wgraj (3–5 stron):
  • Charakterystyka energetyczna (tabela powierzchni)
  • Rzut parteru z wymiarami
  • Rzut piętra/poddasza (jeśli jest)
  • Przekrój budynku
  • Zestawienie stolarki okiennej
❌ Unikaj:
  • Pełnego projektu wykonawczego (50+ stron)
  • Słabej jakości skanów / krzywych zdjęć
  • Plików większych niż 5 MB każdy
  • Łącznie max 18 MB i 10 plików

⚠️ AI to podpowiedź, nie wyrocznia. Zawsze zweryfikuj wartości po imporcie przed wyceną.

📑 7. Generowanie oferty PDF

  1. Po wycenie kliknij zakładkę 📄 Oferta PDF
  2. Wypełnij numer oferty (np. 2026/04/001) i datę
  3. Wybierz typ klienta: 👤 osoba fizyczna lub 🏢 firma — patrz sekcja 8. Osoba / Firma
  4. Wypełnij dane klienta (adres pisany automatycznie WIELKIMI literami)
  5. Wybierz handlowca z listy
  6. Wybierz wersję specyfikacji: skrócona lub pełna — patrz sekcja 9. Specyfikacja
  7. Dopisz uwagi (termin realizacji, warunki płatności)
  8. Kliknij 📄 Generuj PDF — pobierze się gotowa oferta

👤🏢 8. Osoba fizyczna / Firma

Aplikacja generuje różne PDF w zależności od typu klienta:

  • 👤 Osoba fizyczna — w PDF: "DANE KLIENTA", "SZ. P." przed nazwiskiem, brak NIP/REGON
  • 🏢 Firma — w PDF: "DANE FIRMY", "FIRMA:" przed nazwą, NIP i REGON pod adresem
🔍 Pobierz dane firmy — wpisz NIP klienta i kliknij przycisk obok pola. System pobierze z Białej Listy Ministerstwa Finansów:
  • Pełną nazwę firmy
  • REGON
  • Adres siedziby (ulica, kod, miasto)
Pola wypełnią się automatycznie — możesz je nadpisać jeśli klient podał inny adres do faktury.

📋 9. Specyfikacja: skrócona vs pełna

Co zawiera PDFSkróconaPełna
Lista etapów z sumami
Każda zaznaczona pozycja (panel) z ceną
Lista składników konstrukcyjnych panelu
Ceny składników materiałowych

💡 Cena całkowita identyczna w obu wersjach. Wersja PDF wpływa tylko na poziom szczegółowości specyfikacji. Domyślnie wybieraj skróconą — pełną gdy klient prosi o szczegóły techniczne.

📋 Załącznik: Specyfikacja zakresu prac

W zakładce 📋 Specyfikacja masz osobny widok opisujący zakres prac w każdym etapie budowy — to oddzielny dokument od listy pozycji z cenami. Możesz go dołączyć do oferty PDF jako załącznik.

  • Filtr automatyczny — domyślnie zaznaczony toggle „🎯 Pokaż tylko etapy z aktualnej oferty". Widzisz tylko etapy w których cokolwiek zaznaczyłeś w kalkulatorze. Wyłącz toggle żeby zobaczyć pełną bibliotekę wszystkich etapów.
  • Edycja per oferta — kliknij na opis (paragraph) lub szczegół (linia z 📌) → zamieni się w pole edycji. Wpisz tekst, kliknij poza pole lub Ctrl+Enter aby zapisać. Esc anuluje. Idealne pod wymagania konkretnego klienta — np. dopisać że dany dom ma niestandardową grubość izolacji.
  • Reset edycji — przy każdej zmienionej pozycji pojawia się przycisk „↺ Domyślne" (cofa pojedynczą edycję). Na górze widzisz licznik wszystkich edycji + przycisk „↺ Cofnij wszystkie edycje".
  • Edycje są zapisywane razem z ofertą — gdy klikniesz „💾 Zapisz ofertę", Twoje teksty zostają na stałe w tej ofercie. Wczytanie archiwalnej oferty przywróci również Twoje tłumaczenia.
  • Załącznik w PDF — w formularzu Oferta PDF jest checkbox „📎 Dołącz załącznik: specyfikacja zakresu prac" (domyślnie ON). PDF dostanie dodatkowe strony z opisami etapów objętych ofertą — z uwzględnieniem Twoich edycji. Możesz odznaczyć żeby wysłać krótszą ofertę bez specyfikacji.

⚠ Limit importów PDF/JPG (AI)

Każdy użytkownik ma limit 50 importów projektu przez AI w 24h. Limit chroni budżet firmowy przed nadużyciami. W praktyce 50 to bardzo dużo — w typowym dniu pracy zrobisz kilka importów. Jeśli limit zostanie wyczerpany, system pokaże komunikat z czasem do resetu.

💱 10. Waluta PLN ⇄ EUR

Górny pasek aplikacji ma przełącznik PLN / EUR z polem kursu. Domyślnie 4.20 zł/EUR. Po przełączeniu wszystkie ceny w aplikacji i PDF automatycznie się przeliczą. W PDF będzie notka „Kurs: 4,20 zł/EUR".

💡 Najczęściej używaj stałego firmowego kursu (4.20–4.30) z drobnym buforem na wahania. Termin realizacji to często 4–8 tygodni — w tym czasie kurs może się zmienić.

📋 11. Historia ofert

  • Każda zapisana oferta widoczna jest w panelu Historia ofert (na dole zakładki 📄 Oferta PDF)
  • Klik ↩ Wczytaj — przywraca całą wycenę do kalkulatora
  • Klik ✕ Usuń — z inline potwierdzeniem (Tak / Nie)
  • Wyszukiwarka: po nazwie klienta lub handlowca
  • Widzisz tylko swoje oferty (ofert innych handlowców nie widać)

❓ 12. FAQ — najczęstsze pytania

Klikaj pytanie aby rozwinąć odpowiedź.

Czym różni się Pow. zabudowy (Ag), Pow. całkowita (Pc) i Pow. użytkowa (Pu)?
Ag = rzut parteru po obrysie zewnętrznym (jeden „cień" budynku z góry). Pc = suma WSZYSTKICH kondygnacji (parter + piętro + poddasze + garaż). Pu = TYLKO mieszkalna, bez garażu/kotłowni/klatki/balkonów. Zasada: Pu < Ag ≤ Pc.
Co wpisać dla domu z poddaszem użytkowym, ale bez pełnego piętra?
Pc: Ag (parter) + faktyczna powierzchnia poddasza (mniejsza niż parter, bo skosy). Pu: tylko mieszkalna część poddasza (bez nieużytkowanego strychu pod skosami).
Wpisałem powierzchnię ścian zewn., zaznaczyłem panel — i metry nie wskoczyły. Czemu?
Auto-fill rozdziela kategorie: pole "Ściany zewn." → tylko panele sz, "Ściany wewn." → sd, "Dach" → pd, "Stropy" → ps. Jeśli zaznaczasz np. attykę (par-) — auto-fill nie zadziała, bo to inna kategoria.
Co znaczy złoty badge "⚙ Indywidualny przelicznik"?
Oznacza że ręcznie zmieniłeś metry — auto-fill już nigdy nie nadpisze tej wartości. ✅ Żeby przywrócić auto-fill: odznacz checkbox panelu i zaznacz ponownie — badge zniknie.
Co znaczy czerwony komunikat "przekroczono +12 m²" lub "brakuje -23 m²"?
Suma metrów zaznaczonych paneli nie zgadza się z wpisaną w projekcie powierzchnią. „+X m²" = zaznaczyłeś za dużo. „-X m²" = za mało (np. zapomniałeś dodać piętro).
Klient prosi o 10% rabat, system blokuje — pokazuje 0 zł. Czemu?
Rabat nie może być większy niż Twoja marża. Jeśli masz marżę 5%, max rabat = 5%. ✅ Rozwiązanie: zwiększ swoją marżę do ≥10% i wtedy daj 10% rabatu.
Czy klient widzi moją marżę w PDF?
Nie. Marża jest ukryta w PDF. Klient widzi tylko: cena bazowa × (1 + marża%) − rabat = "CENA CAŁKOWITA NETTO".
W PDF zamiast "zł" jest "zl". Co z tym zrobić?
To celowe — narzędzie tworzące PDF zamienia polskie znaki na zwykłe litery (ą→a, ł→l, ś→s, ż→z) żeby plik PDF wyświetlał się poprawnie na każdym komputerze klienta (również starszych). Klient zazwyczaj na to nie zwraca uwagi, a bezpieczeństwo wyświetlania jest ważniejsze.
Mam NIP klienta — czy muszę wpisywać nazwę i adres ręcznie?
Nie. Wybierz 🏢 Firma, wpisz NIP, kliknij 🔍 Pobierz. System pobierze nazwę, REGON i adres z Białej Listy MF (oficjalna baza Min. Finansów). Możesz nadpisać jeśli klient podał inny adres.
Wpisałem NIP, kliknąłem Pobierz, system zwrócił błąd. Co robić?
Sprawdź czy NIP ma 10 cyfr i sumę kontrolną. Jeśli NIP poprawny ale brak danych — firma nie jest VAT-czynna lub została zlikwidowana → wpisz dane ręcznie.
Czym różni się specyfikacja skrócona od pełnej?
Skrócona: etapy + każda pozycja z ceną. Pełna: dodatkowo lista składników konstrukcyjnych pod każdym panelem (np. „Płyta OSB 10 mm — 1.1 m²/m²"). Cena całkowita IDENTYCZNA. Domyślnie wysyłaj skróconą.
Klient prosi o pełną kalkulację z cenami materiałów. Co odpowiedzieć?
Wytłumacz: panel to gotowy element, cena obejmuje materiał, robociznę i montaż. Nie ujawniamy cen pojedynczych materiałów (chroni Twoją marżę). Jeśli klient nalega — to decyzja szefa.
Wygenerowałem skróconą, klient prosi pełną. Muszę robić od nowa?
Nie. Wracaj do Oferta PDF → zmień Wersja oferty: Pełna → kliknij Generuj PDF ponownie. Cała wycena zostaje. Możesz wysłać klientowi obie wersje.
Klient chce ofertę w EUR. Jak przełączyć?
Górny pasek aplikacji → przełącznik PLN/EUR → ustaw kurs (domyślnie 4.20). Wszystkie ceny przeliczą się automatycznie. PDF będzie miał notkę z kursem.
AI nie znalazł powierzchni przy imporcie PDF. Co robić?
Spróbuj wgrać charakterystykę energetyczną + rzut parteru (3–5 stron, max 18 MB). Unikaj 50-stronicowych projektów wykonawczych i krzywych skanów. Przy słabej jakości — wpisz dane ręcznie.
Klient prosi o coś czego nie ma w cenniku. Co zrobić?
Wpisz jako pozycję manualną w ETAP 8 (prace dodatkowe) z indywidualną kwotą. Jeśli to powtarzalne — poproś admina o dodanie do cennika.
Po wpisaniu adresu wszystko zamieniło się na duże litery. Czemu?
Pola adresowe (ulica, miasto) mają auto-uppercase — celowe, klient w PDF widzi profesjonalnie sformatowany adres. Pola Imię/Nazwisko/Nazwa firmy nie mają tej blokady.
Co się popsuło — gdzie szukać pomocy?
Skontaktuj się ze swoim szefem. ⚠️ Nie próbuj samemu naprawiać. Zwykle problem rozwiąże ponowne zalogowanie (Wyloguj → Zaloguj) lub odświeżenie strony (Ctrl+Shift+R / Cmd+Shift+R).

⚙️ Sekcja administratora

Ta sekcja jest widoczna tylko dla użytkowników z rolą admin.

A. Przegląd panelu admina

Jako admin masz dostęp do dodatkowych zakładek:

  • 📦 Materiały — zestawienie zużycia materiałów dla aktualnej wyceny (do zamówienia)
  • 💰 Cennik — zarządzanie Cennikiem 2.0: materiały, panele, robocizny dodatkowe, import/eksport. Szczegółowa instrukcja: Cennik → 📖 Instrukcja (osobna zakładka wewnątrz).
  • ⚙️ Admin — konta użytkowników, korekty AI, zarządzanie listą handlowców

B. Cennik 2.0 — pełna instrukcja

Zakładka 💰 Cennik zawiera 4 sub-taby: 📦 Materiały, 🏗️ Panele, 🔨 Budowa, ⬆ Import/Status.

B.1 Czym jest Cennik 2.0

Cennik 2.0 to baza receptur — każdy panel (np. „Ściana zewnętrzna 145 ocieplona") ma:

  • Recepturę — listę składników: materiał + ilość /m² + % odpadów (np. „Płyta OSB 10 mm — 1.1 m²/m², waste 10%")
  • Robociznę /m² — koszt pracy (poza materiałem)
  • Stałą kwotę /m² — drobne materiały montażowe (śruby, klej, taśma) których nie wpisujemy jako osobne pozycje

Gdy zmienisz cenę materiału — wszystkie panele używające go automatycznie dostają nową cenę. Oszczędza to godziny pracy.

💡 Kiedy edytować Cennik?
✅ Gdy dostawca zmienił cenę materiału
✅ Gdy dochodzi nowy materiał lub panel
✅ Gdy zmienia się technologia
❌ Nie zmieniaj receptur „bo tak" — pochodzą z Excela 18.11.2025 i są zsynchronizowane.

B.2 Sub-tab 📦 Materiały

Co to materiał: surowy składnik (np. „Płyta OSB 10 mm", „Wełna KNAUF Eco 200 mm").

PoleOpisPrzykład
IDAuto-generowany identyfikator (M-001, M-002…)M-023
NazwaPełna nazwa z wymiarem (system blokuje duplikaty)Płyta OSB 10 mm
KategoriaPogrupowanie (drewno, OSB, wełny, membrany…)K-OSB
Jednostkam², m³, mb, szt, kg, t
Cena PLNCena netto za jednostkę (od dostawcy)13.84
DostawcaSkąd kupujemy (do zamówień)DREW TRANS
➕ Dodaj nowy materiał
  1. Klik ➕ Dodaj materiał
  2. Wpisz Nazwę — system sprawdzi unikalność i ostrzeże jeśli podobna istnieje (proponując dodać markę/wymiar)
  3. Wybierz Kategorię, Jednostkę, wpisz Cenę i Dostawcę
  4. 💾 Zapisz — materiał trafia natychmiast do bazy
✏ Edytuj istniejący materiał
  1. Klik ✏ przy materiale
  2. Zmień co potrzeba
  3. 💾 Zapisz
Skutek: jeśli materiał używany w panelach (kolumna „w X panelach"), ich ceny zaktualizują się automatycznie.
🗑 Usuń materiał
⚠️ Niebezpieczne jeśli materiał jest używany w panelach.
  1. Sprawdź kolumnę „w X panelach"
  2. Jeśli „nieużywany" → bezpieczne usunięcie
  3. Jeśli „w 5 panelach" → NIE USUWAJ, najpierw przepnij te panele na inny materiał
💡 Jeśli omyłkowo usuniesz — kopia zapasowa robi się automatycznie, skontaktuj się z twórcą aplikacji.
🔍 Filtrowanie i wyszukiwanie
  • Pole szukania — wyszukuje po nazwie
  • Filtr kategorii — pokazuje tylko wybraną
  • Działa równocześnie

B.3 Sub-tab 🏗️ Panele

Co to panel: gotowy element budynku (jak danie z przepisu z wieloma składnikami). Pola panelu:

  • Nazwa — np. „Ściana zewnętrzna 145 ocieplona"
  • ID — auto-generowany (sz-145-nh-oc, pd-195-oc itp.)
  • Etap — który ETAP w kalkulatorze (ETAP 2, 3, 4)
  • Robocizna /m² — koszt pracy montażowej
  • Stała kwota /m² (fixedMatCost) — drobne materiały (śruby, klej, taśma). Z BOM jako f. Dla nowego panelu od zera: zostaw 0.
  • Receptura — lista składników z ilościami /m² i % odpadów
➕ Dodaj panel od zera
  1. Klik ➕ Dodaj panel od zera
  2. W modalu: Nazwa, Etap, Robocizna /m²
  3. Sekcja Receptura: ➕ Dodaj składnik → wybierz materiał → wpisz „Zużycie /m²" i „Odpady %" (typowo 10% płyty, 5% drewno)
  4. Powtórz dla każdego materiału
  5. 💾 Zapisz
✏ Edytuj panel
  1. Klik ✏ przy panelu
  2. Zmień co potrzeba
  3. 💾 Zapisz — kalkulator natychmiast aktualizuje cenę
⚠️ Walidacja duplikatu: jeśli zapisujesz panel z identyczną recepturą i robocizną jak inny — system odrzuci. Zmień co najmniej jedną wartość.
📋 Stwórz wariant (klon panelu)
  1. Klik 📋 przy panelu
  2. Modal otwarty z kopią — zmień coś (waste%, robociznę, składniki)
  3. 💾 Zapisz — system utworzy nowy panel z innym ID
⚠️ Bez zmian system odrzuci jako duplikat.
🗑 Usuń panel
  1. Klik 🗑 → potwierdź
  2. Klik ⚠️ Ostatnia szansa → potwierdź drugi raz
⚠️ Operacja nieodwracalna z poziomu aplikacji. Jeśli omyłka — skontaktuj się z twórcą aplikacji (kopie zapasowe są).

B.4 Sub-tab 🔨 Budowa

Co to: robocizny poza panelami — fundament, wylewki, instalacje, wykończenia.

  • Edytuj cenę inline w tabeli — zmiana zapisuje się lokalnie, kalkulator natychmiast aktualizuje
  • ⚠️ Aby udostępnić zmiany pozostałym userom — klik ☁️ Zapisz dla wszystkich (wymagane!)
  • Bez tego: tylko Ty widzisz nowe ceny, inni mają starsze

B.5 Sub-tab ⬆ Import/Status

Status: liczby pokazują stan cennika. Jeśli wyglądają podejrzanie (np. „0 paneli") — skontaktuj się z twórcą aplikacji.

📥 Pobierz kopię cennika: jednym kliknięciem zapisujesz cały cennik do pliku na komputerze. 💡 Polecam robić raz w tygodniu — w razie awarii to Twoja deska ratunkowa.

📊 Excel — edycja w arkuszu: pobierz cennik jako Excel, edytuj wygodnie (np. 30 cen na raz), wgraj z powrotem. ⚠️ Wgrane Excel zastępuje cały cennik. Przed wgraniem koniecznie pobierz najpierw kopię (przycisk wyżej) — na wszelki wypadek.

🔄 Aktualizacja cennika z firmowego źródła: jeśli firma przygotowała nową wersję cennika (np. po zmianie cen u dostawców), tutaj możesz zsynchronizować aplikację z tym źródłem.

  1. Klik 🔍 Pokaż co się zmieni — dostaniesz raport bez wprowadzania zmian. Pokazuje co się zmieni, ile paneli, jakie nowe ceny.
  2. Przeczytaj raport uważnie. Jeśli zmiany wyglądają sensownie — klik 🔄 Wykonaj aktualizację.
  3. Aplikacja automatycznie tworzy kopię zapasową przed zmianą i pokazuje komunikat „Zakończono".

💡 Ta funkcja była już użyta jednorazowo 28.04.2026 — uzupełniła receptury 41 paneli zgodnie ze źródłem firmowym. Następnym razem użyjesz jej, gdy firma przygotuje nowszą wersję cennika.

B.6 FAQ Cennika

Zmieniłem cenę OSB. Czy ceny ścian się przeliczyły?
Tak, automatycznie. Wszystkie panele używające OSB w recepturze dostają nową cenę. Sprawdź: sub-tab Panele → kolumna „Materiał /m²".
Co to „Stała kwota /m²" (fixedMatCost)?
Wartość drobnych materiałów montażowych (śruby, klej, taśma) których nie wpisujemy jako osobne pozycje w recepturze. Z BOM jako f. Dla nowych paneli — zostaw 0 i wpisz wszystko w recepturze.
Próbuję zapisać wariant, system mówi „identyczna receptura". Co zrobić?
Zmień co najmniej jedną wartość: waste%, qty, dodaj/usuń składnik, lub robociznę. Wariant z innym tylko nazwą = duplikat = blokada.
Usunąłem materiał i ceny się popsuły. Co robić?
Skontaktuj się z twórcą aplikacji — automatyczne kopie zapasowe są tworzone, można odtworzyć cennik sprzed Twojego usunięcia. Podaj przybliżoną godzinę zdarzenia.
Mam nowy panel ale nie wiem od czego zacząć.
Procedura:
  1. Najpierw upewnij się, że wszystkie materiały potrzebne do panelu istnieją w Materiałach
  2. Sub-tab Panele → ➕ Dodaj panel od zera
  3. Wypełnij Nazwę, Etap, Robocizna
  4. Receptura: krok po kroku składniki
  5. Zapisz, otwórz Kalkulator, sprawdź cenę
Czy mogę zmienić nazwę materiału?
Tak, edytuj materiał i zmień Nazwę. Receptury paneli są podpięte po ID (M-XXX) — zmiana nazwy nie zepsuje receptur.
Edytowałem cenę w Budowie, kalkulator się zaktualizował, ale handlowcy nie widzą zmian. Czemu?
Zmiany w sub-tab Budowa są lokalne dopóki nie klikniesz ☁️ Zapisz dla wszystkich. To celowe — żebyś mógł testować zmiany przed udostępnieniem.
Kiedy używać aktualizacji cennika z firmowego źródła?
Tylko gdy firma przygotowała nową wersję cennika (np. po zmianie cen u dostawców) i chce żebyś go zsynchronizował z aplikacją. Najpierw zawsze klik 🔍 Pokaż co się zmieni (podgląd bez zapisu) — przeczytaj raport, dopiero potem 🔄 Wykonaj aktualizację. Aplikacja sama robi kopię zapasową przed zmianą.
Po aktualizacji cennika widzę, że jeden panel ma starą robociznę. Czemu?
Jeśli ktoś wcześniej ręcznie zmienił robociznę dla tego panelu, aktualizacja jej nie nadpisuje — żeby nie zniszczyć Twojej pracy. To celowa ochrona. Jeśli chcesz przywrócić wartość ze źródła firmowego — wyedytuj panel ręcznie.

B.5 Snapshoty cennika (kopie bezpieczeństwa)

System automatycznie tworzy kopie zapasowe całego Cennika 2.0 — chroni Cię przed pomyłką (np. omyłkowy import Excela). Kopie widzisz w zakładce Cennik → ⬆ Import/Status → 📚 Historia snapshotów cennika.

  • Auto-daily — raz dziennie przy pierwszym otwarciu aplikacji przez admina. Trzymane 90 dni, potem automatycznie kasowane.
  • Manualny — kliknij „📸 Zapisz snapshot teraz" przed dużą zmianą (np. zanim zmienisz ceny dziesięciu materiałów). Dodaj opis np. „przed aktualizacją cen surowców". Manualne snapshoty nie są kasowane automatycznie — zostają jako trwałe punkty kontrolne.
  • Pre-Excel — automatycznie przed każdym importem Cennika z Excela. Jeśli się pomylisz, możesz wrócić do stanu sprzed importu.
  • Pre-restore — automatycznie przed przywróceniem innego snapshotu. Jeśli przywrócisz pomyłkowo, możesz cofnąć przywrócenie.
  • Przywracanie: klik „↩ Przywróć" przy wybranym snapshocie → potwierdzenie → cały cennik wraca do tego stanu. Aktualny stan zostaje zapisany jako pre-restore (bezpieczne).

💡 Kiedy używać manualnych snapshotów: przed dużymi importami z Excela, przed migracjami, przed eksperymentami z nowymi recepturami. Kosztują 0 zł, lepiej zrobić zbyt dużo niż zbyt mało.

B.6 Audyt zmian cennika

Każda Twoja edycja materiału lub panelu (zapis lub usunięcie) jest zapisywana w dzienniku zmian. Zobaczysz co dokładnie się zmieniło, kto i kiedy.

  • Gdzie: Cennik → ⬆ Import/Status → 📜 Audyt zmian cennika (ostatnie 100)
  • Co widać: data/godzina, użytkownik, typ akcji (zapis/usunięcie), nazwa pozycji, czytelny opis różnic (np. „cena PLN: 45 → 50, dostawca: ABC → XYZ")
  • Cofanie pojedynczej zmiany — przy każdym wpisie jest przycisk „↶ Cofnij tę zmianę". W przeciwieństwie do snapshotów (które przywracają cały cennik), tu cofniesz tylko jedną edycję. Pozostałe zmiany zostają nietknięte.
  • Wpis kasujący nie da się odwrócić jako revert — jeśli usunąłeś materiał, cofnięcie ze cofnie usunięcie (przywróci materiał ze starymi danymi).
  • Limit historii: 1000 najnowszych wpisów, starsze automatycznie kasowane. To wystarczy na ~6-12 miesięcy intensywnej pracy.

💡 Snapshot vs audyt — kiedy czego używać:

  • Snapshot = duży reset do stanu sprzed N dni. Cofa wszystko (cennik wygląda jak w danym dniu).
  • Audyt = chirurgiczne cofnięcie jednej pomyłki bez naruszania innych zmian.

B.7 Słowniczek

RecepturaLista składników panelu (materiał + ilość na m² + procent odpadów)
SkładnikPojedyncza pozycja w recepturze
PanelGotowy element budynku (ściana, panel dachowy, strop, podłoga)
Stała kwota /m²Drobne materiały montażowe (śruby, klej, taśma) liczone ryczałtowo
Robocizna /m²Koszt pracy montażowej za 1 m² panelu
Procent odpadówNaddatek na cięcie i straty (zazwyczaj 10% dla płyt, 5% dla drewna)
Kod materiałuIdentyfikator widoczny w aplikacji (np. M-023). Tworzy się automatycznie.
Automatyczny zapisZmiana zapisuje się od razu w chmurze — wszyscy użytkownicy widzą ją natychmiast.

C. Konta i role

  • Tworzenie konta: wpisz e-mail i imię nazwisko → klik "Utwórz". System wygeneruje hasło imienazwisko2025 (transliteracja PL znaków: ą→a, ł→l, ś→s itd.)
  • Pierwsze logowanie wymusi zmianę hasła
  • Role:
    • admin — pełen dostęp (Materiały, Cennik, Admin, wszystkie oferty)
    • handlowiec — tylko Kalkulator, Specyfikacja, Oferta PDF, Historia ofert (swoje)
  • Zmiana roli — inline w tabeli (potwierdzenie przy nadawaniu admin)
  • Każdy nowy handlowiec auto-pojawia się w liście do wyboru w PDF oferty

D. Polityka cen i marża

  • Cena bazowa (Ty jako admin widzisz) = materiał + robocizna z cennika
  • Cena dla handlowca = cena bazowa × (1 + narzut bazowy). Narzut edytowalny w karcie „💼 Polityka cen" wyżej (domyślnie 30%, zakres 30-200%). Zmiana wpływa na wszystkich handlowców po ich kolejnym zalogowaniu.
  • Marża handlowca — procent dodawany do jego ceny (domyślnie 0%, bez limitu max)
  • Rabat dla klienta — handlowiec może udzielić tylko do wysokości swojej marży (system zablokuje większy)
  • Klient w PDF widzi tylko: cenę z marżą minus rabat. Cena bazowa i marża są ukryte.

📋 Zasady zmiany narzutu bazowego

⚠️ To jest decyzja strategiczna — nie operacyjna.

Narzut bazowy to fundament polityki cenowej całej firmy. Każda zmiana ma bezpośredni wpływ na rentowność, konkurencyjność ofert i wizerunek u klientów. Dlatego:
  • Każda zmiana powinna stanowić uzgodnioną politykę cenową firmy
  • Wymaga akceptacji wszystkich członków zarządu (lub osób uprawnionych do decyzji cenowych)
  • Powinna być udokumentowana — z uzasadnieniem (np. wzrost cen surowców, zmiana warunków rynkowych, decyzja zarządu z dnia X)
  • Nie zmieniaj narzutu „testowo" — to nie jest pole eksperymentalne. System zachowuje historię zmian widoczną dla wszystkich adminów.

⚠️ Ryzyka częstej zmiany

RyzykoKonsekwencja
Niespójność ofert dla klientówKlient porównujący dwie oferty (z różnych dni) zobaczy różne ceny tych samych paneli — pyta dlaczego, traci zaufanie.
Konflikty z handlowcamiHandlowiec wystawił ofertę w piątek z narzutem 30%, w poniedziałek widzi że ceny w kalkulatorze są wyższe (40%). Klient pyta o nową kwotę — kłopot z wyjaśnieniem.
Brak czytelnej kalkulacji marży firmyTrudniej rozliczać miesięczne wyniki finansowe gdy narzut zmieniał się 5x w miesiącu.
Utrata kontroli nad pozycją cenowąBez stabilnej polityki cenowej trudno reagować strategicznie na konkurencję — wszystko staje się reaktywne.
Pytania klientów„Dlaczego identyczny dom wyceniliście kuzynowi taniej?" — bardzo trudna rozmowa.

📊 Co dotyczy zmiana, a co nie

  • Wpływa na nowe oferty wystawiane przez handlowców po kolejnym ich zalogowaniu (lub odświeżeniu strony Cmd+Shift+R / Ctrl+Shift+R)
  • Wpływa na ceny widziane w kalkulatorze wszystkich handlowców
  • NIE wpływa na oferty już zapisane w Historii ofert — są zamrożone w momencie zapisu i zachowują ceny z dnia ich utworzenia. Klient otrzymujący starą ofertę zobaczy ceny zgodne z tym co dostał.
  • NIE wpływa na PDF już wygenerowane — klient ma swój plik, ceny w nim się nie zmienią
  • ⚠️ Wpływa pośrednio na konkurencyjność cenową — narzut zbyt wysoki = przegrywasz oferty; zbyt niski = pracujesz „za darmo" pod marżą operacyjną firmy

💡 Dobre praktyki

  • Zmiana raz na kwartał lub rzadziej (nie częściej niż raz na miesiąc)
  • Zawsze udokumentuj zmianę — wyślij maila do zespołu sprzedaży: „Od dnia X narzut zmieniony z A% na B% w związku z [powód]. Wszystkie oferty wystawione przed X obowiązują wg starych cen."
  • Powiadom handlowców przed zmianą — żeby zdążyli wystawić oferty z dotychczasowymi cenami klientom z którymi negocjacje są na zaawansowanym etapie
  • Sprawdź wpływ na typową wycenę — wykonaj próbną kalkulację typowego domu (np. 150 m² Pu) ze starym i nowym narzutem, żeby ocenić różnicę kwotową dla klienta
  • Historia zmian (3 ostatnie) jest widoczna w karcie „💼 Polityka cen" — odwiedzaj ją zanim wprowadzisz kolejną zmianę, żeby zobaczyć czy nie ma zbyt wielu modyfikacji w krótkim czasie

E. Korekty AI

W panelu admina jest sekcja 🧠 Korekty AI (feedback z importu PDF) — widać tam co zwróciło AI vs co wpisał użytkownik. Domyślnie zwinięta (klik aby rozwinąć). Pomaga ulepszyć prompt importu i ocenić jakość.

F. FAQ — admin

Zmieniłem cenę OSB 10 mm w Materiałach. Czy ceny ścian się przeliczyły?
Tak, automatycznie. Każdy panel używający OSB w recepturze dostaje nową cenę materiału w czasie rzeczywistym. Sprawdź: Cennik 2.0 → Panele → kolumna „Materiał /m²".
Co się stanie jeśli usunę materiał używany w panelach?
⚠️ Panele zaczną liczyć cenę bez tego materiału — wartość ofert spadnie i będzie błędna. Zanim usuniesz: sprawdź kolumnę „w X panelach" przy materiale. Jeśli >0, lepiej go nie usuwaj. Jeśli omyłkowo usunąłeś — skontaktuj się z twórcą aplikacji, kopie zapasowe są.
Próbuję zapisać wariant panelu, system mówi „panel ma identyczną recepturę". Co zrobić?
System chroni przed duplikatami. Zmień co najmniej jedną wartość w recepturze (waste%, qty, dodaj/usuń składnik) lub robociznę. Wariant z innym tylko nazwą = duplikat = blokada.
Co to „Stała kwota /m²" w panelu (fixedMatCost)?
Wartość materiałów które nie wpisujemy jako osobne pozycje w recepturze (śruby, klej, drobne, taśma klejąca). Z BOM przyszło jako wartość f. Dla nowych paneli zostaw 0 jeśli nie wiesz — wpisz wszystko w recepturze.
Jak utworzyć konto dla nowego handlowca?
Admin → „Tworzenie nowego konta" → email + imię nazwisko → „Utwórz". System generuje hasło imienazwisko2025. Przy 1. logowaniu user musi je zmienić. Auto-pojawi się w liście handlowców do PDF.
Handlowiec mówi że widzi inne ceny niż ja. Czemu?
Stosujemy narzut bazowy dla handlowca (zarządzany w karcie „💼 Polityka cen", domyślnie 30%). Handlowiec widzi cenę bazową × (1 + narzut). Plus jego własna marża i rabaty. Admin widzi „surową" cenę bazową z cennika.
Gdzie są kopie zapasowe cennika?
Każda aktualizacja cennika z firmowego źródła automatycznie tworzy kopię zapasową w chmurze. Dodatkowo polecam raz w tygodniu pobrać kopię na dysk: Cennik → Import/Status → 📥 Pobierz kopię cennika.
Kiedy używać synchronizacji z BOM?
Po istotnej zmianie cen materiałów w Excelu źródłowym 18.11.2025 (lub nowszym), gdy chcesz zaimportować zaktualizowane receptury. Najpierw 🔍 dry-run (raport bez zapisu), potem ▶ wykonaj migrację (z auto-backupem).

G. Bezpieczeństwo i awarie

Zapis zmian

  • Zmiany w Materiałach i Panelach zapisują się natychmiast w chmurze — wszyscy użytkownicy widzą je od razu.
  • Zmiany w sub-tab Budowa wymagają kliknięcia „☁️ Zapisz dla wszystkich" żeby udostępnić je pozostałym osobom.
  • Snapshoty cennika (auto-daily + manualne + pre-excel + pre-restore) — patrz B.5 wyżej. Codziennie tworzony jest auto-snapshot, plus możesz zrobić manualny przed dużą zmianą. To Twoja siatka bezpieczeństwa.
  • Audyt zmian — każda edycja materiału/panelu jest logowana z możliwością cofnięcia (patrz B.6 wyżej).
  • Eksport JSON (Cennik → Import/Status → Narzędzia zaawansowane → ⬇ Eksport JSON) — pobierz dodatkową kopię cennika offline raz w miesiącu.

Bezpieczeństwo dostępu (po stronie systemu)

  • Wymagane logowanie — bez zalogowania użytkownik nie ma dostępu do cennika, ofert ani importu PDF. Reguły bazy danych Firebase wymagają tokenu autoryzacji przy każdym żądaniu.
  • Role admin/handlowiec — handlowiec nie może zapisywać w cenniku, ustawieniach, kontach. Może czytać i zapisywać tylko swoje oferty.
  • Limit importów AI — każdy użytkownik może wykonać max 50 importów PDF/JPG przez AI w 24h. Chroni budżet firmowy. W praktyce typowy handlowiec wykona kilka importów dziennie — limit jest komfortowy.
  • Co handlowiec faktycznie widzi: ceny po doliczeniu narzutu bazowego (patrz D wyżej). Nie widzi cen surowych z cennika ani niczyich innych ofert.

Coś nie działa — co robić?

  1. Odśwież stronę z pominięciem pamięci podręcznej: Cmd+Shift+R (Mac) lub Ctrl+Shift+R (Windows)
  2. Wyloguj się i zaloguj ponownie
  3. Spróbuj otworzyć aplikację w trybie prywatnym (incognito) — czasem to pomaga
  4. Jeśli problem dalej występuje — skontaktuj się z twórcą aplikacji. Podaj: co próbowałeś zrobić, kiedy dokładnie (godzina), ewentualnie zrzut ekranu.

⚠️ Nie próbuj naprawiać samodzielnie jeśli nie wiesz co robisz — zwłaszcza nie usuwaj nic w cenniku „dla próby". Możesz nadpisać dobry stan. Ewentualną pomyłkę cofniesz przez Audyt (B.6) lub Snapshot (B.5).

📅 Wersja instrukcji: 2026-04-29

🔐 Konta użytkowników — kliknij, aby rozwinąć

➕ Dodaj nowego użytkownika

Hasło początkowe generowane automatycznie z imienia i nazwiska (np. "Jan Kowalski" → jankowalski2025). Użytkownik musi je zmienić przy pierwszym logowaniu.

📊 Wykorzystanie AI — kliknij, aby rozwinąć

Statystyki wczytań projektu PDF/JPG przez AI. Zliczane od 29.04.2026.

Łączny koszt
Liczba importów
Średni koszt importu

🏆 Top użytkownicy

📜 Historia ostatnich 30 importów (kliknij, aby rozwinąć)
💼 Polityka cen — narzut bazowy dla handlowca — kliknij, aby rozwinąć

Tutaj ustawiasz narzut procentowy dla wszystkich użytkowników z rolą handlowiec. Cena widziana przez handlowca = cena bazowa × (1 + narzut). Dotyczy nowych ofert — już zapisane oferty zachowują ceny z dnia zapisu.

%
Cena ×1.30
Limity: 30% – 200%
Aktualna wartość: 30%
📜 Historia ostatnich zmian (kliknij, aby rozwinąć)
🧠 Korekty AI (feedback z importu PDF) — kliknij, aby rozwinąć

Lista zapisanych korekt AI z importu PDF — pokazuje co zwróciło AI vs co wprowadził użytkownik. Pomaga ulepszyć prompt.