Admin App

The Admin App provides internal tools for managing users, content, and system operations.

Overview

The admin app (/apps/admin-app) includes:

User management and analytics
Content moderation tools
System monitoring
Feature flag management
Revenue analytics

Implementation Status

Feature	Status	Notes
User Management	✅ Implemented	View, search, filter, impersonate users
Feature Flags	✅ Implemented	Global and system feature toggles
AI Management	✅ Implemented	Prompts, voices, features, analytics
AI Provider Management	✅ Implemented	Configure AI model providers
Email Management	✅ Implemented	Templates, A/B testing
Analytics Dashboard	✅ Implemented	Business metrics, user stats, revenue
Content Management	✅ Implemented	Content moderation, story management
Editor Configuration	✅ Implemented	Content blocks, editor templates
Conversation Testing	✅ Implemented	AI conversation debugging, analytics
Conversation Management	✅ Implemented	View and manage user conversations
Story Prompts	✅ Implemented	Library, collections, analytics, performance
Book Blurb Tools	✅ Implemented	Sample library, queue management
Feedback Analytics	✅ Implemented	User feedback analysis
Billing Management	✅ Implemented	Subscription analytics and management
Voice Settings	✅ Implemented	TTS voice configuration
Waitlist Management	✅ Implemented	Beta access, signup tracking
User Support Tools	✅ Implemented	Support flags, trends, summaries
Support Dashboard	✅ Implemented	Centralized support management
Resource Management	✅ Implemented	Downloadable resource management
System Administration	✅ Implemented	Database tools, system monitoring
Admin Settings	✅ Implemented	Admin portal configuration

Key Features

User Management

View and search all users
User profile details and activity
User impersonation for support (time-limited, audited)
Account status management
Support flags and notes

Feature Flags

Global feature toggles
Per-user feature overrides
A/B testing configuration
Gradual rollout controls

AI Management

Prompt template editing
Voice configuration (TTS models)
AI feature toggles
Usage tracking

Email Management

Email template editor
A/B testing for email campaigns
Email queue management
Delivery tracking

Analytics

User registration and growth metrics
Content creation statistics
Platform usage patterns and engagement
Revenue tracking (MRR, ARPU, LTV)
Conversion funnel analysis
Subscription metrics and churn rate
Real-time dashboard with key performance indicators

Support Tools

User impersonation (with audit logging)
Debug consoles for AI testing
Conversation testing and analytics
User support flags and trends
Support ticket summaries
Error log viewing

Content Management

Story moderation queue
Content approval/rejection workflow
Content status tracking (draft, reviewed, approved, published)
Engagement metrics and view counts
AI-enhanced content tracking
Cache revalidation tools

Editor & Templates

Reusable content blocks management
Editor template creation and editing
Template library

Tools & Internal Features

Story prompts library with collections
Prompt performance analytics
Bulk operations for prompts
Book blurb sample management
Sample processing queue
Feedback analytics dashboard

Dashboard Overview

The main dashboard (/dashboard/page.tsx) provides a comprehensive overview with:

Key Metrics Displayed

User Metrics: Total users, active users (7d/30d), new users today
Content Metrics: Total campaigns, active campaigns, total stories, word count
Engagement Metrics: Total conversations, response rate, family members, invitations
Publishing & Media: Total books, books in progress, images uploaded, audio recordings
Business Metrics: Monthly revenue, subscription tiers (starter/family/premium)
Waitlist Metrics: Total signups, verified users, conversion rate, free eligible count

Quick Actions

View All Users
Waitlist Management
Content Moderation
Feature Flags
System Health

Recent Activity Feed

Real-time activity tracking for:

User signups
Campaign creation
Story creation
Conversation responses
Book publishing

Access Control

Admin app access requires:

Role: admin or support
Authenticated session via cross-app SSO
Permission checks on all routes

See User Impersonation for details on support session security.

Admin Routes

The admin dashboard is organized under /dashboard/:


/dashboard
├── /users              # User management
│   └── /impersonate    # Support impersonation
├── /feature-flags      # Feature flag management
├── /ai-management      # AI configuration
│   ├── /prompts        # Prompt management
│   │   ├── /new        # Create new prompt
│   │   └── /[id]       # Edit/view prompt
│   │       ├── /edit   # Edit prompt
│   │       └── /history # Prompt version history
│   ├── /voices         # Voice settings
│   ├── /features       # AI feature toggles
│   └── /analytics      # AI usage analytics
├── /ai-providers       # AI provider management
├── /email              # Email management
│   ├── /templates      # Template editor
│   │   ├── /new        # Create new template
│   │   └── /[id]/edit  # Edit template
│   └── /ab-test        # A/B test setup
├── /analytics          # Analytics dashboard
├── /content            # Content management & moderation
├── /editor             # Editor configuration
│   ├── /content-blocks # Reusable content blocks
│   └── /templates      # Editor templates
│       ├── /new        # Create new template
│       └── /edit/[id]  # Edit template
├── /conversation-testing # AI conversation testing
│   ├── /results        # Test results
│   ├── /analytics      # Test analytics
│   └── /debug          # Debug console
├── /conversations      # Conversation management
├── /tools              # Internal tools
│   ├── /story-prompts  # Story prompt library
│   │   ├── /library    # Prompt library
│   │   ├── /collections # Prompt collections
│   │   ├── /analytics  # Prompt analytics
│   │   ├── /performance # Performance metrics
│   │   └── /bulk-operations # Bulk operations
│   ├── /book-blurb     # Book blurb tools
│   │   └── /samples    # Sample management
│   │       ├── /library # Sample library
│   │       ├── /add    # Add samples
│   │       └── /queue  # Processing queue
│   └── /feedback-analytics # Feedback analytics
├── /billing            # Billing management
├── /waitlist           # Beta access management
├── /voice-settings     # TTS voice configuration
├── /user-support       # User support tools
├── /support            # Support dashboard
├── /resources          # Resource management
├── /settings           # Admin settings
└── /system             # System administration
    ├── /database       # Database management
    └── /feature-flags  # System feature flags

API Endpoints

Admin-specific API routes at /api/admin/:

Statistics & Analytics

GET /api/admin/stats/users - User statistics
GET /api/admin/stats/content - Content statistics
GET /api/admin/stats/platform - Platform metrics

Conversation Testing

GET /api/admin/test-conversations - Get conversation tests
GET /api/admin/conversation-test-results - Get test results
GET /api/admin/test-analytics - Test analytics
GET /api/admin/test-provider - Test AI provider
GET /api/admin/debug-test-data - Debug test data

User Support

GET /api/admin/user-support/recent-flags - Recent support flags
GET /api/admin/user-support/trends - Support trends
GET /api/admin/user-support/summaries - Support summaries

General Admin APIs

GET /api/overview-stats - Overview statistics
POST /api/feature-flags - Update feature flags
POST /api/content-blocks - Manage content blocks
GET /api/resources/[id]/increment-download - Track resource downloads
POST /api/clear-cache - Clear application cache
POST /api/apply-migration - Apply database migrations
GET /api/debug-ai - Debug AI functionality
GET /api/debug-usage - Debug usage tracking