Admin Guide
Content management and course administration

๐Ÿ“– Introduction

Welcome to the Thinkster Learning Platform Admin and Instructor Guide! This comprehensive documentation will help you manage courses, create content, monitor student progress, and utilize all administrative features of the platform.

๐Ÿ“Œ Who is this guide for? This guide is designed for administrators, instructors, and content authors who need to manage courses, create educational content, and oversee student learning.

Admin Roles & Permissions

Role Description Key Permissions
Super Admin Platform-wide administrator Full access to all features, organizations, and settings
Organization Admin Manages a specific organization Manage courses, users, and settings within organization
Instructor Teaches and manages courses Create/edit courses, view student progress, grade assignments
Author Creates content and courses Create and edit course content, lessons, and assessments

Platform Capabilities

๐Ÿ“š Course Management

Create, organize, and manage comprehensive courses with modules and activities

๐Ÿ“ Content Creation

Build interactive lessons with videos, text, quizzes, and GeoGebra widgets

๐Ÿ‘ฅ Student Management

Enroll students, create classes, and monitor individual progress

๐Ÿ“Š Analytics & Reports

Track performance metrics, engagement, and learning outcomes

๐Ÿงช Assessment Engine

AI-powered adaptive assessments with automatic grading

๐Ÿง  Learning Journey

HMM-based personalized learning paths and recommendations

๐Ÿš€ Getting Started

System Requirements

  • Browser: Chrome, Firefox, Safari, or Edge (latest versions recommended)
  • Internet Connection: Stable broadband connection
  • Screen Resolution: Minimum 1280x720, 1920x1080 recommended
  • JavaScript: Must be enabled

Before You Begin

Ensure you have:

  1. Admin credentials provided by your platform administrator
  2. Access to your registered admin email address
  3. Understanding of your role and permissions
  4. List of courses or content you need to manage
๐Ÿ’ก Pro Tip: Bookmark the admin dashboard URL for quick access. Keep your credentials secure and use a password manager for safety.

๐Ÿ” Admin Login

Accessing the Admin Portal

The admin login is separate from the student login to ensure secure access to administrative features.

Step 1: Navigate to Admin Login

Open your web browser and go to the admin login page:

https://your-platform-url.com/admin-auth/login

Or click the "Admin" link on the homepage.

Admin Login Page
Figure 1: Thinkster Admin Login Screen

Step 2: Enter Admin Credentials

  1. In the Email field, enter your admin email address (e.g., teacher1@thinkster.test)
  2. In the Password field, enter your secure password
  3. Click the "Login" button to proceed
๐Ÿ“Œ Authentication: The system verifies your credentials and checks your role permissions before granting access to the admin dashboard. Only users with admin, instructor, author, or super_admin roles can access the admin portal.

Login Process Details

  • Email Format: Must be a valid email address registered in the system
  • Password Security: Passwords are encrypted and validated securely
  • Session Management: Your session remains active for security purposes
  • Role-Based Access: Different admin roles see different features

First-Time Login

Initial Setup Steps

  1. Use the temporary credentials provided by your system administrator
  2. Log in to the admin portal
  3. You may be prompted to change your password
  4. Set a strong password (minimum 8 characters, mix of letters, numbers, symbols)
  5. Complete any required profile information
  6. Familiarize yourself with the admin dashboard layout

Password Reset

If You Forgot Your Password:

  1. Click the "Forgot password?" link on the login page
  2. Enter your registered admin email address
  3. Click "Send Reset Link"
  4. Check your email inbox for the password reset link
  5. Click the link (valid for 24 hours)
  6. Enter your new password twice to confirm
  7. Click "Reset Password"
  8. Return to the login page and sign in with your new password
โš ๏ธ Security Notice:
  • Never share your admin credentials with anyone
  • Use a unique, strong password for your admin account
  • Log out when using shared computers
  • Report any suspicious activity immediately
  • After 5 failed login attempts, your account will be temporarily locked for security

Access Navigation

At the bottom of the login screen, you'll see:

  • "โ† Back to student login" - Returns to the student login page
  • This allows instructors who are also students to switch between interfaces

Troubleshooting Login Issues

Problem Solution
Invalid credentials error Double-check email and password. Ensure Caps Lock is off. Try password reset.
Account not found Verify you're using the correct email. Contact system administrator to confirm admin access.
Access denied message Your account may not have admin permissions. Contact system administrator.
Account locked Wait 15 minutes or contact system administrator to unlock your account.
Page won't load Check internet connection. Clear browser cache. Try incognito mode.
๐Ÿ’ก Best Practices:
  • Bookmark the admin login page for quick access
  • Use a password manager to securely store credentials
  • Enable browser auto-fill for faster login (on secure devices only)
  • Keep your email account secure as it's used for password recovery

๐Ÿ  Admin Dashboard

After successfully logging in, you'll be redirected to the admin dashboard - your control center for managing the learning platform.

Admin Dashboard
Figure 2: Admin Dashboard Overview

Dashboard Layout

The admin dashboard is organized into several key areas:

1. Header Section

  • Admin Space Badge: Indicates you're in the administrative area
  • Course Management Title: Main heading showing current section
  • Action Buttons:
    • โœจ Generate with AI - Create courses using AI assistance
    • + Create Course - Manually create a new course

2. Admin Stats Cards

Key metrics displayed at the top of the dashboard:

๐Ÿ“š Total Courses

Number of courses you manage

๐Ÿ‘ฅ Active Students

Total enrolled students across all courses

โœ… Completion Rate

Average course completion percentage

๐Ÿ“Š Recent Activity

Student engagement in last 7 days

3. Course Management Table

The main table displays all courses with:

Column Description
Course Name Title and brief description of the course
Status Published (live) or Draft (not visible to students)
Enrolled Students Number of students currently enrolled
Modules Number of modules in the course
Activities Total lessons, quizzes, and other activities
Last Modified Date and time of last update
Actions Quick action buttons (Edit, View, Delete, etc.)

Navigation Sidebar

The left sidebar provides quick access to all admin features:

  • ๐Ÿ“š Courses: Main course management (current page)
  • ๐Ÿ‘ฅ Students: Student enrollment and progress tracking
  • ๐Ÿ“ Classes: Organize students into groups
  • ๐Ÿข Organizations: Manage organization settings
  • ๐Ÿ“Š Analytics: View detailed reports and insights
  • ๐Ÿงช Assessments: Create and manage adaptive tests
  • ๐Ÿ“– Content Resources: Manage PDFs and learning materials
  • โš™๏ธ Settings: Configure platform settings
๐Ÿ’ก Dashboard Tips:
  • Use the search bar to quickly find specific courses
  • Filter courses by status (Published/Draft) or organization
  • Click on any course name to view detailed statistics
  • Stats cards update in real-time as students engage with content

Quick Actions

Common Dashboard Tasks:

  1. Create a New Course: Click "Create Course" button
  2. Edit Existing Course: Click "Edit" button in course table row
  3. View Course Details: Click on the course name
  4. Publish Draft Course: Use the status toggle in the course row
  5. View Student Progress: Navigate to Students section

๐Ÿ“š Course Management

This section covers creating, organizing, and managing courses on the platform.

Creating a New Course

Method 1: Manual Course Creation

  1. From the admin dashboard, click + Create Course
  2. Fill in the course details form:
    • Course Title: Clear, descriptive name (e.g., "Algebra 1 - Introduction")
    • Description: Brief overview of what students will learn
    • Grade Level: Target student grade or age group
    • Subject: Math, Science, Language Arts, etc.
    • Organization: Select which organization owns this course
  3. Click "Create Course" to save
  4. The course is created in Draft status (not visible to students)
Create Course Form
Figure 3: Course Creation Form

Method 2: AI-Powered Course Generation

  1. Click โœจ Generate with AI button
  2. Enter your course requirements:
    • Topic/Subject: What the course is about
    • Learning Objectives: What students should achieve
    • Grade Level/Difficulty: Target audience
    • Number of Modules: Suggested course structure
  3. AI generates a complete course outline with modules and activities
  4. Review and edit the generated structure
  5. Click "Create Course" to save
๐Ÿ“Œ AI Generation: The AI uses OpenAI GPT 5.2 to create comprehensive course structures based on educational best practices and curriculum standards. You can always edit the generated content.

Course Structure

Courses are organized hierarchically:

  • Course: Top-level container (e.g., "Algebra 1")
  • Modules: Units or chapters within a course (e.g., "Linear Equations")
  • Activities: Individual learning items within modules
    • ๐Ÿ“น Video Lessons
    • ๐Ÿ“– Text Lessons
    • โœ๏ธ Quizzes and Assessments
    • ๐Ÿงฎ Interactive Activities (GeoGebra)
    • ๐Ÿ“„ Resources (PDFs, worksheets)

Adding Modules to a Course

Step-by-Step:

  1. Open your course from the dashboard
  2. Navigate to the "Modules" tab
  3. Click + Add Module
  4. Enter module details:
    • Module Title: Name of the unit
    • Description: What this module covers
    • Order: Sequence number (auto-increments)
  5. Click "Save Module"
Course Modules View
Figure 4: Module Management Interface

Adding Activities to Modules

Creating Activities:

  1. Select a module from your course
  2. Click + Add Activity
  3. Choose activity type (Lesson, Quiz, Video, etc.)
  4. Fill in activity details (see Content Creation section for details)
  5. Set activity order within the module
  6. Click "Save Activity"

Course Settings

Configure important course options:

Setting Options Description
Status Draft / Published Draft courses are only visible to admins
Visibility Public / Private Public courses appear in catalog, Private require enrollment
Sequential Yes / No Require students to complete activities in order
Self-Enrollment Enabled / Disabled Allow students to enroll themselves
Prerequisites Select courses Required courses before enrollment

Managing Course Content

Reordering Content

  • Drag and drop modules to reorder them
  • Drag activities within modules to change sequence
  • Use arrow buttons for precise ordering

Duplicating Content

To Clone a Course or Module:

  1. Click the "โ‹ฎ" menu next to the course/module
  2. Select "Duplicate"
  3. Edit the name and settings
  4. Save the duplicate

Publishing a Course

โš ๏ธ Before Publishing:
  • Review all content for accuracy
  • Test all interactive elements
  • Verify quiz questions and answers
  • Check that modules are in logical order
  • Ensure all required metadata is complete

To Publish a Course:

  1. Open the course in edit mode
  2. Go to "Settings" tab
  3. Change status from "Draft" to "Published"
  4. Click "Save Changes"
  5. Course is now visible to enrolled students
๐Ÿ’ก Best Practices:
  • Start with a clear course outline before creating content
  • Use consistent naming conventions for modules and activities
  • Include a mix of activity types for engagement
  • Add estimated time for each activity to help students plan
  • Keep courses focused - consider breaking large topics into separate courses
  • Use the AI generation as a starting point and customize for your needs

๐Ÿ“ Content Creation

Learn how to create engaging educational content including lessons, quizzes, and interactive activities.

Activity Types Overview

The platform supports multiple types of learning activities:

๐Ÿ“น Video Lessons

Upload or embed video content with automatic progress tracking

๐Ÿ“– Text Lessons

Rich text content with LaTeX math, images, and formatting

โœ๏ธ Quizzes

Multiple choice, true/false, short answer, and essay questions

๐Ÿงฎ Interactive Activities

GeoGebra widgets and other interactive learning tools

Creating a Text Lesson

Step-by-Step:

  1. Navigate to the module where you want to add the lesson
  2. Click + Add Activity
  3. Select "Lesson" as the activity type
  4. Fill in the lesson details:
    • Title: Clear, descriptive name
    • Type: Select "text" for text-based lesson
    • Estimated Time: How long students need
  5. Use the content editor to create your lesson
  6. Click "Save"
Lesson Editor
Figure 5: Lesson Content Editor

Content Editor Features

Rich Text Formatting

  • Text Styles: Bold, italic, underline, strikethrough
  • Headings: H1, H2, H3 for structure
  • Lists: Bullet points and numbered lists
  • Links: Add hyperlinks to resources
  • Code Blocks: Format code snippets

Math Equations (LaTeX)

Add mathematical equations using LaTeX syntax:

  • Inline Math: Use $equation$ for inline equations
  • Display Math: Use $$equation$$ for centered equations
  • Examples:
    • Inline: $x^2 + y^2 = r^2$
    • Display: $$\frac{-b \pm \sqrt{b^2-4ac}}{2a}$$
๐Ÿ“Œ LaTeX Support: The platform uses KaTeX for fast, beautiful math rendering. Common LaTeX commands are supported.

Images and Media

Adding Images:

  1. Click the "Insert Image" button in the editor
  2. Upload an image file (PNG, JPG, GIF)
  3. Add alt text for accessibility
  4. Adjust size and alignment
  5. Insert into content

Creating Interactive Widgets

GeoGebra Integration

Embed interactive math visualizations:

Adding GeoGebra Widget:

  1. Create or find your GeoGebra activity on geogebra.org
  2. Copy the material ID from the URL
  3. In the lesson editor, add a GeoGebra widget block
  4. Paste the material ID
  5. Configure settings:
    • Width and height
    • Show/hide toolbar
    • Enable/disable specific tools
  6. Preview and save

Creating Quizzes

Manual Quiz Creation:

  1. Add a new activity and select type "Quiz"
  2. Configure quiz settings:
    • Time Limit: Optional time constraint
    • Passing Score: Minimum percentage to pass
    • Attempts: Number of retakes allowed
    • Show Answers: Display correct answers after submission
    • Randomize: Shuffle question and answer order
  3. Click "Add Question" to start adding questions

Question Types

Type Use Case Auto-Graded
Multiple Choice Single correct answer from options โœ… Yes
True/False Binary choice questions โœ… Yes
Short Answer Brief text responses โš ๏ธ Partial (AI-assisted)
Essay Extended written responses ๐Ÿค– AI Feedback + Manual Review
Fill-in-the-Blank Complete missing words โœ… Yes
Code Challenge Programming problems โœ… Yes (test cases)

Adding a Multiple Choice Question

Step-by-Step:

  1. Click "Add Question" and select "Multiple Choice"
  2. Enter the question text (supports LaTeX math)
  3. Add answer options:
    • Type each possible answer
    • Mark the correct answer(s)
    • Optionally add explanations for each option
  4. Set question points (default: 1)
  5. Assign to concepts/topics (for learning analytics)
  6. Click "Save Question"
Quiz Question Editor
Figure 6: Quiz Question Editor

AI-Powered Assessment Creation

The platform includes an advanced AI assessment engine:

Creating Adaptive Assessments:

  1. Navigate to Admin โ†’ Assessments
  2. Click + Create Assessment Template
  3. Configure template:
    • Topic: What the assessment covers
    • Objectives: Learning goals to test
    • Question Range: Min/max number of questions
    • Difficulty Range: Easy to Hard scale
  4. Click "Generate Questions"
  5. AI creates questions using Item Response Theory (IRT)
  6. Review and edit generated questions
  7. Save and attach to course
๐Ÿ“Œ Adaptive Testing: AI-generated assessments use 3-parameter IRT model to select questions based on student ability, providing accurate assessment with fewer questions.

Content Standards Alignment

Align your content with educational standards:

  • CCSS (Common Core State Standards): Math K-12
  • Singapore Math: Primary 1-6
  • Map activities to specific standards
  • Track student progress against standards

Aligning Content to Standards:

  1. While editing an activity, go to "Standards" tab
  2. Click "Add Standard"
  3. Search for relevant standards
  4. Select coverage level (Introduced, Reinforced, Mastered)
  5. Save alignment

Content Best Practices

๐Ÿ’ก Creating Effective Content:
  • Clarity: Use clear, concise language appropriate for grade level
  • Structure: Break content into digestible chunks with headings
  • Visuals: Include diagrams, images, and interactive elements
  • Examples: Provide worked examples before practice problems
  • Variety: Mix text, video, and interactive activities
  • Assessment: Include formative checks throughout lessons
  • Accessibility: Add alt text for images, captions for videos
  • Testing: Preview content as a student before publishing
โš ๏ธ Content Review Checklist:
  • โœ“ Spelling and grammar checked
  • โœ“ Math equations render correctly
  • โœ“ All links work and open correctly
  • โœ“ Images load and have alt text
  • โœ“ Interactive widgets function properly
  • โœ“ Quiz answers are correct
  • โœ“ Content matches learning objectives
  • โœ“ Standards alignment is accurate

๐Ÿ‘ฅ Student Management

Manage student enrollments, track progress, and organize classes.

Viewing Students

Access the students section from the admin sidebar:

  1. Click "Students" in the left navigation
  2. View list of all students in your organization
  3. Use search to find specific students
  4. Filter by enrollment status, class, or course
Students List
Figure 7: Students Management Interface

Enrolling Students in Courses

Individual Enrollment:

  1. Go to course details page
  2. Click "Enrollments" tab
  3. Click + Enroll Student
  4. Search and select student(s)
  5. Set enrollment date (default: now)
  6. Click "Enroll"

Bulk Enrollment:

  1. Navigate to Students โ†’ Bulk Actions
  2. Click "Import Students"
  3. Download CSV template
  4. Fill in student information:
    • Email (required)
    • Full name
    • Course IDs to enroll
    • Class assignments
  5. Upload completed CSV
  6. Review and confirm
  7. Students receive welcome emails

Creating and Managing Classes

Classes help organize students into groups (periods, sections, cohorts):

Creating a Class:

  1. Navigate to Admin โ†’ Classes
  2. Click + Create Class
  3. Enter class details:
    • Name: e.g., "Period 3 Algebra"
    • Code: Unique identifier (e.g., "ALG-P3-2026")
    • Grade Level: Target grade
    • School Year: Academic year
  4. Assign courses to the class
  5. Add students to the class
  6. Click "Create Class"
Class Management
Figure 8: Class Management Interface

Tracking Student Progress

Individual Student View

  1. Click on a student name from the students list
  2. View comprehensive dashboard showing:
    • Enrolled Courses: All active enrollments
    • Completion Rate: Overall progress percentage
    • Recent Activity: Last 10 completed activities
    • Quiz Scores: Average and trend over time
    • Time Spent: Total learning time
    • Learning States: HMM-tracked concept mastery

Course-Level Progress

  1. Open a course from admin dashboard
  2. Click "Progress" tab
  3. View class or individual progress:
    • Activities completed per student
    • Quiz scores and attempts
    • Time spent on each module
    • Struggling students (flagged automatically)
Student Progress Dashboard
Figure 9: Student Progress Dashboard

Reviewing Student Submissions

For quizzes and assignments requiring manual grading:

Grading Workflow:

  1. Navigate to Admin โ†’ Reports โ†’ Submissions
  2. Filter by:
    • Course
    • Activity
    • Student
    • Status (pending review, graded)
  3. Click on a submission to review
  4. View student's answers
  5. Read AI-generated feedback (if applicable)
  6. Add instructor feedback and score
  7. Click "Save Grade"
๐Ÿ“Œ AI Assistance: For essay and short answer questions, the AI provides initial feedback and suggested scores. Instructors can accept, modify, or override these suggestions.

Student Actions

Action Description Impact
Reset Progress Clear completion status for activities Student can retake content; scores preserved
Unenroll Remove student from course Loses access; data preserved for records
Extend Deadline Grant more time for assignments Individual deadline adjustment
Reset Quiz Attempts Allow additional quiz retakes Student can attempt quiz again
Send Message Email student directly One-way notification
โš ๏ธ Important: Always communicate with students before resetting their progress or making significant changes to their enrollments.

Identifying At-Risk Students

The platform automatically flags students who may need intervention:

  • Low Engagement: No activity in 7+ days
  • Poor Performance: Quiz average below 60%
  • Struggling States: Multiple concepts in "struggling" learning state
  • Incomplete Work: Multiple overdue assignments
๐Ÿ’ก Student Success Strategies:
  • Monitor the at-risk student dashboard weekly
  • Reach out proactively to struggling students
  • Use HMM learning journey data to identify concept gaps
  • Recommend specific activities for remediation
  • Celebrate progress and achievements
  • Encourage consistent daily engagement

๐Ÿงช Assessment Management

Create and manage adaptive assessments with AI-powered grading and feedback.

๐Ÿ“Œ Coming Soon: Comprehensive guide to the assessment engine, IRT-based adaptive testing, and AI feedback generation.

๐Ÿ“Š Analytics & Reports

Access detailed analytics about student performance, engagement, and learning outcomes.

๐Ÿ“Œ Coming Soon: Guide to viewing reports, interpreting analytics, and exporting data.

โš™๏ธ Organization Settings

Configure organization-specific settings, branding, and preferences.

๐Ÿ“Œ Coming Soon: Instructions for managing organization settings, logos, and configurations.

๐Ÿ”ง Troubleshooting

Common Admin Issues

Problem Solution
Can't create new course Check your role permissions. Only instructors and admins can create courses.
Student not showing in class Verify student enrollment. Check class-student associations in student management.
Content not saving Check internet connection. Ensure all required fields are filled. Try again.
Assessment not generating questions Verify OpenAI API is configured. Check assessment template settings.

Getting Help

๐Ÿ“Œ Support Channels:
  • Technical Support: support@thinkster.com
  • Documentation: Available in the docs folder
  • System Administrator: Contact for platform-level issues
  • Response Time: Within 24 hours on business days

โ“ Frequently Asked Questions

Access & Permissions

Q: Can I be both an instructor and a student?

A: Yes! You can have both roles. Use the student login for learning and admin login for teaching/management.

Q: How do I grant admin access to another user?

A: Super admins can change user roles in the user management section. Contact your system administrator if you need this done.

Q: What's the difference between instructor and author roles?

A: Instructors can teach courses and view student progress. Authors focus on content creation. Both can create courses and content.

Course Management

Q: Can I reuse content from another course?

A: Yes! Use the course cloning feature or copy individual activities between courses.

Q: How do I make a course private?

A: In course settings, set visibility to "private" and manually enroll students or classes.

Q: Can students see draft content?

A: No. Only published activities are visible to students. Use draft status for content in progress.

Student Management

Q: How do I bulk enroll students?

A: Use the CSV import feature in student management or enroll entire classes at once.

Q: Can I reset a student's progress?

A: Yes, but use with caution. This option is available in student progress management.

Technical Questions

Q: What content formats are supported?

A: Video (MP4), images (PNG, JPG), PDFs, LaTeX math, GeoGebra widgets, and rich text.

Q: Is there a mobile app for admins?

A: The admin portal is web-based and works in mobile browsers. A native app may be available in the future.

Q: How is data backed up?

A: All data is automatically backed up daily. Contact your system administrator for backup policies.