Skip to main content

Examinations

BrainScore lets you create and manage online examinations. You organize exams by categories, define examinations with timing and pass marks, add questions and answers, and review exam attempts from users.

Where to Find It​

  • Admin Panel → Exam Categories: List, create, edit, delete exam categories
  • Admin Panel → Examinations: List, create, edit, delete examinations
  • Admin Panel → Exam Attempts: View all user attempts (filter by user, search, status)

Exam Categories​

Categories group your examinations (e.g., "Mathematics", "English", "Science").

List​

  • View all categories with search (by name) and status filter (active/inactive)
  • Statistics: total, active, and inactive categories

Create Category​

  1. Go to Exam Categories → Create
  2. Name *: Unique category name
  3. Image *: Upload image (JPEG, PNG, JPG, GIF, SVG, max 2MB)
  4. Save. New categories are created as active

Edit / Delete​

  • Edit: Change name, image, or status (active/inactive)
  • Delete: Removes the category (ensure no examinations use it if your app enforces that)

Examinations​

An examination is a single test: title, description, duration, number of questions, pass mark, subjects, and date range.

List​

  • Filter by search (title), category, and status (active/inactive)
  • Statistics: total, active, inactive examinations

Create Examination​

  1. Go to Examinations → Create
  2. Image *: Cover image (JPEG, PNG, JPG, GIF, SVG, max 2MB)
  3. Category *: Select an exam category
  4. Title *: Unique examination title
  5. Description: Optional text
  6. Duration (minutes) *: Time limit for the exam (e.g., 60)
  7. Total questions *: Number of questions (e.g., 20)
  8. Pass mark (%) *: Pass threshold 0–100 (e.g., 60)
  9. Subjects *: At least one subject (e.g., "Algebra", "Grammar"). You can add multiple; they are created or reused
  10. Started at *: When the exam becomes available (date/time)
  11. Result published at *: When results are published (must be after Started at)
  12. Instant result: If enabled, users see results immediately after submission (within your app logic)
  13. Status: Active or inactive
  14. Save

Edit / Delete​

  • Edit: Update any of the above fields (image optional on edit)
  • Delete: Removes the examination (consider impact on attempts and certificates)

Questions and Answers​

Each examination has a set of questions. You add them from the examination’s Questions section (e.g., from the examination list, open an exam and go to its questions).

Question Types​

  • Single choice: One correct answer (exactly one must be marked correct)
  • Multiple choice: One or more correct answers
  • True/False: Exactly two answers, one marked correct
  • Fill in the blank: One correct answer (the expected fill-in value)

Add Question Manually​

  1. Open the examination → Questions → Create (or equivalent)
  2. Type *: single_choice, multiple_choice, true_false, or fill_blank
  3. Content *: Question text
  4. Explanation: Optional (shown when you support it, e.g., after result)
  5. Status: Active/inactive
  6. Answers:
    • For each option: Content * and Is correct (checkbox)
    • Rules:
      • Single choice: exactly one correct
      • Multiple choice: at least one correct
      • True/False: exactly two answers, one correct
      • Fill in the blank: exactly one correct answer
  7. Save

Generate Questions with AI​

BrainScore can generate questions and answers using Prompts and LLM Providers:

  1. Open the examination → go to the Generate with AI (or similar) option
  2. Choose Question type, Prompt, and LLM Provider
  3. Fill any input variables required by the prompt (e.g., topic, difficulty)
  4. Generate; review the suggested question and answers
  5. Edit if needed and save to add to the examination

You need at least one active Prompt and one active LLM Provider (with API key) configured. The default LLM provider is used if you do not select one.

Edit / Delete Question​

  • Edit: Change type, content, explanation, status, or answers (correct answers must still match the type rules)
  • Delete: Removes the question and its answers

Exam Attempts​

Users take examinations from the frontend. Each submission is recorded as an exam attempt.

View Attempts​

  • Admin Panel → Exam Attempts
  • List shows: user, examination, score, status, time, etc.
  • Filters:
    • By user (user ID)
    • By search (user email, first name, last name, or examination title)
    • By status (e.g., in progress, completed, failed)

Attempt Statuses​

  • In progress: User started but has not submitted
  • Completed: User submitted the exam
  • Failed: Marked failed (e.g., did not meet pass mark or rule in your app)

Use this list to monitor participation, scores, and to troubleshoot user issues.

Summary​

AreaWhat you do
Exam CategoriesCreate categories and assign an image; activate/deactivate
ExaminationsSet title, duration, pass mark, dates, subjects; activate/deactivate
QuestionsAdd/edit/delete questions and answers; use AI generation with Prompts + LLM
Exam AttemptsView and filter all user attempts and scores

For AI-generated questions, configure Prompts and LLM Providers in the admin panel first (see Prompts and LLM Providers).