k1nq/TREK

mirror of https://github.com/mauriceboe/TREK.git synced 2026-06-19 13:21:46 +00:00

Files

T

jubnl c1b9d11173 docs: add full wiki with 74 pages, assets, and CI workflow

Adds the complete TREK documentation wiki covering installation,
trip planning, admin panel, MCP/AI integration, addons, and operations.

Also fixes encrypt-at-rest gaps: mapbox_access_token, Synology
credentials, per-user webhook/ntfy tokens, and photo passphrases
are now rotated by migrate-encryption.ts and stored encrypted via
settingsService.

2026-04-20 10:11:53 +02:00

4.7 KiB

Raw Blame History

Reservations & Bookings

Track all your trip bookings — hotels, restaurants, events, tours, and more — in one place.

Where to find it

Open your trip in the planner and select the Reservations tab. The panel lists all bookings grouped by status, with a type filter bar at the top.

Reservation types

TREK supports nine reservation types:

Type	How to create
Flight	Transport modal
Train	Transport modal
Car	Transport modal
Cruise	Transport modal
Hotel	Add button in Reservations panel — see Accommodations
Restaurant	Add button in Reservations panel
Event	Add button in Reservations panel
Tour	Add button in Reservations panel
Other	Add button in Reservations panel

Transport types (Flight, Train, Car, Cruise) are created through the dedicated Transport modal, where you can enter endpoint and transit-specific fields. All other types are created directly from the Reservations panel.

Pending and Confirmed

Reservations are grouped into two collapsible sections: Pending and Confirmed. You can collapse or expand each section independently — the open/closed state is saved per trip so it persists across page reloads. Status is set when you create or edit a reservation.

On desktop, a type filter bar lets you show only specific types. Filter selections are kept for the current browser session.

Reservation card contents

Each card displays:

Status dot — green for Confirmed, amber for Pending
Type chip — icon and label for the reservation type
Needs review badge — an amber badge shown on reservations flagged by importers that may need your attention
Title — the reservation name
Edit and delete buttons — visible only if you have edit permission

Admin: Edit and delete buttons are gated by the reservation_edit permission. Members without this permission see read-only cards.

Date and time range — start date, and end date/time if set
From → To — origin and destination endpoints, shown for transport types
Confirmation code — displayed in monospace. If you have Blur booking codes enabled in Display Settings, the code is blurred by default and revealed on hover or tap
Type-specific metadata:
- Flights: airline name, flight number
- Trains: train number, platform, seat
- Hotels: check-in window, check-out time (see Accommodations)
Location / address — for non-hotel, non-transport types
Linked accommodation — hotel name, if this reservation is linked to an accommodation record
Day-plan assignment — the day and place this reservation is linked to
Notes
Attached files — shown as clickable download links

Creating a reservation

Click Add (or the + button) in the Reservations panel. Fill in the form:

Type — choose Hotel, Restaurant, Event, Tour, or Other
Title — required
Link to day-plan assignment — optional; search across all days and places, grouped by day. Not available for Hotel type
Start date and time — not shown for Hotel type
End date and time — not shown for Hotel type
Location / address — not shown for Hotel type
Confirmation code
Status — Pending or Confirmed
Hotel-specific fields — shown only for Hotel type, immediately after status: hotel place, check-in day, check-out day, check-in time (window start and end), and check-out time. See Accommodations
Notes
Files — attach from your device (PDF, Word documents, text files, images) or link an existing trip file. Files added before saving are uploaded automatically after the reservation is created
Price and budget category — shown only when the Budget addon is enabled. Entering a price greater than zero automatically creates a linked budget entry. See Budget-Tracking

Editing and deleting

Each card has a pencil icon to open the edit form and a trash icon to delete. Deleting requires confirmation in a dialog before the record is removed.

Real-time sync

Reservation changes (create, update, delete) are broadcast instantly to all connected trip members via WebSocket, so everyone sees the latest state without refreshing.

4.7 KiB Raw Blame History