jachty.pkmp.com.pl/CLAUDE.md

Projektowe zasady dla jachty3.pagedev.pl

Stack

• Język: PHP 7.4+
• CMS: WordPress 6.x
• Page Builder: Elementor Pro
• Frontend: FullCalendar.js v6 (CDN), jQuery
• Baza danych: MySQL — WordPress CPT + custom tabela wp_yacht_availability
• Integracja: Google Calendar API v3 (OAuth 2.0, natywna implementacja)
• Deployment: FTP via ftp-kr (VS Code extension)

Główny plugin

wp-content/plugins/yacht-booking-system/ — namespace YachtBooking\

Zasady kodu PHP

• WordPress Coding Standards (nie PSR-12)
• Nazewnictwo: PascalCase dla klas, snake_case dla metod i zmiennych
• Singleton pattern dla głównych klas
• Security: nonce verification + sanitize + escape na wyjściu
• Każda operacja DB przez $wpdb->prepare() — bez surowych zapytań SQL

Baza danych

• Custom tabela: wp_yacht_availability (yacht_id, date, status, booking_id)
• CPT: yacht (meta: capacity, price_per_day, gcal_id, features)
• CPT: yacht_booking (meta: yacht_id, start_date, end_date, status, customer_*, total_price, gcal_event_id)
• Schemat dokumentowany w .paul/codebase/db_schema.md
• Zmiany schematu przez klasę Installer (incremental upgrades)

REST API

Namespace: /wp-json/yacht-booking/v1/

• GET /yachts, GET /yachts/{id} — publiczne
• GET /availability/{yacht_id} — publiczne
• POST /bookings — publiczne (wymaga X-WP-Nonce)
• GET /bookings, PUT /bookings/{id}/status — admin only

Testy

• Brak automatycznych testów — testy manualne przez pliki test-*.php w root projektu
• Po każdej zmianie weryfikuj: php -l <plik> (syntax check)

Deployment

1. Edytuj pliki lokalnie w VS Code
2. Deploy przez FTP (ftp-kr) — automatyczny przy zapisie lub ręczny
3. Konfiguracja FTP: .vscode/ftp-kr.json

Frontend

• Elementor widget: frontend/class-calendar-widget.php
• Shortcode: [yacht_calendar yacht_id="X"]
• JavaScript: IIFE pattern (function($) {...})(jQuery)
• CSS: mobile-first, BEM-like nazewnictwo klas
• Nie używaj npm/webpack — zasoby statyczne lub CDN

Wdrażanie zmian Google Calendar

• OAuth tokens w wp_options (klucze: yacht_booking_*)
• Auto-refresh tokenów w class-oauth-handler.php
• Sync: class-sync-controller.php (hooks + cron)