🎓 YarlGo

📖 Description

YarlGo is an academic test management platform designed to help students prepare for competitive and high-stakes exams.

It provides a structured and easy-to-use environment with features like:

• 📚 Question Bank
• 📊 Performance Reports
• 👥 Role-Based Access for Students, Faculty, and Admins

⚙️ Tech Stack

• Backend: Django (secure, scalable, and reliable)
• Frontend: HTMX, jQuery, AJAX (dynamic & interactive UI)

With YarlGo, institutions can seamlessly manage exams, organize subjects, and track student performance—while students benefit from personalized reports and an accessible study space.

---

✨ Key Features

YarlGo empowers institutions, faculty, and students with interactive tools for exam preparation.

🔑 Role-Based Access Control

• Admin: Manage users, batches, and monitor overall platform usage.
• Faculty: Create/manage exams, subjects, and add questions to the question bank.
• Students: Access question banks, attempt practice tests, and view personalized reports.

📚 Exam & Subject Management

• Faculty can organize exams into categories and subjects into topics.
• Ensures alignment with institutional curricula.

🗂️ Question Bank

• Faculty can add questions with support for images, equations, and tables.
• Bulk upload via Excel templates for efficiency.
• Students access subject-specific question banks for targeted practice.

📝 Practice Tests

• Faculty can conduct tests using the question bank.
• Students get instant, performance-based reports with metrics like:
  • ⏱️ Average time per question
  • 📊 Topic-wise analysis
  • 👥 Batch-wise comparisons

📊 Dashboards & Reports

• Admins/Faculty: Track user activity, subject engagement, and performance trends.
• Students: View personalized reports to identify strengths & weaknesses.

📖 Course & Batch Management

• Students grouped into batches by exam category.
• Faculty manage subjects, topics, and organize content accordingly.

👤 Profile Management

• Each user has a personal profile page to view/update details.

⚡ Note: Some features are under development and will be expanded in future updates.

---

🛠️ Components

YarlGo is built as a modular Django project, with separate apps for each functionality:

• Accounts App 🧑‍💼 (user management & roles)
• Exams App 📝 (exam creation & management)
• Subjects App 📚 (subject & topic handling)
• Batches App 👥 (student grouping & batch organization)
• Tests App 🧪 (practice tests & reports)

---

⚙️ Installation

1. Clone the repo:
   git clone https://github.com/rohitmendus/YarlGo.git

2. Navigate into the project directory:
   cd YarlGo

3. Setup a virtual environment:

   • Linux/Mac: python -m venv venv && source venv/bin/activate
   • Windows: python -m venv venv && venv\Scripts\activate

4. Install dependencies:
   pip install -r requirements.txt

5. Apply migrations:
   python manage.py makemigrations && python manage.py migrate

6. Load fixtures (initial data):
   Example: python manage.py loaddata admin_user.json

7. Run the server:
   python manage.py runserver

---

📸 Screenshots

---

📄 License

This project is licensed under the GPLv3 License.
See the LICENSE file for full details.

---