jubnl
c1b9d11173
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.
4.2 KiB
Packing Lists
Create categorized packing checklists with member assignments and optional bag tracking.
Where to find it
Open the Lists tab inside the trip planner and select Packing. The tab is only visible when the Packing addon is enabled.
Admin: Enable the Packing addon and optionally turn on Bag Tracking in Admin-Addons.
Progress bar
A progress bar shows how many items have been checked (packed) out of the total. It is hidden on small screens and visible on larger viewports. When all items are checked, a completion message replaces the bar.
Filters
Three filter buttons let you narrow the item view:
- All — every item regardless of checked state.
- Open — unchecked items only.
- Done — checked items only.
Categories
Items are grouped into categories. Each category has a colored dot that cycles through a 10-color palette. When you create a new packing list, suggested items are pre-populated in these categories: Documents (Passport, Travel Insurance, Visa Documents, Flight Tickets, Hotel Bookings, Vaccination Card), Clothing (T-Shirts (5x), Pants (2x), Underwear (7x), Socks (7x), Jacket, Swimwear, Sport Shoes), Toiletries (Toothbrush, Toothpaste, Shampoo, Sunscreen, Deodorant, Razor), Electronics (Phone Charger, Travel Adapter, Headphones, Camera, Power Bank), Health (First Aid Kit, Prescription Medication, Pain Medication, Insect Repellent), and Finances (Cash, Credit Card).
Each category header has a collapse/expand toggle and an overflow menu with these actions:
- Check all — mark every item in the category as packed.
- Uncheck all — unmark every item in the category.
- Rename — rename the category.
- Delete — delete the category and all its items.
Assigning members to a category
Use the people-picker chip row in the category header to assign trip members to that category. Assigned members receive a packing notification. See Notifications for details.
Items
Each item row contains:
- A checkbox to mark the item packed.
- An editable name (click to rename; renaming is disabled while an item is checked).
- A quantity field (always visible).
- When bag tracking is enabled: a weight field (in grams) and a bag picker.
Hovering over an item reveals a category picker (colored dot), a rename button (pencil icon), and a delete button. Add new items using the inline "add item" row at the bottom of each category.
Bag tracking
Bag tracking is only available when an admin has enabled it.
Admin: Turn on Bag Tracking in Admin-Addons.
When enabled, a Bags panel appears as a right-hand sidebar on wide screens, or as a modal sheet on narrow screens (tap the Bags button in the header to open it). Each bag shows:
- Name and color dot.
- Total weight and a weight-limit progress bar (if a limit is set).
- Member avatars assigned to that bag.
- Item count.
The sidebar also shows an unassigned section for items that have no bag, and a total weight line summing all items.
To use bags:
- Click + Add bag to create a bag with a name and color.
- Assign items to a bag using the bag picker on each item row (visible when bag tracking is enabled).
- Assign members to a bag using the member chip row on the bag card.
Templates
You can save and reuse packing lists across trips:
- Save as Template — click the Save as Template button in the header (visible when the list has items) to save the current list's items and categories as a named template.
- Apply Template — if templates exist, an Apply Template dropdown appears in the header. Selecting a template appends its items to the current list without removing existing items.
Templates are managed by admins in Admin-Packing-Templates.
Permissions
All write operations require the packing_edit permission.