📘 Instrukcja obsługi WisLab

WisLab to centrum zarządzania laboratorium Zn–MnO₂: od zamówień, przez receptury i procesy, po raporty. Cała aplikacja jest po polsku i zbudowana wokół codziennej pracy laboranta.

🚀 Pierwsze kroki

Logowanie

Otwórz http://57.128.242.108:8140 w przeglądarce.
Wpisz login i hasło. Po pierwszym wejściu hasło można zmienić w Zarządzanie.
Po zalogowaniu trafiasz na Dashboard — strona główna.

Nawigacja

Górny pasek ma:

Logo WisLab (lewy róg) — wraca na Dashboard.
Zakładki: Dashboard, Magazyn, Receptury ▾, Badania ▾, Narzędzia, Baza Wiedzy, Raporty, Zarządzanie.
Wyszukiwarka globalna (prawy róg) — szuka po wszystkich tabelach (pasta, próbka, magazyn, dokument).
🌙 / ☀️ — przełącznik motywu jasny/ciemny.

💡 Tip: Każdy ekran ma na górze ścieżkę okruszków (np. Dashboard / Receptury / Procesy). Klik w element ścieżki = powrót.

🏠 Dashboard

Jeden ekran z najważniejszymi rzeczami "tu i teraz".

Co jest na Dashboardzie?

🔍 Wyszukiwarka globalna — wpisz nazwę / formułę / numer próbki, masz wyniki na żywo.
6 przycisków szybkiej akcji — Nowa pasta, Nowy elektrolit, Nowa elektroda, Nowa próbka, Magazyn/Zamów, Raporty.
8 kafelków statystyk — kliknięcie w dowolny otwiera odpowiednią listę.
Aktywne procesy — wszystko ze statusem "planowane" lub "w trakcie", klik = przejście do szczegółów.
Do zrobienia — kolejka zadań (priorytet !!! / !!).
🛒 Magazyn — w drodze (z ETA) + do uzupełnienia (low / order).
🏆 Top pasty (cykle) — ranking past wg liczby cykli.
👤 Ostatnio przygotowane — kto co i kiedy zrobił (chronologicznie).

Workflow: zaczynam dzień

Sprawdź Magazyn — czy nic nie jest "w drodze" do odebrania.
Sprawdź Aktywne procesy — czy któryś nie czeka na kolejny krok.
Sprawdź Do zrobienia — co dziś planowane.

📦 Magazyn

Stan ilościowy odczynników, zamówień i dostaw.

Statusy pozycji

Status	Co znaczy	Co zrobić
have	Mamy w magazynie	Nic — używamy
low	Mało, kończy się	Zamów wkrótce (przycisk "Zamów")
order	Zamów teraz	Klik "Zamów" → wpisz numer + ETA
ordered	Zamówione, czekamy	Po dostawie klik "Dostarczone"

Jak zamówić odczynnik

Krok 1: W wierszu pozycji ze statusem low lub order klik "Zamów".
Krok 2: W modalu wpisz numer zamówienia (np. FV/2026/04/123) i przewidywaną datę dostawy (ETA).
Krok 3: Zatwierdź. Status zmienia się na ordered, w wierszu widać "📦 ETA 12.05.2026".

Jak zaksięgować dostawę

Krok 1: Pozycja ma status ordered. Klik "Dostarczone".
Krok 2: (Opcjonalnie) wgraj fakturę PDF/JPG — pojawi się jako link w kolumnie "Faktura".
Krok 3: Status wraca na have. Faktura widoczna też w Bazie Wiedzy.

Kategorie

carbon — węgle (Super P, C65, grafit, GNP)
binder — spoiwa (PVDF, SBR, CMC)
solvent — rozpuszczalniki (NMP, woda DI, etanol)
additive — dodatki (sole Zn, Mn, Bi₂O₃, ZnO)
substrate — podłoża (siatka stalowa, blacha cynkowa, filc)
tool — narzędzia (rakla, papier P400, ultradźwięki)
prepared — gotowe (pasty, elektrolity przeznaczone do użycia)

💡 Tip: Klik w nazwę pozycji = pełna historia zmian + powiązania (np. które pasty ją używają).

⚙️ Procesy

Najważniejsza zakładka — tu prowadzisz krok-po-kroku przygotowanie elektrody, elektrolitu, pasty.

Zakładki w Procesach

Elektroda Zn — anoda cynkowa: blacha lub siatka.
Elektroda Mn — katoda manganowa: pasta MnO₂ na podłożu.
Elektrolit — przygotowanie roztworu Zn–Mn z kontrolą pH.
SOP Podłoże — sztywna check-lista przygotowania podłoża (aceton → P400 → etanol → HCl → DI → wygrzew).
Historia — wszystko zakończone (completed/cancelled), tabela z datami.

Cykl pracy z procesem

+ Nowy proces → Składniki → Kroki + timery → Notatki → Zakończ → Auto-elektrolit + szablon

Tworzenie nowego procesu

Krok 1: Klik "+ Nowy proces" (prawy górny róg). Otworzy się modal.
Krok 2: Wybierz typ (Elektroda Zn / Mn / Elektrolit). Dla elektrolitu — picker AI poprowadzi przez sole.
Krok 3: Dodaj składniki: nazwa, formuła, ilość, jednostka. Możesz wybrać z magazynu (klik 🔍).
Krok 4: Dodaj kroki: tytuł, opis, czas. Kroki można przeciągać (drag-and-drop).
Krok 5: Zapisz. Proces ląduje w odpowiedniej zakładce ze statusem "planowany".

Prowadzenie procesu (codzienna praca)

1. Otwórz proces — w odpowiedniej zakładce, klik na kartę.
2. Skaluj recepturę — pole "Gotowego [g]" lub "Objętość [L]" → klik "Przelicz". Wszystkie ilości skalują się proporcjonalnie.
3. Odhacz składniki — w miarę odważania zaznaczaj checkbox. Stan zapisuje się automatycznie.
4. Wystartuj timer kroku — przy każdym kroku jest "Start"/"Stop". Timer chodzi nawet po refresh.
5. Wpisz notatki — pole pod każdym krokiem ("Notatka do tego kroku..."). Zapisuje się automatycznie.
6. Wpisz rzeczywisty czas [min] — po zakończeniu kroku, dla statystyk.

💡 Tip: Możesz zostawić proces niedokończony, wyłączyć komputer i wrócić jutro — wszystko jest zapisane w bazie. Otwórz na innym komputerze i zobaczysz dokładnie ten sam stan.

Kalkulator stężeń (dla elektrolitu)

Przy każdym składniku z formułą jest pole c [M]. Wpisz stężenie molowe, system policzy masę:

masa [g] = c [M] × V [L] × M [g/mol]

Aplikacja ROZUMIE monohydraty: ZnSO₄·H₂O, MnSO₄·H₂O itd. Masa molowa pobierana z bazy.

Finalizacja procesu

Krok 1: Wszystkie kroki odhaczone? Wpisz "Notatki końcowe" (np. "klarowny, brak osadu").
Krok 2: Klik "Zakończ".
Krok 3: Status zmienia się na completed. Proces przechodzi do zakładki Historia.
Krok 4 (TYLKO dla elektrolitu): Automatycznie tworzy się:

Wpis w /electrolytes z kodem ELT-001 (kolejny numer).
Skład powiązany ze składnikami z magazynu.
Szablon tego samego procesu z wyczyszczonymi checkboxami — gotowy do następnej szarży.

Klonowanie z historii

W zakładce Historia klik "Użyj ponownie" przy zakończonym procesie → tworzy nową kopię ze statusem "planowany", checkboxy wyzerowane.

💧 Elektrolity

Lista wszystkich roztworów elektrolitowych — anolity, katolity, wspólne.

Lista (zakładka Receptury → Elektrolity)

🔍 Szukaj — po kodzie, nazwie, składniku, formule. Filtruje na żywo.
Filtr status — Aktywne / Zarchiwizowane.
Filtr typ — Anolit / Katolit / Wspólny.
Tabela: Kod, Nazwa, Typ, Skład (żetony), Stężenie, pH, Autor/Data, Status.
Klik nazwę → szczegóły. Klik ✏️ → edycja.

Tworzenie nowego elektrolitu (ręcznie)

Krok 1: Klik "+ Nowy elektrolit".
Krok 2: Wybierz nazwę, typ (anolit/katolit/wspólny), pH, stężenie ogólne.
Krok 3: Picker składu — klik "+ Dodaj składnik". Wybierz z magazynu (z formułą i kategorią) lub wpisz ręcznie. Każdy składnik ma rolę i stężenie (np. "1M").
Krok 4: Wpisz autora i datę wykonania (autouzupełnianie z poprzednich autorów).
Krok 5: Zapisz. Elektrolit ma kod ELT-XXX (auto-numer).

💡 Lepszy sposób: Tworzenie przez Procesy → Elektrolit — masz prowadzenie krok-po-kroku z timerami, a po finalizacji elektrolit powstaje sam.

Szczegóły elektrolitu

Strona pokazuje:

Skład jako tabela z linkami do magazynu (klik = otwiera pozycję).
👤 Autor 📅 Data wykonania.
Powiązania — które próbki używają tego elektrolitu, z którego procesu pochodzi.
Załączniki — zdjęcia z drag-and-drop, klik miniatura → lightbox.
Notatki — pole tekstowe, można edytować.

🧴 Kleje

Receptury klejów do past i elektrod.

Co tu znajdziesz

Baza klejów — wszystkie utworzone kleje w tabeli.
Receptury referencyjne — gotowe szablony:
- NMP-PVDF (wodoodporne): V1, V2, V3, V4, V5
- CB-SBR (wodne — archiwum): CB-SBR®, CB-SBR® ×2

Tworzenie nowego kleju

Krok 1: Klik "+ Dodaj klej".
Krok 2: Kod (np. KLJ-001), nazwa, typ (NMP-PVDF / CB-SBR / inny).
Krok 3: Proporcje (np. "PVDF:NMP 1:9") + skład przez picker.
Krok 4: Autor + data + notatki. Zapisz.

🧪 Roztwory

Bazy roztworów (np. roztwór PVDF w NMP, roztwór HCl 15%).

Po co osobna zakładka?

Roztwory bazowe są pośrednim produktem — nie elektrolit, nie pasta, ale używasz ich w wielu procesach. Tu trzymasz przepisy.

Tworzenie

Klik "+ Nowy roztwór" → nazwa, kod, skład (picker z magazynu), stężenie, autor, data.

📖 Receptury

Centralna lista receptur past z bazy historicznej (Excel) + nowo wprowadzone.

Co znajdziesz

Wszystkie pasty z grupowaniem P1, P2, P3...
Skład w sztywnych polach (base1-4, active, binder1-2, solvent) — historyczny format z Excela.
Wyniki (cykle, pojemność, sprawność) gdy próbka była badana.

💡 Różnica Receptury vs Pasty: "Receptury" to widok read-only z grupowaniem. "Pasty" to lista CRUD z kartami i statystykami. Dane te same.

🎨 Pasty

Pasty MnO₂ na siatce/folii — główny produkt katody.

Widok główny

Statystyki u góry: ile past, ile z >20 cyklami, >50 cyklami.
Search po nazwie/składniku.
Filtr grupy P1-P12 (klik = pokazuje tylko tę grupę).
Karty past — kolor lewej krawędzi = ranking (zielony = top, czerwony = słabe).
Każda karta pokazuje: numer próbki, nazwa, składniki jako żetony, cykle, autor + data, ranking #X.
📊 Wykresy — cykle, pojemność, grupy, top 5.

Tworzenie nowej pasty

Krok 1: Klik "+ Nowa pasta".
Krok 2: Identyfikator (P3-67), nazwa lab. (PMnO2-3), grupa (P3), # próbki.
Krok 3: Picker składu — dodaj bazy, dodatki aktywne, spoiwa, rozpuszczalnik. Każdy ma rolę: Baza / Aktywny / Spoiwo / Rozpuszczalnik.
Krok 4: Autor, data, komentarz, parametry (pH, temperatura, czas mieszania).
Krok 5: Zapisz.

Karta receptury (PDF do druku)

Na stronie szczegółów pasty: "🖨 Karta receptury (PDF)" → otwiera widok A4 z QR. Skanuj telefonem QR → otwiera szczegóły pasty.

⚡ Elektrody

Pełne elektrody (anoda Zn / katoda Mn) — gotowe do testu.

Lista

Sortowanie po Kodzie, Nazwie, Typie, Materiale, Statusie (klik nagłówek).
Klik nazwę = szczegóły.

Tworzenie

Klik "+ Nowa elektroda" → kod, nazwa, typ (anoda/katoda), materiał (Zn / MnO₂ / C), wymiary, masa, podłoże, klej (link), pasta (link), autor + data.

🔬 Próbki

Eksperymenty cyklicznych testów ładowania/rozładowania.

Lista

Tabela z numerem próbki, datą, składnikami z elektrolitu.
Sortowanie po kolumnach (klik nagłówek).
Filtrowanie po numerze próbki / dacie.
Klik # próbki → szczegóły.

Szczegóły próbki

Pokazuje:

Anoda + katoda + elektrolit (linki).
Cykle, pojemności (ładowania/rozładowania), sprawność kulombowska.
Powiązanie z pastą + procesem-źródłem.
Załączniki (zdjęcia ogniwa, krzywe).
"🖨 Etykieta" → 4 etykiety A6 z QR do wydruku i naklejenia na słoiczki.

Tworzenie

Klik "+ Nowa próbka" → numer (auto), data, anoda + katoda + elektrolit (z dropdown), parametry pomiaru (prądy, objętości), notatki.

📚 Badania

Dziennik badań — szersze tematy, hipotezy, plany doświadczeń.

To miejsce na zapis "po co" robisz daną serię prób — w odróżnieniu od pojedynczych próbek.

🧪 Testy

Lista pojedynczych testów (cyklowanie, EIS, CV) z parametrami i wynikami.

🧰 Narzędzia

Pomoce nie-CRUD do codziennej pracy.

🧮 Kalkulator

Mol/M/g — przelicza między stężeniem, masą i objętością. Wbudowane masy molowe (z monohydratami).

📊 Porównywarka

Wybierz 2-5 past lub próbek → porównanie składu i wyników w jednej tabeli.

📅 Timeline

Oś czasu próbek — co, kiedy, przez kogo (chronologicznie).

🔥 Heatmap

Macierz pasta × elektrolit z kolorem = liczba cykli (w trakcie rozwoju).

📝 Notatki

Notatnik na szybkie zapiski, lokalny w przeglądarce.

📋 Kolejka badań

Lista todo z priorytetami (!!! = krytyczne, !! = ważne). Widoczna na Dashboardzie.

📄 Baza Wiedzy

Repozytorium dokumentów — faktury, karty MSDS, publikacje, instrukcje.

Upload

Krok 1: Klik "+ Wgraj dokument" lub przeciągnij plik na stronę (drag-and-drop).
Krok 2: Wybierz kategorię (faktura / msds / publikacja / instrukcja / inne).
Krok 3: Tagi (np. ZnSO4, dostawca-X, 2026) + opis.
Krok 4: Zapisz. Plik trafia na dysk + wpis w bazie.

Wyszukiwanie

Search po nazwie pliku, opisie, tagach.
Filtr kategorii (klik chip).
Klik dokument → preview (PDF/JPG inline) + komentarze + powiązania (z którą pozycją magazynu / pastą jest powiązany).

📊 Raporty

Eksport CSV i statystyki agregowane.

Eksport CSV

4 raporty, każdy do pobrania jako CSV (otwiera się w Excelu z polskimi znakami):

Raport	Filtr	Co dostajesz
Próbki	Daty od/do	Wszystkie próbki w okresie z cyklami i sprawnością
Pasty	Grupa (P1, P2...)	Pasty z wynikami testów
Elektrolity	Status	Lista elektrolitów ze składem
Magazyn	Kategoria	Stan magazynu na dziś

💡 Format CSV: separator średnik, BOM UTF-8, polski przecinek dziesiętny — Excel otwiera bez konfiguracji, polskie znaki zachowane.

Statystyki na stronie

8 metryk: liczba próbek, past, elektrolitów, elektrod, procesów (w tym zakończonych), dokumentów, załączników.
🏆 Top 10 past wg cykli — z linkiem do szczegółów.
📅 Ostatnie próbki — 10 najnowszych.

🤖 Asystent AI

Wbudowany pomocnik (widget na Dashboardzie + przy procesach).

Co potrafi

Odpowiada na pytania o konkretny proces (np. "dlaczego ten krok jest pod wyciągiem?").
Pomaga w pickerze składników — sugeruje sole i monohydraty z magazynu.
Liczy stężenia (kalkulator molowości).
Tłumaczy znaczenie parametrów (sprawność kulombowska, pH, ESR).

Jak korzystać

Otwórz proces → na dole karty jest pole "🧪 Asystent laboratoryjny AI".
Wpisz pytanie po polsku, klik "Zapytaj".
Odpowiedź pojawi się pod polem.

💡 Skróty i tipy

Skróty klawiszowe

Ctrl+F5 lub Ctrl+Shift+R — twardy refresh (wymuś nowe pliki).
W formach: Tab przechodzi przez pola, Enter zatwierdza modal.

Polska notacja

System rozumie obie formy:

1,5 i 1.5 — to samo (przecinek = kropka).
ZnSO4·H2O, ZnSO4*H2O, ZnSO4 H2O — wszystko traktowane jak monohydrat.

Zachowanie pracy

Procesy: stan zapisuje się automatycznie po 5 sekundach od zmiany.
Możesz zamknąć kartę / wyłączyć komputer — wszystko w bazie.
Otwarcie na drugim komputerze pokazuje aktualny stan (synchronizacja przez bazę).

Backup i bezpieczeństwo

Baza danych: /home/user4/wislab/app/data/wislab.db
Backupy automatyczne: kopia przed każdą migracją (pliki .pre-stageN.backup).
W zakładce Zarządzanie — sync do Google Drive (rclone).

Co robić gdy coś nie działa

Coś się nie zapisało? Wyczyść cache: Ctrl+Shift+R.
Strona nie ładuje? Sprawdź czy aplikacja działa: http://57.128.242.108:8140/health.
Nie widzisz nowej zmiany? Wymuś restart aplikacji (administrator: bash /home/user4/wislab/start.sh).
Konflikt na liście? Sprawdź czy nie ma duplikatu — system blokuje powtórzenia kodów (UNIQUE constraint).

Instrukcja aktualizowana: 2026-05-01 · WisLab v2026.5