FarmFlow Desktop 2.0

1. Wprowadzenie

Czym jest FarmFlow Desktop?

FarmFlow Desktop to kompleksowa aplikacja desktopowa do zarządzania produkcją druku 3D. Została zaprojektowana dla właścicieli farm drukarek 3D, małych manufaktur i indywidualnych twórców, którzy potrzebują pełnej kontroli nad procesem produkcyjnym — od zamówienia klienta, przez druk i kontrolę jakości, aż po sprzedaż i fakturowanie.

Dla kogo jest FarmFlow?

• Farmy drukarek 3D — zarządzanie wieloma drukarkami, filamentami i zleceniami jednocześnie
• Małe manufaktury — pełny obieg dokumentów (FV, WZ, PZ), CRM, magazyn
• Indywidualni twórcy — kalkulacja kosztów, cennik, sprzedaż na Allegro
• Prototypownie — śledzenie modeli, wersji, materiałów

Filozofia offline-first

FarmFlow działa w 100% offline. Wszystkie dane przechowywane są lokalnie na Twoim komputerze w bazie SQLite. Nie potrzebujesz internetu do codziennej pracy — jedyne połączenia sieciowe to opcjonalne integracje (Allegro, AI, repozytoria modeli).

Kluczowe cechy

• 47 modułów pokrywających cały cykl produkcyjny
• Kalkulator kosztów z 9 składnikami i analizą progu rentowności
• Podgląd 3D modeli STL bezpośrednio w aplikacji
• Wielojęzyczność (9 języków, przełączanie w runtime)
• System ról i uprawnień (admin / operator / podgląd)
• Import/eksport Excel w każdym module
• Integracja z Allegro (Device Flow OAuth)
• Generowanie zdjęć produktowych AI
• Pełny obieg dokumentów (FV, WZ, PZ, RW, PW)

2. Pierwsze uruchomienie

Instalacja

FarmFlow Desktop dostępny jest jako instalator Windows (.exe lub .msi). Instalacja nie wymaga uprawnień administratora.

1. Pobierz plik FarmFlow_2.0.0_x64-setup.exe
2. Uruchom instalator i postępuj zgodnie z instrukcjami
3. Aplikacja zainstaluje się w %LOCALAPPDATA%\Programs\FarmFlow\
4. Skrót pojawi się na pulpicie i w menu Start

Tworzenie konta

Przy pierwszym uruchomieniu zobaczysz ekran rejestracji. Pierwsze utworzone konto automatycznie otrzymuje rolę Administrator.

1. Wpisz login (minimum 3 znaki) — będzie używany do logowania
2. Wpisz hasło (minimum 4 znaki) i powtórz je
3. Opcjonalnie podaj nazwę wyświetlaną
4. Kliknij „Zarejestruj" — konto zostanie utworzone
5. Zaloguj się swoimi danymi

Konfiguracja firmy

Po pierwszym zalogowaniu zalecamy skonfigurowanie danych firmy (potrzebne do generowania faktur i dokumentów):

1. Przejdź do Ustawienia (ikona koła zębatego w sidebarze)
2. Wypełnij sekcję „Dane firmy" — nazwa, NIP, adres, konto bankowe
3. Ustaw parametry kalkulacji kosztów — cena prądu, robocizna, amortyzacja
4. Kliknij „Zapisz"

3. Nawigacja i interfejs

Sidebar (panel boczny)

Główna nawigacja odbywa się przez panel boczny (sidebar) po lewej stronie ekranu. Moduły pogrupowane są w 6 systemach spójnych z kafelkami na ekranie startowym (Launcher), zdefiniowanych w src/config/systems.ts:

• Produkcja (production): Druki, Zlecenia produkcyjne, Harmonogram, Postprodukcja
• Magazyn (warehouse): Stan, Magazyny, Filamenty, Modele, Przeglądarka 3D
• Sprzedaż (sales): Sprzedaż, Zamówienia, Dokumenty, Kontakty, Marketplaces, Cennik, Historia cen
• Księgowość (accounting): Raporty, Kalkulator, Pulpit, Notatki
• Flota (fleet): Drukarki, Statystyki drukarek, Serwis, Połączenia
• Administracja (admin): Ustawienia, Użytkownicy, Uprawnienia, Panel AI, Allegro (legacy)

Pulpit (Dashboard) jest dostępny jako szybki skrót na samej górze sidebara — poza sekcjami systemów.

Każdą sekcję systemu można zwijać i rozwijać — kliknij nagłówek (z ikoną i nazwą systemu), a sekcja zwinie się/rozwinie. Stan zwijania zapamiętywany jest w przeglądarce (klucz farmflow:sidebar:expanded) i przeżywa restart aplikacji. Każdy system ma własny kolor akcentu spójny z kafelkami na ekranie startowym.

Kliknięcie ikony FarmFlow w nagłówku sidebara zwija go do paska samych ikon (state w localStorage) — tooltip z nazwą modułu pojawia się po najechaniu.

Wyszukiwarka globalna (Ctrl+K)

Naciśnij Ctrl + K aby otworzyć wyszukiwarkę globalną. Przeszukuje jednocześnie 6 tabel: filamenty, drukarki, modele, kontakty, zamówienia i notatki. Wyniki pojawiają się w czasie rzeczywistym (debounce 200ms).

Launcher (ekran startowy)

Po zalogowaniu widzisz launcher z kafelkami modułów. Każdy kafelek pokazuje ikonę i nazwę modułu. Kliknij kafelek aby przejść do wybranego modułu. Na górze launchera widoczne są kluczowe KPI (sprzedaż, zysk, aktywne druki).

Motyw kolorystyczny

FarmFlow obsługuje dwa motywy: ciemny (domyślny) i jasny. Przełączanie odbywa się przez ikonę słońca/księżyca w sidebarze. Preferencja zapisywana jest w localStorage.

4. Pulpit (Dashboard)

Przegląd

Dashboard to centralny punkt informacyjny aplikacji. Wyświetla kluczowe wskaźniki (KPI), alerty wymagające uwagi, ostatnie sprzedaże oraz szybkie akcje.

Wskaźniki KPI

Alerty

System automatycznie generuje alerty dla sytuacji wymagających uwagi:

• Niski stan filamentu — szpula poniżej progu (domyślnie 100g)
• Przeterminowany serwis — drukarka z przekroczonym terminem przeglądu
• Zamówienia po terminie — zamówienia z przekroczonym due_date

Widget Executive KPIs

Widget „Executive KPIs" to zaawansowany panel zarządczy dostępny w palecie widgetów. Zajmuje 2×2 kratki i prezentuje kluczowe wskaźniki finansowe w jednym miejscu:

• Revenue MTD — przychód od początku miesiąca (w PLN)
• Profit/h — zysk na godzinę druku (przychód / godziny pracy drukarek)
• Utilization % — utylizacja floty drukarek (godziny druku / dostępne godziny)
• Queue depth — liczba zleceń oczekujących w kolejce
• Gross margin % — marża brutto (przychód minus koszty / przychód)
• Top model — najczęściej drukowany model w bieżącym miesiącu
• Porównanie — zmiana procentowa przychodu względem poprzedniego miesiąca

Szybkie akcje

Przyciski szybkiego dostępu pozwalają jednym kliknięciem przejść do tworzenia nowego druku, zamówienia lub rejestracji sprzedaży.

5. Filamenty

Przegląd

Moduł Filamenty służy do zarządzania zapasami materiałów do druku 3D. Śledzi stan każdej szpuli, jej zużycie, cenę za gram i ostrzega gdy zapas się kończy.

Dodawanie filamentu

1. Kliknij przycisk „Dodaj filament" w prawym górnym rogu
2. Wypełnij formularz: nazwa, producent, materiał (PLA/PETG/ABS/TPU/...)
3. Ustaw wagę początkową (domyślnie 1000g) i cenę zakupu
4. Wybierz kolor — jednolity lub gradient (2-3 kolory)
5. Opcjonalnie: data zakupu, dostawca, próg niskiego stanu, URL do zamówienia
6. Kliknij „Zapisz"

Kolory i gradienty

FarmFlow obsługuje trzy tryby kolorów filamentu:

• Jednolity — jeden kolor (color picker)
• Gradient 2 kolory — przejście między dwoma kolorami
• Gradient 3 kolory — przejście między trzema kolorami

Możesz zapisywać często używane kombinacje jako palety kolorów do ponownego użycia.

Śledzenie zużycia

Przy każdym zleceniu druku system automatycznie odejmuje zużyty filament od stanu szpuli. Progress bar w tabeli wizualizuje pozostały materiał. Gdy stan spadnie poniżej progu (domyślnie 100g), pojawi się alert na Dashboard.

Import z Excel

Możesz zaimportować wiele szpul jednocześnie z pliku Excel. Pobierz szablon z Ustawień → Szablony importu, wypełnij go danymi i zaimportuj przyciskiem „Import z Excel".

Flagi materiału (auto-fill kosztów w Kalkulatorze)

Każdy filament może mieć ustawione flagi opisujące właściwości materiału — używane przez Kalkulator wyceny do automatycznego doliczania dodatkowych kosztów:

• Materiał ścierny (`is_abrasive`) — kompozyty z dodatkiem włókien węglowych (CF) lub szklanych (GF), np. PA-CF, PETG-CF, PPA-CF. Wymagają hardenowanej dyszy. Po zaznaczeniu Kalkulator automatycznie doliczy „koszt zużycia dyszy" z Ustawień.
• Wymaga suszenia (`requires_drying`) — materiały higroskopijne: PA, PA-CF, PA-GF, Nylon, PETG-CF, PC, PEI, PEEK. Po zaznaczeniu Kalkulator doliczy „koszt suszenia".
• Wymaga komory (`requires_chamber`) — materiały wymagające temperatury otoczenia ≥40°C: ABS, ASA, PC, PA, PEI, PEEK. Flaga informacyjna (na razie nie wpływa na koszt).

Przy pierwszym uruchomieniu po aktualizacji FarmFlow automatycznie ustawia te flagi dla istniejących filamentów na podstawie pola „Materiał" (CF/GF/PA/Nylon itd.). Możesz ręcznie korygować flagi w karcie filamentu.

6. Drukarki

Przegląd

Moduł Drukarki to rejestr Twojego parku maszynowego. Przechowuje parametry techniczne każdej drukarki, śledzi godziny pracy i status operacyjny.

Dodawanie drukarki

1. Kliknij „Dodaj drukarkę"
2. Wypełnij podstawowe dane: nazwa, producent, model
3. Ustaw pobór mocy w watach (potrzebne do kalkulacji kosztów prądu)
4. Opcjonalnie: dysza (średnica, materiał), typ stołu, firmware, lokalizacja
5. Opcjonalnie: numer seryjny, data zakupu, cena zakupu, objętość robocza
6. Kliknij „Zapisz"

Statusy drukarek

Parametry techniczne

Każda drukarka może mieć zapisane szczegółowe parametry: średnica dyszy, materiał dyszy (mosiądz/stal), typ stołu (PEI/szkło/magnetyczny), firmware, objętość robocza, maksymalne temperatury hotend i stołu, łączność (USB/WiFi/Ethernet).

Cena zakupu i godziny żywotności (per-printer amortyzacja)

Dwa pola istotne dla precyzyjnej kalkulacji kosztów:

• Cena zakupu — pełny koszt zakupu drukarki (PLN).
• Godziny oczekiwanej żywotności (`expected_lifetime_h`) — ile godzin pracy realnie wytrzyma maszyna przed zużyciem części głównych.

Gdy oba pola są uzupełnione, Kalkulator wyceny i moduł Druki liczą amortyzację indywidualnie dla tej drukarki: stawka_amortyzacji_PLN/h = cena_zakupu / godziny_żywotności. Bez tych pól używana jest globalna stawka z Ustawień.

Typowe wartości godzin żywotności (źródło: analiza rynkowa, maj 2026):

FarmFlow przy aktualizacji automatycznie wypełnia to pole na podstawie marki drukarki — wartość możesz dostosować ręcznie pod swoje warunki eksploatacji.

7. Modele

Przegląd

Moduł Modele to katalog Twoich produktów. Każdy model to szablon produktu, który może być drukowany wielokrotnie. Przechowuje pliki STL, ceny, kategorie i powiązane zdjęcia produktowe.

Dodawanie modelu

1. Kliknij „Dodaj model"
2. Wpisz nazwę, SKU (opcjonalnie), kategorię
3. Ustaw ceny: domyślna, minimalna, katalogowa
4. Opcjonalnie: opis, notatki
5. Wgraj plik STL (przycisk „Wgraj plik STL")
6. Kliknij „Zapisz"

Podgląd 3D

Po wgraniu pliku STL możesz obejrzeć model w podglądzie 3D bezpośrednio w aplikacji. Użyj myszy do obracania (przeciągnij), przybliżania (scroll) i przesuwania (prawy przycisk).

Import z URL

FarmFlow potrafi automatycznie pobrać metadane modelu z popularnych repozytoriów 3D:

1. Kliknij „Import z URL"
2. Wklej link do modelu (np. z MakerWorld, Printables, Thingiverse)
3. System automatycznie pobierze tytuł, autora, opis i kategorię
4. Sprawdź dane i kliknij „Zapisz"

Zdjęcia produktowe AI

Jeśli masz skonfigurowanego dostawcę AI (Bria, OpenAI), możesz wygenerować profesjonalne zdjęcie produktowe bezpośrednio z podglądu 3D. Szczegóły w sekcji AI (Zdjęcia produktowe).

8. Druki (Print Jobs)

Przegląd

Moduł Druki to serce systemu produkcyjnego. Każde zlecenie druku zawiera pełną kalkulację kosztów (9 składników), śledzenie statusu i powiązanie z modelem, drukarką i filamentem.

Tworzenie zlecenia druku

1. Kliknij „Dodaj druk"
2. Wybierz model z katalogu (lub wpisz ręcznie)
3. Wybierz drukarkę i filament
4. Wpisz ilość sztuk, zużycie filamentu (g) i czas druku (minuty)
5. System automatycznie obliczy wszystkie koszty
6. Kliknij „Zapisz"

Kalkulator kosztów (9 składników)

Trzy poziomy cen

• Cena minimalna — koszt + marża minimalna (np. 10%)
• Cena sugerowana — koszt + marża domyślna (np. 30%)
• Cena katalogowa — koszt + marża katalogowa (np. 60%)

Import ze slicera

Zamiast wpisywać ręcznie czas i zużycie, możesz zaimportować dane bezpośrednio z pliku slicera:

1. Kliknij „Import ze slicera"
2. Wybierz plik G-code lub 3MF
3. System automatycznie wyciągnie: czas druku, zużycie filamentu, temperaturę
4. Dane zostaną wstawione do formularza

Koszt bazowy

Koszt bazowy to suma filamentu + prądu — dwa główne składniki kosztów zmiennych. Wyświetlany jest osobno jako szybki punkt odniesienia.

9. Kontrola Jakości (QC)

Przegląd

Kontrola jakości jest zintegrowana z modułem Druki. Po zakończeniu druku możesz przeprowadzić inspekcję jakościową przed przekazaniem produktu do postprodukcji lub magazynu.

Przeprowadzanie kontroli

1. W module Druki znajdź zlecenie ze statusem „Zakończony"
2. Kliknij przycisk „Kontrola jakości" (ikona lupy)
3. Oceń inspekcję wizualną — czy wydruk wygląda poprawnie?
4. Oceń dokładność wymiarową — czy wymiary są zgodne z modelem?
5. Oceń jakość powierzchni (skala 1-5)
6. Opisz wykryte defekty (jeśli są)
7. Wybierz wynik: Zaliczony lub Niezaliczony

Wyniki kontroli

Reprint

Opcja „Powtórz druk" automatycznie tworzy nowe zlecenie druku z tymi samymi parametrami. Nowe zlecenie ma pole retry_of wskazujące na oryginalne zlecenie — pozwala to śledzić historię powtórek.

10. Postprodukcja

Przegląd

Moduł Postprodukcja służy do śledzenia obróbki po wydruku — szlifowania, malowania, montażu, lakierowania i innych etapów wykończeniowych.

Tworzenie zlecenia postprodukcji

Zlecenie postprodukcji tworzy się automatycznie gdy z modułu Druki klikniesz „Do postprodukcji". Możesz też utworzyć je ręcznie:

1. Kliknij „Nowa postprodukcja"
2. Wybierz model i opcjonalnie powiąż z drukiem
3. Dodaj etapy (checklist) — np. „Usunięcie supportów", „Szlifowanie", „Malowanie"
4. Przypisz operatora (opcjonalnie)
5. Kliknij „Zapisz"

Etapy (checklist)

Każde zlecenie postprodukcji ma dynamiczną listę etapów. Możesz dodawać, usuwać i oznaczać etapy jako ukończone. System śledzi postęp (progress bar) i łączny czas pracy.

Przenoszenie do magazynu

Po zakończeniu wszystkich etapów kliknij „Do magazynu". Produkt zostanie dodany do stanu magazynowego z obliczonym kosztem jednostkowym (koszt druku + koszt postprodukcji).

Ocena jakości

Po zakończeniu postprodukcji możesz ocenić jakość końcową (skala 1-5) i zanotować liczbę defektów. Te dane pomagają w analizie jakości produkcji.

11. Magazyn

Przegląd

Moduł Magazyn pokazuje aktualny stan gotowych produktów. Każda pozycja ma ilość, koszt jednostkowy (weighted average), cenę sprzedaży i lokalizację magazynową.

Jak produkty trafiają do magazynu

• Z druku — przycisk „Do magazynu" w module Druki
• Z postprodukcji — przycisk „Do magazynu" po zakończeniu obróbki
• Ręcznie — przycisk „Dodaj pozycję" (np. zakupiony towar)

Sprzedaż z magazynu

1. Znajdź produkt w tabeli magazynowej
2. Kliknij przycisk „Sprzedaj" (ikona koszyka)
3. Wpisz ilość, cenę jednostkową, wybierz kontakt (klienta)
4. Wybierz kanał sprzedaży (Allegro, sklep, bezpośrednia)
5. Kliknij „Potwierdź" — system automatycznie:
   • Zmniejszy stan magazynowy
   • Zarejestruje sprzedaż w dzienniku
   • Wygeneruje dokument WZ (Wydanie Zewnętrzne)
   • Wygeneruje fakturę VAT (jeśli włączone)

Lokalizacje magazynowe

Każda pozycja może mieć przypisaną lokalizację (shelf_location) — np. „Regał A, półka 3". Ułatwia to fizyczne odnalezienie produktu w magazynie.

Wielomagazynowość

FarmFlow obsługuje wiele magazynów (moduł Magazyny). Każda pozycja stock może być przypisana do konkretnego magazynu. Transfery między magazynami są rejestrowane z historią.

12. Sprzedaż

Przegląd

Moduł Sprzedaż to dziennik wszystkich transakcji sprzedaży. Pokazuje przychód, koszt, zysk i marżę dla każdej transakcji.

Rejestracja sprzedaży

Sprzedaż rejestruje się na dwa sposoby:

• Z magazynu — przycisk „Sprzedaj" w module Magazyn (zalecane)
• Ręcznie — przycisk „Dodaj sprzedaż" w module Sprzedaż

Dane sprzedaży

Każda sprzedaż zawiera: model, klient (kontakt z CRM), kanał sprzedaży, ilość, cenę jednostkową, koszt jednostkowy, zysk, marżę procentową.

Auto-dokumenty

Przy sprzedaży z magazynu system automatycznie generuje:

• WZ (Wydanie Zewnętrzne) — dokument wydania towaru
• FV (Faktura VAT) — faktura z danymi kontrahenta i pozycjami

Analiza marży

Tabela sprzedaży pokazuje marżę procentową dla każdej transakcji. Kolumna „Zysk" jest kolorowana: zielona (zysk) lub czerwona (strata). Pozwala to szybko identyfikować produkty sprzedawane poniżej kosztów.

13. Zamówienia

Przegląd

Moduł Zamówienia służy do rejestracji i śledzenia zamówień klientów. Każde zamówienie może zawierać wiele pozycji (modeli) i jest powiązane z kontaktem z CRM.

Tworzenie zamówienia

1. Kliknij „Nowe zamówienie"
2. Wybierz kontakt (klienta) z listy lub wpisz nazwę ręcznie
3. Ustaw priorytet (Niski / Normalny / Wysoki / Pilny)
4. Ustaw termin realizacji (due_date)
5. Dodaj pozycje — wybierz model, ilość, cenę jednostkową
6. Kliknij „Zapisz"

Statusy zamówień

Tworzenie druku z zamówienia

Kliknij „Utwórz druk" przy pozycji zamówienia — system automatycznie utworzy zlecenie druku z odpowiednim modelem i ilością. To najszybszy sposób na rozpoczęcie produkcji.

Import zamówień z Excel

Dla hurtowych zamówień możesz zaimportować je z pliku Excel. Pobierz szablon z Ustawień, wypełnij danymi i zaimportuj.

14. Zlecenia produkcyjne

Przegląd

Zlecenia produkcyjne to warstwa planowania między zamówieniami a drukami. Pozwalają zaplanować produkcję z wyprzedzeniem, przypisać drukarki i ustalić harmonogram.

Tworzenie zlecenia

1. Kliknij „Nowe zlecenie"
2. Opcjonalnie powiąż z zamówieniem klienta
3. Wybierz model i drukarkę
4. Ustaw ilość i priorytet
5. Zaplanuj daty: start i koniec (scheduled_start / scheduled_end)
6. Kliknij „Zapisz"

Statusy zleceń

• Zaplanowane — zlecenie w harmonogramie, jeszcze nie rozpoczęte
• W toku — produkcja trwa
• Zakończone — produkcja ukończona
• Anulowane — zlecenie anulowane

Harmonogram

Moduł Harmonogram (dostępny z sidebara) wizualizuje zaplanowane zlecenia na osi czasu. Pozwala zobaczyć obciążenie drukarek i zidentyfikować konflikty terminów.

15. Dokumenty

Przegląd

Moduł Dokumenty to centralny rejestr wszystkich dokumentów handlowych i magazynowych. Obsługuje 5 typów dokumentów z auto-numeracją i możliwością drukowania.

Typy dokumentów

Tworzenie dokumentu ręcznie

1. Kliknij „Wystaw dokument"
2. Wybierz typ dokumentu (FV/WZ/PZ/RW/PW)
3. Wypełnij dane kontrahenta (nazwa, NIP, adres)
4. Dodaj pozycje — opis, ilość, jednostka, cena netto, stawka VAT
5. Wybierz metodę płatności i termin
6. Kliknij „Zapisz" — system nada numer automatycznie

Auto-numeracja

Dokumenty numerowane są automatycznie wg wzorca: {prefix}/{numer}/{rok}. Przykład: FV/001/2025. Numeracja resetuje się co rok. Każdy typ dokumentu ma osobny licznik.

Drukowanie i eksport

• Drukowanie — kliknij ikonę drukarki. Dokument otworzy się w iframe i wywoła okno drukowania systemowego (Ctrl+P)
• Eksport Excel — kliknij „Eksport do Excel" aby pobrać dokument jako plik .xlsx

Dokumenty automatyczne

Niektóre dokumenty generują się automatycznie:

• RW — przy rozpoczęciu druku (zużycie filamentu)
• PW — przy zakończeniu druku (przyjęcie produktu)
• WZ + FV — przy sprzedaży z magazynu

MPP — Mechanizm Podzielonej Płatności

System automatycznie oznacza dokument jako wymagający MPP (split payment), gdy kwota brutto przekracza 15 000 PLN — zgodnie z art. 108a ust. 1a ustawy o VAT.

• Oznaczenie MPP pojawia się automatycznie po przekroczeniu progu
• Możesz ręcznie włączyć lub wyłączyć MPP — zaznacz/odznacz checkbox MPP. Po ręcznej zmianie auto-detekcja zostaje wyłączona dla tego dokumentu

16. Kontakty (CRM)

Przegląd

Moduł Kontakty to prosty CRM — baza klientów, dostawców i partnerów biznesowych. Kontakty są powiązane z zamówieniami i sprzedażami, co pozwala śledzić historię współpracy.

Dodawanie kontaktu

1. Kliknij „Dodaj kontakt"
2. Wybierz typ: Klient / Dostawca / Partner / Inny
3. Wypełnij dane: firma, osoba kontaktowa, email, telefon
4. Opcjonalnie: NIP, adres, miasto, tagi, źródło pozyskania
5. Kliknij „Zapisz"

Statystyki kontaktu

System automatycznie śledzi dla każdego kontaktu:

• Łączna liczba zamówień (total_orders)
• Łączny przychód (total_revenue)
• Data ostatniego zamówienia (last_order_at)

Kolumna Tier (scoring klienta)

W tabeli kontaktów widoczna jest kolumna Tier, która pokazuje automatycznie obliczony poziom klienta na podstawie historii zamówień:

• VIP (złoty pill) — najcenniejsi klienci z wysokim score
• Standard (szary pill) — klienci o przeciętnej aktywności
• Low (czerwony pill) — klienci z niską aktywnością lub jednorazowi

Scoring jest obliczany automatycznie na podstawie: liczby zamówień, łącznego przychodu, średniej wartości zamówienia, częstotliwości powtórzeń i czasu od ostatniego zamówienia. Konfiguracja wag dostępna jest w module Customer Scoring.

Anonimizacja RODO

Zgodnie z RODO (GDPR Art. 17 — prawo do bycia zapomnianym), możesz nieodwracalnie zanonimizować dane osobowe kontaktu:

1. Znajdź kontakt w tabeli
2. Kliknij przycisk z ikoną tarczy (trzeci przycisk w kolumnie akcji)
3. Potwierdź operację w oknie dialogowym

Po anonimizacji kontakt pozostaje w bazie (zachowując statystyki zamówień), ale nie zawiera już żadnych danych umożliwiających identyfikację osoby.

Tagi i źródła

Tagi pozwalają kategoryzować kontakty (np. „VIP", „hurtowy", „jednorazowy"). Pole „Źródło" wskazuje skąd pozyskano kontakt (np. „Allegro", „polecenie", „targi").

17. Serwis drukarek

Przegląd

Moduł Serwis służy do rejestrowania przeglądów, napraw i modernizacji drukarek. Pomaga utrzymać park maszynowy w dobrej kondycji i planować konserwację prewencyjną.

Dodawanie wpisu serwisowego

1. Kliknij „Dodaj wpis serwisowy"
2. Wybierz drukarkę z listy
3. Wybierz typ: Przegląd / Naprawa / Modernizacja / Kalibracja / Czyszczenie
4. Wpisz tytuł i opis wykonanych prac
5. Podaj koszt i użyte części (opcjonalnie)
6. Ustaw datę wykonania i następny termin przeglądu
7. Kliknij „Zapisz"

Alerty przeterminowanych przeglądów

Gdy termin następnego przeglądu (next_due_at) zostanie przekroczony, na Dashboard pojawi się alert. Drukarka z przeterminowanym serwisem jest oznaczona w tabeli kolorem czerwonym.

Harmonogram przeglądów

Możesz ustawić cykliczne przeglądy (np. co 500 godzin pracy). System automatycznie oblicza następny termin na podstawie godzin pracy drukarki.

Koszty serwisu

Każdy wpis serwisowy może mieć przypisany koszt. Pozwala to śledzić łączne wydatki na utrzymanie każdej drukarki i podejmować decyzje o wymianie sprzętu.

18. Kalkulator wyceny

Przegląd

Kalkulator wyceny pozwala szybko obliczyć koszt i cenę produktu bez tworzenia formalnego zlecenia druku. Idealny do szybkich wycen dla klientów.

Kalkulacja kosztów

1. Wybierz filament (lub wpisz cenę za gram ręcznie)
2. Wybierz drukarkę (lub wpisz pobór mocy ręcznie)
3. Wpisz zużycie filamentu (g) i czas druku (minuty)
4. Wpisz ilość sztuk
5. System automatycznie obliczy: koszt bazowy, koszt całkowity, 4 poziomy cen

Cztery poziomy cen

• Cena minimalna — pokrywa koszty + minimalna marża
• Cena domyślna — standardowa marża (z ustawień)
• Cena katalogowa — wyższa marża (do cennika)
• Własna marża — wpisz dowolny procent

Dodatkowe składniki kosztu (zużycie dyszy, stołu, suszenie)

Pod podstawowymi polami kosztu znajdziesz trzy dodatkowe pola dla materiałów wymagających szczególnej obsługi:

• Zużycie dyszy — koszt szybszego zużycia dyszy przez ścierne filamenty (PA-CF, PETG-CF, GF). Wartość wyrażana w PLN per druk.
• Zużycie stołu — koszt części eksploatacyjnej stołu (PEI, magnetyczne arkusze).
• Suszenie filamentu — koszt energii i czasu suszarki dla materiałów higroskopijnych (PA, Nylon, PC, PEI).

Domyślne stawki ustawiasz w Ustawienia → Kalkulacja kosztów (pola „Domyślny koszt zużycia dyszy", „Domyślny koszt zużycia stołu", „Domyślny koszt suszenia"). FarmFlow automatycznie zaznacza filamenty CF/GF jako ścierne i materiały typu PA/Nylon/PC/PEI/PEEK jako wymagające suszenia.

Per-printer amortyzacja

Pod wierszem „Amortyzacja" w panelu wyników zobaczysz źródło stawki:

• auto (X.YZ PLN/h) — drukarka ma wpisaną cenę zakupu i godziny żywotności (`expected_lifetime_h`); stawka liczona indywidualnie dla tej maszyny.
• settings (X.YZ PLN/h) — używana globalna stawka z Ustawień (drukarka nie ma kompletu danych).

Prowizja marketplace

Pod polami kosztu znajdziesz dropdown Marketplace z czterema trybami:

1. Bez prowizji — kalkulacja bez doliczania prowizji platformy sprzedażowej (np. sprzedaż bezpośrednia).
2. Wybór platformy (preset) — Allegro 10%, eBay 12.5%, Etsy 6.5%, Amazon 15%, OLX 0%. Stawki aktualne na maj 2026 — administrator może je edytować w Ustawieniach.
3. Wybór konkretnej oferty — wybierz aukcję z listy aktywnych ofert. Jeśli oferta ma indywidualnie ustawione „nadpisanie prowizji" (np. promocja 5% zamiast standardowych 10%), zostanie użyta wartość z oferty.
4. Własna stawka — wpisz dowolny procent (0-99.99) w pole „Prowizja marketplace %".

Po wyborze trybu (oprócz „Bez prowizji") w wynikach pojawi się dodatkowy wiersz Cena finalna marketplace (skopiowanie ikoną przy wartości) oraz Wartość prowizji. To cena, którą musisz wystawić na platformie, aby po potrąceniu prowizji zostało Ci tyle, ile policzyłeś jako cena sugerowana.

Wycena szczegółowa (QUOTE)

Po obliczeniu kosztu kliknij Generuj wycenę — otworzy się okno tworzenia formalnego dokumentu QUOTE z danymi kontrahenta, podglądem STL, kilkoma cennikami progowymi (np. 1 szt., 5 szt., 10 szt.) i terminem ważności. QUOTE można później przekształcić w Proformę (PRO), a tę w Fakturę VAT (FV).

Kalkulator zużycia filamentu

Druga zakładka kalkulatora odpowiada na pytanie: „Ile druków zrobię z tej szpuli?"

• Ile druków z obecnego stanu szpuli
• Ile druków z pełnej szpuli
• Koszt produkcji na szpulę
• Przychód i zysk na szpulę
• Ile dni do wyczerpania (przy 8h druku/dzień)

19. Cennik produktów

Przegląd

Cennik produktów to widok tabelaryczny wszystkich modeli z ich cenami i dostępnością magazynową. Służy jako szybka referencja cenowa i może być wyeksportowany lub wydrukowany.

Zawartość cennika

Filtrowanie i eksport

• Filtr kategorii — pokaż tylko produkty z wybranej kategorii
• Eksport Excel — pobierz cennik jako plik .xlsx
• Drukowanie PDF — wydrukuj cennik (Ctrl+P w oknie podglądu)

20. Statystyki drukarek

Przegląd

Moduł Statystyki drukarek pokazuje wydajność i wykorzystanie każdej drukarki w Twoim parku maszynowym. Pomaga identyfikować najwydajniejsze maszyny i te wymagające uwagi.

Wskaźniki per drukarka

OEE (Overall Equipment Effectiveness)

OEE to kluczowy wskaźnik wydajności maszyn, obliczany jako:

OEE = Dostępność × Wydajność × Jakość

• Dostępność — czas pracy / czas dostępny
• Wydajność — rzeczywista produkcja / planowana produkcja
• Jakość — produkty dobre / produkty łącznie (= success rate)

21. Raporty

Przegląd

Moduł Raporty generuje analizy danych w formie tabel z możliwością eksportu do Excel. Dostępnych jest 5 typów raportów z konfigurowalnymi okresami czasowymi.

Typy raportów

Generowanie raportu

1. Wybierz typ raportu z listy
2. Wybierz okres: ostatnie 7 dni / 30 dni / 90 dni / cały okres
3. Kliknij „Generuj raport"
4. Przejrzyj wyniki w tabeli
5. Kliknij „Pobierz Excel" aby wyeksportować

22. Notatki

Przegląd

Moduł Notatki to prosty system szybkich notatek w stylu „sticky notes". Służy do zapisywania pomysłów, przypomnień i informacji, które nie pasują do żadnego innego modułu.

Tworzenie notatki

1. Kliknij „Nowa notatka"
2. Wpisz tytuł (opcjonalnie)
3. Wpisz treść notatki
4. Notatka zapisuje się automatycznie

Funkcje

• Kolorowe tło — każda notatka ma losowy kolor tła
• Przypinanie — przypięte notatki wyświetlają się na górze
• Inline edycja — kliknij na notatkę aby edytować bezpośrednio
• Usuwanie — ikona kosza na notatce

23. Allegro

Przegląd

Integracja z Allegro pozwala zarządzać ofertami sprzedażowymi bezpośrednio z FarmFlow. Autoryzacja odbywa się przez Device Flow — bezpieczną metodę dla aplikacji desktopowych.

Konfiguracja

1. Przejdź na apps.developer.allegro.pl i utwórz aplikację deweloperską
2. Typ aplikacji: „Urządzenie (bez dostępu do klawiatury)"
3. Skopiuj Client ID i Client Secret
4. W FarmFlow przejdź do modułu Allegro
5. Wklej Client ID i Client Secret w sekcji „Konfiguracja"
6. Kliknij „Zapisz"

Autoryzacja (Device Flow)

1. Kliknij przycisk „Autoryzuj"
2. System wyświetli kod weryfikacyjny (np. ABCD-1234)
3. Otworzy się przeglądarka z linkiem do Allegro
4. Zaloguj się na Allegro (jeśli nie jesteś zalogowany)
5. Wpisz kod weryfikacyjny (lub powinien być wpisany automatycznie)
6. Kliknij „Zezwól" na stronie Allegro
7. FarmFlow automatycznie wykryje zatwierdzenie (polling co 10 sekund)
8. Status zmieni się na „Połączono z Allegro"

Zarządzanie ofertami

Po autoryzacji możesz:

• Tworzyć nowe oferty (tytuł, opis, cena, ilość, zdjęcia)
• Przeglądać istniejące oferty (status: aktywna/zakończona/draft)
• Synchronizować stany magazynowe z Allegro

Rozwiązywanie problemów

24. AI (Zdjęcia produktowe)

Przegląd

FarmFlow integruje się z dostawcami AI do generowania profesjonalnych zdjęć produktowych i opisów aukcji. Klucze API przechowywane są wyłącznie lokalnie — Twoje dane nie są wysyłane nigdzie poza samym requestem generowania.

Obsługiwani dostawcy

Konfiguracja dostawcy AI

1. Przejdź do Ustawienia → Dostawcy AI (lub moduł AI w sidebarze)
2. Wybierz dostawcę (np. Bria AI)
3. Wpisz klucz API (uzyskany z platformy dostawcy)
4. Kliknij „Zapisz" — dostawca zostanie aktywowany

Generowanie zdjęcia produktowego (Bria)

1. Przejdź do modelu z wgranym plikiem STL
2. Kliknij „Zdjęcie produktowe"
3. Wybierz typ sceny: Biurko / Studio / Półka / Warsztat / Wnętrze / E-commerce
4. Lub wpisz własny opis sceny
5. Kliknij „Generuj" — system wyrenderuje podgląd 3D i wyśle do Bria
6. Po kilku sekundach pojawi się wygenerowane zdjęcie
7. Kliknij „Zapisz zdjęcie" aby przypisać je do modelu

Generowanie opisu aukcji

1. Wybierz model i kliknij „Opis aukcji"
2. Wybierz dostawcę tekstu (OpenAI/Grok/Gemini)
3. Podaj materiał, kolor i dodatkowe informacje
4. Kliknij „Generuj"
5. Skopiuj wygenerowany opis do schowka

25. Przeglądarka modeli 3D

Przegląd

Przeglądarka modeli 3D to narzędzie do odkrywania i importowania modeli z popularnych repozytoriów online. Pozwala przeglądać 6 repozytoriów i importować metadane modeli do katalogu FarmFlow.

Obsługiwane repozytoria

Jak korzystać

1. Kliknij kafelek repozytorium — otworzy się w przeglądarce systemowej
2. Przeglądaj modele jak na normalnej stronie
3. Skopiuj URL modelu który Cię interesuje (z paska adresu)
4. Wróć do FarmFlow i wklej URL w pole „Dodaj model z linku"
5. Kliknij „Pobierz dane" — system pobierze metadane (tytuł, autor, opis)
6. Kliknij „Dodaj do katalogu" — model zostanie dodany do Twoich modeli

26. Użytkownicy i uprawnienia

Przegląd

FarmFlow obsługuje wielu użytkowników z systemem ról. Administrator może tworzyć konta dla operatorów i osób z dostępem tylko do podglądu.

Role

Tworzenie konta użytkownika

1. Przejdź do modułu Użytkownicy (dostępny tylko dla admina)
2. Kliknij „Dodaj użytkownika"
3. Wpisz login, hasło i nazwę wyświetlaną
4. Wybierz rolę: Administrator / Operator / Podgląd
5. Kliknij „Zapisz"

Profile uprawnień (zaawansowane)

Oprócz ról, system obsługuje granularne profile uprawnień. W module Uprawnienia możesz:

• Tworzyć profile z niestandardowymi poziomami dostępu per moduł
• Ustawiać poziomy: Brak / Widok / Odczyt / Edycja / Pełny
• Przypisywać profile do użytkowników

27. Ustawienia

Przegląd

Moduł Ustawienia zawiera konfigurację kalkulacji kosztów, dane firmy, szablony importu i funkcję backup/restore.

Kalkulacja kosztów

Parametry wpływające na obliczenia w module Druki i Kalkulator:

Dane firmy

Dane wystawcy dokumentów: nazwa firmy, NIP, REGON, adres, konto bankowe, uwagi na fakturze. Wymagane do poprawnego generowania FV.

Szablony importu

Pobierz puste szablony Excel z gotowymi nagłówkami dla: filamentów, drukarek, modeli, zamówień. Wypełnij szablon danymi i zaimportuj z poziomu odpowiedniego modułu.

Backup / Restore

• Eksport kopii — zapisuje całą bazę danych jako plik JSON
• Przywróć z pliku — nadpisuje WSZYSTKIE dane danymi z kopii

28. Obieg pracy — pełny przepływ

Diagram przepływu

Krok po kroku

Krok 1: Zamówienie

Klient składa zamówienie. Rejestrujesz je w module Zamówienia z pozycjami (modele + ilości), terminem i priorytetem. Status: Nowe.

Krok 2: Planowanie produkcji

Opcjonalnie tworzysz Zlecenie produkcyjne — przypisujesz drukarkę, planujesz termin. Lub bezpośrednio tworzysz druk z zamówienia (przycisk „Utwórz druk").

Krok 3: Druk

Tworzysz zlecenie druku. System oblicza koszty (9 składników). Importujesz parametry ze slicera lub wpisujesz ręcznie. Status zamówienia zmienia się na W realizacji. System generuje dokument RW (rozchód filamentu).

Krok 4: Kontrola jakości

Po zakończeniu druku przeprowadzasz inspekcję QC. Jeśli Pass — produkt idzie dalej. Jeśli Fail — reprint lub odrzucenie.

Krok 5: Postprodukcja

Jeśli produkt wymaga obróbki (szlifowanie, malowanie, montaż) — trafia do postprodukcji. Realizujesz checklist etapów. Po zakończeniu — do magazynu.

Krok 6: Magazyn

Produkt trafia do stanu magazynowego. System generuje dokument PW (przyjęcie wewnętrzne). Koszt jednostkowy obliczany jest automatycznie.

Krok 7: Sprzedaż

Sprzedajesz produkt z magazynu. System automatycznie: zmniejsza stan, rejestruje sprzedaż, generuje WZ i FV. Status zamówienia zmienia się na Gotowe → Dostarczone.

Ścieżki skrócone

• Druk → Magazyn (bez QC i postprodukcji) — dla prostych produktów
• Druk → Sprzedaż (bezpośrednia) — sprzedaż bez magazynowania
• Magazyn → Sprzedaż — sprzedaż z istniejącego stanu (bez nowego druku)

29. Skróty klawiszowe

Globalne skróty

Nawigacja

Nawigacja odbywa się głównie przez sidebar (panel boczny) i wyszukiwarkę globalną. Kliknij moduł w sidebarze lub użyj Ctrl + K i wpisz nazwę modułu.

Tabele

W tabelach danych (DataTable) możesz:

• Kliknąć nagłówek kolumny aby posortować
• Użyć pola wyszukiwania nad tabelą do filtrowania
• Kliknąć wiersz aby otworzyć szczegóły/edycję

Formularze

• Tab — przejdź do następnego pola
• Shift + Tab — wróć do poprzedniego pola
• Enter — zatwierdź formularz (w niektórych kontekstach)
• Escape — zamknij modal bez zapisywania

30. FAQ / Rozwiązywanie problemów

Ogólne

Gdzie przechowywane są moje dane?

Baza danych SQLite znajduje się w %APPDATA%\com.farmflow.desktop\farmflow.db. Możesz skopiować ten plik jako backup ręczny.

Czy mogę używać FarmFlow na wielu komputerach?

Tak, ale każda instalacja ma osobną bazę danych. Użyj funkcji Backup/Restore (Ustawienia) aby przenosić dane między komputerami.

Czy FarmFlow wymaga internetu?

Nie — 100% funkcji podstawowych działa offline. Internet potrzebny jest tylko do: Allegro, AI (zdjęcia/opisy), import z repozytoriów 3D.

Jak zrobić backup?

Ustawienia → Kopia zapasowa → „Eksportuj kopię". Plik JSON zostanie zapisany w wybranej lokalizacji. Zalecamy robić backup co tydzień.

Problemy z drukowaniem dokumentów

Dokument nie drukuje się / puste okno

FarmFlow używa iframe + contentWindow.print() do drukowania. Jeśli nie działa:

1. Upewnij się, że nie blokujesz wyskakujących okien
2. Spróbuj eksportu do Excel i wydruku z arkusza kalkulacyjnego
3. Sprawdź czy WebView2 jest zaktualizowany (Windows Update)

Faktura nie ma danych firmy

Przejdź do Ustawienia → Dane firmy i wypełnij wszystkie pola (nazwa, NIP, adres, konto bankowe).

Problemy z Allegro

„Nieprawidłowy Client ID lub Client Secret"

Sprawdź dane na apps.developer.allegro.pl. Upewnij się, że kopiujesz pełny Client Secret (bez spacji na końcu).

„Kod wygasł"

Kod weryfikacyjny ma ograniczony czas ważności. Kliknij „Autoryzuj" ponownie aby uzyskać nowy kod.

Autoryzacja się zawiesza

System polluje co 10 sekund. Upewnij się, że zatwierdziłeś dostęp na stronie Allegro. Jeśli minęło >5 minut — kod wygasł, zacznij od nowa.

Problemy z wydajnością

Aplikacja wolno się ładuje

Przy dużej bazie danych (>10000 rekordów) ładowanie może trwać dłużej. To normalne — SQLite jest szybki, ale renderowanie dużych tabel wymaga czasu.

Podgląd 3D jest wolny

Duże pliki STL (>50MB) mogą powodować spowolnienie. Three.js renderuje model w WebGL — wydajność zależy od karty graficznej.

Problemy z importem

Import Excel nie działa

Upewnij się, że:

• Plik jest w formacie .xlsx (nie .xls, nie .csv)
• Nagłówki kolumn są zgodne z szablonem (pobierz szablon z Ustawień)
• Dane nie zawierają pustych wierszy na początku

Import ze slicera nie rozpoznaje pliku

Obsługiwane formaty: G-code (.gcode) i 3MF (.3mf). Plik musi zawierać komentarze z czasem druku i zużyciem filamentu (standardowe dla PrusaSlicer, Cura, BambuStudio).

Bezpieczeństwo

Zapomniałem hasła

Nie ma mechanizmu odzyskiwania hasła. Jedyne rozwiązanie to usunięcie pliku bazy danych i rozpoczęcie od nowa (utrata danych) lub przywrócenie z backupu.

Czy moje dane są bezpieczne?

Dane przechowywane są lokalnie w pliku SQLite. Nie są szyfrowane — bezpieczeństwo opiera się na uprawnieniach systemu plików Windows. Dla dodatkowego bezpieczeństwa możesz zaszyfrować dysk (BitLocker).

31. Scheduler (harmonogram Gantt)

Przegląd

Scheduler to pełny harmonogram produkcyjny w widoku Gantta. Umożliwia planowanie zleceń druku na osi czasu z podziałem na drukarki, planowanie okien serwisowych oraz monitorowanie utylizacji floty. Stanowi rozwinięcie modułu „Harmonogram" o pełną oś czasu z drag&drop.

Funkcjonalności

• Widok Gantta z podziałem na drukarki (jeden wiersz = jedna drukarka)
• 4 poziomy zoom: godzina / dzień / tydzień / miesiąc
• Maintenance blocks — zaplanowane okna serwisowe blokujące drukarkę
• Lista nieprzypisanych zleceń (panel boczny) — przeciągnij na timeline aby zaplanować
• Wskaźniki utylizacji per drukarka (tryb dzienny lub tygodniowy)
• Algorytmy auto-przydziału: LPT, Modified LPT, quick-assign

Jak korzystać

1. Otwórz Scheduler z grupy Produkcja w sidebarze
2. Wybierz poziom zoom przyciskami + / -
3. Aby zaplanować nowe zlecenie — przeciągnij je z listy „Nieprzypisane" na wiersz drukarki
4. Aby dodać okno serwisowe — kliknij + Maintenance, wybierz drukarkę, datę start/end, podaj powód
5. Przełącz tryb utylizacji (dzienny/tygodniowy) aby zobaczyć obciążenie floty

32. Kolejka druku (Print Queue)

Przegląd

Print Queue to globalna kolejka zleceń druku oczekujących na przydział. Zawiera priorytety (deadline, marża), sugestie najlepszej drukarki dla każdego zlecenia oraz wykrywanie wąskich gardeł (zlecenia, których nie da się przydzielić w terminie).

Funkcjonalności

• Lista zleceń w kolejce z pozycją, deadline i sugerowaną drukarką
• Algorytm scoring uwzględnia: deadline, marżę, tier klienta i zajętość drukarek
• Reorder modal — przesunięcie zlecenia na konkretną pozycję
• Wykrywanie wąskich gardeł (zlecenia oznaczone jako „nieprzypisywalne")
• Batch optimizer — sugestie scalania zleceń o tej samej geometrii i kolorze
• Powiadomienie o następnym zleceniu po zwolnieniu drukarki

Jak korzystać

1. Otwórz Kolejka druku z grupy Produkcja
2. Sprawdź sugerowane drukarki w kolumnie „Sugestia"
3. Aby zmienić priorytet — kliknij Reorder i wpisz nową pozycję
4. Aby zobaczyć propozycje batch — kliknij Pokaż batche

33. Połączenia drukarek (Cloud + LAN)

Przegląd

Moduł Połączenia umożliwia integrację drukarek 3D z chmurami producentów oraz wykrywanie drukarek w sieci lokalnej. Po podłączeniu drukarki dane (status, telemetria) są dostępne w module Printer Monitor.

Obsługiwane chmury i protokoły

Jak dodać drukarkę z chmury

1. Otwórz Połączenia z grupy Produkcja
2. Wybierz zakładkę odpowiednią dla producenta (Bambu Lab / Prusa Connect / Anycubic)
3. Wpisz dane logowania i kliknij Zaloguj
4. Po zalogowaniu pojawi się lista drukarek powiązanych z kontem
5. Zaznacz drukarki do importu i kliknij Importuj wybrane

Skanowanie LAN

1. Wybierz zakładkę LAN
2. Kliknij Skanuj sieć — postęp pokazuje upływający czas
3. Z listy znalezionych drukarek kliknij Importuj przy wybranym IP
4. Uzupełnij API key (OctoPrint) lub access code (Bambu) i potwierdź

34. Printer Monitor (telemetria)

Przegląd

Printer Monitor pokazuje stan każdej zarejestrowanej drukarki w czasie rzeczywistym: temperaturę dyszy i stołu, postęp aktualnego druku, status (idle / printing / paused / offline / error) oraz podgląd webcam (jeśli skonfigurowany).

Funkcjonalności

• Karty drukarek z wskaźnikami stanu i miniaturkami webcam
• Polling co N sekund (konfigurowalny per drukarka)
• Wykres temperatur z ostatnich godzin (dysza + stół)
• Lista ostatnich zakończonych druków per drukarka
• Alerty o drukarkach offline lub w stanie błędu
• Wykrywanie nieprzypisanych zakończonych zleceń (z propozycją podpięcia do Print Job)

Konfiguracja

1. Przejdź do zakładki Konfiguracja w Printer Monitor
2. Wybierz drukarkę z listy
3. Wybierz protokół: OctoPrint lub Moonraker
4. Wpisz Base URL (np. http://192.168.1.100) i API key
5. Ustaw interwał poll (zalecane 30 sekund)
6. Opcjonalnie podaj URL strumienia webcam
7. Kliknij Zapisz — drukarka pojawi się w widoku Overview

35. Workflows (reguły automatyzacji)

Przegląd

Workflows to silnik reguł typu trigger → action. Pozwala automatyzować powtarzalne czynności bez kodowania — np. „przy zakończeniu druku utwórz wpis postprodukcji" albo „przy spadku stanu filamentu poniżej progu wyślij powiadomienie".

Funkcjonalności

• Builder graficzny (Rule Builder) — wybór wyzwalacza, definicja akcji
• Włączanie / wyłączanie reguł jednym kliknięciem (toggle)
• Zakładka Audit — historia wykonań z błędami i czasem trwania
• Edycja istniejącej reguły lub usunięcie

Jak utworzyć regułę

1. Otwórz Workflows z grupy System
2. Kliknij + Nowa reguła
3. Nadaj regule nazwę i wybierz wyzwalacz (np. „Print Job zakończony")
4. Dodaj akcje (np. „Utwórz wpis Postproduction", „Wyślij powiadomienie")
5. Zapisz i włącz przełącznik Enabled

36. Marketplaces (multi-platform)

Przegląd

Moduł Marketplaces to centrum konfiguracji integracji z wieloma platformami sprzedaży: Allegro, eBay, Etsy, Amazon (stub) i OLX. Każda platforma ma własny adapter implementujący wspólny interfejs ListingAdapter.

Funkcjonalności

• Konta OAuth per platforma (zapisywane w tabeli marketplace_accounts)
• Mapowanie kategorii (model → kategoria danego marketplace)
• Wystawianie ofert i synchronizacja stanów (statusy: pending / syncing / synced / error)
• Generator opisów AI (tabela ai_descriptions)
• Rate limiting i retry z backoff

37. Marketplace Sync

Przegląd

Marketplace Sync to operacyjny moduł synchronizacji ofert. Pokazuje stan połączeń per platforma, mapowanie SKU↔model, log syncu oraz listę nieprzypisanych produktów ściągniętych z marketplace'ów.

Zakładki

• Connections — stan każdego marketplace (connected / authentication_failed / unreachable / not_configured), interwał auto-sync, ostatni sync
• Mappings — tabela mapowań external_sku → model FarmFlow
• Sync — log operacji synchronizacji z statusami
• Unmapped — produkty ściągnięte z marketplace'u bez mapowania na model FarmFlow — wymagają ręcznej resolucji

Jak rozwiązać nieprzypisane produkty

1. Przejdź do zakładki Unmapped
2. Kliknij Przypisz przy produkcie
3. Wybierz odpowiedni model z listy
4. Zatwierdź — mapowanie zostanie zapisane i kolejny sync rozpozna ten SKU automatycznie

38. Wysyłka (Shipping)

Przegląd

Moduł Shipping generuje etykiety wysyłkowe dla zamówień klientów. Obsługuje 4 kurierów: InPost, DPD, DHL, Pocztę Polską.

Funkcjonalności

• Generowanie etykiety dla pojedynczego zamówienia lub batch
• Wyszukiwarka paczkomatów InPost (po nazwie miejscowości)
• Walidacja adresu (lista brakujących pól)
• Raport kosztów wysyłki: filtry po kurierze, okresie, kliencie; agregacja per kurier
• Eksport raportu do Excel

Jak wygenerować etykietę

1. Otwórz Wysyłka z grupy Sprzedaż
2. Znajdź zamówienie na liście (filtr po statusie / kliencie / numerze)
3. Kliknij Wygeneruj etykietę przy zamówieniu
4. Wybierz kuriera, dla InPost wybierz paczkomat
5. Zatwierdź — etykieta zostanie zapisana, a numer trackingu pojawi się w wierszu zamówienia

Batch generation

1. Zaznacz wiele zamówień checkboxami
2. Kliknij Batch wysyłka
3. Wybierz wspólnego kuriera
4. Postęp pokazuje liczbę przetworzonych / błędów

39. Analytics (KPI, forecast, ROI)

Przegląd

Analytics to zaawansowany dashboard analityczny. W przeciwieństwie do prostego pulpitu (Dashboard), Analytics oferuje historię, trendy, prognozy i porównania.

Funkcjonalności

• KPI agregowane na zakres: 7 / 30 / 90 / 180 / 365 dni (przełącznik górny)
• Wykres trendu (SVG line chart) dla wybranej metryki, np. przychód
• Forecast 30 dni naprzód z poziomem pewności (confidence)
• Ranking modeli — marża/h, liczba druków, przychód
• Predykcje wyczerpania zapasów z flagą „needs reorder"
• ROI drukarek — payback period, net profit, koszty serwisu
• Eksport wszystkich raportów do Excel

Dokładność wycen (Quote Accuracy)

Sekcja „Dokładność wycen" pozwala ocenić, jak trafne są automatyczne wyceny STL generowane przez moduł Auto-wycena. System porównuje szacowane koszty z rzeczywistymi i prezentuje wyniki w przejrzystej formie.

Wskaźniki KPI

Kolorowanie wyników

• Zielony — trafność w zakresie ±15% od 100% (dobra wycena)
• Żółty — trafność poza zakresem ±15% (wycena wymaga kalibracji)

Tabela porównawcza

Pod wskaźnikami KPI wyświetlana jest tabela z 50 ostatnimi wycenami zawierająca:

• Datę wyceny
• Szacowany koszt (z auto-wyceny)
• Rzeczywisty koszt (uzupełniony po realizacji)
• Trafność % (kolorowana zielono/żółto)

40. Finanse (płatności, P&L, JPK)

Przegląd

Moduł Finanse to centrum rozliczeń: faktury przeterminowane, aging report, P&L per miesiąc, statystyki metod płatności, walidacja JPK i koszty operacyjne.

Zakładki

• Dashboard — KPI finansowe w skrócie
• Overdue — faktury przeterminowane (sortowane po dniach po terminie)
• Aging — kubełki 0-30 / 31-60 / 61-90 / 90+ dni
• P&L — rachunek zysków i strat per miesiąc (rok+miesiąc do wyboru)
• JPK — walidacja JPK_FA z listą błędów do poprawienia
• Methods — statystyki metod płatności w 90 dniach
• Costs — rejestrowanie kosztów operacyjnych

Rejestrowanie wpłaty

1. Kliknij + Wpłata
2. Wybierz fakturę z listy
3. Podaj kwotę, metodę (przelew / gotówka / karta) i datę
4. Jeśli wpłata przekracza pozostałe saldo — pojawi się ostrzeżenie o nadpłacie
5. Zatwierdź

41. Powiadomienia

Przegląd

Centrum powiadomień gromadzi alerty z wszystkich modułów aplikacji: nowe zamówienia, niski stan magazynu, błędy drukarek, zbliżające się terminy, przeterminowany serwis.

Kategorie i ważność

Każde powiadomienie ma jeden z 3 poziomów ważności: info, warning, critical.

Funkcjonalności

• Filtrowanie: tekst, kategoria, severity, zakres dat
• Mark all as read — oznacz wszystkie jako przeczytane
• Preferencje per kategoria — wyłącz powiadomienia danego typu
• Paginacja po 100 wpisów

42. Portal klienta

Przegląd

FarmFlow zawiera wbudowany lokalny serwer portalu klienta (port domyślny 47322). Klient otrzymuje link, pod którym może sprawdzić status swojego zamówienia bez logowania do systemu.

Konfiguracja brandingu

1. Otwórz Portal klienta z grupy System
2. Wgraj logo (PNG/JPG)
3. Wybierz kolor wiodący (primary color)
4. Uzupełnij nazwę firmy, e-mail i telefon kontaktowy
5. Kliknij Zapisz

Uruchamianie portalu

1. Kliknij Start aby uruchomić serwer na wybranym porcie
2. Status zmieni się na „running"
3. Aby zatrzymać — kliknij Stop

43. Synchronizacja księgowości

Przegląd

Moduł integruje FarmFlow z polskimi platformami księgowymi online: wFirma, Fakturownia, iFirma. Po skonfigurowaniu połączenia faktury z FarmFlow są eksportowane do platformy księgowej automatycznie lub na żądanie.

Dodawanie połączenia

1. Otwórz Sync księgowości z grupy Finanse
2. Kliknij + Dodaj połączenie
3. Wybierz platformę (wFirma / Fakturownia / iFirma)
4. Wklej credentiale (API key / token zgodny z dokumentacją platformy)
5. Kliknij Waliduj — system sprawdzi poprawność
6. Po pozytywnej walidacji kliknij Zapisz

Synchronizacja

• Dry-run — podgląd co zostanie wyeksportowane (bez wysyłki)
• Sync — faktyczna synchronizacja faktur
• Status — last sync, liczba sukcesów / błędów
• Log błędów — lista faktur z komunikatem błędu (do poprawy i ponownego eksportu)

44. Dokumenty rozszerzone (FK / MM / ZZ)

Przegląd

Moduł rozszerzonych dokumentów dodaje typy dokumentów wykraczające poza podstawowy zestaw FV/PZ/WZ: FK (Faktura Korygująca), MM (Przesunięcie Międzymagazynowe), ZZ (Zamówienie Zakupu), Offer (Oferta).

Obsługiwane typy

Faktura korygująca (FK)

1. Wybierz fakturę pierwotną z listy
2. Dla każdej pozycji wpisz nową ilość lub cenę (jeśli się zmienia)
3. Podaj powód korekty
4. System automatycznie wyliczy diff netto / VAT / brutto
5. Zatwierdź — FK zostanie utworzona z odwołaniem do oryginału

Walidacja stanu magazynu

Przy wystawianiu WZ lub RW system sprawdza, czy w magazynie jest wystarczająca ilość produktów. Jeśli nie — pojawia się modal z listą braków i blokuje wystawienie dokumentu.

45. Księga ruchów magazynowych

Przegląd

Movement Ledger to pełna, niezmienialna księga wszystkich ruchów magazynowych w systemie: przyjęcia, wydania, transfery, korekty. Każdy zapis zawiera użytkownika, datę, ilość, magazyn źródłowy i docelowy.

Widoki

• Timeline — wszystkie ruchy chronologicznie z filtrami
• Item History — historia jednego produktu z saldem na każdą datę

Filtry

• Item (konkretny produkt)
• Magazyn (źródłowy lub docelowy)
• Typ ruchu (przyjęcie / wydanie / transfer / korekta)
• Użytkownik wykonujący operację
• Zakres dat

Korekta zapisu

1. Znajdź ruch do skorygowania na liście
2. Kliknij Koryguj
3. Wpisz powód korekty (wymagany)
4. System utworzy zapis korekty (oryginał pozostaje niezmieniony)

46. Audit Log

Przegląd

Audit Log to niezmienialny dziennik wszystkich operacji w systemie. Pokazuje kto, kiedy, w jakim module i na jakim rekordzie wykonał akcję (CREATE / UPDATE / DELETE). Przeznaczony dla administratorów i audytorów.

Zakładki

• Log — pełen dziennik z filtrami (użytkownik, moduł, operacja, record_id, daty)
• Record — historia konkretnego rekordu (po podaniu record_id widzisz wszystkie zmiany na nim wykonane)
• Storage — rozmiar bazy, limit, flaga „należy zarchiwizować" (tylko dla administratora)

Eksport

Cały dziennik (z filtrami) można wyeksportować do Excel — do 50 000 rekordów na raz. Przydatne podczas kontroli zewnętrznej lub w razie sporu o operacje historyczne.

47. Historia cen

Przegląd

Moduł Historia cen śledzi zmiany cen filamentów i modeli w czasie. Pozwala porównać dostawców, przeanalizować trendy rynkowe i uzasadnić zmiany cennika klientowi.

Funkcjonalności

• Wykresy trendów cenowych (filament / model)
• Porównanie dostawców (cena za kg filamentu)
• Tabela historyczna z filtrami: produkt, dostawca, okres
• Eksport do Excel

Jak korzystać

1. Otwórz Historia cen z grupy Analityka
2. Wybierz produkt z listy
3. Ustaw zakres dat
4. Wykres pokaże trend, tabela poniżej szczegóły
5. Kliknij Eksport Excel aby pobrać dane do dalszej analizy

48. Auto-wycena STL

Przegląd

Moduł Auto-wycena STL pozwala natychmiast wyliczyć koszt druku i zaproponować cenę sprzedaży na podstawie pliku STL — bez konieczności ręcznego wpisywania objętości, czasu czy zużycia filamentu. Wystarczy przeciągnąć plik, wybrać materiał i drukarkę.

Upload plików STL

1. Otwórz moduł Auto-wycena STL z grupy Sprzedaż
2. Przeciągnij pliki STL na strefę uploadu (lub kliknij aby wybrać z dysku)
3. Możesz wrzucić wiele plików naraz (batch mode) — każdy pojawi się na liście po lewej
4. Kliknij nazwę pliku na liście aby zobaczyć jego podgląd 3D i wyniki analizy

Analiza geometrii

Po wgraniu pliku system automatycznie analizuje geometrię modelu i wyświetla:

• Objętość — ile cm³ materiału potrzeba do wydruku
• Pole powierzchni — cm² (wpływa na czas druku)
• Bounding box — wymiary modelu w mm (x × y × z)
• Liczba trójkątów — złożoność siatki 3D
• Complexity score — wskaźnik złożoności (0–100), im wyższy tym trudniejszy druk
• Support ratio — szacowany udział supportów (0–100%)

Parametry wyceny

1. Wybierz materiał z listy filamentów (system pobierze gęstość i cenę za kg)
2. Wybierz drukarkę (system pobierze pobór mocy i amortyzację)
3. Ustaw wysokość warstwy (0.10 / 0.15 / 0.20 / 0.28 / 0.30 mm)
4. Wpisz ilość sztuk
5. Kliknij Oblicz wycenę

Wyniki kalkulacji

Po obliczeniu zobaczysz pełny breakdown kosztów:

• Koszt filamentu — na podstawie objętości × gęstość × cena/kg
• Koszt energii — moc drukarki × szacowany czas
• Koszt robocizny — stawka godzinowa z ustawień
• Amortyzacja — per-printer lub globalna stawka
• Setup — koszt przygotowania druku
• Postprodukcja — koszt obróbki wykończeniowej

Poniżej breakdownu wyświetlane są 3 tiery cenowe:

• Cena minimalna — pokrywa koszty + minimalna marża
• Cena sugerowana — standardowa marża z ustawień
• Cena katalogowa — wyższa marża (do cennika/marketplace)

Podgląd 3D

Po prawej stronie wyświetlany jest interaktywny podgląd 3D wybranego pliku STL. Możesz obracać model myszką aby ocenić jego złożoność wizualnie.

Zapisywanie wyceny

Kliknij Zapisz wycenę przy wybranym pliku — wycena zostanie zapisana w bazie danych. Możesz do niej wrócić później lub porównać z rzeczywistym kosztem po wykonaniu druku.

49. Floor Plan (plan hali)

Przegląd

Moduł Floor Plan pozwala zwizualizować rozmieszczenie drukarek na planie hali produkcyjnej. Dzięki niemu widzisz na jednym ekranie, gdzie stoi każda drukarka, jaki ma aktualny status i czy nagrywa timelapse.

Konfiguracja planu

1. Otwórz moduł Floor Plan z grupy Fleet w menu bocznym
2. Ustaw wymiary hali (szerokość × głębokość w metrach) — siatka dostosuje się automatycznie
3. Przeciągnij drukarki z listy na odpowiednie pozycje na siatce (drag & drop)
4. Układ zapisuje się automatycznie

Status drukarek na żywo

Każda drukarka na planie wyświetla kolorowy wskaźnik statusu:

• Zielony — drukarka wolna, gotowa do pracy
• Niebieski — druk w toku (z postępem %)
• Żółty — wymaga uwagi (np. kończy się filament)
• Czerwony — błąd lub offline
• Szary — serwis / wyłączona

Timelapse

Dla każdej drukarki możesz skonfigurować nagrywanie timelapse:

1. Kliknij drukarkę na planie i wybierz zakładkę Timelapse
2. Wybierz tryb nagrywania: Interwał (co N sekund) lub Per layer (zdjęcie po każdej warstwie)
3. Ustaw interwał (5–300 sekund) i limit pamięci (max MB)
4. Kliknij Rozpocznij nagrywanie

Nagrania timelapse można odtwarzać, pobierać lub usuwać z poziomu listy nagrań.

50. Marketing i Ankiety (Customer Discovery)

Przegląd

Rozszerzenia marketingowe służą badaniu potrzeb docelowych segmentów klientów poprzez ankiety B2B.

Ankiety B2B / B2C

Zintegrowane mechanizmy ankiet (Google Forms) umożliwiają zbieranie feedbacku od różnych grup, takich jak:

• Solopreneur / Mała firma
• Business Owner / CEO
• Hobbysta / Pasjonat
• Planista Produkcji
• itd... (9 niezależnych ankiet we wszystkich językach systemu)

Web3Forms Integracja

Główny landing page aplikacji wykorzystuje bezserwerowe połączenie z Web3Forms do zbierania adresów email użytkowników do fazy Early Access / Beta.

* Uwaga: Eksperymentalna wtyczka AI Viral Factory (TikTok) nie jest obecnie kluczową funkcjonalnością platformy i prace nad nią mają niższy priorytet.

11a. Magazyny — zarządzanie wieloma lokalizacjami

Przegląd

Moduł Magazyny rozszerza podstawowy moduł Magazyn o obsługę wielu fizycznych lokalizacji magazynowych. Pozwala tworzyć osobne magazyny dla gotowych produktów, części zamiennych, surowców i zwrotów.

Typy magazynów

Tworzenie magazynu

1. Przejdź do modułu Magazyny
2. Kliknij „Nowy magazyn"
3. Wpisz nazwę i wybierz typ
4. Opcjonalnie dodaj opis
5. Kliknij „Zapisz"

Transfery między magazynami

Możesz przenosić produkty między magazynami:

1. Kliknij „Transfer" w module Magazyny
2. Wybierz pozycję do przeniesienia
3. Wybierz magazyn docelowy
4. Wpisz ilość i powód transferu
5. Kliknij „Potwierdź" — transfer zostanie zarejestrowany w historii

Historia transferów

Wszystkie transfery są rejestrowane z datą, ilością, powodem i użytkownikiem. Historia dostępna jest w sekcji „Ostatnie transfery" na dole strony modułu Magazyny.

Magazyn domyślny

Jeden magazyn może być oznaczony jako domyślny. Produkty z druku/postprodukcji trafiają automatycznie do magazynu domyślnego. Zmień domyślny magazyn przyciskiem „Ustaw jako domyślny".

Dodatek A: Szczegóły kalkulacji kosztów

Wzory obliczeniowe

Poniżej przedstawiono dokładne wzory używane przez FarmFlow do kalkulacji kosztów druku:

Koszt filamentu

koszt_filamentu = zużycie_g × (cena_zakupu_szpuli / waga_początkowa_g)

Przykład: 50g zużycia × (89 PLN / 1000g) = 4.45 PLN

Koszt energii elektrycznej

koszt_prądu = (moc_drukarki_W / 1000) × czas_druku_h × cena_kWh

Przykład: (250W / 1000) × 3h × 1.00 PLN/kWh = 0.75 PLN

Koszt robocizny

koszt_robocizny = czas_druku_h × stawka_godzinowa

Przykład: 3h × 35 PLN/h = 105 PLN

Uwaga: W praktyce czas robocizny to nie czas druku, a czas obsługi (przygotowanie, kontrola). Dostosuj stawkę odpowiednio.

Koszt amortyzacji

koszt_amortyzacji = czas_druku_h × stawka_amortyzacji_PLN_h

Przykład: 3h × 2.50 PLN/h = 7.50 PLN

Stawka amortyzacji = cena_drukarki / (planowane_godziny_życia). Np. 5000 PLN / 2000h = 2.50 PLN/h

v2 — per-printer amortyzacja: jeśli drukarka ma uzupełnioną cenę zakupu i godziny oczekiwanej żywotności (`expected_lifetime_h`), kalkulator używa indywidualnej stawki tej maszyny. Wzór: stawka = printers.purchase_price / printers.expected_lifetime_h. Bez kompletu danych (lub przy `expected_lifetime_h ≤ 0`) — fallback do globalnej stawki z Ustawień.

Zużycie dyszy / stołu / suszenie filamentu (v2)

koszt_zużycia_dyszy = nozzle_wear_cost (PLN per druk, z formularza lub auto z `filaments.is_abrasive=1` × `settings.default_nozzle_wear_cost`)

koszt_zużycia_stołu = build_plate_cost (PLN per druk, z formularza lub `settings.default_build_plate_cost`)

koszt_suszenia = drying_cost (PLN per druk, z formularza lub auto z `filaments.requires_drying=1` × `settings.default_drying_cost`)

Orientacyjne stawki rynkowe (maj 2026):

• Zużycie dyszy: 0.20–0.50 PLN/h dla CF abrasive (hardened nozzle wymaga wymiany co 200-500h)
• Zużycie stołu: 0.10–0.30 PLN/h dla PEI (sheet wytrzymuje 500-1500 cykli)
• Suszenie: ~1 PLN/szpula × hours/szpula (suszarka 4-6h przy 70°C)

Koszt całkowity

koszt_całkowity = filament + prąd + robocizna + amortyzacja + setup + dyszą + stół + suszenie + inny + postprodukcja + QC + pakowanie

Pierwszych 9 składników to koszty per batch (per druk), kolejne 3 to koszty per sztuka × ilość.

Koszt jednostkowy

koszt_jednostkowy = koszt_całkowity / ilość_sztuk

Ceny sprzedaży

cena_minimalna = koszt_jednostkowy × (1 + marża_min / 100)

cena_sugerowana = koszt_jednostkowy × (1 + marża_domyślna / 100)

cena_katalogowa = koszt_jednostkowy × (1 + marża_katalogowa / 100)

Próg rentowności (break-even)

break_even = koszty_stałe_miesięczne / (cena_sprzedaży - koszt_jednostkowy)

Wynik: ile sztuk miesięcznie musisz sprzedać aby pokryć koszty stałe.

Prowizja marketplace — osobny tier (v2)

Prowizja marketplace nie jest wliczana do `total_cost` ani do `unit_gross_price` — to dodatkowy tier cenowy stosowany do ceny sugerowanej:

cena_finalna_marketplace = cena_sugerowana / (1 - prowizja_pct / 100)

wartość_prowizji = cena_finalna_marketplace - cena_sugerowana

Przykład: cena sugerowana 100 PLN, Allegro 10% → cena finalna 111.11 PLN, prowizja 11.11 PLN. Po potrąceniu 10% przez Allegro klient zapłaci 111.11 PLN, sprzedawca otrzyma 100 PLN (zgodnie z wyliczeniem).

Stawka prowizji jest rezolwowana w 5-poziomowym priorytecie (od najwyższego):

1. Wartość ręcznie wpisana w trybie „Własna stawka" w Kalkulatorze
2. Indywidualne nadpisanie per oferta (`marketplace_listings.fee_override`)
3. Aktywny preset platformy (Allegro 10%, eBay 12.5%, Etsy 6.5%, Amazon 15%, OLX 0%)
4. Globalny default użytkownika (Ustawienia → „Domyślna prowizja marketplace %")
5. 0% (brak prowizji — fallback końcowy)

Dodatek B: Import i eksport Excel

Eksport danych

Każdy moduł z tabelą danych oferuje przycisk „Eksport do Excel". Eksportowane są wszystkie widoczne kolumny z aktualnymi filtrami.

Format pliku

• Format: .xlsx (Office Open XML)
• Kodowanie: UTF-8 (polskie znaki obsługiwane)
• Arkusz: jeden arkusz z nagłówkami w pierwszym wierszu
• Daty: format ISO (YYYY-MM-DD)
• Liczby: separator dziesiętny — kropka

Import danych

Import dostępny jest w modułach: Filamenty, Drukarki, Modele, Zamówienia.

Procedura importu

1. Pobierz szablon z Ustawienia → Szablony importu
2. Otwórz szablon w Excel/LibreOffice
3. Wypełnij dane (nie zmieniaj nagłówków!)
4. Zapisz plik jako .xlsx
5. W odpowiednim module kliknij „Import z Excel"
6. Wybierz plik
7. System pokaże podsumowanie: ile zaimportowano, ile pominięto

Mapowanie kolumn (szablony)

Szablon: Filamenty

Szablon: Modele

Dodatek C: Obieg dokumentów — szczegóły

Faktura VAT (FV)

Faktura VAT generowana jest automatycznie przy sprzedaży z magazynu lub ręcznie z modułu Dokumenty.

Zawartość faktury

• Nagłówek: numer, data wystawienia, data sprzedaży, termin płatności
• Sprzedawca: dane firmy z Ustawień (nazwa, NIP, adres, konto)
• Nabywca: dane kontrahenta (nazwa, NIP, adres)
• Pozycje: opis, ilość, jednostka, cena netto, stawka VAT, kwota brutto
• Podsumowanie: suma netto, suma VAT, suma brutto
• Metoda płatności: przelew / gotówka / karta
• Uwagi: opcjonalne notatki (z Ustawień: invoice_notes)

Wydanie Zewnętrzne (WZ)

Dokument WZ potwierdza wydanie towaru z magazynu. Generowany automatycznie przy sprzedaży.

• Numer dokumentu (auto)
• Data wydania
• Odbiorca (kontrahent)
• Pozycje: model, ilość, wartość
• Powiązanie ze sprzedażą i fakturą

Przyjęcie Zewnętrzne (PZ)

Dokument PZ rejestruje przyjęcie towaru od dostawcy (np. zakup filamentu, części zamiennych).

• Numer dokumentu (auto)
• Data przyjęcia
• Dostawca (kontrahent)
• Pozycje: opis, ilość, cena

Rozchód Wewnętrzny (RW)

Dokument RW rejestruje zużycie materiału wewnątrz firmy. Generowany automatycznie przy rozpoczęciu druku.

• Numer dokumentu (auto)
• Data rozchodu
• Pozycje: filament, ilość (g), powiązanie z drukiem
• Cel: produkcja (zlecenie druku)

Przyjęcie Wewnętrzne (PW)

Dokument PW rejestruje przyjęcie produktu z własnej produkcji do magazynu. Generowany przy przeniesieniu druku do magazynu.

• Numer dokumentu (auto)
• Data przyjęcia
• Pozycje: model, ilość, koszt jednostkowy
• Źródło: produkcja własna

Schemat generowania dokumentów

Dodatek D: Najlepsze praktyki

Organizacja pracy

Codzienna rutyna

1. Sprawdź Dashboard — alerty, KPI, otwarte zamówienia
2. Sprawdź stan filamentów — zamów brakujące
3. Przejrzyj kolejkę druków — uruchom nowe zlecenia
4. Przeprowadź QC zakończonych druków
5. Zarejestruj sprzedaże dnia

Cotygodniowa rutyna

1. Wykonaj backup bazy danych (Ustawienia → Eksportuj kopię)
2. Sprawdź przeterminowane serwisy drukarek
3. Przejrzyj raport sprzedaży (7 dni)
4. Zaktualizuj stany magazynowe (inwentaryzacja)
5. Sprawdź zamówienia po terminie

Nazewnictwo

• Filamenty: „[Producent] [Materiał] [Kolor] [Waga]" — np. „Fiberlogy PLA Czerwony 1kg"
• Modele: „[Kategoria] [Nazwa] [Wersja]" — np. „Organizer Biurkowy v2"
• Drukarki: „[Producent] [Model] [#numer]" — np. „Bambu X1C #3"

Kalkulacja kosztów — wskazówki

• Ustaw robociznę na realną stawkę (nie czas druku, a czas obsługi)
• Amortyzacja: podziel cenę drukarki przez planowane godziny życia (np. 2000-5000h)
• Nie zapomnij o kosztach stałych (czynsz, internet, oprogramowanie) — wpisz je w „Koszty stałe miesięczne"
• Marża minimalna powinna pokrywać ryzyko awarii (5-15% druków się nie udaje)

Backup — strategia

• Codziennie: automatyczny backup (planowany w przyszłych wersjach)
• Co tydzień: ręczny eksport z Ustawień → na dysk zewnętrzny lub chmurę
• Przed aktualizacją: zawsze zrób backup przed instalacją nowej wersji
• Przechowuj 3 ostatnie kopie — na wypadek uszkodzenia najnowszej

Dodatek E: Słownik pojęć

Dodatek G: Wymagania systemowe — szczegóły

Minimalne wymagania

Zależności systemowe

• Microsoft Edge WebView2 Runtime — wbudowany w Windows 10 (od aktualizacji 2020) i Windows 11. Jeśli brakuje — instalator FarmFlow zainstaluje go automatycznie.
• Visual C++ Redistributable — wymagany przez Tauri. Instalowany automatycznie.

Porty sieciowe

FarmFlow nie nasłuchuje na żadnym porcie sieciowym w trybie normalnym. Port 47321 jest zarezerwowany dla przyszłego lokalnego REST API (jeszcze nie zaimplementowany).

Lokalizacja plików

Dodatek I: Import ze slicerów — szczegóły

Obsługiwane slicery

Jak działa import

FarmFlow parsuje komentarze w pliku G-code (linie zaczynające się od ;) szukając informacji o czasie druku i zużyciu filamentu. Różne slicery używają różnych formatów komentarzy:

PrusaSlicer / OrcaSlicer

; estimated printing time = 2h 15m 30s

; filament used [g] = 45.23

Cura

;TIME:8130 (sekundy)

;Filament used: 5.432m (metry — przeliczane na gramy)

BambuStudio

; total estimated time: 2h 15m 30s

; filament_used_g = 45.23

Format 3MF

Pliki .3mf to archiwa ZIP zawierające metadane w XML. FarmFlow wyciąga informacje z pliku Metadata/slice_info.config lub 3D/3dmodel.model.

Rozwiązywanie problemów z importem

Dodatek J: Scenariusze użycia

Scenariusz 1: Nowy produkt — od projektu do sprzedaży

1. Dodaj model — Modele → Dodaj model → wgraj STL, ustaw cenę
2. Testowy druk — Druki → Dodaj druk → import ze slicera → drukuj
3. Kontrola jakości — QC → oceń wydruk → jeśli OK, kontynuuj
4. Kalkulacja ceny — Kalkulator → sprawdź marżę przy różnych cenach
5. Produkcja seryjna — Druki → dodaj zlecenie na 10 sztuk
6. Do magazynu — po zakończeniu druku → „Do magazynu"
7. Wystaw na Allegro — Allegro → Nowa oferta → zdjęcie AI + opis AI
8. Sprzedaż — Magazyn → Sprzedaj → auto WZ + FV

Scenariusz 2: Zamówienie klienta

1. Rejestracja — Zamówienia → Nowe zamówienie → dodaj pozycje
2. Planowanie — Zlecenia → Nowe zlecenie → przypisz drukarkę, termin
3. Produkcja — Druki → Utwórz druk z zamówienia
4. QC + Postprodukcja — sprawdź jakość, obróbka wykończeniowa
5. Magazyn — przenieś gotowy produkt
6. Wysyłka — Magazyn → Sprzedaj → WZ + FV → wyślij
7. Zamknięcie — Zamówienia → zmień status na „Dostarczone"

Scenariusz 3: Inwentaryzacja i raportowanie

1. Stan filamentów — Filamenty → sprawdź wagi, zamów brakujące
2. Stan magazynu — Magazyn → porównaj z fizycznym stanem
3. Raport miesięczny — Raporty → Raport sprzedaży (30 dni) → Excel
4. Raport zyskowności — Raporty → Zysk per model → zidentyfikuj bestsellery
5. Statystyki drukarek — Statystyki → sprawdź OEE, failure rate
6. Backup — Ustawienia → Eksportuj kopię zapasową

Scenariusz 4: Serwis drukarki

1. Alert — Dashboard pokazuje „Przeterminowany serwis" dla drukarki X
2. Zmień status — Drukarki → zmień status na „Serwis"
3. Wykonaj przegląd — wyczyść dyszę, skalibruj stół, nasmaruj osie
4. Zarejestruj — Serwis → Dodaj wpis → typ: Przegląd, koszt, części
5. Ustaw następny termin — np. za 500 godzin pracy
6. Przywróć status — Drukarki → zmień status na „Wolna"

Dodatek H: Historia wersji

Co nowego w 2.0

• Pełna praca offline (brak zależności od chmury)
• Lokalna baza SQLite (szybkość, prywatność)
• 24 moduły (vs 8 w wersji 1.x)
• Kalkulator kosztów z 9 składnikami
• Podgląd 3D modeli STL
• System ról i uprawnień
• 9 języków
• Integracja Allegro (Device Flow)
• Generowanie zdjęć AI (Bria, OpenAI)
• Pełny obieg dokumentów (FV, WZ, PZ, RW, PW)
• Import/eksport Excel w każdym module
• Import ze slicerów (G-code, 3MF)
• 6 repozytoriów modeli 3D

Dodatek K: Moduł Slicery — konfiguracja i Quick Slice

Przegląd

Moduł Slicery umożliwia zarządzanie konfiguracjami zainstalowanych slicerów (programów do przygotowywania modeli 3D do druku). Konfiguracje przechowywane są trwale w bazie danych SQLite — każdy użytkownik ma własny zestaw slicerów.

Obsługiwane slicery

Auto-detect (automatyczne wykrywanie)

FarmFlow potrafi automatycznie wykryć zainstalowane slicery na Windows, przeszukując typowe ścieżki instalacji:

1. Przejdź do modułu Slicery w sidebarze
2. Kliknij przycisk „Wykryj slicery" (ikona lupy)
3. System przeszuka typowe lokalizacje (Program Files, AppData)
4. Wykryte slicery pojawią się w sekcji „Wykryte slicery"
5. Kliknij „Dodaj" przy wykrytym slicerze aby zapisać konfigurację

Ręczne dodawanie konfiguracji

1. Kliknij „Dodaj slicer"
2. Wybierz typ slicera (PrusaSlicer / Bambu Studio / AnycubicSlicer)
3. Wpisz nazwę konfiguracji (np. „PrusaSlicer 2.8")
4. Wskaż ścieżkę do pliku wykonywalnego (przycisk „Przeglądaj")
5. Opcjonalnie: wskaż katalog z profilami druku (.ini)
6. Opcjonalnie: wskaż katalog wyjściowy na pliki G-code
7. Kliknij „Zapisz"

Quick Slice (szybki slice)

Quick Slice pozwala przygotować G-code bezpośrednio z FarmFlow, bez otwierania slicera:

1. W sekcji „Quick Slice" wybierz model STL z katalogu
2. Wybierz skonfigurowany slicer
3. Wybierz profil druku (lista profili z katalogu slicera)
4. Kliknij „Slice"
5. FarmFlow uruchomi CLI slicera w tle
6. Po zakończeniu — wynik pojawi się w historii slice'ów

Zarządzanie profilami

FarmFlow odczytuje profile druku (.ini) z katalogu wskazanego w konfiguracji slicera. Profile wyświetlane są jako lista do wyboru przy Quick Slice. Aby dodać nowy profil — utwórz go w slicerze, a FarmFlow automatycznie go wykryje.

Historia slice'ów

Ostatnie 10 operacji slice wyświetlanych jest w tabeli historii z informacjami: data, slicer, model, profil, wynik (sukces/błąd). Pozwala to śledzić co i kiedy było slice'owane.

Uprawnienia