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,76 @@
+# Documents and Files
+
+Attach and manage documents, tickets, and other files for your trip.
+
+<!-- TODO: screenshot: file attachment list with filter tabs -->
+
+![Files](assets/Files.png)
+
+## Where to find it
+
+Open the **Files** tab inside the trip planner, or navigate directly to `/trips/:id/files`.
+
+> **Admin:** Files is an addon. Enable it in [Admin-Addons](Admin-Addons).
+
+## Uploading
+
+Drag and drop files onto the upload area, click it to open the file picker, or paste an image directly into the Files panel.
+
+- **Maximum file size:** 50 MB per file.
+- **Blocked file types:** `.svg`, `.html`, `.htm`, `.xml` — these are always rejected.
+- **Default allowed types:** jpg, jpeg, png, gif, webp, heic, pdf, doc, docx, xls, xlsx, txt, csv, pkpass. An admin can customize the allowed list in [Admin-Addons](Admin-Addons).
+
+Requires the `file_upload` permission.
+
+## Browsing and filtering
+
+The toolbar provides filter tabs: **All**, **PDF**, **Images**, **Docs**, and conditionally **Starred** (only shown when at least one file is starred) and **Collab** (only shown when files exist from collaborative notes). Each tab shows a count badge.
+
+## Previewing files
+
+Clicking a non-image file (e.g., PDF) opens an inline preview modal with options to open in a new tab or download. Clicking an image file opens a full-screen lightbox. You can:
+
+- Navigate between images using the **arrow buttons** or the **left/right arrow keys**.
+- Swipe left/right on touch devices.
+- Jump to a specific image using the **thumbnail strip** at the bottom.
+- Download or open the image in a new tab from the lightbox header.
+
+## Starring
+
+Click the **star icon** on any file to favorite it. Starred files sort to the top of the list and can be filtered with the Starred tab.
+
+Requires the `file_edit` permission.
+
+## Trash
+
+Deleting a file moves it to the trash. Switch to the trash view using the **Trash** button in the toolbar. From the trash view you can:
+
+- **Restore** a file to make it active again.
+- **Permanently delete** a single file.
+- **Empty trash** to permanently remove all trashed files at once.
+
+Restore and delete operations require the `file_delete` permission.
+
+## Linking files to places, reservations, or assignments
+
+A file can be attached to multiple places and reservations at the same time (many-to-many). From the file manager, click the **link (pencil) icon** on a file to open the assign modal. From there you can toggle links to any trip place or reservation. You can also add a descriptive note to the file in the same modal.
+
+From a reservation modal, use the "link existing file" picker to attach files directly.
+
+## Downloading
+
+Click the download icon on any file row to download it. `.pkpass` files (Apple Wallet passes) are served with the `application/vnd.apple.pkpass` MIME type, so Safari on iOS and macOS offers to add the pass to Wallet instead of saving it as a generic download.
+
+## Permissions
+
+| Permission | Controls |
+|---|---|
+| `file_upload` | Uploading new files. |
+| `file_edit` | Starring and linking files. |
+| `file_delete` | Moving to trash, restoring, and permanently deleting. |
+
+## See also
+
+- [Reservations-and-Bookings](Reservations-and-Bookings)
+- [Admin-Addons](Admin-Addons)
+- [Trip-Planner-Overview](Trip-Planner-Overview)