Scholar Lane Academy System Requirements Document

1. Introduction

Scholar Lane Academy is embarking on a transformative project to develop "The MBBS Planner," Pakistan's first AI-powered MBBS Accountability Dashboard. This web application aims to digitize and scale the manual processes currently employed by Scholars Lane, providing a comprehensive solution for MBBS students' accountability and planning.

2. System Overview

The MBBS Planner is a web-based application designed to streamline and enhance the educational experience for MBBS students in Pakistan. It automates daily and weekly planning, progress tracking, and mentor-student interactions, leveraging AI to generate personalized study plans. The application will serve both students and mentors, offering features that facilitate accountability, progress monitoring, and communication.

3. Functional Requirements

• As a Student, I should be able to make a daily morning commitment and an evening check-in to track my progress.
• As a Student, I should be able to view a live streak counter with a badge system (🌱🔥👑) to motivate my progress.
• As a Student, I should be able to see my weekly study plan on a clean dashboard.
• As a Student, I should be able to compare my progress on a leaderboard against my batchmates.
• As a Mentor, I should be able to view all students' streaks in one consolidated view.
• As a Mentor, I should be able to flag students who haven't checked in.
• As a Mentor, I should be able to send batch-wide announcements from a single interface.
• As a Mentor, I should be able to auto-generate monthly progress reports for each student.
• As a Student, I should be able to fill a 5-minute form detailing my year, weak subjects, and available hours per day.
• As a Student, I should receive a personalized weekly study plan generated automatically by the app.

4. User Personas

• Student: An MBBS student in Pakistan looking to enhance their study planning and accountability.
• Mentor: An educator or mentor responsible for overseeing student progress and providing guidance.

5. Core User Flows

• Student Flow:

  • Log in to the application -> Fill out the form with year, weak subjects, and available hours -> Receive a personalized study plan -> Make daily commitments and evening check-ins -> View streak counter and leaderboard -> Access weekly study plan.

• Mentor Flow:

  • Log in to the application -> View students' streaks -> Flag students who haven't checked in -> Send announcements -> Generate monthly progress reports.

6. Visuals Colors and Theme

• primary: #3B7A57 (Olive Green)
• primary_light: #A3C1AD (Light Olive Green)
• secondary: #F5F5DC (Ivory)
• accent: #FF6347 (Tomato Red)
• highlight: #FFD700 (Gold)
• bg: #FFFFFF (White)
• surface: rgba(59, 122, 87, 0.8)
• text: #333333 (Dark Gray)
• text_muted: #777777 (Muted Gray)
• border: rgba(59, 122, 87, 0.2)

7. Signature Design Concept

The homepage of "The MBBS Planner" will feature an interactive 3D virtual study desk using @react-three/fiber and @react-three/drei. Students will navigate through their dashboard by interacting with objects on the desk. For example, clicking on a notebook opens the study plan, while a clock shows streaks and progress. The desk will change from day to night, reflecting the student's study time, with ambient sounds enhancing the immersive experience. This interactive environment will make the application engaging and intuitive, encouraging regular use.

8. Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, creating a layered depth effect as users scroll. Decorative elements like floating books and pens will move at different speeds, providing a dynamic and engaging first impression. Internal pages will adopt a "static" model to ensure clarity and focus on content, with minimal motion to maintain readability.

9. Non-Functional Requirements

• The application must be accessible via any modern web browser.
• The system should support a minimum of 1,000 concurrent users.
• Data privacy and security must comply with local regulations.
• The application should load within 3 seconds on a standard internet connection.

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• AI Models: GPT 5.4 for user-friendly responses, Claude 4.6 Opas for academic work
• AI Tools: Litellm for LLM Routing, Langchain
• Orchestration: Docker, docker-compose, Kubernetes

11. Assumptions and Constraints

• The application will initially be used internally by Scholars Lane Academy.
• The system will later be licensed to other academies and tutors.
• The pricing model will be PKR 5,000–15,000/month per academy.
• The application will offer a free "lite" version for broader accessibility.

12. Glossary

• MBBS: Bachelor of Medicine, Bachelor of Surgery
• Streak: A continuous record of daily commitments and check-ins
• Leaderboard: A ranking system comparing students' progress
• AI: Artificial Intelligence
• LLM: Large Language Model