mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-11-14 00:01:03 +00:00
Wiki: name Tours, the AI Assistant, Trip settings and the notifications inbox on Home, and describe the planner's top bar and its Tours and Journal tabs
This commit is contained in:
+6
-3
@@ -13,6 +13,7 @@ TREK is a self-hosted, real-time collaborative travel planner licensed under AGP
|
||||
- **Day Notes**: notes between a day's stops, each with a title, Markdown text, an icon and a colour
|
||||
- **Route Optimization**: auto-optimize place order, draw the day for driving, walking or cycling, leave single stops out of the route, and hand the day to Google Maps or CoMaps (see [Route Optimization](Route-Optimization))
|
||||
- **Weather Forecasts**: 16-day forecasts via Open-Meteo (no API key required), historical climate averages as fallback
|
||||
- **Trip Settings**: the **Trip settings** pill in the planner's top bar holds People, Sharing and a Journal section where you link a journal from Journey (see [Trip Members and Sharing](Trip-Members-and-Sharing))
|
||||
|
||||
### Travel Management
|
||||
- **Reservations & Bookings**: hotels, restaurants, tickets and every other booking with its confirmation code, travelers, costs and files, shown as cards, as a list or on a timeline; flights, trains and cars have their own Transports tab
|
||||
@@ -30,22 +31,24 @@ TREK is a self-hosted, real-time collaborative travel planner licensed under AGP
|
||||
- **Two-Factor Authentication**: TOTP-based 2FA with QR code setup
|
||||
- **Passkeys** _(admin-enabled)_: passwordless WebAuthn sign-in with Touch ID, Windows Hello, Android screen lock, or a hardware key; owning one also satisfies the require-2FA policy (see [Passkeys](Passkeys))
|
||||
- **Public Share Links**: share a read-only view of any trip, in full, as **Travel & stays only** or **Without photos** (see [Public Share Links](Public-Share-Links))
|
||||
- **Notifications**: in-app, email, webhook and ntfy, and Web Push to a phone or computer even while TREK is closed (see [Notifications](Notifications))
|
||||
- **Notifications**: an inbox with a tile per kind and a list cut into days, plus email, webhook and ntfy, and Web Push to a phone or computer even while TREK is closed (see [Notifications](Notifications))
|
||||
|
||||
### Addons _(admin-toggleable)_
|
||||
- **Lists**: packing lists and to-dos with templates, member assignments, optional bag tracking
|
||||
- **Costs**: expense tracker with category breakdown, splits, multi-currency
|
||||
- **Documents**: file manager for trips, places, and reservations
|
||||
- **Collab**: group chat, shared notes, polls, day-by-day attendance
|
||||
- **Tours**: hikes, city walks, bike, ski, paddle and horse tours with a route, drawn in TREK or imported from GPX, KML or KMZ, as single-day tours or with stages over several days; a **Tours** tab in the planner on the desktop (see [Tours](Tours))
|
||||
- **Road trip**: plan a trip as one continuous drive, with search along the route, driving limits, daily travel times and avoidance of toll roads, motorways and ferries (see [Road Trip](Road-Trip))
|
||||
- **Vacay**: personal vacation day planner with calendar view, public holidays, company holidays (also as half days), and carry-over tracking
|
||||
- **Atlas**: interactive world map with visited countries and regions, bucket list (countries or regions), travel stats, continent breakdown
|
||||
- **Collections**: a personal place library that saves places across trips into named lists, copies them into any trip, and shares them with per-member roles (see [Collections](Collections))
|
||||
- **Journey**: magazine-style travel journal with entries, drafts, photos (via Immich/Synology Photos) shown on the journey's map when geotagged, and moods
|
||||
- **Journey**: magazine-style travel journal with entries, drafts, photos (via Immich/Synology Photos) shown on the journey's map when geotagged, and moods; a journey can be linked to a trip and laid out as a printable photo book in TREK Studio (see [Journey Journal](Journey-Journal))
|
||||
- **Naver List Import**: import places from shared Naver Maps lists
|
||||
- **MCP**: expose TREK to AI assistants via the Model Context Protocol (OAuth 2.1)
|
||||
- **AirTrail**: sync flights from your self-hosted AirTrail instance into trips
|
||||
- **Dawarich**: read the stays and routes your self-hosted Dawarich instance recorded, offered as suggestions you confirm; nothing is written back (see [Dawarich](Dawarich))
|
||||
- **AI Assistant**: a chat inside the trip that reads the plan and proposes changes you confirm, using your own AI connection (off by default)
|
||||
- **AI Parsing**: LLM fallback that extracts bookings from confirmation files KDE Itinerary cannot read, and, with a model that reads images, from photos and scanned PDFs and receipts (see [AI-Booking-Import](AI-Booking-Import))
|
||||
|
||||
> Dashboard widgets (currency converter and timezone clock) are per-user preferences, not an admin-toggleable addon; see [Dashboard-Widgets](Dashboard-Widgets).
|
||||
@@ -58,7 +61,7 @@ TREK is a self-hosted, real-time collaborative travel planner licensed under AGP
|
||||
|
||||
### AI / MCP Integration
|
||||
- **MCP Server**: built-in Model Context Protocol server with OAuth 2.1 authentication
|
||||
- **300+ Tools**: create trips, plan itineraries, manage budgets, upload files, search places near a point, send messages, and more
|
||||
- **400+ Tools**: create trips, plan itineraries, manage budgets, upload files, search places near a point, send messages, and more
|
||||
- **30 Resources**: read-only `trek://` URIs for trips, days, places, budget, packing, journeys, and more
|
||||
- **35 OAuth Scopes**: granular permissions across 17 permission groups
|
||||
- **Pre-built Prompts**: `trip-summary`, `packing-list`, and `budget-overview` context loaders
|
||||
|
||||
@@ -16,7 +16,7 @@ On a desktop or a tablet (768 px and wider) the **Plan** tab has three parts:
|
||||
└─────────────────┴──────────────────────────┴──────────────────┘
|
||||
```
|
||||
|
||||
- **Days** on the left: the trip day by day. Every day is a card with its places, bookings, transports and notes. See [Day Plans and Notes](Day-Plans-and-Notes).
|
||||
- **Days** on the left: the trip day by day. Every day is a card with its places, bookings, transports, tours and notes. See [Day Plans and Notes](Day-Plans-and-Notes).
|
||||
- **Map** in the centre: the places of the trip, the route of the selected day and the booking routes you switched on. The lock on the map (*Lock the map view*) keeps the view where it is, so picking a day or a place no longer zooms or pans; click it again to let the map follow the selection. See [Map Features](Map-Features).
|
||||
- **Places** on the right: every place of the trip, with search, filters, import and a select mode. See [Places and Search](Places-and-Search).
|
||||
|
||||
@@ -31,21 +31,29 @@ Opening a day also narrows the places column. With a day open, **Planned** in th
|
||||
|
||||
With the [Road trip](Road-Trip) addon on, a **Days** / **Road trip** switch sits above the days column. See [Road trip view](#road-trip-view).
|
||||
|
||||
## The top bar
|
||||
|
||||
Inside a trip the top bar carries the way back as a pill: an arrow and the trip's name, which takes you back to the [dashboard](My-Trips-Dashboard). Beside it sits the **Trip settings** pill, which opens People, Sharing and, with the Journey addon on, Journal: who is on the trip, the read-only link and the invite link, and the journal the trip shows. On the right are the **?** help button (see [Help Center](Help-Center)), the assistant launcher when the AI Assistant addon is on, the notification bell and your user menu.
|
||||
|
||||
## Tabs
|
||||
|
||||
The tab bar sits directly below the main navigation bar.
|
||||
The tab bar sits in the middle of the top bar.
|
||||
|
||||
| Tab | What it holds |
|
||||
|---|---|
|
||||
| **Plan** | Days, map and places, as described on this page. Always shown. |
|
||||
| **Tours** | The trip's tour planner: draw a tour or import a GPX, KML or KMZ track. Second after **Plan**, on a computer or tablet, while the Tours addon is on. See [Tours](Tours). |
|
||||
| **Transports** | Flights, trains, buses, cars, taxis, bicycles, ferries, cruises, cable cars and public transit, as cards, a list or a timeline. See [Transport: Flights, Trains, Cars](Transport-Flights-Trains-Cars). |
|
||||
| **Bookings** | Stays, restaurants, events, tours, parking and other bookings, in the same three views. See [Reservations and Bookings](Reservations-and-Bookings). |
|
||||
| **Lists** | Packing list and to-dos. See [Packing Lists](Packing-Lists) and [Todos and Tasks](Todos-and-Tasks). |
|
||||
| **Costs** | Expenses, splits and settling up, as a list or a table. See [Costs](Budget-Tracking). |
|
||||
| **Files** | Tickets, receipts and other documents. See [Documents and Files](Documents-and-Files). |
|
||||
| **Collab** | Chat, shared notes, polls and What's Next. See [Real-Time Collaboration](Real-Time-Collaboration). |
|
||||
| **Journal** | The journal from Journey that is linked to the trip, for whoever the link lets in. Shown only while one is linked. See [Journey Journal](Journey-Journal). |
|
||||
|
||||
> **Admin:** The **Lists**, **Costs**, **Files** and **Collab** tabs only appear when the matching addon is enabled. See [Admin-Addons](Admin-Addons).
|
||||
On a phone the **Road trip** tab takes the place of the **Days** / **Road trip** switch, and the **Tours** tab is left out; tours are listed on the **Plan** tab there. An installed [plugin](Plugins) can add a tab of its own and, if its manifest says so, hide core tabs while it is active.
|
||||
|
||||
> **Admin:** The **Tours**, **Lists**, **Costs**, **Files** and **Collab** tabs only appear when the matching addon is enabled. See [Admin-Addons](Admin-Addons).
|
||||
|
||||
The active tab is saved in `sessionStorage` per trip, so switching between trips brings you back to where you were. The installed app (PWA) goes further: after the system closed it, it reopens on the trip and the tab it was on, and on a phone on the plan day as well.
|
||||
|
||||
@@ -111,4 +119,5 @@ When you open a trip, a short loading screen shows the trip title while the plan
|
||||
- [Accommodations](Accommodations)
|
||||
- [Reservations and Bookings](Reservations-and-Bookings)
|
||||
- [Road Trip](Road-Trip)
|
||||
- [Tours](Tours)
|
||||
- [Admin-Addons](Admin-Addons)
|
||||
|
||||
Reference in New Issue
Block a user