Missions UI Proposal for OASIS Portal
Overview
Based on the STAR architecture, missions are high-level story containers that organize quests into chapters. Missions provide the narrative structure for user progression, while quests are the actionable steps within missions.
Key Concepts from STAR
Mission Structure
Mission: A container for quests, organized into optional chapters
Chapters: Optional grouping of quests (for large missions)
Quests: Actionable steps within a mission
MissionType: Enum defining mission types (Easy, Medium, Hard, Expert)
Inherits from QuestBase: Missions inherit quest properties like:
Name, Description
Status (Pending, InProgress, Completed, etc.)
Difficulty
Rewards (Karma, XP)
Quests list
Order/Sequence
Mission Operations
Create mission
Start mission (for user)
Complete mission (when all quests/chapters complete)
Update mission
Delete mission
Publish/Unpublish mission
Download/Install mission
Clone mission
UI Design Proposal
1. Mission Tracker (Main View)
Location: STAR Dashboard β Missions Tab
Layout:
Features:
Mission Cards: Visual cards showing mission progress
Progress Visualization:
Progress bar showing completion percentage
Quest timeline showing completed/active/pending quests
Color-coded nodes (green = completed, purple = active, gray = pending)
Mission Metadata: Type, quest count, start/completion dates
Chapter Support: Visual grouping if mission has chapters
Status Indicators: Active, Completed, Not Started
2. Mission Detail View
Layout:
Features:
Chapter Organization: Group quests by chapters
Quest List: Show all quests with completion status
Progress Tracking: Real-time progress updates
Rewards Display: XP and Karma rewards
Action Buttons:
Start mission (if not started)
Complete mission (if all quests done)
Navigate to active quest
Share mission progress
3. Mission Creation Interface
Layout (Similar to Quest Builder but simpler):
Features:
3-Step Wizard: Simple creation flow
Basic Info: Name, description, type, difficulty
Organization: Choose flat or chapter-based structure
Quest Selection: Link existing quests or create new ones
Chapter Management: Add/remove/reorder chapters
Rewards: Set XP and Karma rewards
4. Mission Timeline View (Alternative)
Alternative visualization for complex missions:
Features:
Visual Timeline: Tree/graph view of mission structure
Chapter Separation: Clear visual boundaries
Quest Dependencies: Show quest relationships
Status Indicators: Visual status per quest/chapter
UI Components Needed
Components
MissionCard: Reusable card component showing mission summary
MissionProgressBar: Progress visualization component
QuestTimeline: Timeline visualization for quests
ChapterAccordion: Collapsible chapter sections
MissionCreator: 3-step wizard for creating missions
ChapterSelector: Component for organizing quests into chapters
MissionDetailView: Full mission detail with chapters and quests
MissionStatusBadge: Status indicator badge
API Integration Points
GET /api/missions- List all missionsGET /api/missions/{id}- Get mission detailsPOST /api/missions- Create missionPUT /api/missions/{id}- Update missionDELETE /api/missions/{id}- Delete missionPOST /api/missions/{id}/start- Start missionPOST /api/missions/{id}/complete- Complete missionGET /api/missions/{id}/quests- Get quests for missionGET /api/missions/{id}/chapters- Get chapters for mission
Design Principles
Visual Hierarchy: Clear visual distinction between missions, chapters, and quests
Progress Clarity: Always show progress clearly (percentage, visual indicators)
Chapter Support: Primary organization method for large missions
Quest Integration: Seamless integration with quest system
Status Awareness: Clear status indicators at all levels
Timeline Visualization: Visual representation of quest sequence
Responsive Design: Works on desktop and mobile
Consistent Styling: Matches portal design system
Color Scheme
Mission Primary: Pink/Magenta (rgba(236, 72, 153, ...))
Completed: Green (rgba(34, 197, 94, ...))
Active: Purple (rgba(168, 85, 247, ...))
Pending: Gray (rgba(255, 255, 255, 0.1))
Next Steps
Enhance existing
mission-interface.jswith chapter supportCreate mission creation wizard similar to quest builder
Add chapter management UI components
Integrate with quest selection/creation
Add timeline visualization component
Connect to backend API endpoints
Add mission progress tracking
Implement mission completion flow
Last updated