Features

​

Platform features

​

Test creation and management

​

Rich question editor

// TipTap editor configuration
import { useEditor } from '@tiptap/react'
import StarterKit from '@tiptap/starter-kit'
import Image from '@tiptap/extension-image'
import Link from '@tiptap/extension-link'
import CodeBlockLowlight from '@tiptap/extension-code-block-lowlight'

const editor = useEditor({
  extensions: [
    StarterKit,
    Image,
    Link,
    CodeBlockLowlight,
    Underline,
    CharacterCount,
  ],
})

​

13+ question types

​

Question library

• Centralized storage: Create questions once, use many times
• Duplication: Copy questions from library to tests
• Organization: Categorize by subject or topic
• Version tracking: Original reference tracking with originalReferenceId

// Question duplication maintains reference
{
  referenceId: "section_xyz",           // Current location
  originalReferenceId: "library_abc",   // Source library
  organizationId: "org_123"
}

​

AI-powered features

​

AI question generation

​

Test administration

​

Scheduling and automation

// Schedule a test for March 1, 2024, 9 AM - 11 AM
await ctx.scheduler.runAt(
  scheduledStartAt,
  internal.internal.test.activateTest,
  { testId }
);

await ctx.scheduler.runAt(
  scheduledEndAt,
  internal.internal.test.deactivateTest,
  { testId }
);

• Automatic activation at scheduled start time
• Automatic deactivation at scheduled end time
• Background job management
• Overlap detection for concurrent test limits
• Job cancellation when schedules change

​

Access control

// Access control configuration
{
  password: "exam2024",
  allowedEmailDomains: ["university.edu", "school.org"],
  allowedIpAddresses: ["192.168.1.0/24", "10.0.0.1"],
  access: "private"
}

​

Duration management

• Test-level duration: Single time limit for entire test
• Section-level durations: Different limits per section
• Pause functionality: Organizers can pause tests
• Time tracking: Monitor time spent on each question

​

Live monitoring

​

Real-time presence tracking

// Real-time monitoring with Convex subscriptions
const presence = useQuery(
  api.organizer.testMonitoring.getTestPresence,
  { testId }
);

const activeParticipants = presence?.activeParticipants ?? [];
const completedCount = presence?.completedCount ?? 0;

• Participants send heartbeats every 30 seconds
• Presence expires after 2 minutes of inactivity
• Tracks connection drops and returns

​

Grading and results

​

Automatic grading

• Multiple choice
• Yes/No
• Image choice
• Audio choice
• Matching pairs
• Ranking (with configurable scoring)

// Automatic grading on submission
const score = await autoGradeAnswer({
  question,
  answer,
  type: question.type
});

​

Manual grading

• Text field responses
• File uploads
• Audio responses
• Video responses
• Fill in the blank (semi-automatic)

​

Advanced analytics

​

Organization features

​

Multi-tenancy

• Multiple organizations: Users can belong to many organizations
• Role-based access: Owner, Admin, Member roles
• Team collaboration: Multiple organizers per organization
• Organization switching: Easy switching between organizations

// Organization structure
{
  organization: {
    name: "Springfield High School",
    type: "education",
    logoUrl: "..."
  },
  members: [
    { role: "owner", userId: "user_1" },
    { role: "admin", userId: "user_2" },
    { role: "member", userId: "user_3" }
  ]
}

​

Team invitations

• Email-based invitations via Plunk
• Token-based security (7-day expiry)
• Role assignment on invitation
• Bulk invitation support

​

User groups

• Create groups (classes, departments, cohorts)
• Bulk email management
• Assign entire groups to tests
• Track group performance

​

Subscription plans

​

Plan comparison

​

Notifications

• Similar events grouped together
• “5 participants joined your test”
• Reduces notification fatigue
• Per-organizer read status

• Participant joined test
• Test submission completed
• Grading required
• Test scheduled start/end
• Organization invitations
• System updates

• Enable/disable by notification type
• Category-based settings
• Per-organizer configuration

​

File management

​

Cloudflare R2 integration

// File upload flow
import { r2 } from './common/storage';

// 1. Generate upload URL
const uploadUrl = await r2.generateUploadUrl(ctx);

// 2. Client uploads to R2
// ... client-side upload ...

// 3. Save public URL
const publicUrl = keyToPublicUrl(fileKey);

• Question images and media
• Answer file uploads
• Audio/video responses
• Organization logos
• Editor media embeds

​

Data management

​

Soft deletes

// Soft delete pattern
await ctx.db.patch(testId, {
  deletedAt: Date.now()
});

// Query excludes soft-deleted items
.filter(q => q.eq(q.field("deletedAt"), undefined))

• Data recovery possible
• Audit trail preservation
• Referential integrity maintained
• Gradual cleanup options

​

Activity logging

• Test creation, updates, deletion
• Participant actions
• Grading activities
• Settings changes
• Access control modifications