================================================================================

KLASERIO - CYFROWY KLASER NUMIZMATYCZNY

OFICJALNY PODRĘCZNIK I INSTRUKCJA OBSŁUGI DLA KOLEKCJONERÓW MONET

Oficjalny Portal: www.klaserio.pl | Kontakt z autorem: kontakt.klaserio@gmail.com

Wersja Aplikacji: 1.0.5 (Build 9)

================================================================================


SPIS TREŚCI:

1. O Aplikacji i Filozofia Bezpieczeństwa (100% Offline)

2. Nawigacja Główna, Menu Boczne Modal Navigation Drawer ☰ i Rozwijanie Akordeonowe v

3. Zarządzanie Klaserami i Folderami Monet (Tworzenie, Klonowanie, Edycja, Usuwanie)

4. Kompletny Przewodnik Dodawania i Edycji Monety (Opis Wszystkich Pola Numizmatycznych)

5. Aparat, Zdjęcia HD, Kadrowanie ⚪/⏹️, Galeria Wariantów/Destruktów i Pinch-to-Zoom

6. Dynamiczne Pigułki Podpowiedzi (Autocomplete), Autorski Słownik [➕ Dodaj...] i Czyszczenie ✕

7. Widoki Listy Monet (Standardowy, Kompaktowy, Kafelki/Grid), Sortowanie i Szukanie na Żywo

8. Masowe Zaznaczanie Zakresem "Od...Do" i Łączenie Nieciągłych Grup (1-5, 8-10, 12, 14)

9. 4 Formaty Eksportu Danych (Excel Kompakt, Excel HD, ZIP HD ze Zdjęciami, Tekst/E-mail)

10. Analityka, Wartość Portfela i Podsumowanie Finansowe (Przewodnik po Wszystkich 5 Zakładkach)

11. Kreator Własnego Wykresu (Custom Chart Creator - 6 Wymiarów, 3 Typy Wykresów)

12. Kolekcje Inteligentne (Smart Collections), Szablony 1-Click i Kreator Reguł (Rule Builder)

13. Kopia Zapasowa (Backup JSON / ZIP) i Przywracanie Bazy Danych

14. Pomoc, Zgłaszanie Błędów, Strona www.klaserio.pl i Kontakt z Autorem


================================================================================

SEKCJA 1: O APLIKACJI I FILOZOFIA BEZPIECZEŃSTWA (100% OFFLINE)

================================================================================

Aplikacja Klaserio została zaprojektowana od podstaw specjalnie dla numizmatyków,

kolekcjonerów oraz pasjonatów monet, którzy pragną prowadzić czytelną, bezpieczną

i profesjonalną ewidencję swoich zbiorów.


GWARANCJA PRYWATNOŚCI I LOKALNEGO PRZECHOWYWANIA:

- 100% LOKALNE PRZECHOWYWANIE: Wszystkie zarejestrowane wpisy, notatki kustosza,

 ceny zakupu, wyceny katalogowe oraz zdjęcia przechowywane są wyłącznie

 w pamięci lokalnej Twojego smartfona.

- BRAK LOGOWANIA I KONT: Aplikacja nie wymaga zakładania konta, podawania adresu e-mail,

 numeru telefonu ani jakiejkolwiek rejestracji.

- PEŁNA PRACA BEZ INTERNETU (OFFLINE): Klaserio działa w 100% sprawnie bez dostępu do sieci.

- PEŁNA KONTROLA NAD DANYMI: W dowolnym momencie możesz wygenerować pełną kopię zapasową

 bazy w formacie JSON lub wyeksportować zbiory do arkuszy Excel (.xlsx) oraz archiwów ZIP.


================================================================================

SEKCJA 2: NAWIGACJA GŁÓWNA, MENU BOCZNE (DRAWER ☰) I POD-MENU AKORDEONOWE [v]

================================================================================

Główną osią nawigacji po aplikacji Klaserio jest boczny panel szufladowy (Modal Navigation Drawer)

otwierany przyciskiem [☰] w lewym górnym rogu ekranu.


SKRÓTY W BOCZNYM PANELU:

1. 📁 Moje Kolekcje – przejście do głównej listy klaserów/folderów z monetami.

2. ✨ Analityka i Statystyki – centrum analityki, wykresów, wycen rynkowych i budżetu.

3. ⚙️ Ustawienia Aplikacji – konfiguracja pól, motywu wizualnego i kopii zapasowych.

4. 📖 Instrukcja obsługi – pełny, interaktywny podręcznik użytkownika z wyszukiwarką.

5. ✉️ Zgłoś błąd / Sugestie – dedykowany formularz kontaktowy z automatyczną diagnostyką.

6. ℹ️ O aplikacji & Autor – misja aplikacji, informacje o wersji i autorze.

7. 🌐 Społeczność i strona www – link do oficjalnego portalu www.klaserio.pl oraz grupy na FB.

8. 👥 Zaproś znajomych – szybkie udostępnienie informacji o aplikacji innym kolekcjonerom.


ROZWIJANE POD-MENU AKORDEONOWE [v]:

Obok wybranych pozycji w menu bocznym (np. Moje Kolekcje, Analityka i Statystyki)

znajduje się ikona strzałki rozwijania [v]. Tąpnięcie w strzałkę rozwija bezpośrednią

listę poszczególnych klaserów bez konieczności wychodzenia z bieżącego ekranu.


PRZYCISK WSTECZ [←] VS MENU [☰]:

Gdy otworzysz konkretną kolekcję (np. II RP), w lewym górnym rogu pojawiają się

obok siebie dwa przyciski: [☰] (Menu) oraz [←] (Wstecz). Przycisk [←] powraca

do listy wszystkich klaserów, a [☰] otwiera boczny panel.


================================================================================

SEKCJA 3: ZARZĄDZANIE KLASERAMI I FOLDERAMI MONET

================================================================================

Klasery pozwalają grupować monety według Twojego uznania (np. "Monety II RP 1918-1939",

"PRL Obiegowe", "Srebro Inwestycyjne", "Dukaty Królewskie", "Rzym Antyczny").


TWORZENIE NOWEGO KLASERA (KOLEKCJI):

1. Na ekranie głównym [Moje Kolekcje] kliknij zielony przycisk plusa [+] w prawym dolnym rogu.

2. Wpisz czytelną nazwę klasera w oknie dialogowym i zatwierdź przyciskiem "Dodaj".


EDYCJA, KLONOWANIE I USUWANIE KLASERA:

Przy każdym klaserze na liście znajduje się ikona trzech kropek [⋮]. Tąpnięcie w nią otwiera menu:

- Zmień nazwę – pozwala edytować nazwę klasera.

- Klonuj kolekcję – tworzy kopię klasera wraz ze wszystkimi monetami, parametrami i zdjęciami.

- Usuń kolekcję – trwałe usunięcie klasera z monetami (wymaga potwierdzenia dialogowego).


================================================================================

SEKCJA 4: KOMPLETNY PRZEWODNIK DODAWANIA I EDYCJI MONETY (WSZYSTKIE POLA)

================================================================================

Aby dodać nową monetę, otwórz wybrany klaser i kliknij zielony przycisk [+] w prawym dolnym rogu.


FORMULARZ EDYCJI MONETY - SZCZEGÓŁOWY PRZEWODNIK NUMIZMATYCZNY:


1. IDENTYFIKACJA MONETY:

- Nazwa monety: Dowolny opis (np. "10 Złotych Józef Piłsudski - Strzelec").

- Nominał: Wartość nominalna (np. "10", "2", "1/2", "100").

- Jednostka: Nazwa waluty (złoty, grosz, thaler, denar, drachma, trojak, szóstak, szyling itp.).

- Rok emisji: Rok wybicia (np. "1934").


2. DATOWANIE HISTORYCZNE:

- Przełącznik "Przed Naszą Erą (p.n.e.)": Niezbędny dla monet antycznych (Rzym, Grecja).


3. EPOKA / OKRES HISTORYCZNY:

- Wybór z listy (np. II RP 1918-1939, PRL 1945-1989, Stanisławowska, Królestwo Polskie, Rzym Antyczny, Średniowiecze).


4. METAL / KRUSZEC:

- Wybór stopu: Srebro Ag (np. Ag 750, Ag 925), Złoto Au (np. Au 900, Au 999), Miedź Cu, Mosiądz, Brąz, Nikiel Ni, Cynk Zn, Bimetal.


5. STAN ZACHOWANIA (GRADACJA NUMIZMATYCZNA I-VI I SLABY):

- Stan I (Menniczy / UNC) – stan idealny, bez śladów obiegu, pełny połysk menniczy.

- Stan II (Znakomity / AU) – znikome ślady dotyku.

- Stan III (Bardzo piękny / XF) – czytelne detale, lekko wytarty relief.

- Stan IV (Piękny / VF) – widoczne zużycie obiegowe, czytelne napisy.

- Stan V (Dość piękny / F) – mocne wytarcie, czytelny rysunek ogólny.

- Stan VI (Dostateczny / VG) – słabo czytelny egzemplarz.

- PROOF (Stempel lustrzany) – monety kolekcjonerskie z lustrzanym tłem.

- NGC / PCGS (Grading w slabie) – ocena w plastikowym slabie (np. NGC MS65).


6. STATUS MONETY W PORTFELU:

- W kolekcji (fizycznie posiadana), Poszukiwana (wishlist), Zamówiona (w drodze), Na sprzedaż, Dublet, Sprzedana.


7. FINANSE I TRANSAKCJE:

- Cena zakupu (PLN), Szacowana wartość rynkowa/katalogowa (PLN), Data zakupu, Miejsce zakupu (Dom Aukcyjny, Allegro, OLX, Giełda numizmatyczna, JDA).


8. CECHY MENNICZE I WARIANTY:

- Odmiana (szczegóły stempla), Wariant (różnice napisów/obwódki), Destrukt menniczy (błędy bicia), Rzadkość (skala R1-R8 / Unikat wg Kopickiego), Literatura / Katalog (Kopicki, Parchimowicz, Fischer, Gumowski, Berezowski), Średnica [mm], Waga [g], Rant (gładki, ząbkowany, ozdobny, z napisem), Mincarz / Znak mennicy (np. MW, A, B, H).


9. UWAGI I OPIS WŁASNY:

- Proweniencja (pochodzenie), historia egzemplarza oraz własne notatki kustosza.


================================================================================

SEKCJA 5: APARAT, ZDJĘCIA HD, KADROWANIE ⚪/⏹️, GALERIA WARIANTÓW I PINCH-TO-ZOOM

================================================================================

Aplikacja Umożliwia przechowywanie wysokiej jakości fotografii dla każdej monety.


SLOTY FOTOGRAFICZNE:

1. Awers (główne zdjęcie strony przedniej).

2. Rewers (główne zdjęcie strony tylnej).

3. Odmiana 📷 (zbliżenie stempla lub znaku).

4. Wariant 📷 (zbliżenie napisu otokowego).

5. Destrukt 📷 (zbliżenie błędu bicia).


KADROWANIE I ROTACJA ZDJĘĆ:

Przy wybieraniu zdjęcia uruchamia się kadrownik: wybierz kadr okrągły ⚪ (dopasowany do monety) lub prostokątny ⏹️ oraz obrócenie o 90°.


PODGLĄD HD I PINCH-TO-ZOOM:

Kliknięcie w dowolne zdjęcie na karcie monety otwiera pełnoekranową galerię zdjęć z możliwością płynnego powiększania gestem dwóch palców (Pinch-to-Zoom).


================================================================================

SEKCJA 6: DYNAMICZNE PIGUŁKI PODPOWIEDZI (AUTOCOMPLETE), SŁOWNIK I CZYSZCZENIE ✕

================================================================================

PIGUŁKI PODPOWIEDZI POD POLAMI:

Podczas pisania w polach tekstowych bezpośrednio pod polem pojawiają się poziome pigułki sugestii. Tąpnięcie w pigułkę automatycznie wypełnia pole.


AUTORSKI SŁOWNIK [➕ Dodaj...]:

Pierwszą pigułką jest przycisk [➕ Dodaj...]. Jeśli wpiszesz nową, niestandardową wartość (np. rzadki stop metalu), po kliknięciu wywołasz monit dialogowy:

"Nie ma na liście opcji. Czy chcesz dodać tę wartość na stałe do słownika podpowiedzi?"

Po zatwierdzeniu nowa opcja podpowiada się przy dodawaniu kolejnych monet.


PRZYCISK CZYSZCZENIA [✕] I AUTOMATYCZNA WIELKA LITERA:

Po prawej stronie każdego pola tekstowego znajduje się czerwony przycisk [✕] usuwający cały tekst jednym kliknięciem. Pole tekstowe automatycznie wstawia wielką literę na początku słowa.


================================================================================

SEKCJA 7: WIDOKI LISTY MONET, SORTOWANIE I WYSZUKIWANIE NA ŻYWO

================================================================================

TRYBY WYŚWIETLANIA LISTY MONET:

- Widok Standardowy: Pełna karta ze zdjęciami Awersu/Rewersu, wyceną, stanem zachowania i odznakami wariantów.

- Widok Kompaktowy: Tabela zwięzła z miniaturkami do szybkiego przeglądania obszernych bazy.

- Widok Kafelkowy (Grid): Galeria kafelkowa z naciskiem na zdjęcia.


WYSZUKIWANIE NA ŻYWO BEZ POLSKICH ZNAKÓW:

Ikona lupy [🔍] otwiera wyszukiwarkę na żywo. Aplikacja ignoruje polskie znaki diakrytyczne oraz wielkość liter (np. "zolw" odnajdzie "Żółw", "pilsudski" odnajdzie "Piłsudski").


SORTOWANIE MONET:

Ikona sortowania [≡] pozwala sortować rosnąco [⬆] lub malejąco [⬇] wg: Nazwy, Nominału, Rocznika, Ceny zakupu, Szacowanej wartości, Stanu zachowania, Rzadkości, Średnicy czy Nakładu.


WSKAŹNIKI WARIANTÓW (NOTCH) I KROPKI STATUSÓW:

Górna krawędź obwódki karty monety zawiera zintegrowaną etykietę (Notch) z opisem wariantu/odmiany. Kolorowa kropka sygnalizuje status monety (zielona = W kolekcji, niebieska = Poszukiwana, fioletowa = Dublet/Na sprzedaż).


================================================================================

SEKCJA 8: MASOWE ZAZNACZANIE ZAKRESEM "OD...DO" I ŁĄCZENIE NIECIĄGŁYCH GRUP

================================================================================

WŁĄCZENIE TRYBU MASOWEGO:

Przytrzymaj dłużej palec (Long Press) na pierwszej monecie na liście.


PRECYZYJNY INSTRUKTAŻ ZAZNACZANIA ZAKRESEM (np. kombinacja 1-5, 8-10, 12, 14):

1. ZAZNACZENIE ZAKRESU 1-5: Przytrzymaj monetę nr 1 (Long Press). Przewiń listę i tapnij pojedynczo (Single Tap) monetę nr 5. Aplikacja automatycznie zaznaczy całą ciągłą grupę od 1 do 5 (pozycje 1, 2, 3, 4, 5).

2. DOŁĄCZENIE ZAKRESU 8-10: Przewiń listę niżej do monety nr 8. Tapnij pojedynczo monetę nr 8, a następnie tapnij monetę nr 10. Drugi zakres (8, 9, 10) zostanie dołączony bez odznaczania grupy 1-5!

3. DODAJE POJEDYNCZYCH POZYCJI 12 i 14: Tapnij pojedynczo monetę nr 12, następnie tapnij monetę nr 14.

4. EFEKT: Zaznaczone są odrębne sekcje: [1-5], [8-10], [12] oraz [14]!

5. MASOWE AKCJE: Klonowanie do innego klasera, Przenoszenie do innego folderu, Usuwanie z bazy oraz Udostępnianie/Eksport.


================================================================================

SEKCJA 9: 4 FORMATY EKSPORTU DANYCH I UDOSTĘPNIANIE

================================================================================

Możesz wyeksportować swoje zbiory do 4 profesjonalnych formatów:

1. Raport Excel Kompaktowy (.xlsx): Szybka arkuszowa baza danych ze skompresowanymi obrazkami monet umieszczonymi bezpośrednio w komórkach tabeli.

2. Raport Excel HD z Osadzonymi Obrazami (.xlsx): Pełny arkusz kalkulacyjny ze zdjęciami Awersu i Rewersu w wysokiej rozdzielczości HD.

3. Archiwum ZIP ze Zdjęciami HD: Paczka ZIP zawierająca plik danych oraz podkatalog ze wszystkimi fotografiami monet w oryginalnej rozdzielczości HD.

4. Lista Tekstowa / E-mail / SMS / WhatsApp: Generowanie czytelnego podsumowania tekstowego z wyceną do natychmiastowego wysłania za pomocą menu udostępniania.


================================================================================

SEKCJA 10: ANALITYKA, WARTOŚĆ PORTFELA I FINANSE (5 ZAKŁADEK)

================================================================================

Centrum [✨ Analityka i Statystyki] podzielone jest na 5 zakładek przesuwnych z przyciskami nawigacyjnymi [➔] i [⬅️]:


ZAKŁADKA 1: WARTOŚĆ SZACOWANA PORTFELA

- Łączny poniesiony koszt zakupu zbioru (PLN).

- Całkowita szacowana wartość rynkowa/katalogowa (PLN).

- Bilans zysku / straty (+PLN / -PLN).

- Procentowy wskaźnik zwrotu z inwestycji ROI (+% / -%).

- Przycisk "Udostępnij Raport Portfela".


ZAKŁADKA 2: WYKRESY & ROZKŁAD STRUKTURA

- Wykresy kołowe (Donut) podziału portfela wg Epok, Kruszcu i Statusu.

- Wykres słupkowy Koszt Zakupu vs Szacowana Wartość.

- Liniowy wykres trendu wartości w czasie.


ZAKŁADKA 11 (SPECJALNA): KREATOR WŁASNEGO WYKRESU (CUSTOM CHART CREATOR)

- W zakładce Wykresów dotknij 5. chipa "➕ Dodaj własny wykres...".

- Wybierz 1 z 6 wymiarów numizmatycznych: Nominał, Rok emisji, Stan zachowania, Rzadkość (R1-R8), Literatura/Katalog, Miejsce zakupu.

- Wybierz 1 z 3 typów wykresu: Wykres Kołowy (Donut), Wykres Słupkowy, Tabela Zestawieniowa.


ZAKŁADKA 3: ANALIZA FINANSOWA & PORTFEL

- Porównanie Side-by-Side: Zestawienie finansowe dla grup "Poszukiwane", "Na sprzedaż" oraz "Dublety".

- Zamrożony Kapitał: Kwota ulokowana w dubletach i monetach przeznaczonych do sprzedaży.

- Największe Okazje Cenowe (<50% Wartości): Przełącznik [% Oszczędność procentowa] vs [PLN Oszczędność kwotowa].

- Kruszce & Bulion (Kalkulator Ag/Au): Wyliczenie masy czystego srebra i złota w gramach [g] oraz uncjach trojańskich [oz] z wyceną giełdową.


ZAKŁADKA 4: PLANER ZAKUPÓW & BUDŻET (WISHLIST PLANNER)

- Wyliczanie budżetu potrzebnego na zakup monet ze statusem "Poszukiwana" oraz "Zamówiona".

- Zestawienie kosztów uzupełnienia braków w rozbiciu na Epoki historyczne.


ZAKŁADKA 5: SZABLONY & KREATOR REGUŁ (1-CLICK & RULE BUILDER)

- 5 Szablonów 1-Click: 💎 Perełki Kolekcji, 🔄 Zamrożone Dublety, 🇵🇱 Braki II RP, 🏷️ Największe Okazje, 🥇 Inwestycja w Kruszec.

- Kreator Reguł (Rule Builder) do tworzenia własnych Kolekcji Inteligentnych z logiką AND / OR oraz operatorami =, !=, >, <, CONTAINS, BETWEEN.


================================================================================

SEKCJA 12: KOLEKCJE INTELIGENTNE (SMART COLLECTIONS) I WARUNKI

================================================================================

Kolekcje Inteligentne to wirtualne foldery, które automatycznie filtrują i grupują monety ze wszystkich klaserów na podstawie zadanych reguł.


TWORZENIE WŁASNEJ KOLEKCJI INTELIGENTNEJ:

1. Przejdź do zakładki [Szablony & Kreator] w Analityce.

2. Kliknij przycisk "Utwórz Własną Kolekcję Inteligentną".

3. Wybierz nazwę, ikonę oraz dodaj warunki filtrowania:

  - Kombinacja logiki: ORAZ (AND) / LUB (OR).

  - Operatory: Równe (=), Różne (!=), Większe (>), Mniejsze (<), Zawiera (CONTAINS), Pomiędzy (BETWEEN).

  - Przykład: [Metal CONTAINS Srebro] AND [Stan zachowania = I].


================================================================================

SEKCJA 13: KOPIA ZAPASOWA (BACKUP JSON / ZIP) I PRZYWRACANIE BAZY DANYCH

================================================================================

Aby zabezpieczyć swoje dane na wypadek awarii lub zmiany telefonu, przejdź do [⚙️ Ustawienia Aplikacji] ➔ [Kopia zapasowa].


TWORZENIE KOPII ZAPASOWEJ:

- Kliknij "Utwórz kopię zapasową".

- Wybierz miejsce zapisu pliku .json lub .zip.

- Kopia zawiera kompletną strukturę bazy danych, skonfigurowane pola oraz zdjęcia.


PRZYWRACANIE BAZY DANYCH:

- Kliknij "Przywróć z kopii zapasowej" i wskaż plik .json.

- Baza zostanie bezpiecznie odtworzona na bieżącym lub nowym urządzeniu.


================================================================================

SEKCJA 14: POMOC, ZGŁASZANIE BŁĘDÓW, STRONA WWW.KLASERIO.PL I KONTAKT

================================================================================

SPOSOBY KONTAKTU I POMOCY:

- 📖 Instrukcja obsługi – niniejszy pełny podręcznik z interaktywną wyszukiwarką w aplikacji.

- ✉️ Zgłoś błąd / Sugestie – dedykowany formularz kontaktowy z automatyczną diagnostyką pod adresem: kontakt.klaserio@gmail.com

- 🌐 Oficjalny portal: www.klaserio.pl

- 👥 Zaproś znajomych – poleć aplikację Klaserio innym pasjonatom numizmatyki!


================================================================================

Klaserio v1.0.5 (Build 9) • Prawa zastrzeżone • www.klaserio.pl • kontakt.klaserio@gmail.com

================================================================================