# scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool architecture

> Architecture diagram of the GitHub repository scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool
- Repository: https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool

## Overview

This is a Chrome attendance-helper extension. The main workflow is to connect to the signed-in Monash attendance page, read course and attendance details, generate a semester week view, enter codes, and submit selected sessions one at a time with per-session feedback. The README also documents local persistence, account-specific settings, official attendance-rate display, PASS filtering, and bilingual UI. Source evidence covers most runtime links; the exact extension permission wiring and some refresh details were not sampled.

Main entry points: [`app.js`](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/app.js) (Semester view), [`browser.js`](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/browser.js) (Browser adapter), [`background.js`](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/background.js) (Extension launcher), [`store.js`](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/store.js) (Local records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_extension["Extension UI"]
  node_launcher["Extension launcher<br/>[background.js]"]
  node_semester_ui["Semester view<br/>[app.js]"]
end

subgraph group_planning["Schedule and records"]
  node_week_model["Week planner<br/>[weeks.js]"]
  node_record_store[("Local records<br/>[store.js]")]
end

subgraph group_school["School interaction"]
  node_browser_adapter["Browser adapter<br/>[browser.js]"]
  node_page_reader["School page reader<br/>[page.js]"]
  node_demo_adapter["Preview simulator<br/>[demo.js]"]
end

subgraph group_support["UI support"]
  node_translations["Translations<br/>[i18n.js]"]
end

node_student(("Student"))
node_school_site["Monash attendance site"]

node_student -->|"opens extension"| node_launcher
node_launcher -->|"opens view"| node_semester_ui
node_student -->|"connects and submits"| node_semester_ui
node_semester_ui -->|"invokes adapter"| node_browser_adapter
node_semester_ui -->|"builds weeks"| node_week_model
node_semester_ui -->|"loads and saves"| node_record_store
node_semester_ui -->|"translates UI"| node_translations
node_browser_adapter -->|"executes page functions"| node_page_reader
node_page_reader -->|"reads and submits forms"| node_school_site
node_browser_adapter -->|"navigates and verifies"| node_school_site
node_record_store -->|"uses date parsing"| node_week_model
node_semester_ui -->|"uses in preview"| node_demo_adapter
node_demo_adapter -->|"returns simulated results"| node_student

click node_launcher "https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/background.js"
click node_semester_ui "https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/app.js"
click node_week_model "https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/weeks.js"
click node_record_store "https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/store.js"
click node_browser_adapter "https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/browser.js"
click node_page_reader "https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/page.js"
click node_demo_adapter "https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/demo.js"
click node_translations "https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/i18n.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_launcher,node_semester_ui toneBlue
class node_week_model,node_record_store toneAmber
class node_browser_adapter,node_page_reader,node_demo_adapter toneMint
class node_translations toneRose
class node_student,node_school_site toneIndigo
```

## Components

### Extension UI

- [Extension launcher](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/background.js): `background.js`
- [Semester view](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/app.js): `app.js`

### Schedule and records

- [Week planner](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/weeks.js): `weeks.js`
- [Local records](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/store.js): `store.js`

### School interaction

- [Browser adapter](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/browser.js): `browser.js`
- [School page reader](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/page.js): `page.js`
- [Preview simulator](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/demo.js): `demo.js`

### UI support

- [Translations](https://github.com/scarlyhalon/mnsmy-international-student-attendence-code-assistant-tool/blob/main/i18n.js): `i18n.js`

### Other components

- **Student**
- **Monash attendance site**

## Connections

- Student → Extension launcher: opens extension (evidence: `README.md`)
- Extension launcher → Semester view: opens view (evidence: `background.js`)
- Student → Semester view: connects and submits (evidence: `README.md`)
- Semester view → Browser adapter: invokes adapter (evidence: `app.js`)
- Semester view → Week planner: builds weeks (evidence: `app.js`)
- Semester view → Local records: loads and saves (evidence: `app.js`)
- Semester view → Translations: translates UI (evidence: `app.js`)
- Browser adapter → School page reader: executes page functions (evidence: `browser.js`)
- School page reader → Monash attendance site: reads and submits forms (evidence: `README.md`)
- Browser adapter → Monash attendance site: navigates and verifies (evidence: `browser.js`)
- Local records → Week planner: uses date parsing (evidence: `store.js`)
- Semester view → Preview simulator: uses in preview (evidence: `app.js`)
- Preview simulator → Student: returns simulated results (evidence: `demo.js`)
