Feature Plan: Link Hub

Summary

Owner: Freddi
Status: Delivery
Target Release: Rolling
Backlog Entry: Projects/Uebliche/agendas.md ▸ 📦 Backlog ▸ Link hub polish

Goals

Centralize community, support, and social links shown across the network.
Allow live updates without requiring client or server restarts.
Surface links contextually in NPC dialogue, menus, and the desktop app.

Scope

Maintain link definitions within features/links with categories and localization.
Expose REST or GraphQL endpoints for consumers.
Integrate with NPC dialogue and future UI components for surfacing links.
Exclude analytics tracking beyond basic click counters (handled elsewhere).

Implementation Outline

Define link schemas and persistence via Mongo managers.
Provide read APIs consumed by client mod, desktop app, and server features.
Hook into NPC/dialogue modules for contextual presentation.
Keep documentation mirrored with /Projects/Uebliche/docs/gameserver/features/links/plan.md.

Dependencies

MongoDB storage for link definitions.
Desktop/UI consumers that present the link hub.
Agenda coordination for communication updates.

Risks & Mitigations

Stale links: schedule periodic reviews; add monitoring for HTTP status where possible.
Localization gaps: enforce translation completeness during reviews.
Security: validate URLs to prevent injection or unsafe schemes.

Validation Plan

Unit tests for link validation and categorization helpers.
Manual QA through desktop app and in-game menus after updates.
Future integration with monitoring to track failures.

Notes & Decisions

Capture major policy decisions (e.g., allowed domains) under agenda ⚖️ Decisions.

References

services/gameserver/src/main/java/net/uebliche/features/links
services/gameserver/src/main/java/net/uebliche/features/dialog
Desktop integration points (future) under app/dashboard/src