Skip to content

README.md

Latest commit

 

History

History
79 lines (54 loc) · 2.55 KB

README.md

File metadata and controls

79 lines (54 loc) · 2.55 KB

Humor Admin Dashboard

A Next.js admin dashboard for managing humor caption workflows, monitoring caption performance, and maintaining humor flavors.

This app is part of a larger multi-app humor system and serves as the admin-side control center. It is designed for authorized users to review platform activity, manage humor flavor configurations, and track how captions perform based on user voting data.

Overview

The Humor Admin Dashboard supports the management and analysis side of the humor caption pipeline.

Admins can:

  • view caption rating statistics
  • monitor overall voting activity
  • review top and bottom performing captions
  • manage humor flavors and prompt steps
  • support experimentation across the humor generation workflow

This dashboard connects creative tooling with feedback analytics, making it easier to iterate on humor styles using real user response data.

Authentication and Access Control

This app is intended for admin use only.

Access is restricted through authentication and role-based authorization. Admin functionality is only available to users with the appropriate permissions, helping protect configuration tools and internal analytics from general users.

In this system, admin access is checked against profile permissions such as:

  • is_superadmin
  • is_matrix_admin

This ensures that only authorized users can access sensitive admin pages and actions.

Features

  • Admin-only access to dashboard and management tools
  • Caption statistics dashboard with live platform data
  • Summary metrics such as:
    • total votes
    • total scored captions
    • average caption score
    • vote sentiment
  • Top and bottom caption performance views
  • Humor flavor and step management
  • Safer admin workflows for editing and deletion

Statistics Dashboard

The admin dashboard displays meaningful statistics about the captions users are rating.

It uses live data sources to surface:

  • voting activity
  • caption performance trends
  • strongest and weakest captions
  • overall sentiment patterns

The goal is to help admins quickly understand what kinds of captions are performing well and where further iteration may be needed.

Data Sources

This app uses confirmed Supabase-backed data sources including:

  • caption_votes for raw voting activity
  • caption_scores for aggregated caption score data
  • humor_flavors for flavor definitions
  • humor_flavor_steps for linked prompt-step configurations

Tech Stack

  • Next.js
  • React
  • Supabase
  • Vercel

Running Locally

Install dependencies and start the development server:

npm install
npm run dev