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,75 @@
+# Trip Members and Sharing
+
+<!-- TODO: screenshot: trip members list with roles and share link form -->
+
+![Trip Members](assets/Share.png)
+
+## Opening the Members Panel
+
+- From the **dashboard**: click the share/members icon on a trip card.
+- From the **trip planner**: click the Share button in the top navigation bar.
+
+When you have the `share_manage` permission the modal opens to a two-column layout on wider screens (members on the left, share link on the right). Without that permission only the members column is shown. On narrow screens the columns always stack.
+
+## Members List
+
+The left column lists everyone who has access to the trip.
+
+- The **trip owner** is marked with a crown badge.
+- Your own entry is labeled **(you)**.
+- Each non-owner member shows a remove button.
+
+### Inviting Members
+
+If you have the `member_manage` permission (default: trip owner), an invite control appears above the list. Select a user from the searchable dropdown and click **Invite**. The user is looked up by username or email on the server, added immediately, and the list refreshes. The invited user also receives an in-app notification.
+
+### Removing a Member
+
+Click the remove icon next to any member's name. A confirmation prompt appears before the member is removed.
+
+If you click the remove icon next to **your own** name, the action is labeled **Leave trip** and uses a "log out" icon. Leaving reloads the page and returns you to the dashboard.
+
+The trip owner cannot be removed through this panel.
+
+## Public Share Link
+
+The right column is only visible to users with the `share_manage` permission (default: trip owner).
+
+A share link creates a **read-only, token-based URL**:
+
+```
+<your-instance>/shared/<token>
+```
+
+Viewers do not need to log in. The link can be shared with anyone.
+
+### Creating a Link
+
+Click **Create share link**. A URL is generated and shown with a copy button.
+
+### Permission Toggles
+
+Before or after creating the link, you can control what the link exposes. Toggle each section on or off with the pill buttons:
+
+| Toggle | Default | What it shows |
+|---|---|---|
+| **Map** | Always on | Trip map with place markers — cannot be disabled |
+| **Bookings** | On | Reservations and accommodations |
+| **Packing** | Off | Packing list |
+| **Budget** | Off | Budget tab |
+| **Collab** | Off | Read-only view of notes, chat, and polls |
+
+Changes to toggles take effect immediately for an existing link.
+
+### Deleting a Link
+
+Click **Delete link** (red button below the URL) to revoke access. The token is invalidated and existing viewers are redirected.
+
+> **Admin:** To invite users who do not yet have an account, create invite links in the admin panel. See [Invite-Links](Invite-Links).
+
+## Related Pages
+
+- [Public-Share-Links](Public-Share-Links)
+- [Invite-Links](Invite-Links)
+- [Creating-a-Trip](Creating-a-Trip)
+- [Trip-Planner-Overview](Trip-Planner-Overview)