Instrukcja obsługi aplikacji
Witaj w podręczniku użytkownika aplikacji Kiszonkowiec. Dowiedz się, jak zarządzać domową produkcją kiszonek, jak korzystać z kalkulatora solanki, generować listy zakupów oraz śledzić dojrzałość słoików za pomocą kodów QR.
1. Wstęp
Aplikacja Kiszonkowiec to cyfrowe narzędzie dla każdego miłośnika domowej fermentacji mlekowej. Pomaga wyeliminować chaos związany z ręcznym notowaniem terminów, obliczaniem stężeń soli i kontrolowaniem terminów zdatności do spożycia.
Dzięki architekturze PWA (Progressive Web App) aplikację można zainstalować zarówno na komputerze (laptopie), jak i na telefonie z systemem Android/iOS. Aplikacja działa całkowicie w trybie offline – dane zapisywane są lokalnie w bazie danych przeglądarki i synchronizowane automatycznie przy ponownym nawiązaniu połączenia z internetem.
2. Logowanie i Rejestracja
Dostęp do pełnych możliwości aplikacji Kiszonkowiec wymaga zalogowania. Pozwala to na bezpieczne przechowywanie danych w chmurze oraz synchronizację między urządzeniami.
Po przejściu pod adres app.kiszonkowiec.pl zostaniesz powitany ekranem logowania, na którym masz do wyboru dwie główne opcje:
- Zaloguj się: Zakładka przeznaczona dla zarejestrowanych użytkowników. Wpisz swój adres e-mail oraz hasło podane podczas rejestracji, a następnie kliknij zielony przycisk „Zaloguj się”.
- Załóż konto: Jeśli korzystasz z aplikacji po raz pierwszy, przełącz się na zakładkę „Załóż konto”. Podaj swój adres e-mail (będzie służył jako login) oraz silne hasło. Po zatwierdzeniu Twoje konto zostanie natychmiast utworzone.
W przypadku zapomnienia hasła, pod formularzem logowania znajdziesz odnośnik „Zapomniałeś hasła?”, który umożliwia szybkie zresetowanie hasła i odzyskanie dostępu do konta poprzez link wysłany na Twój adres e-mail.
3. Pulpit „Dziś”
Ekran główny (zakładka „Dziś”) to Twoje centrum dowodzenia na bieżący dzień i tydzień. Wyświetla kluczowe podsumowania oraz akcje, które wymagają Twojej uwagi:
- Licznik słoików: Szybki wgląd w liczbę aktualnie fermentujących (aktywnych) naczyń oraz sumę ukończonych projektów.
- Do zakiszenia w tym tygodniu: Automatyczna lista zadań (checklist) wygenerowana na podstawie Twojego harmonogramu. Zaznaczając zrealizowane zadania i klikając „Zatwierdź zakiszenie”, automatycznie dodajesz nowe słoiki do trackera.
- Wymaga Działania (Alerty przeniesienia): Gdy czas burzliwej fermentacji słoika dobiegnie końca, aplikacja wyświetli tu wyraźne ostrzeżenie, że naczynie należy przenieść w chłodniejsze miejsce (np. do lodówki lub piwnicy) w celu spowolnienia procesu.
- Najnowsze aktywne fermentacje: Skrócona lista ostatnio rozpoczętych procesów z paskami postępu.
- Porada dnia: Dynamiczne wskazówki i fakty dotyczące fermentacji (np. czystości naczyń, doboru soli czy eliminowania drożdży kożuchujących).
4. Planer i Kalendarz
Zakładka „Kalendarz” pozwala na planowanie przyszłej produkcji oraz ułatwia codzienne zarządzanie zapleczem surowcowym. Składa się z trzech zintegrowanych modułów:
3.1 Tygodniowy harmonogram kiszenia
Aplikacja dzieli rok na 52 tygodnie produkcyjne. Używając przycisków nawigacji, możesz zaplanować kiszenie z wyprzedzeniem. Karta podsumowania tygodnia pokazuje całkowitą liczbę planowanych butelek/słoików oraz szacowany koszt zakupu składników.
3.2 Automatyczna lista zakupów
Na podstawie przepisów przypisanych do wybranego tygodnia aplikacja tworzy inteligentną listę zakupów. Składniki są automatycznie sumowane i grupowane według kategorii w sklepie (warzywa, przyprawy suche, inne itp.). Listę możesz:
- Odznaczać w sklepie w czasie rzeczywistym.
- Wysłać domownikom, klikając ikonę „Udostępnij” (generuje to czytelny link tekstowy).
- Przekształcić w zapasy spiżarni jednym kliknięciem („Kupione (dodaj do spiżarni)”).
3.3 Spiżarnia (mam w domu)
Moduł spiżarni pozwala na odnotowanie posiadanych w domu składników (np. zapasu soli, kupionego wcześniej czosnku itp.). Ilości produktów znajdujących się w spiżarni są automatycznie odejmowane od listy zakupów na dany tydzień, dzięki czemu kupujesz tylko to, co jest faktycznie potrzebne.
5. Baza i Kreator Przepisów
Zakładka „Przepisy” to Twoja biblioteka kulinarna. Znajdziesz w niej zarówno wbudowane, klasyczne przepisy, jak i miejsce na własne kompozycje.
4.1 Wyszukiwanie i Filtrowanie
Siatkę przepisów możesz łatwo przeszukiwać tekstowo lub filtrować za pomocą zakładek:
- Wszystkie: Pełna lista dostępnych receptur.
- Sezonowe: Przepisy rekomendowane na bieżący miesiąc (ze względu na naturalną dostępność świeżych warzyw w Polsce).
- Ulubione: Przepisy oznaczone przez Ciebie gwiazdką w szczegółach.
- Własne: Twoje autorskie kompozycje stworzone w kreatorze.
- Rynek: Przepisy opublikowane w chmurze przez innych użytkowników społeczności Kiszonkowiec.
4.2 Kalkulator Solanki i Szczegóły Przepisu
Po kliknięciu w dowolną kartę przepisu otwiera się szczegółowy modal. Jego kluczową funkcją jest Kalkulator Solanki. Wpisz pożądaną objętość wody (np. dla posiadanych słoików), a kalkulator natychmiast przeliczy potrzebną ilość soli niejodowanej (np. dla stężenia 2%, 3% czy 5%).
W tym miejscu możesz również ustawić swoją globalną ocenę przepisu (w skali 1-5 gwiazdek) oraz określić częstotliwość kiszenia (np. „Co tydzień” – co automatycznie uwzględni ten przepis w każdym tygodniowym harmonogramie).
4.3 Kreator własnych przepisów
Klikając pływający przycisk plusa (FAB) w prawym dolnym rogu ekranu Przepisów, otworzysz zaawansowany kreator. Pozwala on na wprowadzenie:
- Nazwy przepisu, domyślnego typu naczynia, trudności i szacowanego kosztu.
- Czasu fermentacji (liczby dni) potrzebnej do osiągnięcia gotowości.
- Sezonowości (określenie przedziału miesięcy, np. od czerwca do września).
- Domyślnych parametrów solanki (wody, soli i stężenia procentowego).
- Listy składników, przypraw, narzędzi i szczegółowych kroków przygotowania (wpisywanych linia po linii w prostym formacie).
6. Tracker (Monitor słoików)
Zakładka „Tracker” służy do bieżącego śledzenia procesu fermentacji każdego zrobionego naczynia. Lista podzielona jest na słoiki „W trakcie” (aktywne fermentacje) oraz „Zjedzone” (historia produkcji).
5.1 Szczegóły partii i alerty
Po kliknięciu w aktywny słoik (lub zeskanowaniu jego kodu QR), zobaczysz szczegóły konkretnej partii:
- Liniowy pasek postępu: Wizualizuje etap fermentacji (np. „Dzień 3 z 7”) wyliczony na podstawie daty zakiszenia i czasu trwania z przepisu.
- Lokalizacja: Informacja o aktualnym miejscu (np. Blat kuchenny, Spiżarnia, Lodówka).
- Ostrzeżenie FIFO (First In, First Out): Unikalny system zapobiegający marnowaniu żywności. Jeśli w Twoich zapasach (np. lodówce) znajduje się starsza partia tej samej kiszonki, aplikacja pokaże jasny komunikat: „W spiżarni znajduje się starsza partia! Zjedz ją w pierwszej kolejności.”.
- Galeria zdjęć partii: Możliwość dokumentowania procesu. Możesz zrobić zdjęcie aparatem telefonu lub wgrać plik z dysku, aby wizualnie porównać etapy fermentacji tej samej partii w kolejnych dniach.
7. Inwentarz Naczyń
Jedną z unikalnych cech Kiszonkowca jest zintegrowany inwentarz naczyń domowych (znajdziesz go w zakładce „Ustawienia”). Zamiast planować kiszenie w oderwaniu od rzeczywistości, możesz zdefiniować liczbę wolnych słoików i nakrętek, które fizycznie posiadasz w kuchni.
Aplikacja weryfikuje Twoje zapotrzebowanie produkcyjne na dany tydzień. Jeśli zaplanujesz kiszenie 4 słoików o pojemności 0.9L, a w inwentarzu masz tylko 2 wolne naczynia, system automatycznie dopisze brakujące słoiki oraz pasujące nakrętki do listy zakupów.
W Ustawieniach możesz łatwo dodawać własne naczynia, określając ich pojemność w mililitrach, wybierając pasującą ikonę (słoik/butelka/kamionka) oraz konfigurując opcjonalny typ nakrętki (np. 82 mm).
8. Drukowanie i QR Skaner
Aplikacja posiada zautomatyzowany moduł generowania etykiet identyfikacyjnych w formacie PDF. Etykiety można drukować na zwykłym papierze lub na gotowych arkuszach samoprzylepnych A4.
7.1 Zbiorczy Kreator Etykiet
Uruchamiany przyciskiem „Etykiety zbiorczo” z poziomu Trackera lub ekranu głównego. Umożliwia:
- Wybór formatu arkusza A4 (obsługa popularnych szablonów, np. Avery L7159 - 24 etykiety 63.5x34mm, 21 etykiet, 40 etykiet itd.).
- Zdefiniowanie pozycji startowej na arkuszu – jeśli zużyłeś już np. 5 naklejek z arkusza, możesz wpisać pozycję startową „6”, a generator PDF pominie pierwsze 5 pól, nie marnując papieru!
- Wybór konkretnych słoików z listy, które mają zostać uwzględnione na wydruku.
7.2 Inteligentny kod QR
Każda etykieta zawiera unikalny kod QR. Zeskanowanie go dowolnym czytnikiem w telefonie (lub wbudowanym skanerem w aplikacji Kiszonkowiec) natychmiast przeniesie Cię do karty danego słoika w aplikacji, gdzie możesz sprawdzić datę produkcji, oryginalny przepis, zalecenia solankowe i dodać własne notatki.
9. Ustawienia i Chmura
Zakładka „Ustawienia” pozwala dostosować aplikację do Twojego domowego workflow:
- Profil i Chmura: Założenie konta (wymaga podania jedynie e-maila) pozwala na synchronizację bazy danych z chmurą. Umożliwia to wygodną pracę na wielu urządzeniach jednocześnie (np. planowanie na laptopie, a odznaczanie zakupów i skanowanie QR na telefonie).
- Wspólne gospodarstwo (Domownicy): Funkcja parowania kont. Podając kod parowania partnerowi lub skanując jego kod QR, łączycie Wasze bazy danych w jedno. Posiadacie wówczas wspólną spiżarnię, tę samą listę zakupów i wspólnie zarządzacie słoikami.
- Preferencje planowania: Możliwość ustawienia stałego dnia kiszenia w tygodniu (np. Sobota) oraz docelowej liczby słoików rotacyjnych, które aplikacja powinna sugerować z kalendarza.
- Heatmapa i statystyki: Wizualizacja Twojej aktywności produkcyjnej z ostatnich 12 tygodni (w stylu wykresów aktywności GitHub) wraz z licznikami całkowitej produkcji.
- Zarządzanie bazą danych: Narzędzia do eksportu całego stanu aplikacji do pliku tekstowego (kopia bezpieczeństwa JSON), importu danych z pliku oraz całkowitego czyszczenia lokalnej bazy danych.
