User Manual & System Architecture

How to Use CR Quiz

A complete visual guide to the Inter-House Classroom Quiz platform — from quiz creation and Excel question uploads, to the 4-house round-robin quiz format and house-wise result analysis.

View Flowcharts Step-by-Step Guide Get Started
The 4 House Teams
Green House
Blue House
Yellow House
Red House

Questions are assigned round-robin:
Q1 $\rightarrow$ Green, Q2 $\rightarrow$ Blue, Q3 $\rightarrow$ Yellow, Q4 $\rightarrow$ Red

1. Fast Signup
Simple username & password. No complex forms.
2. Excel Upload
Upload 10+ questions in seconds. Select topic via dropdown.
3. Round-Robin Play
Unlimited attempts; every quiz attempt starts fresh from 0 for all houses.
4. House Review
Winner ceremony + house-wise answer inspection with given choices.

Interactive System Flowcharts

Detailed visual process charts of each key workflow in CR Quiz
Mermaid Process Diagrams
Flow Overview: This diagram explains how an educator or student journeys from signing up, authoring questions, running round-robin turns, and seeing the winning house.
flowchart TD Start([User Visits CR Quiz]) --> Register[Register / Login
Simple Username & Password] Register --> Dash[User Dashboard] subgraph Authoring["1. Quiz & Content Authoring"] Dash --> CreateQuiz[Create Quiz
Title & Time Limit] CreateQuiz --> CreateTopic[Create Custom Topic
Isolated to Current User] CreateTopic --> UploadQ[Add Questions
Excel Bulk Upload OR Web Form] end subgraph PlayQuiz["2. Round-Robin Quiz Taking"] UploadQ --> StartAttempt[Start Quiz Attempt
All 4 House Scores Start at 0] StartAttempt --> Q1[Q1: Green House Turn 💚] Q1 --> Q2[Q2: Blue House Turn 💙] Q2 --> Q3[Q3: Yellow House Turn 💛] Q3 --> Q4[Q4: Red House Turn ❤️] Q4 --> NextRound{More Questions?} NextRound -- Yes --> Q1 NextRound -- No --> FinishAttempt[Quiz Completed] end subgraph ResultsReview["3. Scoring & Review"] FinishAttempt --> Leaderboard[House Podium & Winner Award 🏆] Leaderboard --> HouseReview[Review Answers House-Wise
Green / Blue / Yellow / Red] HouseReview --> Retake[Retake Quiz Anytime
Unlimited Attempts & Fresh 0 Scores] end classDef primary fill:#e7f1ff,stroke:#0d6efd,stroke-width:2px,color:#084298; classDef success fill:#d1e7dd,stroke:#198754,stroke-width:2px,color:#0f5132; classDef warning fill:#fff3cd,stroke:#ffc107,stroke-width:2px,color:#664d03; classDef danger fill:#f8d7da,stroke:#dc3545,stroke-width:2px,color:#842029; class Q1 success; class Q2 primary; class Q3 warning; class Q4 danger;
Excel Upload Rules: The Excel template contains Question Text, Option 1-4, Correct Option (1-4), Marks, and Order. The Topic is selected in the web dropdown so templates remain simple and error-free.
flowchart TD A[Dashboard Quizzes] --> B[Click Create Quiz] B --> C[Fill Quiz Form
Title, Time Limit, Image] C --> D[Quiz Saved and Ready] D --> E{Choose Question Entry Method} E -- Method A: Excel Bulk Upload --> F[Download Sample Template] F --> G[Fill Questions in Excel
Question, 4 Choices, Marks] G --> H[Go to Upload Page] H --> I[Select Topic from Dropdown
or Click New Topic] I --> J[Choose XLSX File and Upload] J --> K[Parser Validates and Saves Questions] E -- Method B: Manual Form --> L[Click Add Question] L --> M[Enter Question Text and Image] M --> N[Enter 4 Choices and Mark Correct Choice] N --> O[Save Question] K --> P[Questions Linked to Quiz in Order] O --> P P --> Q[Publish Quiz for Students] classDef step fill:#f0f9ff,stroke:#0284c7,stroke-width:2px,color:#0369a1; class A,B,C,D,P,Q step;
Sequence Logic: Questions automatically rotate across the 4 houses using formula: index % 4: Q1, Q5, Q9 $\rightarrow$ Green | Q2, Q6, Q10 $\rightarrow$ Blue | Q3, Q7 $\rightarrow$ Yellow | Q4, Q8 $\rightarrow$ Red.
flowchart TD StartQuiz[User Clicks Start Quiz] --> InitScores[Initialize Attempt
Green, Blue, Yellow, Red start at 0 pts] InitScores --> LoadQ[Load Current Question] LoadQ --> AssignHouse[Identify Assigned Turn
Q1, Q5, Q9: Green House
Q2, Q6, Q10: Blue House
Q3, Q7: Yellow House
Q4, Q8: Red House] AssignHouse --> PlayerPrompt[Display Question and Choices to House] PlayerPrompt --> UserInput{User Submits Answer} UserInput -- Correct --> ScoreUp[Assigned House Gains Points
e.g. +10 pts] UserInput -- Wrong --> ScoreZero[0 pts to Assigned House
Right Answer Highlighted] UserInput -- Skipped --> ScoreZero ScoreUp --> UpdateLive[Update Live House Standings Bar] ScoreZero --> UpdateLive UpdateLive --> CheckMore{More Questions Remaining?} CheckMore -- Yes --> NextQ[HTMX Loads Next Question Instantly] NextQ --> LoadQ CheckMore -- No --> EndQuiz[Finalize Attempt and Calculate Winner] EndQuiz --> ResultPage[Redirect to Result Page] classDef g fill:#d1e7dd,stroke:#198754,stroke-width:2px; classDef b fill:#cfe2ff,stroke:#0d6efd,stroke-width:2px; class ScoreUp g; class UpdateLive b;
Review Answers Feature: Users can inspect the exact answers given for each house individually or across all houses simultaneously.
flowchart TD ResultLoaded[Quiz Result Page Loaded] --> HeaderCard[Attempt Score and Time Summary] HeaderCard --> Podium[House Podium Cards
Winner Trophy for Highest Scoring House] Podium --> StandingStats[Attempt Score Breakdown
Green, Blue, Yellow, Red Points] StandingStats --> ReviewSection[Review Answers Section] ReviewSection --> TabAll[House-Wise All View
4 Grouped Cards by House Color] ReviewSection --> TabGreen[Green House Tab
Q1, Q5, Q9] ReviewSection --> TabBlue[Blue House Tab
Q2, Q6, Q10] ReviewSection --> TabYellow[Yellow House Tab
Q3, Q7] ReviewSection --> TabRed[Red House Tab
Q4, Q8] ReviewSection --> TabSeq[Sequence Tab Q1-Q10] TabAll --> DetailCard[For Each Question: Shows Given Answer
Correct Answer and Full Choices Breakdown] TabGreen --> DetailCard TabBlue --> DetailCard TabYellow --> DetailCard TabRed --> DetailCard TabSeq --> DetailCard classDef tabStyle fill:#fef3c7,stroke:#d97706,stroke-width:2px,color:#92400e; class TabAll,TabGreen,TabBlue,TabYellow,TabRed,TabSeq tabStyle;
Classroom Quiz Rules: In teacher-led live mode on a projector, questions pass to the next house if answered incorrectly, eliminating wrong options along the way!
flowchart TD TeacherStart[Teacher launches Live Classroom Quiz] --> ProjectorView[Projector Screen Display] ProjectorView --> TurnHouse[Turn directed to House Group
e.g. Green House] TurnHouse --> TeacherAction{Teacher records response} TeacherAction -- Correct --> PointsHouse[+10 Points awarded to Answering House] PointsHouse --> NextTurn[Next Question directed to Next House] TeacherAction -- Wrong --> EliminateOpt[Option eliminated from screen] EliminateOpt --> PassCheck{Two or More Options Remaining?} PassCheck -- Yes --> PassNext[Question PASSES to Next House
Blue House gets chance] PassNext --> TeacherAction PassCheck -- No --> Audience[Only 1 Option Left
Points go to Quiz Master] Audience --> NextTurn NextTurn --> SessionEnd{Session Complete?} SessionEnd -- Yes --> TrophyCelebration[House Winner Trophy and Cheer] SessionEnd -- No --> TurnHouse classDef live fill:#e0e7ff,stroke:#4338ca,stroke-width:2px,color:#312e81; class TeacherStart,ProjectorView,TrophyCelebration live;

Step-by-Step User Manual

Clear instructions for teachers, students, and quiz masters
1
Create an Account or Sign In

Registration has been streamlined. Simply provide a Username and Password.

  • No mandatory email, role, or classroom needed.
  • Once logged in, you immediately land on your personal Quiz Dashboard.
Path: /accounts/register/ or /accounts/login/
2
Create a New Quiz

Quizzes are universal for all 4 house groups by default.

  • Enter your Quiz Title and optional description.
  • Set a Time Limit in minutes (optional).
  • No passing percentage or assigned house restrictions required — quizzes are open and competitive for all houses!
Path: /dashboard/quizzes/add/
3
Add Questions via Excel or Web Form

Easily upload questions in bulk using the clean Excel template:

  • Topic Selection: Select your topic directly on the upload page via dropdown. Topics are isolated so you only see your own!
  • Clean Excel Template: Columns include Question Text, Option 1, Option 2, Option 3, Option 4, Correct Option, Marks.
  • Download the sample .xlsx file directly from the upload page.
Path: /dashboard/questions/upload/
4
Play the Round-Robin Quiz

Start a quiz attempt anytime. Take unlimited attempts!

  • Every quiz attempt starts with 0 points for all houses.
  • Turns rotate in sequence: Q1 $\rightarrow$ Green, Q2 $\rightarrow$ Blue, Q3 $\rightarrow$ Yellow, Q4 $\rightarrow$ Red.
  • The active house banner shows whose turn it is.
  • Instant feedback shows if the answer was correct and marks earned.
Path: /dashboard/quizzes/<id>/take/
5
House Standings & Winner Ceremony

Upon finishing the quiz, the results page displays the live house scores:

  • Top cards highlight points earned by each house in this attempt.
  • The winner house is awarded a golden trophy badge 🏆.
  • Optional collapsible table reveals cumulative all-time quiz standings across all attempts.
Path: /dashboard/result/<attempt_id>/
6
Review Answers House-Wise

Under the results, inspect the given answers organized by house:

  • Interactive Tabs: Filter by House-Wise (All), Green, Blue, Yellow, Red, or Sequence.
  • Given Answer Callout: Directly see what answer was selected, whether it was correct (✔) or wrong (✘), and the right choice.
  • Full breakdown of all choices with clear status badges.
Path: /dashboard/result/<attempt_id>/#answersTab
Frequently Asked Questions

Yes! Users can take quizzes unlimited times. Every new quiz attempt starts with 0 points for all 4 houses, providing a completely fair and independent competition every time.

Questions follow a round-robin rotation based on question sequence:
  • Question 1, 5, 9, 13... $\rightarrow$ Green House
  • Question 2, 6, 10, 14... $\rightarrow$ Blue House
  • Question 3, 7, 11, 15... $\rightarrow$ Yellow House
  • Question 4, 8, 12, 16... $\rightarrow$ Red House

No. Topic isolation is built into the system. You only see topics that you created yourself, keeping your question bank personalized and organized.

To prevent typos and mismatching, the Topic is selected via a clean dropdown menu directly on the upload page before uploading the spreadsheet. The Excel file only contains the question content, 4 choices, correct answer number (1 to 4), and marks.