How mohd-ali-creator/autoqp works
AutoQP is a web platform for managing a subject-scoped question bank and producing exam PDFs. Its main workflow is human-reviewed question intake, bank search and blueprint-based paper assembly, followed by LaTeX compilation and PDF/source output. The web app exposes thin API routes over domain modules; an isolated compile worker handles the compilation capability. Major documented branches also include authentication and subject access. Source excerpts are empty, so relationships rely on README architecture statements; unsampled implementation details and data-store wiring are not asserted.
Main entry points: staging/route.ts Staging API · papers/route.ts Papers API · compile-paper.ts Paper compilation · auth/route.ts Auth API
Components 21
Access
- Auth API
apps/web/app/api/auth/route.ts - Session auth
apps/web/modules/auth/session.ts - Subject access
apps/web/modules/auth/subject-access.ts
Question Intake
- Staging API
apps/web/app/api/staging/route.ts - 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 - Question contract
packages/schema/src/question.schema.ts
Bank & Assembly
- Questions API
apps/web/app/api/questions/route.ts - 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 - Papers API
apps/web/app/api/papers/route.ts - Paper assembly
apps/web/modules/bank/assemble-paper.ts
Compilation
- Compile API
apps/web/app/api/compile/route.ts - Paper compilation
apps/web/modules/compile/compile-paper.ts - Paper preview
apps/web/modules/compile/components/PaperPreview.tsx - Compile worker
apps/compile-worker/src/compile.ts - LaTeX template
apps/compile-worker/templates/standard.tex.hbs
Other components
- Exam staff
- Supabase
Connections 19
- Exam staff → Auth API: authenticates
README.md - Auth API → Session auth: delegates to
README.md - Exam staff → Staging API: submits input
README.md - Staging API → Input extraction: delegates to
README.md - Staging API → Question generation: delegates to
README.md - Staging API → Staging review: delegates to
README.md - Exam staff → Questions API: searches bank
README.md - Questions API → Question search: delegates to
README.md - Exam staff → Papers API: requests paper
README.md - Papers API → Blueprint generation: delegates to
README.md - Papers API → Paper assembly: delegates to
README.md - Compile API → Paper compilation: delegates to
README.md - Paper compilation → Compile worker: invokes
- Compile worker → LaTeX template: renders with
- Paper compilation → Paper preview: provides preview
- Input extraction → Question contract: uses contract
- Question generation → Question contract: uses contract
- Session auth → Supabase: uses
- Subject access → Supabase: checks access