CompuGrade District Admin Manual

1. District Admin Guide: Provisioning and Operations

A District Admin is responsible for the operational health of a single school district — managing seat inventory, provisioning schools and classrooms, and ensuring teachers and students have the access they need.

Left Sidebar Navigation:

Item	Purpose
Dashboard	District KPIs: seats used, schools active, recent activity
Schools	Add and manage schools within the district
Classes	Create and manage classrooms tied to Open edX courses
Seat Management	View and allocate the district's purchased seat budget
Users	Manage teachers and students within the district
Reports	Generate grade, activity, and compliance reports
Settings	District SSO configuration, notification preferences

---

1.1 Review District Dashboard

1. Log in at staging-api.dashboard.compugrade.com with your District Admin credentials.
2. Review: Purchased vs. Consumed Seats, Active Schools, Active Classes, Recent Activity Feed.
3. A seat buffer under 10% is an urgent signal to contact your account manager.

---

1.2 Add a New School

1. Click Schools → "+ Add School".
2. Fill in: School Name, Principal Name, School Type, Address.
3. Click Save. The school can now receive seat allocations.

---

1.3 Allocate Seat Licenses to Schools

1. Click Seat Management. The top section shows Total Purchased / Allocated / Unallocated seats.
2. Click "Allocate" next to a school → enter the seat limit → click Confirm.

Note: Seats are consumed automatically when a student enrolls via the Open edX CMS plugin webhook. District Admins do not manually deduct seats.

---

1.4 Provision a New Classroom

Context: Creating a class triggers a server-to-server request to the Open edX CMS plugin, which creates the Django Classroom model and fires a webhook back to deduct seats automatically.

1. Click Classes → "+ Create New Class".

2. Fill in the form:

   Field	Description
   Class Name	e.g., "Period 3 — Word Processing"
   School	School this class belongs to
   Teacher	Lead teacher assigned
   Course	Linked Open edX course
   Start / End Date	Active dates
   Seat Limit	Max students for this class

3. Click Submit. Within seconds:

   • ✅ Django Classroom model created in Open edX
   • ✅ Seats deducted from school allocation via webhook
   • ✅ Teacher assigned to the course in Open edX

---

1.5 Bulk Import Teachers & Students

1. Click Users → "Bulk Import" → download the CSV template.
2. Fill columns: First Name, Last Name, Email, Role, School, Class.
3. Upload the CSV. The system creates accounts, enrolls users, and sends invitation emails.
4. A results summary shows success and error counts (e.g., duplicate email, invalid class).

Tip: Districts using Clever or ClassLink have rostering handled automatically via SSO — bulk CSV import is only needed for manually managed rosters.

---

1.6 Generate Reports

1. Click Reports → choose a report type:

   Report	Contents
   Grade Report	Final scores for all students across all lessons
   Lesson Activity Report	Time spent, attempts, and completion rate per lesson
   Overdue Lessons Report	Students who haven't submitted past-due assignments
   Seat Usage Report	Current and historical seat consumption by school

2. Apply filters: Date Range, School, Class, Teacher → click Generate → download as CSV.

---

1.7 Manage District SSO Settings

1. Click Settings → SSO Configuration tab.
2. To update credentials: Click Edit → update Client ID / Secret → Save.
3. To switch provider: Click Change Provider → select new provider → enter credentials → Save.

Warning: Changing SSO credentials affects all users logging in via that provider immediately. Coordinate the change simultaneously with the provider's admin console.