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-06-19 13:21:46 +00:00 · 2026-04-20 10:11:53 +02:00
parent 2ab8b401fb
commit c1b9d11173
118 changed files with 5545 additions and 7 deletions
@@ -0,0 +1,82 @@
+# 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 -->
+
+![Trip Planner](assets/TripPlannerWithPlane.png)
+
+## 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)