How mnprt-here/eldamo-assistant works
Eldamo Assistant is a client-side language-learning revision and test board. Learners search vocabulary, browse course sections, generate customizable quizzes, or play Wordle; the browser UI delegates retrieval to the query engine and quiz generation to the quiz engine, then renders results or answers. Static JSON supplies Quenya words and sentences, with additional language word databases supporting search and games. A Python CLI offers parallel search, revision, and quiz workflows. The JavaScript excerpts are partial, so some UI-to-engine wiring is based on the documented feature flow; only evidenced links are shown.
Main entry points: app.js Browser query engine · query_engine.py Python query engine · cli.py Terminal workflows · index.html SPA interface
Components 14
Web application
- SPA interface
index.html - UI workflows
app.js
Learning engines
- Browser query engine
app.js - Browser quiz engine
app.js - Wordle game
app.js - Python query engine
query_engine.py - Python quiz engine
quiz_engine.py
Study content
- Quenya words
database/quenya-english-words.json - Quenya sentences
database/quenya-english-exercise-sentences.json - Neo-Quenya index
database/words-nq.json - Neo-Sindarin index
database/words-ns.json
CLI application
- Terminal workflows
cli.py
Other components
- Learner
- CLI user
Connections 15
- Learner → SPA interface: opens
- SPA interface → UI workflows: hosts
- UI workflows → Browser query engine: searches and retrieves
- UI workflows → Browser quiz engine: configures and generates
- UI workflows → Wordle game: starts game
- Browser query engine → Neo-Quenya index: reads
- Browser query engine → Neo-Sindarin index: reads
- Browser quiz engine → Browser query engine: retrieves sections
- Wordle game → Browser query engine: uses word index
- CLI user → Terminal workflows: uses
- Terminal workflows → Python query engine: searches and revises
- Terminal workflows → Python quiz engine: generates quizzes
- Python quiz engine → Python query engine: retrieves sections
- Python query engine → Quenya words: loads
- Python query engine → Quenya sentences: loads