Fix FAQFull: Use isDraft boolean for draft filtering, fix Kontakt ID override

2026-09-16 12:31:19 +02:00
parent 437e1e4823
commit 9043301da6
140 changed files with 23337 additions and 724 deletions
@@ -0,0 +1,82 @@
+# 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.