This chapter sketches the MVP surfaces so you can visualize how Mnemo will feel before we cut any HTML. Each section shows the page layout (ASCII mockups) plus the backing data flow so we know exactly which tables/LLM calls power every click.
┌───────────────────────────────────────────────┐
│ Mnemo │
│-----------------------------------------------│
│ Tracks [+ Add track]
│ [★] Greek — "basic travel" [Test Me] [⚙] │
│ [ ] German — "advanced" [Test Me] [⚙] │
│ │
│ Next up │
│ Grammar: Present tense -ω verbs (due now) │
│ Vocab: Ordering coffee in Athens │
│ │
│ Session length │
│ ( slider ▭▭▭▭▭ ) 10 prompts │
│ │
│ [ Test Me ] │
└───────────────────────────────────────────────┘
Landing page after login.
Lists every language track with a quick “Test Me” button and a link to configure ([⚙]).
Dedicated + Add track button opens the track wizard without diving into settings.
Shows the current queue preview chosen by the scheduler so learners know what’s coming.
Session length slider (or dropdown) feeds the scheduler before it generates the batch.
Interaction Reads Writes / Calls
Render track list user_language_tracks (filtered by user_id), joined with track_factor_selection for status summary— “Next up” preview Scheduler pulls due pairs from srs_state + track_factor_selection, plus vocab metadata from vocab_groups — Session length slider none (pure UI until submit) value passed to scheduler request Test Me Scheduler queries srs_state and enqueues (grammar_factor_id, vocab_group_id) pairs; generator prompt built from those rows generator LLM call (no DB write until answer) + Add track — navigates to add-track page
┌───────────────────────────────────────────────┐
│ New Track │
│-----------------------------------------------│
│ Language: [Greek ▾] │
│ Descriptor: ["basic travel"] │
│ Native lang: English (read-only) │
│ Experience: [Beginner ▾] │
│ │
│ [Continue to Grammar ▶] │
└───────────────────────────────────────────────┘
Lightweight wizard (one screen for MVP) invoked from “Add track” or [⚙].
Language dropdown lists only the curated bundles we ship—no custom languages in the UI.
Descriptor is the only freeform field so learners can remind themselves of the track’s intent.
Native language is shown for context (editable elsewhere in profile settings).
Continue button jumps straight to the grammar checklist for that track.
Interaction Reads Writes / Calls
Populate language dropdown language_grammar_factors (distinct language_name seeded in code)— Show native language users.native_language— Save/Continue — Insert into user_language_tracks (language, descriptor, experience, cadence). Seed track_factor_selection rows for every curated factor with default enabled=false. Cancel — none
┌───────────────────────────────────────────────┐
│ Greek Grammar Factors │
│-----------------------------------------------│
│ [x] Alphabet basics 12 prompts · 92% ✔ │
│ [x] Present tense -ω verbs 7 prompts · 57% ✔ │
│ [ ] Café ordering phrases 0 prompts yet │
│ [ ] Transit emergencies 0 prompts yet │
│-----------------------------------------------│
│ Stats update automatically from your attempts │
│ │
│ [Save changes] [Back to track] │
└───────────────────────────────────────────────┘
Shows the curated checklist shipped in code for the selected language.
Each row is just a checkbox: enabled items feed the scheduler; disabled ones are ignored.
Attempt counts + correctness summaries are read-only data pulled from recent practice history.
Save writes track_factor_selection; there’s still no freeform editing of factors in MVP.
Interaction Reads Writes / Calls
Render checklist language_grammar_factors (for the selected language) joined with track_factor_selection for this track_id— Show stats Aggregate attempts scoped to track_id + grammar_factor_id (count + % correct derived from last N judge entries) — Toggle checkbox — Updates track_factor_selection.enabled (boolean) in place. Save — persists all pending toggles in one transaction
┌───────────────────────────────────────────────┐
│ Vocabulary Areas (Greek) │
│-----------------------------------------------│
│ ▼ Ordering coffee (12 words ready) │
│ καφές ✖ ελληνικός ✖ ζάχαρη ✖ │
│ [ + More suggestions ] │
│ ▶ Transit pickups (collapsed) │
│ │
│ + Add new area │
│-----------------------------------------------│
│ Add Area │
│ Description: ["Emergency room visit"] │
│ Guidance: (textarea for extra hints) │
│ [Generate 15 words] │
│ │
│ Suggestions │
│ νοσοκομείο ✖ τραύμα ✖ ασφάλιση ✖ │
│ │
│ [Accept list] [Regenerate] [ + More suggestions ]
└───────────────────────────────────────────────┘
Existing vocab areas render as an accordion: collapsed rows show the label + word count, while expanded rows expose the words with per-word trash icons and a per-area “+ More suggestions” button.
Bottom panel lets the user describe a new area; clicking Generate calls the LLM and shows the 10–20 suggested words.
MVP lets you accept the current list, regenerate entirely, or ask for a few more words before saving.
Interaction Reads Writes / Calls
Render area list vocab_groups (per track_id) + word counts from group_words join vocab_items— Expand area Fetch group_words + vocab_items rows for that group — Delete word — Delete row from group_words; cleanup orphaned vocab_items if no other references + More suggestions (existing area) Context: track_id, area metadata, remaining words; call vocab generator LLM On accept, insert new vocab_items + group_words Add new area → Generate — LLM call with (track_id, area_description, guidance) Accept new area list — Insert into vocab_groups, vocab_items, group_words
┌───────────────────────────────────────────────┐
│ Prompt 3 of 10 │
│ Grammar focus: Present tense -ω verbs │
│ Vocab focus: Ordering coffee │
│-----------------------------------------------│
│ Translate into Greek: │
│ "I would like a sweet coffee, please." │
│ │
│ [ textarea for answer ] │
│ │
│ [ Submit answer ] │
└───────────────────────────────────────────────┘
Displays the single prompt currently under review with explicit grammar + vocab badges.
Submit posts to the judge; there are no hints, retries, or partial credit UI in MVP.
After submission we immediately show verdict + model answer inline (next section).
Interaction Reads Writes / Calls
Render prompt Scheduler selects due pair from srs_state + track_factor_selection; generator LLM pulls: factor metadata (language_grammar_factors), vocab words (vocab_items), recent attempts for context Inserts a stub row in attempts with generator payload + prompt ID Submit answer — Judge LLM invoked with prompt + learner answer. Result stored in judge_actions + updates attempts.verdict. Update srs_state scores for the affected factor + vocab group.
┌───────────────────────────────────────────────┐
│ Result │
│-----------------------------------------------│
│ Focus item Verdict Notes │
│ Grammar • Present -ω verbs ✖ Missing article
│ Word • καφές ✔ Nailed it
│ Word • ζάχαρη ✖ Forgot accent
│-----------------------------------------------│
│ Model answer: «Θα ήθελα έναν γλυκό καφέ, παρακαλώ.»
│ Your answer: «Θέλω γλυκό καφέ παρακαλώ» │
│-----------------------------------------------│
│ [Next prompt ▶] │
│ │
│ Recent attempts │
│ ✔ #1021 Greek / coffee / present tense │
│ ✖ #1020 Greek / transit / aorist │
└───────────────────────────────────────────────┘
Immediately follows the prompt view after judge response.
Shows per-item verdicts for every grammar factor + vocab word that was targeted, mirroring what we log in the DB.
Model vs learner answers stay visible for quick comparison.
Recent attempts sidebar offers quick navigation across the session.
Interaction Reads Writes / Calls
Render verdict table judge_actions rows filtered by attempt_id, joined with language_grammar_factors/vocab_items for display names— Show model vs learner answer attempts.prompt_blob + attempts.answer_blob— Recent attempts list latest attempts for the track ordered by created_at — “Next prompt” same as Practice Session flow (scheduler + generator) See Section 5
┌───────────────────────────────────────────────┐
│ Settings │
│-----------------------------------------------│
│ Profile │
│ Display name [Niko] │
│ Email [nikomatsakis@…] │
│ Native lang [English ▾] │
│ Password [••••••] [Change] │
│ │
│ Data │
│ [Delete my account] │
│-----------------------------------------------│
│ Admin (password required) │
│ [Unlock console] │
│ Users: (table appears after unlock) │
└───────────────────────────────────────────────┘
Combines user profile edits, account deletion, and the admin override switch.
Admin unlock (via env-set password) reveals a simple table where the operator can reset passwords, remove users, or pause sign-ups; no multi-tenant tools yet.
Data export is intentionally deferred until after the MVP loop is live.
Interaction Reads Writes / Calls
Render profile users row for the authenticated user— Update profile fields — Update users (display name, email, native language). Password change writes to users.password_hash. Delete my account — Delete from users cascade to tracks/vocab/attempts (enforced via FK). Admin unlock — Checks shared admin password (env). On success, loads summary list from users and user_language_tracks. Admin actions users/user_language_tracks as neededReset password, delete user, toggle “allow sign-ups” flag stored in config table (future).
With these mockups and data notes we can now trace an MVP user story end to end—UI, queries, writes, and LLM calls all line up with the schema from the Architecture chapter. This should stay in sync with future iterations so we keep the “docs from the future” promise before building screens.