How kwiteegaylah/gradedesk works
GradeDesk is an offline Windows grade-recording app for WVSTU instructors. Instructors enter rosters, assessments, attendance, and raw marks; the app computes transmuted and weighted term and final grades, supports review and sorting, and exports submission-ready Excel workbooks. It also autosaves locally, supports JSON backup/restore, and checks for updates online. The main process owns IPC and storage, while the gradebook joins persisted inputs to the calculation engine. Renderer-to-main wiring is supported by the main-process description; unsampled renderer internals are not expanded.
Main entry points: index.js Calculation facade · app.js GradeDesk screens · main.js IPC and app host · gradebook.js Course gradebook
Components 21
Instructor interface
- GradeDesk screens
src/renderer/app.js - Sorting
src/renderer/sorting.js - User guide
src/renderer/guide.js - Date helpers
src/renderer/dates.js - Preset interface
src/renderer/presets.js
Application runtime
- IPC and app host
src/main.js - Course gradebook
src/data/gradebook.js
Grade calculation
- Calculation facade
src/engine/index.js - Grade calculations
src/engine/grades.js - Score transmutation
src/engine/transmutation.js - Assessment policy
src/engine/policy.js - Roster parsing
src/engine/roster.js - Date logic
src/engine/dates.js - Preset logic
src/engine/presets.js - Transmutation tables
data/transmutation_tables.json
Local data
- SQLite store
src/data/store.js - Backup and restore
src/data/backup.js
Exports and updates
- Excel workbooks
src/export/excel.js - Update manager
src/updates.js
Other components
- Instructor
- GitHub releases
Connections 24
- Instructor → GradeDesk screens: enters grades
README.md - GradeDesk screens → IPC and app host: requests via IPC
src/main.js - IPC and app host → SQLite store: reads and writes
src/main.js - IPC and app host → Course gradebook: requests computation
src/main.js - Course gradebook → SQLite store: loads course data
src/data/gradebook.js - Course gradebook → Calculation facade: computes grades
src/data/gradebook.js - Calculation facade → Score transmutation: re-exports
src/engine/index.js - Calculation facade → Grade calculations: re-exports
src/engine/index.js - Calculation facade → Assessment policy: re-exports
src/engine/index.js - Calculation facade → Roster parsing: re-exports
src/engine/index.js - Calculation facade → Date logic: re-exports
src/engine/index.js - Calculation facade → Preset logic: re-exports
src/engine/index.js - Grade calculations → Score transmutation: looks up scores
src/engine/grades.js - IPC and app host → Excel workbooks: generates exports
src/main.js - Excel workbooks → Calculation facade: uses grade results
src/export/excel.js - IPC and app host → Backup and restore: handles backup
src/main.js - Backup and restore → SQLite store: serializes database
src/data/backup.js - IPC and app host → Update manager: starts update check
src/main.js - Update manager → GitHub releases: checks releases
src/updates.js - GradeDesk screens → Sorting: offers sorting
- GradeDesk screens → User guide: opens guide
- GradeDesk screens → Date helpers: uses date helpers
- GradeDesk screens → Preset interface: uses preset interface
- Calculation facade → Transmutation tables: accepts injected tables
src/engine/index.js