How arjundevjha/paperforge works
PaperForge is a Singapore A-Level question-bank and worksheet platform. Its central workflow brings examination papers into the system, extracts and aligns questions with marking schemes, classifies and deduplicates items, then lets teachers review the bank and generate worksheets with matching answer keys. The graph combines documented capabilities with relationships visible in the supplied excerpts and source index; some intake and UI wiring is documented only at a high level.
Main entry points: store.ts Question Data Store · pipeline.ts Ingestion Pipeline · questions/route.ts Questions API · worksheets/route.ts Worksheets API
Components 19
Teacher Web App
- Resource Hub
apps/web/src/components/hub/TeacherResourceHub.tsx - Source Console
apps/web/src/components/sources/SourcesConsole.tsx - Question Bank
apps/web/src/components/questions/QuestionBankMatrix.tsx - Review Queue UI
apps/web/src/components/review/ReviewQueue.tsx - Review API
apps/web/src/app/api/review/route.ts - Questions API
apps/web/src/app/api/questions/route.ts
Paper Intake
- Source API
apps/web/src/app/api/sources/route.ts - Ingestion Pipeline
packages/ingestion/src/pipeline.ts
Question Processing
- Question Parser
packages/questions/src/parser.ts - SEAB Syllabus
packages/shared/src/syllabus.ts - Topic Classification
packages/classification/src/matcher.ts - Duplicate Detection
packages/dedup/src/classifier.ts
Data and Storage
- Question Data Store
packages/db/src/store.ts - File Storage Providers
packages/storage/src/index.ts - Supabase Sync
apps/web/src/lib/supabase/db-sync.ts
Worksheet Delivery
- Worksheets API
apps/web/src/app/api/worksheets/route.ts - Worksheet Engine
packages/worksheets/src/engine.ts - A4 PDF Compiler
packages/pdf/src/compiler.ts
Other components
- Teacher or Tutor
Connections 24
- Teacher or Tutor → Resource Hub: uses
- Resource Hub → Source Console: opens
- Source Console → Source API: uploads papers
- Source API → File Storage Providers: lists files
apps/web/src/app/api/sources/route.ts - Teacher or Tutor → Ingestion Pipeline: submits papers
- Ingestion Pipeline → Question Parser: extracts questions
- Ingestion Pipeline → File Storage Providers: gets provider
packages/ingestion/src/pipeline.ts - Ingestion Pipeline → Question Data Store: ingests package
packages/ingestion/src/pipeline.ts - Ingestion Pipeline → Duplicate Detection: hashes text
packages/ingestion/src/pipeline.ts - Question Parser → Topic Classification: classifies items
- Topic Classification → SEAB Syllabus: aligns topics
packages/classification/src/matcher.ts - Question Data Store → Topic Classification: classifies seeded items
- Question Data Store → Duplicate Detection: checks duplicates
- Teacher or Tutor → Question Bank: browses bank
- Question Bank → Questions API: requests questions
- Questions API → Question Data Store: lists questions
apps/web/src/app/api/questions/route.ts - Questions API → Supabase Sync: syncs questions
apps/web/src/app/api/questions/route.ts - Teacher or Tutor → Review Queue UI: verifies items
- Review Queue UI → Review API: resolves review
- Review API → Question Data Store: updates review
apps/web/src/app/api/review/route.ts - Teacher or Tutor → Worksheets API: requests worksheet
- Worksheets API → Question Data Store: loads questions
apps/web/src/app/api/worksheets/route.ts - Worksheets API → Worksheet Engine: builds manifest
apps/web/src/app/api/worksheets/route.ts - Worksheet Engine → A4 PDF Compiler: generates PDFs
packages/worksheets/src/engine.ts