mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-06-19 13:21:46 +00:00
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.
This commit is contained in:
@@ -0,0 +1,61 @@
|
||||
# Collab Polls
|
||||
|
||||
Create group polls to make decisions collaboratively — where to eat, which hotel, what to do on a free day.
|
||||
|
||||
<!-- TODO: screenshot: poll with options and vote counts -->
|
||||
|
||||

|
||||
|
||||
## Where to find it
|
||||
|
||||
Open the trip planner → **Collab** tab → **Polls** section. The Collab addon must be enabled and the Polls sub-feature must be turned on. See [Real-Time-Collaboration](Real-Time-Collaboration).
|
||||
|
||||
## Creating a poll
|
||||
|
||||
Users with `collab_edit` permission can click **+ New** in the Polls header. A modal opens with the following fields:
|
||||
|
||||
| Field | Required | Notes |
|
||||
|-------|----------|-------|
|
||||
| Question | Yes | The poll prompt |
|
||||
| Options | Yes | At least 2 options required; add more with **+ Add option** |
|
||||
| Multiple choice | No | Toggle on to allow voters to select more than one option |
|
||||
|
||||
Click **Create** to save and broadcast the poll to all connected members.
|
||||
|
||||
## Voting
|
||||
|
||||
Click an option button to vote. A filled circle and blue highlight indicate your selection. For **multiple-choice** polls, you can click additional options to select more than one; clicking an already-selected option removes your vote for that option. For **single-choice** polls, clicking a different option moves your vote to the new selection.
|
||||
|
||||
Percentage bars and voter avatars are only visible **after you have voted** or once the poll is closed or expired.
|
||||
|
||||
## Results
|
||||
|
||||
Each option shows:
|
||||
|
||||
- A **percentage fill bar** that expands proportionally to the votes received
|
||||
- Up to **3 voter avatar chips** stacked next to the option
|
||||
- The **percentage** of total votes in the right margin
|
||||
|
||||
The option with the most votes is highlighted when the poll is closed or expired.
|
||||
|
||||
## Deadline
|
||||
|
||||
Polls may have an optional deadline set via the API. When a deadline is present, a live countdown badge appears on the poll card, updating every **30 seconds**. The badge shows the remaining time in days/hours/minutes format.
|
||||
|
||||
When the deadline passes, the poll is automatically treated as closed: voting is disabled and results are displayed to everyone.
|
||||
|
||||
## Closing a poll manually
|
||||
|
||||
Users with `collab_edit` permission can click the lock icon on an open poll to close it immediately. Once closed, voting is permanently disabled.
|
||||
|
||||
## Deleting a poll
|
||||
|
||||
Users with `collab_edit` permission can delete a poll using the trash icon. Deletion is permanent and removes the poll for all members.
|
||||
|
||||
## Active and closed sections
|
||||
|
||||
Open polls appear at the top of the list. Closed or expired polls move to a **Closed** section below the active polls.
|
||||
|
||||
## Related pages
|
||||
|
||||
[Real-Time-Collaboration](Real-Time-Collaboration) · [Collab-Chat](Collab-Chat) · [Collab-Notes](Collab-Notes)
|
||||
Reference in New Issue
Block a user