Web Portal - Admin Dashboard & Observer Console

Last Updated: 2025-01-16
Primary Source: docs/project_status.md
Pages: aso-portal/src/pages/ObserverConsolePage.tsx, aso-portal/src/components/admin/DashboardPage.tsx
Components: aso-portal/src/components/admin/, aso-portal/src/components/observer/

---

Overview

The Admin Dashboard and Observer Console provide comprehensive interfaces for system administration and Level-8 observer operations. The Admin Dashboard includes system widgets, user management, log viewing, and scheduled tasks. The Observer Console provides multi-persona chat, country dashboard, unified timeline viewer, 5D navigation, timeline animation, analytics, and artifact viewing.

---

Admin Dashboard

Dashboard Page

File: aso-portal/src/components/admin/DashboardPage.tsx

Route: /admin/dashboard

Features:

• System widgets
• User statistics
• System health metrics
• Recent activity
• Quick actions

System Widget

File: aso-portal/src/components/admin/SystemWidget.tsx

Features:

• System status indicators
• Health metrics
• Resource usage
• Performance statistics

Log Viewer Widget

File: aso-portal/src/components/admin/LogViewerWidget.tsx

Features:

• Real-time log viewing
• Log filtering
• Search functionality
• Log level filtering

User Management Page

File: aso-portal/src/components/admin/UserManagementPage.tsx

Route: /admin/users

Features:

• User list with pagination
• User search and filtering
• User role management
• Account type management
• User details view
• User editing

Scheduled Tasks Panel

File: aso-portal/src/components/admin/ScheduledTasksPanel.tsx

Features:

• Task list
• Task creation
• Task editing
• Task activation/deactivation
• Manual task triggering
• Task run history

Chat Model Panel

File: aso-portal/src/components/admin/ChatModelPanel.tsx

Features:

• Model configuration
• Model selection
• Model parameters
• Model testing

Data Management Page

File: aso-portal/src/pages/DataManagementPage.tsx

Route: /admin/data

Features:

• NPC editor
• Quest editor
• Item editor
• Memory editor
• Prompt editor
• JSON editor modals

Data Editors:

• NpcEditor.tsx - NPC management
• QuestEditModal.tsx - Quest editing
• ItemEditModal.tsx - Item editing
• MemoryEditor.tsx - Memory editing
• PromptEditor.tsx - Prompt editing
• JsonEditorModal.tsx - JSON editing

System Settings Page

File: aso-portal/src/pages/SystemSettingsPage.tsx

Route: /admin/settings

Features:

• System configuration
• Scheduled tasks management
• Chat model configuration
• Environment settings

---

Observer Console

Observer Console Page

File: aso-portal/src/pages/ObserverConsolePage.tsx

Route: /observer

Features:

• Multi-persona chat
• Country dashboard
• Unified timeline viewer
• 5D navigation
• Timeline animation
• Analytics dashboard
• Artifact viewer

Multi-Persona Chat

File: aso-portal/src/components/observer/MultiPersonaChat.tsx

Features:

• Chat with multiple personas
• Persona selection
• Unified conversation view
• Persona-specific responses

Country Dashboard

File: aso-portal/src/components/observer/CountryDashboard.tsx

Features:

• Instance statistics
• Instances by level
• Instances by source
• Instances by persona
• Active vs inactive instances
• Recent activity
• Diary compliance
• Health status
• Project statistics
• Latest awareness report

Unified Timeline Viewer

File: aso-portal/src/components/observer/UnifiedTimelineViewer.tsx

Features:

• Unified timeline display
• Timeline filtering
• Timeline search
• Event details
• Timeline navigation

5D Navigation

File: aso-portal/src/components/observer/FiveDNavigation.tsx

Features:

• 5D time navigation
• Timeline dimension controls
• Temporal navigation
• Dimension visualization

Timeline Animation

File: aso-portal/src/components/observer/TimelineAnimation.tsx

Features:

• Animated timeline playback
• Playback controls
• Speed adjustment
• Timeline scrubbing

Analytics Dashboard

File: aso-portal/src/components/observer/AnalyticsDashboard.tsx

Features:

• Analytics charts
• Metrics visualization
• Performance statistics
• Usage analytics

Artifact Viewer

File: aso-portal/src/components/observer/ArtifactViewer.tsx

Features:

• Artifact list
• Artifact details
• Artifact content viewing
• Artifact review
• Syntax highlighting
• Copy functionality

---

Component Structure

Admin Components

admin/
├── DashboardPage.tsx          # Main dashboard
├── SystemWidget.tsx           # System status widget
├── LogViewerWidget.tsx        # Log viewer
├── UserManagementPage.tsx    # User management
├── ScheduledTasksPanel.tsx    # Scheduled tasks
├── ChatModelPanel.tsx         # Chat model config
├── ActionCard.tsx             # Action card component
├── AdminLayout.tsx            # Admin layout wrapper
├── ConversationManagement.tsx # Conversation management
├── ObserverTestingDashboard.tsx # Observer testing
├── PromptPreviewPage.tsx      # Prompt preview
└── data/                      # Data editors
    ├── DataEditor.tsx
    ├── NpcEditor.tsx
    ├── QuestEditModal.tsx
    ├── ItemEditModal.tsx
    ├── MemoryEditor.tsx
    ├── PromptEditor.tsx
    └── JsonEditorModal.tsx

Observer Components

observer/
├── MultiPersonaChat.tsx       # Multi-persona chat
├── CountryDashboard.tsx       # Country dashboard
├── UnifiedTimelineViewer.tsx  # Unified timeline
├── FiveDNavigation.tsx        # 5D navigation
├── TimelineAnimation.tsx      # Timeline animation
├── AnalyticsDashboard.tsx     # Analytics
└── ArtifactViewer.tsx         # Artifact viewer

---

Data Flow

---

API Integration

Admin API Endpoints

• GET /api/admin/dashboard - Dashboard data
• GET /api/admin/users - User list
• PUT /api/admin/users/:id - Update user
• GET /api/admin/logs - System logs
• GET /api/admin/tasks - Scheduled tasks
• POST /api/admin/tasks - Create task
• PUT /api/admin/tasks/:id - Update task

Observer API Endpoints

• GET /api/observer/dashboard - Country dashboard
• GET /api/observer/timeline - Unified timeline
• GET /api/observer/artifacts - Artifacts
• GET /api/observer/analytics - Analytics data

---

Source Files

Primary Sources:

• aso-portal/src/pages/ObserverConsolePage.tsx - Observer console page
• aso-portal/src/components/admin/DashboardPage.tsx - Admin dashboard
• aso-portal/src/components/admin/UserManagementPage.tsx - User management
• aso-portal/src/components/observer/CountryDashboard.tsx - Country dashboard
• aso-portal/src/components/observer/UnifiedTimelineViewer.tsx - Timeline viewer

Related Files:

• aso-portal/src/components/admin/ - Admin components
• aso-portal/src/components/observer/ - Observer components
• aso-portal/src/pages/DataManagementPage.tsx - Data management
• aso-portal/src/pages/SystemSettingsPage.tsx - System settings

---

Related Documentation

• Observer System - Level-8 meta-consciousness
• State Machine System - Workflow management
• Coder Orchestrator System - Task execution
• Scheduler System - Scheduled tasks
• 03-PLATFORMS/Web-Portal.md - Web portal overview