# mohd-ali-creator/autoqp architecture

> Architecture diagram of the GitHub repository mohd-ali-creator/autoqp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mohd-ali-creator/autoqp
- Repository: https://github.com/mohd-ali-creator/autoqp

## Overview

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: [`apps/web/app/api/staging/route.ts`](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/staging/route.ts) (Staging API), [`apps/web/app/api/papers/route.ts`](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/papers/route.ts) (Papers API), [`apps/web/modules/compile/compile-paper.ts`](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/compile/compile-paper.ts) (Paper compilation), [`apps/web/app/api/auth/route.ts`](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/auth/route.ts) (Auth API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation["Access"]
  node_auth_route["Auth API<br/>[route.ts]"]
  node_session["Session auth<br/>[session.ts]"]
  node_subject_access["Subject access<br/>[subject-access.ts]"]
end

subgraph group_intake["Question Intake"]
  node_staging_api["Staging API<br/>[route.ts]"]
  node_extract["Input extraction"]
  node_generation["Question generation"]
  node_staging_review["Staging review<br/>[staging-review.ts]"]
  node_schema["Question contract<br/>[question.schema.ts]"]
end

subgraph group_bank["Bank &amp; Assembly"]
  node_questions_api["Questions API<br/>[route.ts]"]
  node_search["Question search"]
  node_question_card["Question card<br/>[QuestionCard.tsx]"]
  node_blueprint["Blueprint generation"]
  node_papers_api["Papers API<br/>[route.ts]"]
  node_assembly["Paper assembly<br/>[assemble-paper.ts]"]
end

subgraph group_compile["Compilation"]
  node_compile_api["Compile API<br/>[route.ts]"]
  node_compile_paper["Paper compilation<br/>[compile-paper.ts]"]
  node_preview["Paper preview<br/>[PaperPreview.tsx]"]
  node_worker["Compile worker<br/>[compile.ts]"]
  node_tex_template["LaTeX template<br/>[standard.tex.hbs]"]
end

node_user(("Exam staff"))
node_supabase[("Supabase")]

node_user -->|"authenticates"| node_auth_route
node_auth_route -->|"delegates to"| node_session
node_user -->|"submits input"| node_staging_api
node_staging_api -->|"delegates to"| node_extract
node_staging_api -->|"delegates to"| node_generation
node_staging_api -->|"delegates to"| node_staging_review
node_user -->|"searches bank"| node_questions_api
node_questions_api -->|"delegates to"| node_search
node_user -->|"requests paper"| node_papers_api
node_papers_api -->|"delegates to"| node_blueprint
node_papers_api -->|"delegates to"| node_assembly
node_compile_api -->|"delegates to"| node_compile_paper
node_compile_paper -.->|"invokes"| node_worker
node_worker -.->|"renders with"| node_tex_template
node_compile_paper -.->|"provides preview"| node_preview
node_extract -.->|"uses contract"| node_schema
node_generation -.->|"uses contract"| node_schema
node_session -.->|"uses"| node_supabase
node_subject_access -.->|"checks access"| node_supabase

click node_auth_route "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/auth/route.ts"
click node_session "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/auth/session.ts"
click node_subject_access "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/auth/subject-access.ts"
click node_staging_api "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/staging/route.ts"
click node_extract "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/intake/extract-from-input.ts"
click node_generation "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/intake/generate-questions.ts"
click node_staging_review "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/intake/staging-review.ts"
click node_questions_api "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/questions/route.ts"
click node_search "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/bank/search-questions.ts"
click node_question_card "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/bank/components/QuestionCard.tsx"
click node_blueprint "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/bank/blueprint-generator.ts"
click node_papers_api "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/papers/route.ts"
click node_assembly "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/bank/assemble-paper.ts"
click node_compile_api "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/compile/route.ts"
click node_compile_paper "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/compile/compile-paper.ts"
click node_preview "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/compile/components/PaperPreview.tsx"
click node_worker "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/compile-worker/src/compile.ts"
click node_tex_template "https://github.com/mohd-ali-creator/autoqp/blob/main/apps/compile-worker/templates/standard.tex.hbs"
click node_schema "https://github.com/mohd-ali-creator/autoqp/blob/main/packages/schema/src/question.schema.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_route,node_session,node_subject_access toneBlue
class node_staging_api,node_extract,node_generation,node_staging_review,node_schema,node_supabase toneAmber
class node_questions_api,node_search,node_question_card,node_blueprint,node_papers_api,node_assembly toneMint
class node_compile_api,node_compile_paper,node_preview,node_worker,node_tex_template toneRose
class node_user toneIndigo
```

## Components

### Access

- [Auth API](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/auth/route.ts): `apps/web/app/api/auth/route.ts`
- [Session auth](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/auth/session.ts): `apps/web/modules/auth/session.ts`
- [Subject access](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/auth/subject-access.ts): `apps/web/modules/auth/subject-access.ts`

### Question Intake

- [Staging API](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/staging/route.ts): `apps/web/app/api/staging/route.ts`
- [Input extraction](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/intake/extract-from-input.ts): `apps/web/modules/intake/extract-from-input.ts`
- [Question generation](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/intake/generate-questions.ts): `apps/web/modules/intake/generate-questions.ts`
- [Staging review](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/intake/staging-review.ts): `apps/web/modules/intake/staging-review.ts`
- [Question contract](https://github.com/mohd-ali-creator/autoqp/blob/main/packages/schema/src/question.schema.ts): `packages/schema/src/question.schema.ts`

### Bank & Assembly

- [Questions API](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/questions/route.ts): `apps/web/app/api/questions/route.ts`
- [Question search](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/bank/search-questions.ts): `apps/web/modules/bank/search-questions.ts`
- [Question card](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/bank/components/QuestionCard.tsx): `apps/web/modules/bank/components/QuestionCard.tsx`
- [Blueprint generation](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/bank/blueprint-generator.ts): `apps/web/modules/bank/blueprint-generator.ts`
- [Papers API](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/papers/route.ts): `apps/web/app/api/papers/route.ts`
- [Paper assembly](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/bank/assemble-paper.ts): `apps/web/modules/bank/assemble-paper.ts`

### Compilation

- [Compile API](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/app/api/compile/route.ts): `apps/web/app/api/compile/route.ts`
- [Paper compilation](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/compile/compile-paper.ts): `apps/web/modules/compile/compile-paper.ts`
- [Paper preview](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/web/modules/compile/components/PaperPreview.tsx): `apps/web/modules/compile/components/PaperPreview.tsx`
- [Compile worker](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/compile-worker/src/compile.ts): `apps/compile-worker/src/compile.ts`
- [LaTeX template](https://github.com/mohd-ali-creator/autoqp/blob/main/apps/compile-worker/templates/standard.tex.hbs): `apps/compile-worker/templates/standard.tex.hbs`

### Other components

- **Exam staff**
- **Supabase**

## Connections

- Exam staff → Auth API: authenticates (evidence: `README.md`)
- Auth API → Session auth: delegates to (evidence: `README.md`)
- Exam staff → Staging API: submits input (evidence: `README.md`)
- Staging API → Input extraction: delegates to (evidence: `README.md`)
- Staging API → Question generation: delegates to (evidence: `README.md`)
- Staging API → Staging review: delegates to (evidence: `README.md`)
- Exam staff → Questions API: searches bank (evidence: `README.md`)
- Questions API → Question search: delegates to (evidence: `README.md`)
- Exam staff → Papers API: requests paper (evidence: `README.md`)
- Papers API → Blueprint generation: delegates to (evidence: `README.md`)
- Papers API → Paper assembly: delegates to (evidence: `README.md`)
- Compile API → Paper compilation: delegates to (evidence: `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
