diff --git a/wiki/Home.md b/wiki/Home.md index 6f4b798eb..189adf639 100644 --- a/wiki/Home.md +++ b/wiki/Home.md @@ -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 diff --git a/wiki/Trip-Planner-Overview.md b/wiki/Trip-Planner-Overview.md index 5e10769b6..6528ac96f 100644 --- a/wiki/Trip-Planner-Overview.md +++ b/wiki/Trip-Planner-Overview.md @@ -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)