Moodle Student Tracker

Moodle Student Tracker is a RAG-based personal academic assistant designed specifically for students at Bilkent University. This innovative tool integrates seamlessly with Telegram to provide a single interface for tracking all academic materials, grades, attendance, and email communications in real-time.

Key Features

Comprehensive Academic Assistance

• Automatically indexes various Moodle course materials, supporting formats such as PDF, DOCX, PPTX, and HTML.
• Provides context-aware answers with filtering capabilities based on enrolled courses and fallback procedures for enhanced accuracy.
• Incorporates tutor and quiz modes to facilitate interactive learning and practice question generation.
• Generates weekly summaries of course content, keeping students informed of key information.

STARS Integration

• Facilitates automatic login via OAuth with SMS two-factor authentication (2FA).
• Displays course-specific grades, exam schedules, attendance details, and academic standings.
• Offers comprehensive access to transcripts summarizing performance across semesters.

Moodle Tracking Features

• Enables automatic synchronization at regular intervals to keep academic information up to date.
• Sends notifications for new assignments and provides reminders for upcoming deadlines three days in advance.
• Supports user-submitted file uploads, indexing documents for personal tracking.

Email Monitoring

• Monitors AIRS and DAIS (department) emails, providing notification of new messages every five minutes, along with LLM summary capabilities for email content.

Advanced Memory and Personalization

• Tracks learning progress and identifies weak topics for review, enhancing personalized learning experiences.
• Maintains conversation history and integrates semantic memory management, which utilizes preferences and goals for a tailored user interaction.

Technical Architecture

Moodle Student Tracker employs a hexagonal architecture with distinct layers for UI adapters, core logic, and external integrations:

• UI Adapters: Main interfaces through Telegram and CLI.
• Core Logic: Responsible for executing business logic, managing memory, and orchestrating RAG (retrieval-augmented generation) processes.
• External Adapters: Interfaces with Moodle Web Services, STARS API, and email protocols to gather and process data efficiently.

Data Flow Overview

The data flow includes mechanisms for real-time user queries, STARS authentication, and background synchronization. The application efficiently processes user inquiries, extracting relevant academic data and providing concise responses via the Telegram platform.

File Structure

The repository structure is organized to facilitate easy navigation and management:

.  
├── telegram_bot.py          # Main Telegram bot (handlers + jobs)  
├── main.py                  # CLI interface (sync, chat, summary, web)  
└── core/                    # Core functionalities and integrations  

For a fully functional experience, users simply set up the environment and initiate the bot or CLI interfaces according to their preferences. This intelligent academic assistant is tailored to empower students with essential tools for achieving academic success, all while ensuring ease of use through Telegram.