How baodam2001/algo-learn works
algo-learn is an interactive learning platform for algorithms and data-structures courses. A learner selects a topic and question in the Svelte app; the shared question catalog and router identify a generator, which produces an exercise for the UI to display and interact with. The shared package also contains generators across logic, automata, graphs, mathematics, and core data structures, with reusable algorithm utilities. The graph uses documented imports for confirmed links; frontend routing and rendering links are dashed because the relevant route excerpts were not provided.
Main entry points: QuestionRouter.ts Question router · resolution.ts Resolution exercise · questionsSelection.stable.ts Question selection · automaton Automata exercises
Components 24
Learner experience
- Web routes
packages/svelte-front-end/src/routes - Question catalogue
packages/svelte-front-end/src/lib/components/catalogue/Catalogue.svelte - Question view
packages/svelte-front-end/src/lib/components/ViewSingleQuestion.svelte - Exercise interaction
packages/svelte-front-end/src/lib/components/InteractWithQuestion.svelte
Question runtime
- Question selection
packages/settings/questionsSelection.stable.ts - Question router
packages/shared/src/api/QuestionRouter.ts - Question contracts
packages/shared/src/api/QuestionGenerator.ts - Parameter handling
packages/shared/src/api/Parameters.ts
Question generators
- Automata exercises
packages/shared/src/question-generators/automaton - Automaton generation
packages/shared/src/question-generators/automaton/generate/automatonGenerator.ts - Logic exercises
packages/shared/src/question-generators/propositional-logic - Resolution exercise
packages/shared/src/question-generators/propositional-logic/resolution.ts - Graph exercises
packages/shared/src/question-generators/graph-algorithms - Data structures
packages/shared/src/question-generators - Math exercises
packages/shared/src/question-generators/math - Other exercises
packages/shared/src/question-generators
Shared logic
- Seeded randomness
packages/shared/src/utils/random.ts - Graph utilities
packages/shared/src/utils/graph.ts - Propositional logic
packages/shared/src/utils/propositionalLogic/propositionalLogic.ts - Resolution utilities
packages/shared/src/utils/propositionalLogic/resolution.ts - Translations
packages/shared/src/utils/translations.ts - Text formatting
packages/shared/src/utils/format.ts - Markdown parsing
packages/shared/src/utils/parseMarkdown.ts
Other components
- Learner
Connections 23
- Learner → Web routes: opens
- Web routes → Question catalogue: shows catalogue
- Question catalogue → Question router: selects question
- Web routes → Question selection: loads collection
- Question selection → Automata exercises: registers generators
packages/settings/questionsSelection.stable.ts - Question selection → Logic exercises: registers generators
packages/settings/questionsSelection.stable.ts - Question selection → Data structures: registers generators
packages/settings/questionsSelection.stable.ts - Question router → Parameter handling: parses parameters
packages/shared/src/api/QuestionRouter.ts - Question router → Question contracts: uses contract
packages/shared/src/api/QuestionRouter.ts - Question router → Question view: provides question
- Question view → Exercise interaction: renders exercise
- Automata exercises → Automaton generation: uses generation
packages/shared/src/question-generators/automaton/congruence.ts - Automata exercises → Question router: serializes link
packages/shared/src/question-generators/automaton/congruence.ts - Automata exercises → Seeded randomness: uses randomness
packages/shared/src/question-generators/automaton/congruence.ts - Resolution exercise → Question router: serializes link
packages/shared/src/question-generators/propositional-logic/resolution.ts - Resolution exercise → Propositional logic: uses literals
packages/shared/src/question-generators/propositional-logic/resolution.ts - Resolution exercise → Resolution utilities: uses resolution
packages/shared/src/question-generators/propositional-logic/resolution.ts - Resolution exercise → Seeded randomness: uses randomness
packages/shared/src/question-generators/propositional-logic/resolution.ts - Propositional logic → Graph utilities: builds rooted tree
packages/shared/src/utils/propositionalLogic/propositionalLogic.ts - Propositional logic → Markdown parsing: uses markdown tools
packages/shared/src/utils/propositionalLogic/propositionalLogic.ts - Propositional logic → Resolution utilities: uses resolution
packages/shared/src/utils/propositionalLogic/propositionalLogic.ts - Translations → Text formatting: formats text
packages/shared/src/utils/translations.ts - Question contracts → Parameter handling: types parameters
packages/shared/src/api/QuestionGenerator.ts