SCA Grading System Documentation

Complete guide for using the catalytic converter grading system

Back to Admin

🚀 Getting Started

👨‍💼 Admin Guide

🔧 Technical

🚀 Quick Start

For Graders (End Users)

  1. Click on the grading link provided to you
  2. Wait for images to load (this may take a moment)
  3. Review each catalytic converter image carefully
  4. Select your grading decision: AM, Not AM, or ?
  5. Submit your grades when complete

For Administrators

  1. Access the Admin Panel
  2. Generate grading sessions for users
  3. Share the generated links with graders
  4. Monitor session status and manage users

🏗️ System Overview

The SCA Grading Confirmation System is a web-based application for reviewing and grading catalytic converter images. It uses session-based authentication to provide secure, temporary access to grading interfaces.

🔑 Key Features

  • • Session-based authentication (no passwords needed)
  • • Mobile-responsive grading interface
  • • Batch grade submission
  • • Real-time progress tracking
  • • Admin panel for session management

🛡️ Security

  • • UUID-based session tokens
  • • Configurable session expiration
  • • Session deactivation capability
  • • No sensitive data in client storage

📖 User Guide

Grading Interface

Grading Options:

AM - Aftermarket catalytic converter
Not AM - Original Equipment Manufacturer (OEM)
? - Uncertain/Unable to determine

Tips for Accurate Grading

  • Take time to examine each image carefully
  • Look for manufacturer markings and part numbers
  • Consider the overall condition and appearance
  • Use "?" when uncertain rather than guessing
  • Images can be zoomed or viewed in higher resolution if needed

Session Behavior

  • • Sessions are temporary and will expire based on administrator settings
  • • Your progress is automatically saved as you work
  • • You can close and reopen your session link to continue where you left off
  • • Once submitted, grades cannot be modified
  • • Contact your administrator if you encounter any issues

👨‍💼 Session Management

Creating Sessions

Single Session

  1. Enter user identifier (email recommended)
  2. Select expiration period (1-30 days)
  3. Click "Generate Link"
  4. Copy and share the generated link

Bulk Sessions

  1. Enter multiple user identifiers (one per line)
  2. Select expiration period for all sessions
  3. Click "Generate Bulk Links"
  4. Copy individual links or email templates

Managing Sessions

  • View All Sessions: See all database sessions with status indicators
  • Session Status: ACTIVE (green) or INACTIVE (gray) indicators
  • Deactivate Sessions: Immediately disable access to active sessions
  • Copy Session IDs: Use "Copy ID" buttons for session management
  • Monitor Progress: Check session validation and usage status

🔧 API Reference

Session Endpoints

# Create Session
POST /api/python/api/v1/sessions
Content-Type: application/json

{
  "user_identifier": "user@example.com",
  "expires_in_days": 7,
  "metadata": {
    "created_by": "admin-interface"
  }
}

# Validate Session
GET /api/sessions/{sessionId}/validate

# Deactivate Session
POST /api/python/api/v1/sessions/{sessionId}/deactivate

Grading Endpoints

# Submit Batch Grades
POST /api/python/api/v1/grading/sessions/{sessionId}/batch
Content-Type: application/json

[
  {
    "image_name": "catalytic_001.jpg",
    "box_uid": "12345",
    "grade": "AM",
    "catalytic_id": 1
  }
]

🛠️ Troubleshooting

Common Issues

"Session not found" Error

  • • Check that the session URL is complete and unmodified
  • • Verify the session hasn't expired
  • • Contact administrator to check session status

Images Not Loading

  • • Check internet connection
  • • Try refreshing the page
  • • Clear browser cache and cookies
  • • Try a different browser or device

Grade Submission Failed

  • • Ensure all required grades are selected
  • • Check network connection
  • • Try submitting again
  • • Contact administrator if problem persists

Getting Help

If you need assistance:

  • • Contact your system administrator
  • • Provide your session ID when reporting issues
  • • Include any error messages you see
  • • Note the time when the issue occurred

🏗️ System Architecture

Technology Stack

Frontend

  • • Next.js 15 (React Framework)
  • • TypeScript (Type Safety)
  • • Tailwind CSS (Styling)
  • • React Query (Data Management)

Backend

  • • Python API (Business Logic)
  • • PostgreSQL (Database)
  • • CDN (Image Storage)
  • • Next.js API Routes (Proxy Layer)

Data Flow

1. Admin creates session → Python API → Database
2. User accesses grading link → Session validation
3. Catalytic data loaded → Images from CDN
4. Grades submitted → Python API → Database
5. Success notification → Cache updated

Security Features

  • • UUID-based session tokens (cryptographically secure)
  • • Session expiration enforcement
  • • No sensitive data in client-side storage
  • • Input validation and sanitization
  • • CORS protection and secure headers
SCA Grading Confirmation System Documentation
Last updated: February 2024