Restore study gestures and shuffle progress; harden note autosave and record V1 comparison

This commit is contained in:
Elijah 2026-11-11 20:00:17 -07:00
parent 4bf121728b
commit d7e19db468
8 changed files with 236 additions and 37 deletions

View file

@ -1,7 +1,8 @@
# Study Desk V2 — progress and resume notes
Updated 2026-11-11. Branch: **v2**. Original V1: **main**, preserved at `7bd0a9a`.
Work remains local; no push, repository creation or production deployment has been performed.
The owner authorized publishing progress and `v2` now tracks Forgejo `origin/v2`.
No production deployment has been performed.
## Product and architecture
@ -45,9 +46,10 @@ The earlier agent manually exercised quiz completion/results, flashcards, streak
mock AI generation through the assistant, editable drafts, and a 375px home page without
horizontal overflow. Treat these as historical evidence; record Terra's fresh results below.
Not verified: actual Docker image build/runtime, Unraid filesystem permissions and proxy,
paid provider inference, real ChatGPT OAuth/eligibility. Docker is not installed here. Do not
claim these have been tested. The installable app caches its shell, not private study data;
Docker Desktop is now installed. Image build and a disposable non-root container passed
login, document/card persistence across restart, full-backup ZIP, anonymous sharing and
private API denial. Still unverified: Unraid filesystem permissions/proxy, paid-provider
inference and real ChatGPT OAuth/eligibility. The installable app caches its shell, not private study data;
full offline administrator study is not implemented.
## Remaining work
@ -67,9 +69,21 @@ full offline administrator study is not implemented.
3. `npm.cmd run check` (tests require localhost networking for their mock AI server).
4. `npm.cmd run dev` for Vite + API, or `npm.cmd run build` then `npm.cmd start` for the built
app. See README and .env.example. All automated test databases are disposable copies.
5. Keep regular local commits on `v2`. Do not push until the owner explicitly changes the
original local-only instruction. Publishing later can use `git push -u origin v2` after
reviewing the diff and confirming credentials; no force push is needed.
5. Keep focused commits on `v2`. The owner has now authorized pushing progress to this branch;
Git Credential Manager works. Never force push or publish/deploy to production implicitly.
## V1 comparison and follow-up usability work
See `docs/V2-COMPARISON.md` for the requirement matrix, V1 differences and remaining priorities.
Fixed the flashcard entrance/exit CSS conflict; restored touch grading and shuffle-remaining;
reset review queues on scope changes; serialized note autosaves, protected navigation with
unsaved edits and added an explicit retry action. Verified a note survives immediate
navigation and reload, and shuffling keeps browse progress at 2/4 rather than restarting.
The owner's rationale check passed using a synthetic three-question quiz with per-option
explanations: correct, incorrect and partial SATA feedback all show explanations inline under
their options. Results group explanations with each question. Screenshot is ignored at
`.test-data/rationale-check/correct-inline.png`. The temporary test server is stopped after QA.
## Fresh UI QA findings