Files
j_kedzierski/prompts/06-faq.md
T

83 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.