# longhorn-developers/degree-audit-plus architecture

> Architecture diagram of the GitHub repository longhorn-developers/degree-audit-plus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/longhorn-developers/degree-audit-plus
- Repository: https://github.com/longhorn-developers/degree-audit-plus

## Overview

Degree Audit Plus is a browser extension that turns UT Direct degree-audit results into a progress dashboard and semester planner. The main workflow is: enter from UT Direct or the popup, retrieve and parse audit data, store it locally, then explore requirements, plan courses, and find catalog recommendations. The graph preserves the documented popup, preferences, Core recommendations, and audit-history capabilities. Some links reflect README or SOURCE INDEX references rather than inspected implementations; those evidence limits are noted in the graph.

Main entry points: [`features/audit/audit-provider.tsx`](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit/audit-provider.tsx) (Audit state), [`entrypoints/degree-audit/main.tsx`](https://github.com/longhorn-developers/degree-audit-plus/blob/main/entrypoints/degree-audit/main.tsx) (Degree app), [`features/audit-scraping/content-controller.ts`](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit-scraping/content-controller.ts) (Page controller), [`features/audit/audit-storage.ts`](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit/audit-storage.ts) (Audit persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Extension entrypoints"]
  node_content["Content entry<br/>[content.tsx]"]
  node_degreepage["Degree app<br/>[main.tsx]"]
  node_popup["Popup app<br/>[popup-app.tsx]"]
  node_messages["Runtime messages<br/>[messages.ts]"]
end

subgraph group_scrape["UT Direct integration"]
  node_scrapecontrol["Page controller"]
  node_historysync["History sync"]
  node_runner["Audit runner<br/>[audit-runner.ts]"]
  node_pageparser["Audit parser"]
  node_background["Background controller"]
  node_session["Session state<br/>[session.ts]"]
end

subgraph group_audit["Audit state"]
  node_auditprovider["Audit state<br/>[audit-provider.tsx]"]
  node_auditstorage[("Audit persistence<br/>[audit-storage.ts]")]
  node_calculations["Progress calculations"]
  node_domain["Audit and course types<br/>[audit.ts]"]
end

subgraph group_experience["Planning experience"]
  node_dashboard["Progress dashboard"]
  node_planner["Semester planner"]
  node_search["Course search"]
  node_recommend["Core recommendations"]
end

subgraph group_catalog["Catalog and preferences"]
  node_catalogdb[("Course catalog<br/>[catalog-db.ts]")]
  node_catalogparse["Catalog parser<br/>[catalog-parser.ts]"]
  node_preferences["Preferences"]
  node_prefstorage[("Preference storage")]
end

node_student(("Student"))
node_ut{{"UT Direct"}}
node_browser{{"Browser APIs"}}

node_student -->|"uses audit"| node_ut
node_ut -->|"opens experience"| node_content
node_student -->|"opens popup"| node_popup
node_content -->|"starts controller"| node_scrapecontrol
node_scrapecontrol -->|"starts sync"| node_historysync
node_scrapecontrol -->|"dispatches actions"| node_runner
node_scrapecontrol -->|"records login"| node_session
node_historysync -->|"stores history"| node_auditstorage
node_historysync -->|"parses results"| node_pageparser
node_runner -->|"stores results"| node_auditstorage
node_background -->|"forwards requests"| node_scrapecontrol
node_background -.->|"routes messages"| node_messages
node_session -->|"probes session"| node_ut
node_degreepage -->|"provides state"| node_auditprovider
node_auditprovider -->|"observes and saves"| node_auditstorage
node_auditprovider -->|"calculates progress"| node_calculations
node_auditprovider -->|"reads selection"| node_preferences
node_auditprovider -->|"uses audit types"| node_domain
node_degreepage -->|"renders audit view"| node_dashboard
node_degreepage -->|"renders planner view"| node_planner
node_degreepage -->|"mounts course search"| node_search
node_search -->|"searches catalog"| node_catalogdb
node_search -.->|"shows suggestions"| node_recommend
node_search -->|"adds planned courses"| node_auditprovider
node_catalogparse -.->|"maps catalog data"| node_catalogdb
node_degreepage -->|"wraps app"| node_preferences
node_preferences -->|"persists settings"| node_prefstorage
node_popup -->|"observes audit history"| node_auditstorage
node_popup -->|"checks login"| node_session
node_popup -->|"sends commands"| node_messages
node_messages -.->|"dispatches requests"| node_background
node_browser -.->|"stores audit data"| node_auditstorage
node_browser -.->|"stores catalog"| node_catalogdb

click node_content "https://github.com/longhorn-developers/degree-audit-plus/blob/main/entrypoints/content.tsx"
click node_degreepage "https://github.com/longhorn-developers/degree-audit-plus/blob/main/entrypoints/degree-audit/main.tsx"
click node_popup "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/popup/popup-app.tsx"
click node_messages "https://github.com/longhorn-developers/degree-audit-plus/blob/main/lib/browser/messages.ts"
click node_scrapecontrol "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit-scraping/content-controller.ts"
click node_historysync "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit-scraping/audit-history-sync.ts"
click node_runner "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit-scraping/audit-runner.ts"
click node_pageparser "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit-scraping/audit-page-parser.ts"
click node_background "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit-scraping/background-controller.ts"
click node_session "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/session/session.ts"
click node_auditprovider "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit/audit-provider.tsx"
click node_auditstorage "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit/audit-storage.ts"
click node_calculations "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit/audit-calculations.ts"
click node_dashboard "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/dashboard/degree-audit-page.tsx"
click node_planner "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/planner/degree-planner-page.tsx"
click node_search "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/course-search/course-search-panel.tsx"
click node_recommend "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/course-search/course-recommendations.ts"
click node_catalogdb "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/catalog/catalog-db.ts"
click node_catalogparse "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/catalog/scraping/catalog-parser.ts"
click node_preferences "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/preferences/preferences-provider.tsx"
click node_prefstorage "https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/preferences/preferences-storage.ts"
click node_domain "https://github.com/longhorn-developers/degree-audit-plus/blob/main/domain/audit.ts"

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_content,node_degreepage,node_popup,node_messages,node_browser toneBlue
class node_scrapecontrol,node_historysync,node_runner,node_pageparser,node_background,node_session toneAmber
class node_auditprovider,node_auditstorage,node_calculations,node_domain toneMint
class node_dashboard,node_planner,node_search,node_recommend toneRose
class node_catalogdb,node_catalogparse,node_preferences,node_prefstorage,node_student,node_ut toneIndigo
```

## Components

### Extension entrypoints

- [Content entry](https://github.com/longhorn-developers/degree-audit-plus/blob/main/entrypoints/content.tsx): `entrypoints/content.tsx`
- [Degree app](https://github.com/longhorn-developers/degree-audit-plus/blob/main/entrypoints/degree-audit/main.tsx): `entrypoints/degree-audit/main.tsx`
- [Popup app](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/popup/popup-app.tsx): `features/popup/popup-app.tsx`
- [Runtime messages](https://github.com/longhorn-developers/degree-audit-plus/blob/main/lib/browser/messages.ts): `lib/browser/messages.ts`

### UT Direct integration

- [Page controller](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit-scraping/content-controller.ts): `features/audit-scraping/content-controller.ts`
- [History sync](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit-scraping/audit-history-sync.ts): `features/audit-scraping/audit-history-sync.ts`
- [Audit runner](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit-scraping/audit-runner.ts): `features/audit-scraping/audit-runner.ts`
- [Audit parser](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit-scraping/audit-page-parser.ts): `features/audit-scraping/audit-page-parser.ts`
- [Background controller](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit-scraping/background-controller.ts): `features/audit-scraping/background-controller.ts`
- [Session state](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/session/session.ts): `features/session/session.ts`

### Audit state

- [Audit state](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit/audit-provider.tsx): `features/audit/audit-provider.tsx`
- [Audit persistence](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit/audit-storage.ts): `features/audit/audit-storage.ts`
- [Progress calculations](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/audit/audit-calculations.ts): `features/audit/audit-calculations.ts`
- [Audit and course types](https://github.com/longhorn-developers/degree-audit-plus/blob/main/domain/audit.ts): `domain/audit.ts`

### Planning experience

- [Progress dashboard](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/dashboard/degree-audit-page.tsx): `features/dashboard/degree-audit-page.tsx`
- [Semester planner](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/planner/degree-planner-page.tsx): `features/planner/degree-planner-page.tsx`
- [Course search](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/course-search/course-search-panel.tsx): `features/course-search/course-search-panel.tsx`
- [Core recommendations](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/course-search/course-recommendations.ts): `features/course-search/course-recommendations.ts`

### Catalog and preferences

- [Course catalog](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/catalog/catalog-db.ts): `features/catalog/catalog-db.ts`
- [Catalog parser](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/catalog/scraping/catalog-parser.ts): `features/catalog/scraping/catalog-parser.ts`
- [Preferences](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/preferences/preferences-provider.tsx): `features/preferences/preferences-provider.tsx`
- [Preference storage](https://github.com/longhorn-developers/degree-audit-plus/blob/main/features/preferences/preferences-storage.ts): `features/preferences/preferences-storage.ts`

### Other components

- **Student**
- **UT Direct**
- **Browser APIs**

## Connections

- Student → UT Direct: uses audit (evidence: `README.md`)
- UT Direct → Content entry: opens experience (evidence: `README.md`)
- Student → Popup app: opens popup (evidence: `README.md`)
- Content entry → Page controller: starts controller (evidence: `entrypoints/content.tsx`)
- Page controller → History sync: starts sync (evidence: `features/audit-scraping/content-controller.ts`)
- Page controller → Audit runner: dispatches actions (evidence: `features/audit-scraping/content-controller.ts`)
- Page controller → Session state: records login (evidence: `features/audit-scraping/content-controller.ts`)
- History sync → Audit persistence: stores history (evidence: `features/audit-scraping/audit-history-sync.ts`)
- History sync → Audit parser: parses results (evidence: `features/audit-scraping/audit-history-sync.ts`)
- Audit runner → Audit persistence: stores results (evidence: `features/audit-scraping/audit-runner.ts`)
- Background controller → Page controller: forwards requests (evidence: `features/audit-scraping/content-controller.ts`)
- Background controller → Runtime messages: routes messages (evidence: `features/audit-scraping/background-controller.ts`)
- Session state → UT Direct: probes session (evidence: `features/session/session.ts`)
- Degree app → Audit state: provides state (evidence: `entrypoints/degree-audit/main.tsx`)
- Audit state → Audit persistence: observes and saves (evidence: `features/audit/audit-provider.tsx`)
- Audit state → Progress calculations: calculates progress (evidence: `features/audit/audit-provider.tsx`)
- Audit state → Preferences: reads selection (evidence: `features/audit/audit-provider.tsx`)
- Audit state → Audit and course types: uses audit types (evidence: `features/audit/audit-provider.tsx`)
- Degree app → Progress dashboard: renders audit view (evidence: `entrypoints/degree-audit/main.tsx`)
- Degree app → Semester planner: renders planner view (evidence: `entrypoints/degree-audit/main.tsx`)
- Degree app → Course search: mounts course search (evidence: `entrypoints/degree-audit/main.tsx`)
- Course search → Course catalog: searches catalog (evidence: `features/course-search/course-search-panel.tsx`)
- Course search → Core recommendations: shows suggestions
- Course search → Audit state: adds planned courses
- Catalog parser → Course catalog: maps catalog data
- Degree app → Preferences: wraps app (evidence: `entrypoints/degree-audit/main.tsx`)
- Preferences → Preference storage: persists settings (evidence: `features/preferences/preferences-provider.tsx`)
- Popup app → Audit persistence: observes audit history (evidence: `features/popup/popup-app.tsx`)
- Popup app → Session state: checks login (evidence: `features/popup/popup-app.tsx`)
- Popup app → Runtime messages: sends commands (evidence: `features/popup/popup-app.tsx`)
- Runtime messages → Background controller: dispatches requests (evidence: `features/audit-scraping/background-controller.ts`)
- Browser APIs → Audit persistence: stores audit data
- Browser APIs → Course catalog: stores catalog
