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.
79 lines
2.6 KiB
Markdown
79 lines
2.6 KiB
Markdown
# Todos and Tasks
|
|
|
|
Manage a to-do list for trip tasks and pre-departure preparation.
|
|
|
|
<!-- TODO: screenshot: to-do list with checkboxes and priority badges -->
|
|
|
|
|
|
|
|
## Where to find it
|
|
|
|
Open the **Lists** tab inside the trip planner and select **Todo**. The Todo feature shares the Lists addon with Packing Lists, so it is only visible when that addon is enabled.
|
|
|
|
> **Admin:** Enable the Lists/Packing addon in [Admin-Addons](Admin-Addons).
|
|
|
|
## Layout
|
|
|
|
The panel is divided into two columns by default:
|
|
|
|
- **Left sidebar** — category navigation, smart filters, sort toggle, and a completion progress card.
|
|
- **Task list** — the tasks that match the active filter.
|
|
|
|
When you click a task, a **detail pane** opens as a third column on the right side of the task list (on desktop) or slides up as a bottom sheet (on mobile). The new-task form also opens as a modal overlay.
|
|
|
|
On small screens the sidebar collapses to a narrow icon rail showing only colored dots and icons with badge counts.
|
|
|
|
## Task fields
|
|
|
|
Each task has the following fields:
|
|
|
|
| Field | Notes |
|
|
|---|---|
|
|
| Name | Required. |
|
|
| Checked | Boolean — marks the task done. |
|
|
| Category | Optional grouping label. |
|
|
| Due date | Optional date. |
|
|
| Description | Optional free-text body. |
|
|
| Assignee | Optional trip member. |
|
|
| Priority | 0 (none), 1 (P1), 2 (P2), or 3 (P3). |
|
|
|
|
Click a task row to open the detail pane on the right (or a modal sheet on mobile) where you can edit all fields.
|
|
|
|
## Priority levels
|
|
|
|
| Level | Label | Color |
|
|
|---|---|---|
|
|
| 1 | P1 | Red (`#ef4444`) |
|
|
| 2 | P2 | Amber (`#f59e0b`) |
|
|
| 3 | P3 | Blue (`#3b82f6`) |
|
|
|
|
Tasks with no priority set show no badge.
|
|
|
|
## Sidebar filters
|
|
|
|
| Filter | Shows |
|
|
|---|---|
|
|
| **All** | All unchecked tasks. |
|
|
| **My tasks** | Unchecked tasks assigned to you. |
|
|
| **Overdue** | Unchecked tasks with a past due date. |
|
|
| **Done** | Checked tasks. |
|
|
| Per-category rows | All tasks in that specific category (checked and unchecked). |
|
|
|
|
## Sort by priority
|
|
|
|
Toggle the **Priority** button in the sidebar to sort the current task list from P1 → P2 → P3 (tasks with no priority appear last).
|
|
|
|
## Adding tasks
|
|
|
|
Click the **+ Add task** button in the top-right corner of the Lists panel header (visible when the **Todo** sub-tab is active). A new-task form opens as a modal where you can set all fields before saving. On mobile it slides up from the bottom of the screen.
|
|
|
|
## Permissions
|
|
|
|
All write operations require the `packing_edit` permission (shared with Packing Lists).
|
|
|
|
## See also
|
|
|
|
- [Packing-Lists](Packing-Lists)
|
|
- [Admin-Addons](Admin-Addons)
|
|
- [Trip-Planner-Overview](Trip-Planner-Overview)
|