How greubela/edusquirrel-workbook works
EduSquirrel Workbook is a browser-based platform for authoring and delivering interactive, multilingual student workbooks. Its principal workflow is to mount an app, assemble workbook content into sections and exercises, render those elements in the browser, and let students complete interactions. The README also documents coding tasks, GPT-assisted feedback, TurtleStitch activities, and browser/worker/server modules. The graph follows those documented capabilities; several implementation links are unverified because their source was not sampled.
Main entry points: interactionRenderer Exercise interactions · SyncInformation.scala Interaction sync · HtmlFullWorkbookApp.scala Workbook app context · MainApp.scala Browser mounting
Components 20
App entry
- Browser mounting
modules/client/src/main/scala/MainApp.scala - Workbook app context
modules/client/src/main/scala/it/evadid/homepage/control/singletons/HtmlFullWorkbookApp.scala
Workbook experience
- Workbook authoring
modules/client/src/main/scala/it/evadid/homepage/workbook/content - Workbook model
modules/core/shared/src/main/scala/it/evadid/workbook - Element dispatch
modules/client/src/main/scala/it/evadid/homepage/workbook/htmlRenderer/HtmlRenderFactory.scala - Workbook rendering
modules/client/src/main/scala/it/evadid/homepage/workbook/htmlRenderer/structureRenderer/HtmlWorkbookRenderer.scala - Exercise interactions
modules/client/src/main/scala/it/evadid/homepage/workbook/htmlRenderer/interactionRenderer - TurtleStitch tasks
modules/client/src/main/scala/it/evadid/homepage/workbook/htmlRenderer/interactionRenderer/turtleStitch
Shared services
- Language maps
modules/client/src/main/scala/it/evadid/homepage/control/change/LanguageMapStorageControl.scala - Language types
modules/core/shared/src/main/scala/it/evadid/core/datastructures/language/AppLanguage.scala - Interaction sync
modules/core/shared/src/main/scala/it/evadid/workbook/interaction/sync/SyncInformation.scala - Remote cache
modules/core/shared/src/main/scala/it/evadid/core/datastructures/storage/RemoteCacheController.scala - Serialized history
modules/core/shared/src/main/scala/it/evadid/workbook/interaction/variable/InteractionVariableHistorySerialized.scala - IndexedDB sync
modules/client/src/main/scala/it/evadid/homepage/workbook/syncDestination/LocalIndexedDbStorageSync.scala
Execution and feedback
- Browser worker
modules/worker/src/main/scala/it/evadid/worker/WebWorkerBackendServer.scala - Pyodide execution
homepage/js/pyodide-worker.js - Feedback diagnosis
modules/client/src/main/scala/it/evadid/homepage/workbook/legacy/interactionPlugins/blockEnvironment/feedback/diagnosis/DiagnosisEngine.scala - LLM feedback client
modules/client/src/main/scala/it/evadid/homepage/workbook/legacy/interactionPlugins/blockEnvironment/feedback/ai/FetchProxyLlmClient.scala - JVM command handlers
modules/server/src/main/scala/it/evadid/server
Other components
- Student or author
Connections 20
- Student or author → Browser mounting: opens workbook
- Browser mounting → Workbook app context: mounts app
- Workbook app context → Workbook authoring: loads content
- Workbook authoring → Workbook model: composes model
- Workbook model → Element dispatch: renders elements
- Element dispatch → Workbook rendering: dispatches rendering
- Workbook rendering → Exercise interactions: renders exercises
- Workbook app context → Language maps: loads translations
- Language maps → Language types: uses language types
modules/client/src/main/scala/it/evadid/homepage/control/change/LanguageMapStorageControl.scala - Student or author → Exercise interactions: completes tasks
- Exercise interactions → Interaction sync: syncs interaction state
- Interaction sync → Remote cache: uses remote cache
modules/core/shared/src/main/scala/it/evadid/core/datastructures/storage/RemoteCacheController.scala - Interaction sync → Serialized history: stores history
modules/core/shared/src/main/scala/it/evadid/workbook/interaction/sync/SyncInformation.scala - Interaction sync → IndexedDB sync: uses sync destination
modules/client/src/main/scala/it/evadid/homepage/workbook/syncDestination/LocalIndexedDbStorageSync.scala - Exercise interactions → Browser worker: runs worker tasks
- Exercise interactions → Pyodide execution: runs Python tasks
- Exercise interactions → Feedback diagnosis: requests diagnosis
- Feedback diagnosis → LLM feedback client: requests LLM feedback
- LLM feedback client → JVM command handlers: calls server proxy
- Exercise interactions → TurtleStitch tasks: offers TurtleStitch tasks