mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-06-19 21:31: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.
83 lines
4.1 KiB
Markdown
83 lines
4.1 KiB
Markdown
# Trip Planner Overview
|
|
|
|
The trip planner is the main workspace for building your itinerary. It opens automatically after you create a trip, or any time you click a trip card on the dashboard.
|
|
|
|
<!-- TODO: screenshot: trip planner tab bar overview -->
|
|
|
|
|
|
|
|
## Layout
|
|
|
|
The planner uses a **three-pane resizable layout** on desktop:
|
|
|
|
```
|
|
┌─────────────────┬──────────────────────────┬──────────────────┐
|
|
│ Day Plan │ │ Places │
|
|
│ Sidebar │ Interactive │ Sidebar │
|
|
│ (left) │ Map │ (right) │
|
|
│ │ (center) │ │
|
|
└─────────────────┴──────────────────────────┴──────────────────┘
|
|
```
|
|
|
|
- **Left sidebar** — Day plan: your list of days, assigned places, notes, and transport entries. Collapsible via the panel toggle button.
|
|
- **Center** — Interactive map showing all place markers and day routes.
|
|
- **Right sidebar** — Places list: search, category filters, and bulk actions. Collapsible.
|
|
|
|
Each sidebar has a drag handle on its inner edge for resizing.
|
|
|
|
A **Day Detail overlay** slides in over the center pane when you open a specific day, showing weather, the day's notes, reservation summaries, and the accommodation block. It can be minimized without closing it.
|
|
|
|
## Tabs
|
|
|
|
The tab bar sits directly below the main navigation bar.
|
|
|
|
| Tab | Description |
|
|
|---|---|
|
|
| **Plan** | The three-pane map view described above. Always visible. |
|
|
| **Transports** | Flights, trains, cars, cruises, and buses. |
|
|
| **Reservations** | Hotels, restaurants, events, tours, and other bookings. |
|
|
| **Lists** | Packing list and to-do list. |
|
|
| **Budget** | Budget tracking and expense logging. |
|
|
| **Files** | Document manager for receipts, tickets, and other files. |
|
|
| **Collab** | Real-time chat, shared notes, and polls. |
|
|
|
|
> **Admin:** The **Lists**, **Budget**, **Files**, and **Collab** tabs only appear when the corresponding addon is enabled. See [Admin-Addons](Admin-Addons).
|
|
|
|
The active tab is saved in `sessionStorage` per trip, so switching between trips preserves your last position.
|
|
|
|
## Mobile Layout
|
|
|
|
On screens narrower than 768 px, the two sidebars are not shown side-by-side. Instead, two floating buttons appear over the map:
|
|
|
|
- **Plan** — opens the Day Plan Sidebar as a full-screen overlay.
|
|
- **Places** — opens the Places Sidebar as a full-screen overlay.
|
|
|
|
Tap outside the overlay or use the close button to return to the map.
|
|
|
|
## Undo
|
|
|
|
The planner tracks your recent actions — adding places, assigning them to days, reordering, and removing assignments — in a short undo ring. The **Undo** button appears in the Day Plan Sidebar toolbar (at the top of the sidebar) whenever an undoable action is available. It shows the name of the last action as a tooltip on hover and reverses it when clicked.
|
|
|
|
## Splash Screen
|
|
|
|
When you first open a trip, a brief loading screen appears while the planner data and place photos are fetched. This screen shows the trip title and a loading animation. Once data is ready and a short grace period for photos has elapsed, the planner workspace appears.
|
|
|
|
## Getting Around
|
|
|
|
| Task | Where to go |
|
|
|---|---|
|
|
| Add and search places | [Places-and-Search](Places-and-Search) |
|
|
| Organize days and notes | [Day-Plans-and-Notes](Day-Plans-and-Notes) |
|
|
| Map features and routes | [Map-Features](Map-Features) |
|
|
| Weather forecasts | [Weather-Forecasts](Weather-Forecasts) |
|
|
| Reservations and bookings | [Reservations-and-Bookings](Reservations-and-Bookings) |
|
|
|
|
## Related Pages
|
|
|
|
- [Places-and-Search](Places-and-Search)
|
|
- [Day-Plans-and-Notes](Day-Plans-and-Notes)
|
|
- [Map-Features](Map-Features)
|
|
- [Weather-Forecasts](Weather-Forecasts)
|
|
- [Reservations-and-Bookings](Reservations-and-Bookings)
|
|
- [Admin-Addons](Admin-Addons)
|