How bildungsportal/next-exam works
Major components
a. Electron Application Shell – This encapsulates both the student and teacher versions. Each version includes:
– The Main Process (Electron’s background process that manages application windows, native integrations, and some system-level functions).
– The Renderer Process (the frontend built in Vue; note the renderer directories with Vite configurations and Vue component files).
– Preload Scripts (used to securely bridge Node APIs to the renderer process; present in packages/preload).
c. Native Modules and Utilities – For example, the “disable-shortcuts” project written in C (and managed via CMake files in student/disable-shortcuts) that likely handles secure input or keyboard restrictions.
d. Third-party integrations – This includes the integration of LanguageTool (present under public/LanguageTool), which is provided as a set of JAR files and native libraries.
e. Build and Deployment Tools – Tools like electron-builder (with configuration files such as electron-builder.yml), Vite, and build scripts (like build.mjs and prebuild.js) that handle assembly and distribution.
f. Supporting Runtime Environments – Minimal JRE distributions (for Linux, Mac, Win) are packaged as part of the public files. They are critical for any Java-based components (such as LanguageTool).
Relationships and data flows
– Represent the Vue-based UI (renderer) as the interactive layer where candidates or teachers interact with the system.
– Include the integration of the LanguageTool libraries (packaged as JAR files and dependent libraries) as an external or embedded service that either the main process (or the server) communicates with for grammar checks or language processing.
– Indicate that build tools (electron-builder, Vite, CMake) are used for compiling the different parts, but these can be represented as a side component that feeds into both the development and production pipelines.
• Two main application variants (“student” and “teacher”) each with:
– An Electron shell containing:
• Main process (managing window creation, native integrations, etc.)
• Renderer (user interface built with Vue)
• Preload scripts (enabling secure API access)
• In the teacher application, an additional Node/Express server component handling exam control, routing (located in teacher/packages/server).
• LanguageTool components (included as jars and supporting libraries in public/LanguageTool) that can be depicted as either a local embedded service or an external API.
• A native module component (the disable-shortcuts module) integrated into the student application.