Mapa scenariuszy i narzędzi

Tabela do szybkiego dopasowania: cel klubu → scenariusz → narzędzia do odczytu i zapisu → ścieżka w panelu, gdy API nie wystarcza.

Scenariusz	Cel klubu	Odczyt	Zapis	Tylko w panelu
UC-001	Nazwa, logo, kolory, social	`get_social_links`	`set_club_logo`, `update_social_links`, `save_club_profile`	Ustawienia > Ogólne (nazwa, dyscyplina), Ustawienia > Wygląd (kolory)
UC-002	Opublikuj stronę	`get_website_status`, `get_plan_info`	`set_website_published`, `set_default_landing`	Ustawienia > Udostępnianie (subdomena, własna domena, przełącznik Strona WWW)
UC-003	Nagłówek, slider, stopka	`get_site_design_settings`	`update_site_design_settings`	Wygląd: czcionki, edytor stylów PRO
UC-004	Sekcje strony głównej	`list_page_blocks`	`create_page_block`, `update_page_block`, `move_page_block`, `reorder_page_blocks`, `delete_page_block`, `create_club_banner`	Karuzela kart, licznik biletów, sklep, social media, sekcja z kolumnami
UC-005	Menu strony	`list_menu_items`	`create_menu_item`, `update_menu_item`, `reorder_menu_items`, `delete_menu_item`	-
UC-006	Podstrony	`list_infopages`, `get_infopage`	`create_infopage`, `update_infopage`, `create_sponsors_page`, `create_database_page`	Usuwanie podstrony
UC-007	Aktualności	`list_posts`, `get_post`, `list_tags`, `get_game_context`	`create_post`, `update_post`, `delete_post`, `reorder_pinned_posts`	Upload okładki z dysku (albo `/api/v1/uploads`)
UC-008	Mecze i wyniki	`list_clubs`, `list_games`, `get_game`, `get_standings`, `get_game_context`	`create_club`, `update_club`, `create_game`, `update_game`, `delete_game`, `save_game_link`, `configure_games_sync`	Nazwa ligi i sezonu, skład meczowy, wydarzenia meczowe
UC-009	Kadra	`get_positions`, `list_players`, `get_player`	`create_player`, `update_player`, `create_player_team`, `set_player_teams`, `bulk_set_player_teams`, `delete_player`	Kolejność drużyn
UC-010	Sponsorzy	`list_sponsor_categories`, `list_sponsors`, `get_header_partner_logos`	`create_sponsor_category`, `create_sponsor`, `update_sponsor`, `reorder_sponsors`, `reorder_sponsor_categories`, `update_header_partner_logos`	-
UC-012	Zamówienia ze sklepu	`list_store_orders`, `get_store_order`, `get_store_settings`	`update_store_order_status` (wysyła zawsze wbudowany mail o statusie)	Przegląd sklepu, Napisz wiadomość, podgląd wysłanych maili, numer przesyłki, zwrot, anulowanie
UC-013	Maile do kupujących	-	-	Ustawienia sklepu > Maile: adres kontaktowy, automatyzacje, własne szablony
UC-014	Wiadomość do wielu kupujących	`list_store_orders`	-	Zamówienia > Nowa wiadomość
UC-015	VAT w sklepie	-	-	Ustawienia sklepu > Zamówienia > Stawka VAT; stawka produktu w formularzu produktu

Wspólne dla wszystkich

POST /api/v1/uploads - jedyna droga dla pliku z dysku; zwraca url.
report_support_issue - gdy klub prosi o coś poza zasięgiem narzędzi (własna domena, zwrot płatności, zmiana planu).
get_platform_guide - skrócony przewodnik po panelu wbudowany w agenta; ta baza jest jego rozwinięciem.

Kolejność budowy nowego klubu

Sprawdzona 2026-09-24 na klubie demo, od zera do opublikowanej strony w jednym przebiegu:

update_club (własna drużyna: nazwa, herb) → create_club ×N (rywale)
create_game ×N → update_game (wyniki rozegranych)
create_player ×N (zawodnicy, potem sztab)
create_sponsor_category → create_sponsor ×N
create_post ×N (dwa przypięte)
create_infopage ×3 (O klubie, Kontakt, Zostań sponsorem)
create_page_block: games_last_next v6, news v6, media_text, players, sponsors, newsletter
create_menu_item (top ×6, buttons ×1, footer ×3), update_social_links
update_site_design_settings → set_website_published → set_default_landing {website}
Sprawdzenie w panelu: Ustawienia > Udostępnianie, przełącznik Strona WWW.

Połączenie asystenta (UC-011)

Podłącz asystenta AI. Powyższy katalog dotyczy /api/v1/mcp. Osobny /api/mcp dla ChatGPT udostępnia tylko list_posts, list_games, list_sponsors, bez zapisu. Odczytaj jego tools/list, aby poznać właściwe argumenty.