No description
Find a file
Elijah ccdad9728b
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 33s
Add drag reordering, exam deadlines, frozen shared quizzes, batched OCR and semantic search
- Drag-to-reorder for class materials, folders, quiz questions and deck cards. Pointer-based
  so touch works, plus keyboard (arrows/Home/End) with screen-reader announcements.
- Timed exams get a wall-clock deadline. The server refuses late answers, submits overdue
  exams with what was saved, and the countdown keeps running while the page is closed.
- Shared quiz sessions keep a frozen copy of their questions and flag later owner edits.
- Scanned PDFs are read in cached 8-page batches with real page numbers (pdf-lib), removing
  the 30 MB whole-file limit. Compatible providers now receive PDFs as file parts.
- Semantic search: embeddings for OpenAI, Gemini, Ollama and compatible servers, background
  indexing into chunk_vectors (migration 2), hybrid keyword + vector ranking for search, the
  assistant and focused generation, and a Settings -> AI section.

181 tests pass locally and in the Docker test stage on Node 24.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 11:48:20 -07:00
.forgejo/workflows Add V2 Forgejo workflow publishing study:v2 image 2026-11-12 11:29:22 -07:00
docs Add drag reordering, exam deadlines, frozen shared quizzes, batched OCR and semantic search 2026-11-12 11:48:20 -07:00
scripts Reject mismatched uploads; add local mock AI runner 2026-11-11 13:31:01 -07:00
server Add drag reordering, exam deadlines, frozen shared quizzes, batched OCR and semantic search 2026-11-12 11:48:20 -07:00
shared Address first round of feedback 2026-11-11 18:30:07 -07:00
tests Add drag reordering, exam deadlines, frozen shared quizzes, batched OCR and semantic search 2026-11-12 11:48:20 -07:00
web Add drag reordering, exam deadlines, frozen shared quizzes, batched OCR and semantic search 2026-11-12 11:48:20 -07:00
.dockerignore Harden private media and backup recovery; add V2 deployment and migration guides 2026-11-11 19:31:32 -07:00
.env.example Add the V2 web app: design system, shell, study flows, AI, settings, sharing 2026-11-11 08:53:01 -07:00
.gitattributes Start Study Desk V2: remove V1 sources, add backend foundation 2026-11-11 08:16:41 -07:00
.gitignore Harden private media and backup recovery; add V2 deployment and migration guides 2026-11-11 19:31:32 -07:00
compose.yaml Harden private media and backup recovery; add V2 deployment and migration guides 2026-11-11 19:31:32 -07:00
Dockerfile Add V2 Forgejo workflow publishing study:v2 image 2026-11-12 11:29:22 -07:00
package-lock.json Add drag reordering, exam deadlines, frozen shared quizzes, batched OCR and semantic search 2026-11-12 11:48:20 -07:00
package.json Add drag reordering, exam deadlines, frozen shared quizzes, batched OCR and semantic search 2026-11-12 11:48:20 -07:00
PROGRESS.md Add drag reordering, exam deadlines, frozen shared quizzes, batched OCR and semantic search 2026-11-12 11:48:20 -07:00
README.md Add V2 Forgejo workflow publishing study:v2 image 2026-11-12 11:29:22 -07:00
tsconfig.base.json Start Study Desk V2: remove V1 sources, add backend foundation 2026-11-11 08:16:41 -07:00
tsconfig.json Start Study Desk V2: remove V1 sources, add backend foundation 2026-11-11 08:16:41 -07:00
tsconfig.server.json Start Study Desk V2: remove V1 sources, add backend foundation 2026-11-11 08:16:41 -07:00
tsconfig.web.json Start Study Desk V2: remove V1 sources, add backend foundation 2026-11-11 08:16:41 -07:00
vite.config.ts Add the V2 web app: design system, shell, study flows, AI, settings, sharing 2026-11-11 08:53:01 -07:00
vitest.config.ts Start Study Desk V2: remove V1 sources, add backend foundation 2026-11-11 08:16:41 -07:00

Study Desk V2

A personal study platform for nursing school: classes and folders, quizzes, FSRS flashcards, notes, private documents, and AI-assisted content creation. One administrator; friends study through revocable public links without accounts.

Run locally

Requires Node.js 24 or newer and npm. The development VM currently uses Node 26.

npm.cmd ci
npm.cmd run dev

Open the Vite address printed in the terminal (normally http://localhost:5173). The API listens on port 3726. For the production build locally:

npm.cmd run build
npm.cmd start

Open http://localhost:3726. On a fresh install, enter the setup code from the server log or data/setup-code.txt, then choose your administrator password. Alternatively set ADMIN_PASSWORD for first startup. An optional .env file is loaded by the server; see .env.example. Existing environment variables take precedence.

This checkout already has an ignored .env pointing at .data/ from development. Do not delete it or run reset/seed commands against content you want to keep. The demo seeder is an opt-in development tool, never part of startup.

What is implemented

  • Classes, folders, search, edit/duplicate/move/delete actions; Markdown and embedded images.
  • Multiple-choice and select-all quizzes; practice feedback, exam timers, shuffle, partial credit, saved sessions, missed-question review, results and history.
  • Flashcard editing, browse/self-assessment sessions, FSRS scheduling, persistent reviews, undo, keyboard shortcuts and streak effects.
  • Public quiz/deck/class/folder/note links and explicitly shared documents. Collection shares include current and future quizzes, decks and notes; uploaded documents stay private.
  • JSON import previews, validation, templates, content exports and a V1 SQLite import path.
  • PDF/DOCX/PPTX/TXT/Markdown/image uploads; text extraction, OCR via a configured vision model, chunking and SQLite FTS retrieval with source references.
  • OpenAI, Anthropic, Gemini, OpenAI-compatible and Ollama provider connections, manual/discovered models, task routing, encrypted keys and usage estimates.
  • AI generation with editable drafts; an assistant that searches materials, reads notes, creates drafts, finds weak topics and proposes confirmed content changes.
  • Responsive light/dark interface and an installable app shell. Offline studying is limited: private data is not cached; most operations need a server connection.

Deploy, back up, migrate

See deployment and restore, V1 migration, and AI providers and account integration.

The image runs a single Node process with SQLite and local file storage. No database or queue container is required. The container runs as UID/GID 1000 and persists everything under /data.

docker compose up -d --build

Default V2 host port: 3727, deliberately separate from the old application. Use a separate data folder. Docker Desktop image build and disposable-container runtime checks now pass; Unraid-specific permissions and reverse-proxy checks remain. No production deployment has been performed.

Verification and resuming work

npm.cmd run check

Tests create isolated temporary databases. AI integration tests use a local mock server and need loopback networking. They do not spend provider credits. Real provider credentials, account-specific model access, Linux container behavior and Unraid proxy configuration must be checked in their target environments.

PROGRESS.md records completed work, remaining verification, decisions and the resume procedure. V1 remains on main and in Git history; V2 work is on the v2 branch. Pushing v2 to Forgejo runs CI and publishes the study:v2 image (never :latest); see deployment. Nothing deploys automatically.