mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-06-19 13:21:46 +00:00
jubnl
c1b9d11173
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.
90 lines
4.7 KiB
Markdown
90 lines
4.7 KiB
Markdown
# 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](Transport-Flights-Trains-Cars) |
|
|
| Train | [Transport modal](Transport-Flights-Trains-Cars) |
|
|
| Car | [Transport modal](Transport-Flights-Trains-Cars) |
|
|
| Cruise | [Transport modal](Transport-Flights-Trains-Cars) |
|
|
| Hotel | Add button in Reservations panel — see [Accommodations](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](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:
|
|
|
|
1. **Type** — choose Hotel, Restaurant, Event, Tour, or Other
|
|
2. **Title** — required
|
|
3. **Link to day-plan assignment** — optional; search across all days and places, grouped by day. Not available for Hotel type
|
|
4. **Start date and time** — not shown for Hotel type
|
|
5. **End date and time** — not shown for Hotel type
|
|
6. **Location / address** — not shown for Hotel type
|
|
7. **Confirmation code**
|
|
8. **Status** — Pending or Confirmed
|
|
9. **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](Accommodations)
|
|
10. **Notes**
|
|
11. **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
|
|
12. **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](Budget-Tracking)
|
|
|
|
<!-- TODO: screenshot: Create Reservation modal -->
|
|
|
|
## 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.
|
|
|
|
---
|
|
|
|
**See also:** [Transport-Flights-Trains-Cars](Transport-Flights-Trains-Cars) · [Accommodations](Accommodations) · [Budget-Tracking](Budget-Tracking) · [Documents-and-Files](Documents-and-Files) · [Trip-Planner-Overview](Trip-Planner-Overview)
|