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,71 @@
+# Creating a Trip
+
+<!-- TODO: screenshot: trip creation form with date and cover fields -->
+
+![Trip creation dialog](assets/TripCreate.png)
+
+## Opening the Dialog
+
+Click the **New Trip** button in the dashboard toolbar (or the **Create First Trip** button on the empty state) to open the Create Trip dialog.
+
+You can also open it directly via a deep link: navigate to `/dashboard?create=1`. This is the URL used by system notices that prompt you to create a trip.
+
+## Fields
+
+### Title (required)
+
+The trip name. Cannot be empty — saving is blocked until a title is entered.
+
+### Description (optional)
+
+A short free-text description shown on the trip card.
+
+### Dates
+
+Set a **Start date** and **End date** using the date picker. The day count is calculated automatically when both are set.
+
+If you leave **both** dates empty, a separate **Day count** field appears. Enter a number between **1 and 365** to create a date-less itinerary with a fixed number of days.
+
+You cannot set only one date and leave the other blank via normal interaction — setting a start date auto-fills or adjusts the end date to preserve the previous duration.
+
+### Cover Image
+
+The cover image is displayed on the trip card and as the background of the Spotlight card. You can add one in three ways:
+
+- **Drag and drop** an image file onto the dashed upload area.
+- **Paste from clipboard** — if you have an image in your clipboard, paste it anywhere in the dialog.
+- **File picker** — click the upload area to browse for a file.
+
+When **creating** a new trip the cover image field is always visible. When **editing** an existing trip it is only shown if you have the `trip_cover_upload` permission. For a new trip, the image is uploaded immediately after the trip is created.
+
+### Reminder
+
+A push notification sent before the trip departs. The field shows a set of preset options:
+
+| Option | Days before departure |
+|---|---|
+| None | 0 |
+| 1 day | 1 |
+| 3 days | 3 |
+| 9 days | 9 |
+| Custom | 1–30 (you enter the number) |
+
+When **creating** a new trip the reminder field is always visible. When **editing** an existing trip it is only shown to the **trip owner** or **admin** users.
+
+If reminders are disabled on your instance (`trip_reminders_enabled = false`), the reminder section is shown at reduced opacity with an informational message in place of the preset buttons.
+
+> **Admin:** Trip reminders are controlled by a server-side feature flag (`trip_reminders_enabled`). Contact your administrator to enable them.
+
+### Members
+
+Add initial trip members from the members selector. On a **new** trip, selected members are queued locally and added to the trip immediately after it is saved. The selector shows all registered users on your instance except yourself.
+
+## Saving
+
+Click **Create Trip**. The trip is saved and you are taken to the [Trip-Planner-Overview](Trip-Planner-Overview) for the new trip.
+
+## Related Pages
+
+- [Trip-Members-and-Sharing](Trip-Members-and-Sharing)
+- [Trip-Planner-Overview](Trip-Planner-Overview)
+- [My-Trips-Dashboard](My-Trips-Dashboard)