# brightspace-dashboard-data-community/admin-dashboard architecture

> Architecture diagram of the GitHub repository brightspace-dashboard-data-community/admin-dashboard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/brightspace-dashboard-data-community/admin-dashboard
- Repository: https://github.com/brightspace-dashboard-data-community/admin-dashboard

## Overview

Admin Dashboard is a browser-based Brightspace administration tool. An administrator uses its lookup and enrollment interfaces to find users or courses, inspect and modify enrollments, and consult operational reports. The repository also contains course-management, auditing, and faculty-onboarding capabilities. The graph preserves those major product areas; several are represented by their exact source files without asserted internal connections because their implementation was not sampled. Edges are limited to README statements and relationships visible in excerpts.

Main entry points: [`js/inline-enrollment-handlers.js`](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/inline-enrollment-handlers.js) (Inline Enrollment Actions), [`js/auth.js`](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/auth.js) (Brightspace API Access), [`js/manage-enrollment-tabbed.js`](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/manage-enrollment-tabbed.js) (Enrollment Management), [`js/change-role-modal.js`](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/change-role-modal.js) (Role Change)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Administration"]
  node_dashboard["Dashboard Interface<br/>[app.js]"]
  node_enrollment["Enrollment Management"]
  node_inline["Inline Enrollment Actions"]
  node_rolemodal["Role Change"]
  node_deletemodal["Enrollment Deletion"]
  node_bulkunenroll["Bulk Unenrollment"]
  node_lookupuser["User Lookup<br/>[search-user.js]"]
  node_lookupcourse["Course Lookup<br/>[search-course.js]"]
  node_courseops["Course Operations"]
  node_userops["User Operations<br/>[user-merge.js]"]
end

subgraph group_insights["Reports and Audits"]
  node_reports["Operational Reports"]
  node_enrollmentdata["Enrollment Data Analysis"]
  node_audits["Course and User Audits"]
  node_accessibility["Accessibility Review"]
end

subgraph group_onboarding["Faculty Onboarding"]
  node_facultycommand["Onboarding Command Center<br/>[command-center.js]"]
  node_facultyrecords["Faculty Records"]
  node_onboardingqueue["Onboarding Action Queue"]
  node_automationchecks["Automated Checks"]
  node_emailtemplates["Onboarding Emails<br/>[email-templates.js]"]
end

subgraph group_platform["Shared Platform"]
  node_auth["Brightspace API Access<br/>[auth.js]"]
  node_modalutils["Modal Utilities<br/>[modal-utils.js]"]
end

node_administrator(("Administrator"))
node_brightspace(("Brightspace"))

node_administrator -->|"uses"| node_dashboard
node_dashboard -->|"manages enrollments"| node_enrollment
node_administrator -->|"looks up users"| node_lookupuser
node_administrator -->|"looks up courses"| node_lookupcourse
node_administrator -->|"views reports"| node_reports
node_enrollment -->|"calls"| node_auth
node_enrollment -->|"uses handlers"| node_inline
node_inline -->|"fetches data"| node_auth
node_inline -->|"opens"| node_rolemodal
node_inline -->|"opens"| node_deletemodal
node_inline -->|"hides"| node_modalutils
node_enrollment -->|"opens"| node_rolemodal
node_rolemodal -->|"changes enrollment"| node_auth
node_rolemodal -->|"shows confirmation"| node_modalutils
node_deletemodal -->|"deletes enrollment"| node_auth
node_deletemodal -->|"shows confirmation"| node_modalutils
node_bulkunenroll -->|"fetches data"| node_auth
node_facultycommand -.->|"uses queue"| node_onboardingqueue
node_onboardingqueue -->|"loads records"| node_facultyrecords
node_facultyrecords -->|"reads and writes files"| node_brightspace
node_enrollmentdata -.->|"downloads datasets"| node_brightspace

click node_dashboard "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/app.js"
click node_enrollment "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/manage-enrollment-tabbed.js"
click node_inline "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/inline-enrollment-handlers.js"
click node_rolemodal "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/change-role-modal.js"
click node_deletemodal "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/delete-enrollment-modal.js"
click node_bulkunenroll "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/bulk-unenroll-by-role.js"
click node_lookupuser "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/search-user.js"
click node_lookupcourse "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/search-course.js"
click node_courseops "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/course-repair-workbench.js"
click node_userops "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/user-merge.js"
click node_reports "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/end-of-semester-report.js"
click node_enrollmentdata "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/enrollment-data-service.js"
click node_audits "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/empty-course-audit.js"
click node_accessibility "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/yuja-accessibility.js"
click node_facultycommand "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/faculty-onboarding/js/command-center.js"
click node_facultyrecords "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/faculty-onboarding/js/faculty-record-service.js"
click node_onboardingqueue "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/faculty-onboarding/js/onboarding-queue-service.js"
click node_automationchecks "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/faculty-onboarding/js/automation-checks.js"
click node_emailtemplates "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/faculty-onboarding/js/email-templates.js"
click node_auth "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/auth.js"
click node_modalutils "https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/modal-utils.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_enrollment,node_inline,node_rolemodal,node_deletemodal,node_bulkunenroll,node_lookupuser,node_lookupcourse,node_courseops,node_userops toneBlue
class node_reports,node_enrollmentdata,node_audits,node_accessibility toneAmber
class node_facultycommand,node_facultyrecords,node_onboardingqueue,node_automationchecks,node_emailtemplates toneMint
class node_auth,node_modalutils toneRose
class node_administrator,node_brightspace toneIndigo
```

## Components

### Administration

- [Dashboard Interface](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/app.js): `js/app.js`
- [Enrollment Management](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/manage-enrollment-tabbed.js): `js/manage-enrollment-tabbed.js`
- [Inline Enrollment Actions](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/inline-enrollment-handlers.js): `js/inline-enrollment-handlers.js`
- [Role Change](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/change-role-modal.js): `js/change-role-modal.js`
- [Enrollment Deletion](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/delete-enrollment-modal.js): `js/delete-enrollment-modal.js`
- [Bulk Unenrollment](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/bulk-unenroll-by-role.js): `js/bulk-unenroll-by-role.js`
- [User Lookup](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/search-user.js): `js/search-user.js`
- [Course Lookup](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/search-course.js): `js/search-course.js`
- [Course Operations](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/course-repair-workbench.js): `js/course-repair-workbench.js`
- [User Operations](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/user-merge.js): `js/user-merge.js`

### Reports and Audits

- [Operational Reports](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/end-of-semester-report.js): `js/end-of-semester-report.js`
- [Enrollment Data Analysis](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/enrollment-data-service.js): `js/enrollment-data-service.js`
- [Course and User Audits](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/empty-course-audit.js): `js/empty-course-audit.js`
- [Accessibility Review](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/yuja-accessibility.js): `js/yuja-accessibility.js`

### Faculty Onboarding

- [Onboarding Command Center](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/faculty-onboarding/js/command-center.js): `faculty-onboarding/js/command-center.js`
- [Faculty Records](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/faculty-onboarding/js/faculty-record-service.js): `faculty-onboarding/js/faculty-record-service.js`
- [Onboarding Action Queue](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/faculty-onboarding/js/onboarding-queue-service.js): `faculty-onboarding/js/onboarding-queue-service.js`
- [Automated Checks](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/faculty-onboarding/js/automation-checks.js): `faculty-onboarding/js/automation-checks.js`
- [Onboarding Emails](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/faculty-onboarding/js/email-templates.js): `faculty-onboarding/js/email-templates.js`

### Shared Platform

- [Brightspace API Access](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/auth.js): `js/auth.js`
- [Modal Utilities](https://github.com/brightspace-dashboard-data-community/admin-dashboard/blob/main/js/modal-utils.js): `js/modal-utils.js`

### Other components

- **Administrator**
- **Brightspace**

## Connections

- Administrator → Dashboard Interface: uses (evidence: `README.md`)
- Dashboard Interface → Enrollment Management: manages enrollments (evidence: `README.md`)
- Administrator → User Lookup: looks up users (evidence: `README.md`)
- Administrator → Course Lookup: looks up courses (evidence: `README.md`)
- Administrator → Operational Reports: views reports (evidence: `README.md`)
- Enrollment Management → Brightspace API Access: calls (evidence: `js/manage-enrollment-tabbed.js`)
- Enrollment Management → Inline Enrollment Actions: uses handlers (evidence: `js/manage-enrollment-tabbed.js`)
- Inline Enrollment Actions → Brightspace API Access: fetches data (evidence: `js/inline-enrollment-handlers.js`)
- Inline Enrollment Actions → Role Change: opens (evidence: `js/inline-enrollment-handlers.js`)
- Inline Enrollment Actions → Enrollment Deletion: opens (evidence: `js/inline-enrollment-handlers.js`)
- Inline Enrollment Actions → Modal Utilities: hides (evidence: `js/inline-enrollment-handlers.js`)
- Enrollment Management → Role Change: opens (evidence: `js/manage-enrollment-tabbed.js`)
- Role Change → Brightspace API Access: changes enrollment (evidence: `js/change-role-modal.js`)
- Role Change → Modal Utilities: shows confirmation (evidence: `js/change-role-modal.js`)
- Enrollment Deletion → Brightspace API Access: deletes enrollment (evidence: `js/delete-enrollment-modal.js`)
- Enrollment Deletion → Modal Utilities: shows confirmation (evidence: `js/delete-enrollment-modal.js`)
- Bulk Unenrollment → Brightspace API Access: fetches data (evidence: `js/bulk-unenroll-by-role.js`)
- Onboarding Command Center → Onboarding Action Queue: uses queue
- Onboarding Action Queue → Faculty Records: loads records (evidence: `faculty-onboarding/js/onboarding-queue-service.js`)
- Faculty Records → Brightspace: reads and writes files (evidence: `faculty-onboarding/js/faculty-record-service.js`)
- Enrollment Data Analysis → Brightspace: downloads datasets
