# jerniqz-del/eclassrecord architecture

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

- Interactive diagram: https://gitdiagram.com/jerniqz-del/eclassrecord
- Repository: https://github.com/jerniqz-del/eclassrecord

## Overview

E-Class Record is an offline Electron desktop app for Filipino teachers. The main workflow is to set up a class, load its roster, enter and verify scores under DepEd grading rules, and review computed grades; records are saved locally. Separate capabilities include advisory consolidation and grade transfer, PACE forms, calendar and teacher tools, backup/recovery, mobile companion sync, School Cloud, and updates. The README documents the product workflow and local storage; sampled source and the source index support selected main-process links. Other renderer-to-main wiring is not shown, so those links are omitted.

Main entry points: [`src/renderer/js/app.js`](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/app.js) (Application Shell), [`src/main/main.js`](https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/main.js) (Electron Main Process), [`src/renderer/js/learners.js`](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/learners.js) (Roster Management), [`src/renderer/js/advisory-dashboard.js`](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/advisory-dashboard.js) (Advisory Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_classroom["Classroom Records"]
  node_app["Application Shell<br/>[app.js]"]
  node_roster["Roster Management<br/>[learners.js]"]
  node_records["Score Grid<br/>[record-table.js]"]
  node_grading["Grading Rules<br/>[grading.js]"]
  node_grades["Grade Summary<br/>[learner-grades.js]"]
  node_database[("Record Database<br/>[database.js]")]
  node_calendar["Calendar<br/>[calendar.js]"]
  node_teachertools["Teacher Tools<br/>[teacher-tools.js]"]
end

subgraph group_advisory["Advisory &amp; PACE"]
  node_advisory["Advisory Dashboard"]
  node_advisorydata["Advisory Data<br/>[advisory-data.js]"]
  node_transfer["Grade Transfer"]
  node_pace["PACE Engine<br/>[pace-engine.js]"]
  node_paceform["PACE Form Export"]
end

subgraph group_desktop["Desktop Services"]
  node_main["Electron Main Process<br/>[main.js]"]
  node_files["File I/O &amp; Backups<br/>[file-io.js]"]
  node_sf1["LIS SF1 Import<br/>[sf1-reader.js]"]
  node_export["Record Export"]
  node_updater["OTA Updates<br/>[updater.js]"]
end

subgraph group_connected["Connected Features"]
  node_companion["Companion Sync"]
  node_schoolcloud["School Cloud"]
  node_schoolclient["School Cloud Client"]
end

node_teacher(("Teacher"))
node_local(("Local Computer"))

node_teacher -->|"uses"| node_app
node_app -->|"sets up"| node_roster
node_roster -->|"provides learners"| node_records
node_records -->|"checks scores"| node_grading
node_grading -->|"computes grades"| node_grades
node_app -->|"manages records"| node_database
node_database -->|"stores locally"| node_local
node_roster -->|"imports LIS roster"| node_sf1
node_teacher -->|"consolidates classes"| node_advisory
node_advisory -.->|"uses data"| node_advisorydata
node_advisory -->|"transfers grades"| node_transfer
node_teacher -->|"prepares forms"| node_pace
node_pace -.->|"exports forms"| node_paceform
node_app -.->|"offers calendar"| node_calendar
node_app -.->|"offers tools"| node_teachertools
node_app -.->|"uses desktop services"| node_main
node_main -->|"handles file I/O"| node_files
node_main -->|"dispatches sync"| node_companion
node_main -->|"dispatches cloud requests"| node_schoolcloud
node_schoolclient -.->|"connects to"| node_schoolcloud
node_main -->|"initializes updates"| node_updater
node_teacher -->|"exports reports"| node_export

click node_app "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/app.js"
click node_roster "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/learners.js"
click node_records "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/record-table.js"
click node_grading "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/grading.js"
click node_grades "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/learner-grades.js"
click node_database "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/database.js"
click node_advisory "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/advisory-dashboard.js"
click node_advisorydata "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/advisory-data.js"
click node_transfer "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/advisory-grade-transfer.js"
click node_pace "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/pace-engine.js"
click node_paceform "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/pace-form-export.js"
click node_main "https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/main.js"
click node_files "https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/file-io.js"
click node_sf1 "https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/sf1-reader.js"
click node_export "https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/official-ecr-exporter.js"
click node_companion "https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/companion-sync-service.js"
click node_schoolcloud "https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/school-cloud-service.js"
click node_schoolclient "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/school-cloud-client.js"
click node_calendar "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/calendar.js"
click node_teachertools "https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/teacher-tools.js"
click node_updater "https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/updater.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_app,node_roster,node_records,node_grading,node_grades,node_database,node_calendar,node_teachertools toneBlue
class node_advisory,node_advisorydata,node_transfer,node_pace,node_paceform toneAmber
class node_main,node_files,node_sf1,node_export,node_updater toneMint
class node_companion,node_schoolcloud,node_schoolclient toneRose
class node_teacher,node_local toneIndigo
```

## Components

### Classroom Records

- [Application Shell](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/app.js): `src/renderer/js/app.js`
- [Roster Management](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/learners.js): `src/renderer/js/learners.js`
- [Score Grid](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/record-table.js): `src/renderer/js/record-table.js`
- [Grading Rules](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/grading.js): `src/renderer/js/grading.js`
- [Grade Summary](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/learner-grades.js): `src/renderer/js/learner-grades.js`
- [Record Database](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/database.js): `src/renderer/js/database.js`
- [Calendar](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/calendar.js): `src/renderer/js/calendar.js`
- [Teacher Tools](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/teacher-tools.js): `src/renderer/js/teacher-tools.js`

### Advisory & PACE

- [Advisory Dashboard](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/advisory-dashboard.js): `src/renderer/js/advisory-dashboard.js`
- [Advisory Data](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/advisory-data.js): `src/renderer/js/advisory-data.js`
- [Grade Transfer](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/advisory-grade-transfer.js): `src/renderer/js/advisory-grade-transfer.js`
- [PACE Engine](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/pace-engine.js): `src/renderer/js/pace-engine.js`
- [PACE Form Export](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/pace-form-export.js): `src/renderer/js/pace-form-export.js`

### Desktop Services

- [Electron Main Process](https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/main.js): `src/main/main.js`
- [File I/O & Backups](https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/file-io.js): `src/main/file-io.js`
- [LIS SF1 Import](https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/sf1-reader.js): `src/main/sf1-reader.js`
- [Record Export](https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/official-ecr-exporter.js): `src/main/official-ecr-exporter.js`
- [OTA Updates](https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/updater.js): `src/main/updater.js`

### Connected Features

- [Companion Sync](https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/companion-sync-service.js): `src/main/companion-sync-service.js`
- [School Cloud](https://github.com/jerniqz-del/eclassrecord/blob/main/src/main/school-cloud-service.js): `src/main/school-cloud-service.js`
- [School Cloud Client](https://github.com/jerniqz-del/eclassrecord/blob/main/src/renderer/js/school-cloud-client.js): `src/renderer/js/school-cloud-client.js`

### Other components

- **Teacher**
- **Local Computer**

## Connections

- Teacher → Application Shell: uses (evidence: `README.md`)
- Application Shell → Roster Management: sets up (evidence: `README.md`)
- Roster Management → Score Grid: provides learners (evidence: `README.md`)
- Score Grid → Grading Rules: checks scores (evidence: `README.md`)
- Grading Rules → Grade Summary: computes grades (evidence: `README.md`)
- Application Shell → Record Database: manages records (evidence: `README.md`)
- Record Database → Local Computer: stores locally (evidence: `README.md`)
- Roster Management → LIS SF1 Import: imports LIS roster (evidence: `README.md`)
- Teacher → Advisory Dashboard: consolidates classes (evidence: `README.md`)
- Advisory Dashboard → Advisory Data: uses data
- Advisory Dashboard → Grade Transfer: transfers grades (evidence: `README.md`)
- Teacher → PACE Engine: prepares forms (evidence: `README.md`)
- PACE Engine → PACE Form Export: exports forms
- Application Shell → Calendar: offers calendar
- Application Shell → Teacher Tools: offers tools
- Application Shell → Electron Main Process: uses desktop services
- Electron Main Process → File I/O & Backups: handles file I/O (evidence: `src/main/main.js`)
- Electron Main Process → Companion Sync: dispatches sync (evidence: `src/main/main.js`)
- Electron Main Process → School Cloud: dispatches cloud requests (evidence: `src/main/main.js`)
- School Cloud Client → School Cloud: connects to
- Electron Main Process → OTA Updates: initializes updates (evidence: `README.md`)
- Teacher → Record Export: exports reports (evidence: `README.md`)
