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.
3.2 KiB
Admin — Users and Invites
The Users tab in the Admin Panel lets you view all registered users, manage their accounts, and create invite links so new people can register without open registration.
User list
The user table shows every registered account with the following columns:
| Column | Description |
|---|---|
| User | Avatar, username, and an always-visible presence dot (green = online, grey = offline) |
| Account email address | |
| Role | Badge showing admin or user |
| Created | Account creation date |
| Last Login | Date and time of most recent login |
| Actions | Edit and delete buttons |
Your own account row is highlighted. You cannot delete your own account.
User actions
Edit a user
Click the pencil icon on any row to open the edit form. You can change:
- Username
- Email address
- Role — toggle between
userandadmin - Password — set a new password; must be at least 8 characters
Click Save to apply changes.
Delete a user
Click the trash icon and confirm. Deletion is permanent. The user's account is removed from the database along with their data (cascade behavior is enforced at the database level).
You cannot delete your own account while logged in as that user.
Creating a user directly
Click Create User (top-right of the Users tab) to create an account without an invite link. You set the username, email, password, and role at creation time.
Invite links
Invite links let a specific number of people register themselves. This is useful when open registration is disabled.
Creating an invite
Click Create Invite (invite links section, below the user table). Configure:
- Max uses — how many times the link can be used before it expires:
1×,2×,3×,4×,5×, or∞(unlimited). Defaults to1×. - Expiry — how long the link remains valid:
1d,3d,7d,14d, or∞(no expiry). Defaults to7d.
After creation the link is copied to your clipboard automatically. Share it with the intended recipient. The URL format is:
<APP_URL>/register?invite=<token>
Invite list
Existing invites are listed below the creation button. Each row shows:
- The invite token (truncated, monospace)
- A status badge —
active,used up, orexpired - Usage —
used / max(orused / ∞for unlimited) - Expiry date, if set
- Created by — the admin who generated the link
- A copy link button (only shown for active invites)
- A delete (revoke) button
Revoking an invite immediately invalidates it; anyone following the link after revocation will receive an error.
Permissions
The Users tab also hosts the Permissions panel at the bottom, which controls what roles can perform which actions. See Admin-Permissions for details.