Contact person: Web App for Law Exam Simulation Germany

Phone:Show

Email:Show

Location: La Calamine, Germany

Budget: Recommended by industry experts

Time to start: As soon as possible

Project description:
"Development of a Law Exam Simulation Web App – incl. AI Grader & Extended Exam UI
1) Project Goal

We are commissioning the development of a browser‑based, mobile‑optimized web app for simulating law exams in Civil Law, Criminal Law, and Public Law. Core features include an AI case generator, an AI grader (with point scheme & margin comments), a timer/countdown with end time (Europe/Brussels) and progress bar, PDF export, local persistence (resume after reload), lecturer mode, and exam mode with two linked exams. A dedicated essay writing zone is central, which automatically locks once exam time has expired. The application must also implement login/registration and run securely on a server environment. It must comply with the requirements of the Juristenausbildungsgesetz NRW (JAG NRW) and the Juristische Ausbildungs- und Prüfungsordnung (JAPO Bayern).

2) Scope of Features (MVP + Extensions)
2.1 Authentication & User Accounts

Login/Registration (email + password)

Email verification (double opt‑in)

Password reset (token or magic link)

Roles: Student / Lecturer / Admin

Sessions: Secure server sessions or JWT with refresh flow

Rate limiting & brute force protection

2.2 Exam Simulation

Select main subject: Civil Law, Criminal Law, Public Law

Difficulty levels: Beginner, Intermediate, Expert, Bar Exam

Timer: 1–3 hours; display of end time (Europe/Brussels); Start/Pause, Reset; progress bar (percentage & remaining time)

Buttons: New Case, Timer/Pause, Reset, PDF Export

Essay Writing Zone (Markdown editor, autosave, central workspace) – automatically becomes read‑only when time is up

Solution Outline (toggle on/off)

Notes editor

Demo case law references (toggle on/off)

AI prompt template with copy button (clipboard API)

Local persistence (IndexedDB/LocalStorage): timer, text, mode; continue after reload

PDF export: includes case, essay, solution outline (optional), notes, metadata, grading/feedback

2.3 AI Grader (core feature)

Compare student essay vs. solution outline (structure, definitions, application, result)

Evaluate with 0–18 point scheme (configurable), margin comments anchored to text

Feedback categories: structure, focus, norms, reasoning, clarity

Export: PDF with rubric and comments

2.4 Lecturer Mode

Toggle between Student and Lecturer role

Define grading rubrics (weighting: structure, definitions, application, focus)

Add/edit margin comments; reusable feedback snippets

Lock/unlock solution outline and hints

2.5 Exam Mode: Two Linked Exams

Support two tasks with shared or split timer

Combined export (single PDF dossier) and grading overview

3) UI/UX

Header: Logo, role switch, session status (autosave indicator)

Top bar: subject dropdown, difficulty select, New Case, Timer/Pause, Reset, PDF

Timer widget: countdown, end time (Europe/Brussels), progress bar with warning thresholds

Left pane: case facts + toggle for demo case law references

Center pane: Essay Writing Zone (Markdown editor + outline sidebar), AI prompt template (copy)

Right pane: Solution Outline (toggle), Notes editor, in Lecturer mode: rubric & margin comments
Two‑exam mode: tabs Exam 1 / Exam 2, shared timer
4) Tech Stack & Integrations
Frontend: React + Vite/[login to view URL], Zustand/Redux for state, dayjs + timezone (Europe/Brussels)
Editors: Markdown editor (TipTap/CodeMirror/Monaco) with read‑only mode when locked
Backend (server‑side): Node.js (Express/Fastify/NestJS) or Python (FastAPI), PostgreSQL (Prisma/SQLModel)
Authentication: server sessions (signed cookies) or JWT with refresh; email delivery via SMTP/provider
AI Integration: vendor‑agnostic (OpenAI/HuggingFace/local LLM via API); prompt templates with guardrails
PDF export: server‑side (Puppeteer) or client‑side (jsPDF + html2canvas)
Deployment: Linux server, Docker, NGINX reverse proxy, HTTPS (Let’s Encrypt), CI/CD pipeline
Monitoring & Logging: Prometheus/Grafana, centralized logs (ELK/Opensearch)
Backups: automated PostgreSQL dumps, rotation
5) Data Model (MVP)
User(id, role, locale, settings)
Session(id, userId, subject, difficulty, start, duration, end, paused, remainingSec)
Case(id, subject, difficulty, facts, solutionOutline, demoCitations[
Submission(id, sessionId, essayMd, notesMd, lockedAt)
Review(id, submissionId, score, rubricJson, inlineComments[])
6) Timer & Lock
End time = start + duration; display as Europe/Brussels timezone
Persist: remainingSec, paused, lastTickAt; resume after reload
Progress bar = elapsed/duration * 100%
On timeout: Essay Writing Zone becomes read‑only; banner “Time expired – view only”
7) Local Persistence
IndexedDB: essays, notes, outlines
LocalStorage: flags, mode, timer
Autosave every 5s; conflict resolution by timestamp

8) AI Prompt Template (Example)
Role: Law exam grader (German law: BGB/StGB/Constitutional).
Inputs: {Facts}, {Solution Outline}, {Student Essay}.
Task: Check structure, norms, definitions, application, result. Grade 0–18. Create inline comments with anchors. Provide a summary with improvement suggestions.
Format:
- score: <0–18>
- rubric: {structure, definitions, application, focus, clarity}
- inline_comments: [{anchor, category, comment}]
- summary: <max 200 words>
9) PDF Export
Cover page (metadata: subject, difficulty, duration, end time)
Case facts; optional demo references
Essay (Markdown rendered)
Solution outline (toggleable)
Rubric & comments (Lecturer mode)
Two‑exam mode: combined dossier
10) Security, Data Protection & JAG NRW / JAPO Compliance
0–18 grading scale: mandatory (JAG NRW §13; JAPO §2)
Anonymous exams: display candidate ID only; mapping restricted to admin
Two correctors: mandatory in NRW & Bavaria; system must support first/second review + deviation reconciliation; optional third review
Mandatory subjects: Civil, Criminal, Public law; optional specializations (per JAPO §§16–18)
Exam flow: multiple sequential exams; two‑exam mode supported
Allowed materials: whitelist/blacklist per exam profile (legal codes without commentary)
Time & lock: essay zone becomes read‑only when time is up
Audit logs: immutable, signed; log start/stop, pauses, saves, IP/client hash
E‑Exam compatibility (Bavaria, BW, Thuringia): fullscreen lock, interval backups, resume tokens, print/copy restrictions (where technically feasible)
GDPR: TLS, password hashing (Argon2/bcrypt), data minimization, role‑based access, user rights (export/delete)
Server hardening: NGINX reverse proxy, security headers, firewall, backups (encrypted at rest)
11) Acceptance Criteria
Login/registration with email verification and password reset works
RBAC enforced (student/lecturer)
Timer shows end time (Europe/Brussels) correctly; pause/resume; continues after reload
Essay zone autosaves; becomes read‑only when time expires
Demo case law references toggle on/off; state persists
PDF export contains case, essay, (optional) solution, rubric, comments
AI grader returns 0–18 score, rubric, inline comments; exports to PDF
Lecturer mode: grading rubrics, margin comments
Two‑exam mode with shared timer + combined export
Server runs in Docker behind NGINX with HTTPS; backups tested
Compliance with JAG NRW & JAPO requirements: 0–18 points, anonymous ID, dual grading
Tests: >80% unit coverage, 5 end‑to‑end scenarios (timeout, lock, logs, grading) pass
12) Deliverables
Running MVP web app + source code (Git repository)
Setup/operations docs, admin manual, short video walkthrough
Test plan & reports (unit/E2E)
13) Project Organization & Milestones (example)
Week 1: UX prototype, data model, timer proof‑of‑concept
Week 2: Editor suite, autosave, demo references
Week 3: AI grader v1 (API integration, prompt pipeline)
Week 4: Lecturer mode (rubric, comments)
Week 5: Two‑exam mode, PDF dossier
Week 6: Hardening, testing, docs, acceptance
14) Optional/Plus
PWA (offline‑first), user accounts & course rooms, statistics dashboard, real case law import (admin)
15) Required From Freelancer
Short profile, references (EdTech/assessment/AI NLP)
Proposed tech stack + architecture sketch
Effort estimate (fixed price or time‑based), payment plan, risks & assumptions

Annex: Legal Compliance Checklist (NRW & Bavaria)
A) JAG NRW
§13 JAG NRW: 0–18 point grading scale → grading module must support 0–18 incl. decimals
§§14–16 JAG NRW: mandatory first & second corrector → dual grading workflow
§15 JAG NRW: anonymization → candidate ID only
§11 JAG NRW: mandatory subjects → Civil, Criminal, Public Law preset
Exam series → support multiple linked exams
B) JAPO Bavaria
§2 JAPO: 0–18 point grading → identical to NRW
§§16–18 JAPO: subjects incl. specializations → dropdown config
§20 JAPO: dual grading, third review if deviation → workflow support
§21 JAPO: anonymization → candidate ID only
§22 JAPO: exam procedure → timer, essay lock, whitelist of aids
C) E‑Exams (Bavaria, BW, Thuringia)
Fullscreen lock → kiosk mode, warning if left
Backups → autosave + server snapshots

Resume → token‑based rejoin
Audit logs → immutable, signed
D) GDPR
Art. 32: integrity & confidentiality → TLS, encryption, hashing
Art. 15–20: rights to access, correction, deletion, export → features required
Role‑based access → RBAC for student/lecturer/admin" (client-provided description)