# rianszzz/uglab architecture

> Architecture diagram of the GitHub repository rianszzz/uglab, 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/rianszzz/uglab
- Repository: https://github.com/rianszzz/uglab

## Overview

UGLab is a Chrome extension that extracts quiz questions from Gunadarma LMS pages, routes them through either model APIs or a logged-in AI website, parses responses, and fills the LMS form. The documented quiz support spans multiple-choice, true/false, multi-select, short answer, essay, coding, and multi-box questions. The sampled excerpts show the popup, background router, web-AI injector, and LMS content script; API/model details and some wiring are documented or only partially shown.

Main entry points: [`src/background.js`](https://github.com/rianszzz/uglab/blob/main/src/background.js) (Message router), [`popup.js`](https://github.com/rianszzz/uglab/blob/main/popup.js) (Popup controller), [`src/ai-injector.js`](https://github.com/rianszzz/uglab/blob/main/src/ai-injector.js) (Web AI automation), [`src/lms-content.js`](https://github.com/rianszzz/uglab/blob/main/src/lms-content.js) (Question extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Extension UI"]
  node_popup["Popup controller<br/>[popup.js]"]
end

subgraph group_lms["LMS Interaction"]
  node_lms_page["Quiz page"]
  node_question_scan["Question extraction<br/>[lms-content.js]"]
  node_answer_fill["Answer form filling<br/>[lms-content.js]"]
end

subgraph group_orchestration["Answer Orchestration"]
  node_background["Message router<br/>[background.js]"]
  node_extension_store[("Extension storage")]
  node_answer_parse["Answer parsing<br/>[background.js]"]
end

subgraph group_ai["AI Processing"]
  node_api_models["Model APIs"]
  node_ai_tab["AI website tab"]
  node_ai_injector["Web AI automation<br/>[ai-injector.js]"]
  node_ai_provider["AI web providers"]
end

node_student(("Student"))

node_student -->|"starts run"| node_popup
node_popup -->|"requests scan"| node_question_scan
node_question_scan -->|"scrapes questions"| node_lms_page
node_student -->|"opens quiz"| node_lms_page
node_popup -->|"sends start"| node_background
node_popup -->|"saves settings"| node_extension_store
node_background -->|"stores payload"| node_extension_store
node_background -->|"requests answers"| node_api_models
node_background -->|"opens or reuses"| node_ai_tab
node_ai_tab -->|"runs injector"| node_ai_injector
node_ai_injector -->|"reads payload"| node_extension_store
node_ai_injector -->|"injects prompt"| node_ai_provider
node_ai_provider -->|"returns response"| node_ai_injector
node_ai_injector -->|"sends result"| node_background
node_api_models -.->|"returns answers"| node_background
node_background -->|"parses response"| node_answer_parse
node_background -->|"delivers answers"| node_answer_fill
node_answer_fill -->|"fills responses"| node_lms_page
node_question_scan -->|"returns questions"| node_popup

click node_popup "https://github.com/rianszzz/uglab/blob/main/popup.js"
click node_question_scan "https://github.com/rianszzz/uglab/blob/main/src/lms-content.js"
click node_answer_fill "https://github.com/rianszzz/uglab/blob/main/src/lms-content.js"
click node_background "https://github.com/rianszzz/uglab/blob/main/src/background.js"
click node_answer_parse "https://github.com/rianszzz/uglab/blob/main/src/background.js"
click node_ai_injector "https://github.com/rianszzz/uglab/blob/main/src/ai-injector.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_popup toneBlue
class node_lms_page,node_question_scan,node_answer_fill toneAmber
class node_background,node_extension_store,node_answer_parse toneMint
class node_api_models,node_ai_tab,node_ai_injector,node_ai_provider toneRose
class node_student toneIndigo
```

## Components

### Extension UI

- [Popup controller](https://github.com/rianszzz/uglab/blob/main/popup.js): `popup.js`

### LMS Interaction

- **Quiz page**
- [Question extraction](https://github.com/rianszzz/uglab/blob/main/src/lms-content.js): `src/lms-content.js`
- [Answer form filling](https://github.com/rianszzz/uglab/blob/main/src/lms-content.js): `src/lms-content.js`

### Answer Orchestration

- [Message router](https://github.com/rianszzz/uglab/blob/main/src/background.js): `src/background.js`
- **Extension storage**
- [Answer parsing](https://github.com/rianszzz/uglab/blob/main/src/background.js): `src/background.js`

### AI Processing

- **Model APIs**
- **AI website tab**
- [Web AI automation](https://github.com/rianszzz/uglab/blob/main/src/ai-injector.js): `src/ai-injector.js`
- **AI web providers**

### Other components

- **Student**

## Connections

- Student → Popup controller: starts run (evidence: `README.md`)
- Popup controller → Question extraction: requests scan (evidence: `popup.js`)
- Question extraction → Quiz page: scrapes questions (evidence: `README.md`)
- Student → Quiz page: opens quiz (evidence: `README.md`)
- Popup controller → Message router: sends start (evidence: `popup.js`)
- Popup controller → Extension storage: saves settings (evidence: `popup.js`)
- Message router → Extension storage: stores payload (evidence: `src/background.js`)
- Message router → Model APIs: requests answers (evidence: `src/background.js`)
- Message router → AI website tab: opens or reuses (evidence: `README.md`)
- AI website tab → Web AI automation: runs injector (evidence: `README.md`)
- Web AI automation → Extension storage: reads payload (evidence: `src/ai-injector.js`)
- Web AI automation → AI web providers: injects prompt (evidence: `src/ai-injector.js`)
- AI web providers → Web AI automation: returns response (evidence: `README.md`)
- Web AI automation → Message router: sends result (evidence: `src/ai-injector.js`)
- Model APIs → Message router: returns answers
- Message router → Answer parsing: parses response (evidence: `src/background.js`)
- Message router → Answer form filling: delivers answers (evidence: `src/background.js`)
- Answer form filling → Quiz page: fills responses (evidence: `README.md`)
- Question extraction → Popup controller: returns questions (evidence: `popup.js`)
