40 lines
1.8 KiB
Markdown
40 lines
1.8 KiB
Markdown
---
|
|
type: User Story
|
|
title: Enter the account portal through Discord
|
|
description: Direct visitors are guided to the configured Discord community and its account commands.
|
|
tags: [player, portal, discord, onboarding]
|
|
timestamp: 2026-08-01T22:34:31Z
|
|
story_id: US-001
|
|
status: verified
|
|
---
|
|
|
|
# User Story
|
|
|
|
As a prospective player, I want the portal to direct me to the community Discord, so that I can begin registration through the trusted entry point.
|
|
|
|
# Acceptance Criteria
|
|
|
|
- [x] Given an unauthenticated visitor, when they open the portal, then they are told to run `/register` or `/account` in Discord.
|
|
- [x] Given a configured invite URL, when the visitor selects the join action, then the Discord invite opens in a new browser context.
|
|
- [x] Given a configured guild ID, when the visitor selects the app action, then a `discord://` guild link is opened.
|
|
- [x] Given an unauthenticated protected-page request, when authorization fails, then the visitor returns to the portal with prominent Discord instructions.
|
|
- [x] Every portal page credits Social Minecraft sponsorship by DMG Games and links to `https://dmg.games`.
|
|
- [x] Portal branding uses the SoMC Portal name and a dedicated favicon.
|
|
|
|
# Implementation
|
|
|
|
- [`apps/web/src/app/page.tsx`](../apps/web/src/app/page.tsx)
|
|
- [`apps/web/src/lib/auth/user-session.ts`](../apps/web/src/lib/auth/user-session.ts)
|
|
- [`apps/web/src/components/site-footer.tsx`](../apps/web/src/components/site-footer.tsx)
|
|
- [`apps/web/src/app/icon.svg`](../apps/web/src/app/icon.svg)
|
|
- Configuration: `DISCORD_GUILD_ID`, `DISCORD_INVITE_URL`
|
|
|
|
# Validation
|
|
|
|
Covered by the Next.js production build and protected-route session checks.
|
|
|
|
# Related Stories
|
|
|
|
- [Discord magic-link authentication](us-002-discord-magic-link.md)
|
|
- [First-time onboarding](us-003-onboarding.md)
|