# FAQ — `/pl/faq` i `/de/faq` (page id 5)

**Stan obecny: pusta.** Layout to `TextSection` z treścią `"Treść w
przygotowaniu"` — mimo że strona główna ma już `faqTeaser` z 8 gotowymi
pytaniami. To najszybszy do naprawienia brak w całym serwisie: treść już
istnieje, trzeba ją tylko przenieść na dedykowaną stronę i rozbudować.

---

## 1. Zmiana blokowa (wymagana, nie tylko treściowa)

`TextSection` (pojedynczy blok tekstowy) nie nadaje się do renderowania
listy pytań-odpowiedzi z akordeonem i danymi strukturalnymi. Potrzebny jest
blok dedykowany — patrz [10-architektura-cms.md](./10-architektura-cms.md)
§2 po specyfikację pola. W skrócie: reużyć strukturę `faqTeaser` (ma już
pole `questions[{question, answer}]`), ale jako pełną, niekróconą wersję
z opcjonalnym grupowaniem w kategorie.

---

## 2. Treść — reorganizacja istniejących 8 pytań w kategorie

Obecne pytania z `faqTeaser` na home są dobre i się nie duplikują treściowo —
przenieść 1:1, tylko pogrupować pod nagłówkami kategorii dla skanowalności
(strona `Read`, nie `Persuade` — priorytet to łatwość znalezienia odpowiedzi):

**Kategoria „Proces i dokumenty"**
- Czy muszę przyjeżdżać osobiście do biura?
- Jakie dokumenty są potrzebne do rozliczenia?
- Do kiedy muszę złożyć deklarację podatkową w Niemczech?

**Kategoria „Zwrot podatku i koszty"**
- Jak długo czeka się na zwrot podatku z urzędu skarbowego?
- Ile kosztuje rozliczenie podatku z Niemiec?

**Kategoria „Świadczenia dodatkowe"**
- Czy załatwiacie również zasiłek Kindergeld? *(w danych występuje 2×, prawie
  identyczne pytanie — połączyć w jedno przy migracji na tę stronę, nie
  duplikować)*

**[NOWE — sugerowane pytania do uzupełnienia, wymagają weryfikacji merytorycznej
klienta przed publikacją]** — typowe pytania w tej branży, których brakuje:
- „Czy mogę się rozliczyć, jeśli pracowałem w Niemczech tylko kilka miesięcy?"
- „Co się stanie, jeśli spóźnię się ze złożeniem deklaracji?"
- „Czy mogę rozliczyć się wspólnie z małżonkiem, jeśli on/ona nie pracuje w Niemczech?"
- „Czy pomagacie też w rozliczeniu za lata wcześniejsze (wsteczne)?"

Zaznaczam je jako propozycję TEMATÓW, nie gotowe odpowiedzi — treść
merytoryczna (terminy, kwoty, warunki) musi pochodzić od klienta/doradcy
podatkowego, nie być domyślana. Widoczny placeholder do wypełnienia w panelu.

---

## 3. Layout

- Nagłówek strony (spójny page-header jak w innych podstronach) + krótki
  wstęp („Nie znalazłeś odpowiedzi? Napisz na WhatsApp" z linkiem — most do
  konwersji nawet na stronie czysto informacyjnej).
- Kategorie jako sekcje z nagłówkiem H2, pod nimi akordeon pytań (H3 per
  pytanie, poprawna hierarchia nagłówków — `wymagania-projektowe-strony.md`
  §4 wymaga braku przeskoków poziomów).
- Jedno pytanie otwarte naraz w obrębie kategorii (spójnie z `faqTeaser` na
  home, patrz [02-strona-glowna.md](./02-strona-glowna.md) §9).
- Opcjonalnie: pole wyszukiwania/filtrowania pytań na górze, jeśli lista
  urośnie powyżej ~15 pozycji — na start (12 pytań) niepotrzebne, dodać
  dopiero gdy lista faktycznie się rozrośnie (nie budować „na zapas" —
  `fundamenty-projektu.md` §6).

## 4. Tło i animacja

Strona typu **Read** (patrz [01](./01-design-system-impeccable.md) §3) —
`sticky-progress` (cienka linia postępu czytania na górze) jako jedyny efekt
motion poza standardowym `reveal-up` na wejściu każdej kategorii. Tekstura
papieru z hero TU pomijamy — długi tekst do czytania potrzebuje maksymalnego
spokoju tła, nie dekoracji.

## 5. SEO

Ta strona to naturalny kandydat na `FAQPage` structured data (schema.org) —
pytania i odpowiedzi 1:1 z treścią widoczną na stronie (wymóg Google, nie
ukryty tekst). Szczegóły implementacji w
[11-integracje-seo-wydajnosc.md](./11-integracje-seo-wydajnosc.md) §2.