Eve library

Psyche Admin Dashboard

Other

Revision 1

On this page

Web interface for managing AI virtual assistants in the Psyche platform.

Part of the Psyche AI Virtual Assistant Platform.

Overview#

The Admin Dashboard provides a comprehensive management interface for:

  • Personas: Create and manage AI personas with personality, expertise, and memory
  • Sessions: Monitor and manage active assistant sessions
  • Knowledge Base: Upload and manage documents for RAG
  • Analytics: View metrics, performance, and usage statistics
  • Tools: Manage tool integrations and MCP connections
  • Settings: Configure system settings and integrations

Tech Stack#

  • Framework: Next.js 14.2 with App Router
  • UI Components: Radix UI (40+ accessible components)
  • Styling: Tailwind CSS with custom design system
  • State Management: Zustand + React Query
  • Forms: React Hook Form + Zod validation
  • Charts: Recharts
  • Testing: Vitest + Playwright

Features#

Dashboard Overview#

  • Real-time session monitoring
  • System health and status
  • Quick statistics (active sessions, personas, response time)
  • Recent activity feed

Persona Management#

  • CRUD operations for AI personas
  • Personality configuration (Big Five model)
  • Expertise domain setup
  • Voice and avatar configuration
  • Training status tracking

Session Management#

  • Active session monitoring
  • Platform support (Zoom, Teams, Meet, Webex)
  • Session metrics and analytics
  • Message and tool usage tracking

Knowledge Base#

  • Multi-format document upload (PDF, DOCX, MD, HTML, CSV, JSON)
  • Document search and filtering
  • Source tracking and versioning
  • RAG pipeline integration

Analytics#

  • Session volume trends
  • Response time metrics
  • User satisfaction scores
  • Quality metrics (accuracy, latency, error rates)
  • Platform usage breakdown

Accessibility (WCAG 2.1)#

  • Skip navigation links
  • Proper ARIA landmarks
  • Keyboard navigation
  • Screen reader support
  • High contrast dark mode

Project Structure#

text
src/
├── app/                    # Next.js App Router
│   ├── layout.tsx          # Root layout
│   ├── providers.tsx       # Client providers
│   ├── auth/               # Authentication pages
│   └── dashboard/          # Dashboard pages
│       ├── personas/       # Persona management
│       ├── sessions/       # Session management
│       ├── knowledge/      # Knowledge base
│       ├── analytics/      # Analytics
│       ├── tools/          # Tool management
│       └── settings/       # Settings
├── components/             # React components
│   ├── ui/                 # Radix UI components
│   └── layout/             # Layout components
├── api/                    # API client
├── stores/                 # Zustand stores
├── hooks/                  # Custom hooks
├── types/                  # TypeScript types
├── lib/                    # Utilities
└── styles/                 # Global styles

Development#

Using Nx#

bash
# Install dependencies (from monorepo root)
pnpm install

# Development server
nx dev psyche-admin
nx serve psyche-admin

# Production build
nx build psyche-admin

# Start production server
nx start psyche-admin

# Type checking
nx typecheck psyche-admin

# Linting
nx lint psyche-admin

# Formatting
nx format psyche-admin
nx format-check psyche-admin

# Testing
nx test psyche-admin
nx test-watch psyche-admin
nx test-cov psyche-admin

# Visual regression tests
nx test-visual psyche-admin
nx test-visual-update psyche-admin

# Bundle analysis
nx analyze psyche-admin

# Docker
nx docker-build psyche-admin
nx docker-run psyche-admin

Direct Commands#

bash
cd apps/psyche/admin
pnpm dev          # Development server
pnpm build        # Production build
pnpm start        # Production server
pnpm lint         # ESLint
pnpm typecheck    # TypeScript check
pnpm test         # Unit tests
pnpm test:visual  # Playwright tests

Configuration#

Environment Variables#

Variable Description Default
NEXT_PUBLIC_API_URL Backend API URL http://localhost:8000
NEXT_PUBLIC_WS_URL WebSocket URL ws://localhost:8001
NEXT_PUBLIC_APP_URL Application URL http://localhost:3000

Next.js Configuration#

  • Server Actions enabled (2MB body limit)
  • Optimized image formats (AVIF, WebP)
  • Security headers (HSTS, CSP, X-Frame-Options)
  • TypeScript strict mode

API Integration#

The dashboard communicates with backend services via:

  • REST API at NEXT_PUBLIC_API_URL
  • WebSocket for real-time updates at NEXT_PUBLIC_WS_URL

API Endpoints#

text
/api/v1/sessions     - Session management
/api/v1/personas     - Persona management
/api/v1/knowledge    - Knowledge base
/api/v1/tools        - Tool management
/api/v1/webhooks     - Webhook configuration

Theming#

  • Light and dark mode support
  • Custom color palette (Psyche blue)
  • Tailwind CSS utility classes
  • Glass morphism effects
  • Smooth animations

Testing#

Unit Tests (Vitest)#

bash
nx test psyche-admin

Visual Regression (Playwright)#

bash
nx test-visual psyche-admin

Coverage Report#

bash
nx test-cov psyche-admin

Docker#

Build Image#

bash
nx docker-build psyche-admin

Run Container#

bash
nx docker-run psyche-admin

The container:

  • Runs on port 3000
  • Uses Node.js 20 Alpine
  • Includes health checks
  • Non-root user (psyche)

License#

Proprietary - Oshun Platform