Video Quality Standard

The Video Quality Standard feature ensures that only high-quality videos are visible to recruiters, helping talents showcase their best work and providing recruiters with professional content.

Overview

All uploaded videos are reviewed and assigned a quality grade (A, B, or C) by administrators. This grading system helps maintain content standards while providing clear feedback to talent users.

Quality Grades

• Grade A: Excellent quality - Professional footage, clear visibility, optimal lighting
• Grade B: Good quality - Acceptable standards with minor improvements possible
• Grade C: Needs improvement - Video is not visible to recruiters and requires resubmission

Features

For Talent Users

Pre-Upload Guidance

Before uploading, talents see clear guidelines:

• Use landscape orientation (16:9 recommended)
• Ensure good lighting conditions
• Focus on key skills and match moments
• Keep audio clear if including commentary

Upload Notification

After uploading, talents are informed:

• Videos will be reviewed within 24-48 hours
• Grades A and B are visible to recruiters
• Grade C videos need improvement

Grade C Notifications

When a video receives Grade C:

• Email notification with specific feedback
• Rejection reason explaining what needs improvement
• Link to video quality guidelines
• Option to upload an improved version

For Administrators

Video Grading Interface

Admins can grade videos through the moderation panel:

• View all videos with current grades
• Access grading modal with grade selector (A/B/C)
• Required rejection reason for Grade C
• Automatic email notification to talent

Grade Management

• Videos show grade badges in the admin grid
• Grade C automatically sets video status to REJECTED
• Talent's primary video grade is updated automatically
• Full audit trail with grader ID and timestamp

For Recruiters

Filtered Content

Recruiters only see quality content:

• Grade C videos are automatically filtered out
• Grade A and B videos display quality badges
• Search and filter results exclude rejected videos

Quality Indicators

• Video cards display grade badges
• Dashboard shows only approved, quality-graded videos
• Clear quality indicators help identify top talent

API Endpoints

Grade Video (Admin)

PATCH /api/videos/[videoId]/grade

Request Body:

{
  "qualityGrade": "A" | "B" | "C",
  "rejectionReason": "string" // Required for Grade C
}

Response:

{
  "success": true,
  "video": {
    "id": "string",
    "qualityGrade": "A" | "B" | "C",
    "gradeAssignedBy": "string",
    "gradeAssignedAt": "ISO8601",
    "rejectionReason": "string?"
  },
  "message": "Video graded {grade} successfully"
}

Get Video Grade

GET /api/videos/[videoId]/grade

Returns the current grade information for a video.

Database Schema

Video Model Extensions

model Video {
  // ... existing fields
  qualityGrade     VideoQualityGrade?
  gradeAssignedBy  String?
  gradeAssignedAt  DateTime?
  rejectionReason  String?
}
 
enum VideoQualityGrade {
  A
  B
  C
}

Talent Model Extensions

model Talent {
  // ... existing fields
  primaryVideoGrade VideoQualityGrade?
}

Email Notifications

Grade C Rejection Email

Sent automatically when a video receives Grade C, includes:

• Clear explanation of Grade C meaning
• Specific feedback from admin
• Tips for improvement
• Links to quality guidelines and dashboard

Template: emails/video-quality-rejection-email.tsx

Implementation Details

Visibility Enforcement

• Grade C videos have status set to REJECTED
• Recruiter endpoints filter: qualityGrade != 'C' OR qualityGrade IS NULL
• Admin endpoints show all grades for moderation

Primary Video Grade

When a video is graded, the talent's primaryVideoGrade is updated to the best grade across all their videos (A > B > C).

Analytics Events

Logged events for tracking:

• VIDEO_GRADE_ASSIGNED: When any grade is assigned
• VIDEO_GRADE_REJECTED: When Grade C is assigned
• VIDEO_GRADE_EMAIL: When notification email is sent

Best Practices

For Admins

1. Review videos promptly (within 24-48 hours)
2. Provide specific, actionable feedback for Grade C
3. Be consistent with grading standards
4. Use rejection reasons to help talents improve

For Talents

1. Follow pre-upload guidelines
2. Review rejection feedback carefully
3. Improve and resubmit rejected videos
4. Focus on professional, high-quality footage

Future Enhancements

Planned improvements:

• Guardian notification integration
• Automated quality checks using AI
• Grade appeal process
• Quality trend analytics
• Bulk grading tools
• Grade A filter in recruiter search

Troubleshooting

Video not visible to recruiters

• Check if video has Grade C
• Verify video status is APPROVED
• Ensure video is associated with a public talent profile

Grade not updating

• Verify admin permissions
• Check for required rejection reason on Grade C
• Review browser console for API errors

Related Documentation

• Video Upload
• Admin Moderation
• Recruiter Dashboard