How milind2k4/autoqp works
AutoQP is a centralized, AI-assisted exam question bank and LaTeX-to-PDF platform. Its principal workflow takes source material through question extraction or generation, human staging review, subject-scoped bank search, blueprint-based paper assembly, and compilation to PDF and raw LaTeX. The graph also includes authentication, shared question contracts, and the web/API boundary. The README documents the intended route-to-module split and isolated compiler; sampled route and compiler excerpts are empty, so detailed calls and storage interactions cannot be verified.
Main entry points: page.tsx Web application · staging-review.ts Staging review · route.ts Auth API · compile-paper.ts Paper compilation
Components 21
Web and API
- Web application
apps/web/app/page.tsx - Auth API
apps/web/app/api/auth/route.ts - Session handling
apps/web/modules/auth/session.ts - Subject access
apps/web/modules/auth/subject-access.ts - Staging API
apps/web/app/api/staging/route.ts - Questions API
apps/web/app/api/questions/route.ts - Papers API
apps/web/app/api/papers/route.ts - Compile API
apps/web/app/api/compile/route.ts
Question Intake
- Input extraction
apps/web/modules/intake/extract-from-input.ts - Question generation
apps/web/modules/intake/generate-questions.ts - Staging review
apps/web/modules/intake/staging-review.ts
Bank and Assembly
- Question search
apps/web/modules/bank/search-questions.ts - Question card
apps/web/modules/bank/components/QuestionCard.tsx - Blueprint generation
apps/web/modules/bank/blueprint-generator.ts - Paper assembly
apps/web/modules/bank/assemble-paper.ts
Paper Compilation
- Paper compilation
apps/web/modules/compile/compile-paper.ts - Paper preview
apps/web/modules/compile/components/PaperPreview.tsx - Tectonic worker
apps/compile-worker/src/compile.ts - LaTeX template
apps/compile-worker/templates/standard.tex.hbs
Shared Contracts
- Question schema
packages/schema/src/question.schema.ts
Other components
- Exam staff
Connections 20
- Exam staff → Web application: uses
README.md - Web application → Auth API: requests auth
- Auth API → Session handling: delegates auth
README.md - Web application → Staging API: submits intake
- Staging API → Staging review: delegates review
README.md - Web application → Questions API: requests questions
- Questions API → Question search: delegates search
README.md - Web application → Papers API: requests papers
- Papers API → Paper assembly: delegates assembly
README.md - Web application → Compile API: requests compile
- Compile API → Paper compilation: delegates compile
README.md - Input extraction → Staging review: stages questions
- Question generation → Staging review: stages questions
- Staging review → Question schema: uses contract
- Question search → Question card: feeds display
- Paper assembly → Blueprint generation: uses blueprint
- Paper compilation → Tectonic worker: dispatches compile
README.md - Tectonic worker → LaTeX template: renders template
- Paper compilation → Paper preview: provides preview
- Auth API → Subject access: checks access