mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-06-19 13:21:46 +00:00
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.
93 lines
4.2 KiB
Markdown
93 lines
4.2 KiB
Markdown
# Packing Lists
|
|
|
|
Create categorized packing checklists with member assignments and optional bag tracking.
|
|
|
|
<!-- TODO: screenshot: packing list with checked items and categories -->
|
|
|
|
|
|
|
|
## 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](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](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](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:
|
|
|
|
1. Click **+ Add bag** to create a bag with a name and color.
|
|
2. Assign items to a bag using the bag picker on each item row (visible when bag tracking is enabled).
|
|
3. 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](Admin-Packing-Templates).
|
|
|
|
## Permissions
|
|
|
|
All write operations require the `packing_edit` permission.
|
|
|
|
## See also
|
|
|
|
- [Packing-Templates](Packing-Templates)
|
|
- [Admin-Addons](Admin-Addons)
|
|
- [Notifications](Notifications)
|
|
- [Trip-Planner-Overview](Trip-Planner-Overview)
|