# Pokefans.app — Pełna dokumentacja

> Pokefans.app to najlepsza polska platforma dla kolekcjonerów kart Pokémon TCG. Darmowa, w pełni po polsku, z aplikacją PWA (działa offline). Oferuje skaner AI, kompletny katalog z cenami, marketplace, aukcje, śledzenie trendów cenowych, zarządzanie kolekcją i bazę wiedzy.

## O platformie

Pokefans.app powstała, aby ułatwić polskim kolekcjonerom kart Pokémon TCG codzienne zarządzanie kolekcją, śledzenie cen rynkowych oraz handel kartami w bezpiecznym środowisku. Platforma jest w pełni darmowa i dostępna jako Progressive Web App — działa na telefonie, tablecie i komputerze, również offline.

### Technologia
- Skaner kart oparty o AI vision (Google Gemini) — rozpoznaje kartę ze zdjęcia
- Ceny rynkowe z Cardmarket.com i TCGPlayer via TCGdex API
- Dane o meta deckach turniejowych z LimitlessTCG API
- Informacje o Pokémonach z Bulbapedia i PokeAPI
- Aplikacja PWA z obsługą offline i push notyfikacjami
- Dostępna w języku polskim i angielskim

---

## Funkcje szczegółowo

### Skaner AI kart (`/skaner`)
Skaner wykorzystuje sztuczną inteligencję (Google Gemini Flash) do rozpoznawania kart Pokémon TCG ze zdjęcia aparatu. Po zrobieniu zdjęcia AI identyfikuje nazwę Pokémona, numer karty, set i rzadkość. System automatycznie wyszukuje kartę w bazie danych i wyświetla:
- Cenę rynkową (Cardmarket avg, trend, min)
- Wykres historii cen (1d, 7d, 30d)
- Informacje o karcie (HP, typ, rzadkość, set)
- Czy karta jest używana w meta deckach turniejowych
- Szybkie akcje: dodaj do kolekcji, listy życzeń lub wystaw na aukcję

### Katalog kart (`/karty`)
Kompletny katalog ponad 15 000 kart Pokémon TCG z filtrami:
- Po secie (np. Scarlet & Violet, Base Set)
- Po typie (Fire, Water, Grass, Lightning, Psychic, Fighting, etc.)
- Po rzadkości (Common, Uncommon, Rare, Ultra Rare, etc.)
- Po nazwie Pokémona
Każda karta pokazuje cenę rynkową, obraz w wysokiej rozdzielczości, statystyki i przynależność do meta decków.

### Sety (`/sety`)
Przeglądaj wszystkie sety Pokémon TCG:
- Logo i symbol setu
- Liczba kart w secie
- Data premiery
- Seria (np. Scarlet & Violet, Sword & Shield)
- Podgląd kart w secie

### Kalendarz setów (`/kalendarz`)
Timeline nadchodzących i przeszłych premier setów Pokémon TCG z datami, opisami i linkami do szczegółów.

### Marketplace i Aukcje (`/marketplace`)
System aukcji kart Pokémon TCG:
- Aukcje z odliczaniem czasu
- System licytacji z automatycznym przedłużaniem
- Kup teraz (Buy Now) opcja
- Panel transakcji (potwierdzenie płatności, wysyłki, odbioru)
- System ocen kupujących i sprzedających
- E-mail powiadomienia o przebiciach i zakończeniu aukcji

### Trendy cenowe (`/trendy`)
Interaktywne wykresy cen kart Pokémon TCG:
- Średnia cena sprzedaży
- Trend cenowy
- Najniższa cena
- Porównanie 1d / 7d / 30d
- Źródło danych: Cardmarket.com via TCGdex

### Kolekcja (`/kolekcja`)
Zarządzanie kolekcją kart:
- Dodawanie kart z katalogu lub skanera
- Stan karty (Mint, Near Mint, Excellent, Good, Played, Poor)
- Szacowana wartość na podstawie cen rynkowych
- Lista życzeń (Wishlist)
- Eksport i przegląd portfolio

### Portfel (`/portfel`)
Wartość kolekcji w czasie:
- Wykres wartości portfela
- Podział wg rzadkości, setów i typów
- Snapshoty dzienne wartości

### Smart Trade (`/smart-trade`)
System dopasowywania wymian między kolekcjonerami — algorytm znajduje użytkowników, którzy mają karty z Twojej wishlisty i szukają kart z Twojej kolekcji.

### Porównywarka kart (`/porownaj`)
Porównuj karty Pokémon obok siebie — ceny, statystyki, rzadkość, przynależność do meta.

### Społeczność (`/spolecznosc`)
- Publiczne profile kolekcjonerów
- System followowania
- Statystyki społeczności (top kolekcjonerzy)

### Osiągnięcia (`/osiagniecia`)
System gamifikacji z odznaczeniami i XP:
- Kategorie: kolekcja, handel, społeczność
- Tiery: brąz, srebro, złoto, diament
- Nagrody za kamienie milowe (np. 100 kart, pierwsza aukcja)

---

## Baza Wiedzy

### Akademia (`/wiedza/akademia`)
Kompletny kurs gry w Pokémon TCG:
- Jak zacząć grać — zasady podstawowe
- Jak działa energia w Pokémon TCG
- Ewolucja Pokémonów w grze karcianej
- Mechanika walki — ataki, obrażenia, efekty
- Budowanie pierwszego decku

### Pokédex (`/wiedza/pokedex`)
Lista wszystkich Pokémonów z:
- Typami i statystykami
- Łańcuchem ewolucji
- Opisem lore z Bulbapedii
- Generacją i regionem

### Regiony (`/wiedza/regiony`)
Przewodnik po regionach Pokémon:
- Kanto, Johto, Hoenn, Sinnoh, Unova, Kalos, Alola, Galar, Paldea
- Kluczowe lokacje i legendarne Pokémony

### Historia (`/wiedza/historia`)
Historia franczyzy Pokémon od 1996 roku — gry, anime, manga, TCG.

### Słowniczek (`/wiedza/slowniczek`)
100+ terminów TCG wyjaśnionych: GX, V, VMAX, VSTAR, ex, Trainer, Supporter, Stadium, Energy, Prize cards, Bench, Active Pokémon, itd.

### Formaty (`/wiedza/formaty`)
Zasady formatów turniejowych:
- Standard (najnowsze sety)
- Expanded (rozszerzony)
- Unlimited
- GLC (Gym Leader Challenge)

### Strategie (`/wiedza/strategie`)
Przewodniki po strategiach turniejowych, meta deckach, budowaniu decków.

---

## Blog

Blog Pokefans.app publikuje artykuły o:
- Jak zacząć kolekcjonowanie kart Pokémon
- Najdroższe karty Pokémon 2026
- Recenzje nowych setów (np. Scarlet & Violet: Prismatic Evolutions)
- Jak rozpoznać fałszywe karty
- Historia Pokémonów i TCG
- Inwestowanie w karty Pokémon
- Gradowanie kart (PSA, BGS, CGC)
- Budowanie decków turniejowych

---

## Dane techniczne

- **Baza kart**: 15 000+ kart z Pokemon TCG API
- **Ceny**: Cardmarket.com, TCGPlayer via TCGdex API (aktualizowane co 24h)
- **Meta decki**: LimitlessTCG API (turnieje Pokémon TCG)
- **Lore**: Bulbapedia API + PokeAPI
- **Skaner AI**: Google Gemini 2.5 Flash (vision)
- **Języki**: Polski (główny), Angielski
- **PWA**: Instalowalna, działa offline, push notyfikacje
- **Darmowa**: Wszystkie funkcje dostępne bezpłatnie

## Kontakt

- Website: https://pokefans.app
- Email: hi@pokefans.app
- Support: https://pokefans.app/kontakt
- FAQ: https://pokefans.app/faq