EJU Math Vault is a Node.js + Express web app for EJU math training and content management. It delivers timed practice sessions, strict per-blank grading, and an admin editor for questions, answers, and images.

• Email login with 6-digit verification code (JWT-based).
• Timed training sessions with per-blank feedback.
• Admin tooling for question/answer edits and content integrity checks.
• Content indexers for questions, tags, patterns, and HTML rendering.

• src/ Express API (auth, attempts, grading, sessions)
• public/ Frontend pages (training, login, admin)
• content/ Questions, answers, solutions, assets, specs
• content/index/ Generated indexes
• schemas/ JSON schema definitions
• scripts/ Indexers and build-time tools

nvm use 20
npm install

Generate content indexes:

node scripts/content_indexer.js

Start the API server:

JWT_SECRET=devsecret npm run dev

Optional: bind to all interfaces for LAN access:

HOST=0.0.0.0 JWT_SECRET=devsecret npm run dev

Build and run with Docker Compose:

JWT_SECRET=devsecret docker compose up --build

Data and content are mounted for persistence:

• ./data -> /app/data
• ./content -> /app/content The container will generate content/index/question_index.json on first start if missing.

Request a verification code:

curl -s -X POST http://localhost:3000/auth/request-code \
  -H 'Content-Type: application/json' \
  -d '{"email":"test@example.com"}'

Verify the code and receive a JWT:

curl -s -X POST http://localhost:3000/auth/verify-code \
  -H 'Content-Type: application/json' \
  -d '{"email":"test@example.com","code":"123456"}'

• /admin dashboard
• /admin/exams exam browser
• /admin/question/<question_id>/edit question editor

• JWT_SECRET (required)
• HOST (optional bind address)
• PORT (default: 3000)
• ADMIN_TOKEN (optional admin protection)
• DB_PATH (optional data storage path)

• Generated files under content/index/ are not committed.
• content/answers/normalized.json is generated by admin edits.
• Optional: npm run translate:exercise-md-cn generates content/exercise_cn/ from content/exercise/ (requires OPENAI_API_KEY).