56 lines
3.9 KiB
Markdown
56 lines
3.9 KiB
Markdown
---
|
|
type: User Story
|
|
title: Manage users as an administrator
|
|
description: Authorized operators search users and maintain their names, linked accounts, primaries, and Discord nicknames.
|
|
tags: [admin, users, minecraft, discord]
|
|
timestamp: 2026-08-07T23:02:04Z
|
|
story_id: US-013
|
|
status: verified
|
|
---
|
|
|
|
# User Story
|
|
|
|
As an administrator, I want to manage a user's identity and Minecraft accounts, so that support issues can be resolved without direct database access.
|
|
|
|
# Acceptance Criteria
|
|
|
|
- [x] Administrators can search by preferred name, Discord username or ID, Minecraft username, or UUID.
|
|
- [x] Search results show onboarding state, primary username, and active account count.
|
|
- [x] A user detail view shows Discord display name, username, guild nickname, immutable ID, active accounts, groups, recent events, and recent IP observations.
|
|
- [x] Each grouped recent address shows the latest observation's approximate location and classification, including clear, VPN, proxy, Tor, hosting, and unknown classifications.
|
|
- [x] Missing IP enrichment is labelled as location unavailable and falls back to the stored observation classification.
|
|
- [x] Address groups use the enrichment associated with their latest observation.
|
|
- [x] Administrators can update the preferred name and synchronize Discord.
|
|
- [x] Administrators can add Mojang-verified accounts or explicitly override an unverified username.
|
|
- [x] Administrators can remove an account only after a visible confirmation step.
|
|
- [x] Removing a primary account selects a replacement or falls back to the preferred-name nickname.
|
|
- [x] Administrators can set a new primary account and automatically update Discord.
|
|
- [x] Every action rechecks role and account ownership and records the acting administrator.
|
|
- [x] Discord failures do not falsely persist the requested name, primary, or removal change.
|
|
- [x] Each row in the administrator user registry shows the user's effective group in an accessible dropdown.
|
|
- [x] Selecting a group immediately applies the assignment; selecting `everyone` removes the explicit assignment.
|
|
- [x] Group changes preserve the active user search and show accessible success or error feedback.
|
|
- [x] Registry assignment changes revalidate administrator authorization, user existence, and group existence, and audit the previous and new effective groups.
|
|
- [x] User rows and group-assignment controls are reusable between the Users registry and group-member details.
|
|
- [x] Group details show only the group's effective members with identity, Discord, primary-account, account-count, status, and group columns.
|
|
- [x] Changing a user's group requires modal confirmation and choosing `everyone` removes the explicit assignment.
|
|
- [x] Moving a member to another group removes that user from the current effective-member list after confirmation.
|
|
|
|
# Implementation
|
|
|
|
- [`apps/web/src/app/admin/(console)/users/page.tsx`](../apps/web/src/app/admin/%28console%29/users/page.tsx)
|
|
- [`apps/web/src/app/admin/(console)/users/[userId]/page.tsx`](../apps/web/src/app/admin/%28console%29/users/%5BuserId%5D/page.tsx)
|
|
- [`apps/web/src/app/admin/(console)/users/actions.ts`](../apps/web/src/app/admin/%28console%29/users/actions.ts)
|
|
- [`apps/web/src/components/user-group-select.tsx`](../apps/web/src/components/user-group-select.tsx)
|
|
- [`apps/web/src/components/admin-user-table.tsx`](../apps/web/src/components/admin-user-table.tsx)
|
|
|
|
# Validation
|
|
|
|
Nickname fallback behavior is tested in [`packages/minecraft/test/minecraft.test.ts`](../packages/minecraft/test/minecraft.test.ts). Latest-observation enrichment and classification fallback are covered by [`apps/web/src/lib/access-address-groups.test.ts`](../apps/web/src/lib/access-address-groups.test.ts). The full 107-test suite, TypeScript, lint, OKF validation, and the production build pass.
|
|
|
|
# Related Stories
|
|
|
|
- [Administrator SSO](us-011-admin-sso.md)
|
|
- [Synchronize Discord nicknames](us-006-discord-nickname.md)
|
|
- [Control Minecraft admission with groups](us-017-group-access.md)
|