# Question JSON Format Documentation

When uploading a full JSON structure for an Examination from the Admin Panel, the `questions` array inside each section must be perfectly structured. This document illustrates how to structure questions for different types: **Single Choice**, **Multiple Choice (Multi-Correct)**, **Numerical**, and **Subjective**.

> [!WARNING]
> The database strictly expects `correct_answer` to be a JSON object, usually in the format `{"value": <answer>}`. Do not provide a raw string or array.

## 1. Single Choice (Objective)
The standard four-option multiple choice question with one correct answer.

```json
{
  "id": "q1-uuid-here",
  "topic": "Physics",
  "subtopic": "Kinematics",
  "subject": "Physics",
  "type": "Single_Choice",
  "question_text": "A car accelerates from rest to 20 m/s in 5 seconds. What is its acceleration?",
  "question_text_hi": "एक कार 5 सेकंड में आराम से 20 मीटर/सेकंड तक गति पकड़ती है। इसका त्वरण क्या है?",
  "options": {
    "A": "4 m/s²",
    "B": "5 m/s²",
    "C": "2 m/s²",
    "D": "10 m/s²"
  },
  "options_hi": {
    "A": "4 m/s²",
    "B": "5 m/s²",
    "C": "2 m/s²",
    "D": "10 m/s²"
  },
  "correct_answer": {
    "value": "A"
  },
  "solution_text": "Using v = u + at, we get 20 = 0 + a(5) => a = 4 m/s².",
  "solution_text_hi": "v = u + at का उपयोग करने पर, हमें 20 = 0 + a(5) => a = 4 m/s² प्राप्त होता है।",
  "language": "English"
}
```

## 2. Multiple Choice (Multi-Correct)
A question where more than one option is correct. The user will be able to select multiple checkboxes.

```json
{
  "id": "q2-uuid-here",
  "topic": "Mathematics",
  "subtopic": "Calculus",
  "subject": "Mathematics",
  "type": "Multiple_Choice",
  "question_text": "Which of the following functions are continuous at $x = 0$?",
  "question_text_hi": "निम्नलिखित में से कौन से फलन $x = 0$ पर सतत हैं?",
  "options": {
    "A": "$f(x) = |x|$",
    "B": "$f(x) = \\frac{1}{x}$",
    "C": "$f(x) = x^2$",
    "D": "$f(x) = \\tan(x)$"
  },
  "options_hi": {
    "A": "$f(x) = |x|$",
    "B": "$f(x) = \\frac{1}{x}$",
    "C": "$f(x) = x^2$",
    "D": "$f(x) = \\tan(x)$"
  },
  "correct_answer": {
    "value": ["A", "C", "D"]
  },
  "solution_text": "$|x|$, $x^2$, and $\\tan(x)$ are continuous at $x = 0$. $\\frac{1}{x}$ is undefined.",
  "language": "English"
}
```

## 3. Numerical (Fill in the blanks)
A question expecting a purely numerical value as an answer. The UI renders a single-line input box.

```json
{
  "id": "q3-uuid-here",
  "topic": "Chemistry",
  "subtopic": "Thermodynamics",
  "subject": "Chemistry",
  "type": "Numerical",
  "question_text": "Calculate the work done (in Joules) when a gas expands from 1L to 3L against a constant external pressure of 1 atm. (Use $1 L \\cdot atm = 101.3 J$)",
  "question_text_hi": "1 atm के निरंतर बाहरी दबाव के खिलाफ 1L से 3L तक गैस के विस्तार पर किए गए कार्य (जूल में) की गणना करें।",
  "options": null,
  "options_hi": null,
  "correct_answer": {
    "value": "-202.6"
  },
  "solution_text": "$W = -P_{ext} \\Delta V = -1 \\text{ atm} \\times (3L - 1L) = -2 \\text{ L atm} = -202.6 \\text{ J}$",
  "language": "English"
}
```

## 4. Subjective
A question expecting a long descriptive text or derivation. The UI renders a large text area.
Note: For subjective questions, the backend awards points if the submitted text is greater than 5 characters (since manual grading is required for strict correctness).

```json
{
  "id": "q4-uuid-here",
  "topic": "Physics",
  "subtopic": "Electromagnetism",
  "subject": "Physics",
  "type": "Subjective",
  "question_text": "State Gauss's Law in electrostatics and derive the electric field due to an infinitely long straight charged wire.",
  "question_text_hi": "स्थिरविद्युतिकी में गॉस के नियम को बताएँ और एक असीमित लंबे सीधे आवेशित तार के कारण विद्युत क्षेत्र व्युत्पन्न करें।",
  "options": null,
  "options_hi": null,
  "correct_answer": {
    "value": "Subjective"
  },
  "solution_text": "Gauss's law states that the net electric flux through any closed surface is equal to $\\frac{1}{\\varepsilon_0}$ times the net electric charge enclosed within that closed surface...",
  "language": "English"
}
```