64 lines
2.9 KiB
Markdown
64 lines
2.9 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Project Overview
|
|
|
|
WordPress site for **Carei** (car rental) at `carei.pagedev.pl`. The core custom code is the **carei-reservation** plugin — a multi-step car reservation form integrated with the Softra Rent API, rendered as an Elementor widget.
|
|
|
|
## Architecture
|
|
|
|
### Custom Plugin: `wp-content/plugins/carei-reservation/`
|
|
|
|
```
|
|
carei-reservation.php — Plugin bootstrap, .env parsing, singleton init, asset registration
|
|
includes/
|
|
class-softra-api.php — Softra Rent API client (cURL, JWT token caching via WP transient)
|
|
class-rest-proxy.php — WP REST API proxy (namespace: carei/v1) exposing Softra endpoints to frontend
|
|
class-admin-panel.php — CPT carei_reservation for storing booking history, admin columns, status management
|
|
class-elementor-widget.php — Elementor widget rendering the reservation modal + multi-step form
|
|
assets/
|
|
js/carei-reservation.js — Vanilla JS: modal, form steps, API calls, validation, booking flow
|
|
css/carei-reservation.css — All form/modal styling
|
|
```
|
|
|
|
### Data Flow
|
|
|
|
1. Frontend JS calls WP REST endpoints (`/wp-json/carei/v1/...`)
|
|
2. `Carei_REST_Proxy` forwards requests to Softra Rent API via `Carei_Softra_API`
|
|
3. `Carei_Softra_API` handles JWT auth with automatic token caching (transient, 50min TTL)
|
|
4. On successful booking: reservation data saved as CPT `carei_reservation` with post meta
|
|
|
|
### Key API Endpoints (Softra Rent)
|
|
|
|
- `/account/auth` — JWT token
|
|
- `/branch/list` — Rental locations
|
|
- `/car/class/list` — Vehicle classes by date/branch
|
|
- `/pricelist/list` — Pricing with extras
|
|
- `/customer/add`, `/rent/makebooking`, `/rent/confirm` — Booking flow
|
|
|
|
### WP REST Routes (carei/v1)
|
|
|
|
`/branches`, `/car-classes`, `/car-classes-all`, `/segments-branches-map`, `/pricelist`, `/extras`, `/submit-booking`, `/agreement-defs`
|
|
|
|
## Configuration
|
|
|
|
- API credentials in `.env` at WordPress root (format: `key: value` — url, username, password)
|
|
- Deployment via SFTP to `host117523.hostido.net.pl:/public_html` (config in `.vscode/sftp.json`)
|
|
- Theme: Hello Elementor
|
|
|
|
## Development
|
|
|
|
- **No build tools** — pure PHP + vanilla JS + CSS, no npm/composer
|
|
- Test API connectivity: `php softra-test.php` (reads `.env`, authenticates, fetches branches and models)
|
|
- API documentation in `docs/rent-api-*.md` (transcribed from Softra PDF spec v1.15)
|
|
- Planning state tracked in `.paul/` (ROADMAP.md, PROJECT.md, phases/)
|
|
|
|
## Conventions
|
|
|
|
- Polish language throughout UI, comments, and admin labels
|
|
- Design tokens: primary `#2F2482`, accent `#FF0000`, font Albert Sans
|
|
- Admin reservation statuses: `nowe` → `przeczytane` → `zrealizowane`
|
|
- No JS frameworks — all frontend logic in single vanilla JS file
|
|
- No additional dependencies — keep the stack minimal (WordPress + Elementor only)
|