How saptarshi-bandopadhyay/axiom works
ReproCheck is a full-stack research-methodology reviewer. A researcher submits a PDF or pasted text through the UI; the backend validates and prepares the paper, then runs a staged review with a reviewer-approved checklist before returning findings, contradictions, and an assessment. The UI also supports grounded Q&A. The README documents the review lifecycle; sampled files and the SOURCE INDEX support key wiring, but several route and workflow-node implementations were not inspected, so uncertain links are omitted.
Main entry points: graph.py Workflow Graph · workflow_service.py Workflow Service · App.tsx Review App · client.ts API Client
Components 28
Reviewer UI
- Review App
frontend/src/App.tsx - Submission Form
frontend/src/components/SubmissionForm.tsx - Paradigm Selector
frontend/src/components/ParadigmSelector.tsx - API Client
frontend/src/api/client.ts - Checklist Editor
frontend/src/components/ChecklistEditor.tsx - Report View
frontend/src/components/ReviewReportView.tsx - Grounded Q&A
frontend/src/components/GroundedQnADrawer.tsx
API and Ingestion
- Session Routes
backend/app/api/sessions.py - Checklist Routes
backend/app/api/checklists.py - Review Routes
backend/app/api/reviews.py - Q&A Route
backend/app/api/qna.py - Input Guardrails
backend/app/core/guardrails.py - PDF Extraction
backend/app/services/pymupdf_extractor.py - File Storage
backend/app/services/local_storage.py
Review Workflow
- Workflow Service
backend/app/services/workflow_service.py - Workflow Graph
backend/app/workflows/graph.py - Paradigm Classification
backend/app/workflows/nodes/classify.py - Checklist Generation
backend/app/workflows/nodes/checklist.py - Human Approval
backend/app/workflows/nodes/approval.py - Methodology Review
backend/app/workflows/nodes/review.py - Consistency Check
backend/app/workflows/nodes/consistency.py - Assessment Synthesis
backend/app/workflows/nodes/assessment.py - Grounded Answers
backend/app/workflows/nodes/qna.py - LLM Gateway
backend/app/core/llm_gateway.py
State and Models
- Workflow State
backend/app/workflows/state.py - Review Sessions
backend/app/models/session.py
Other components
- Researcher
- PostgreSQL
Connections 36
- Researcher → Submission Form: submits paper
README.md - Submission Form → Paradigm Selector: selects paradigm
frontend/src/components/SubmissionForm.tsx - Review App → Submission Form: renders
frontend/src/App.tsx - Review App → API Client: requests data
frontend/src/App.tsx - API Client → Session Routes: sends submissions
frontend/src/api/client.ts - API Client → Checklist Routes: approves checklist
frontend/src/api/client.ts - API Client → Review Routes: fetches report
frontend/src/api/client.ts - API Client → Q&A Route: asks questions
frontend/src/api/client.ts - Review App → Checklist Editor: renders
frontend/src/App.tsx - Review App → Report View: renders
frontend/src/App.tsx - Review App → Grounded Q&A: renders
frontend/src/App.tsx - Session Routes → Input Guardrails: validates input
backend/app/api/sessions.py - Session Routes → PDF Extraction: extracts PDF
backend/app/api/sessions.py - Session Routes → File Storage: stores upload
backend/app/api/sessions.py - Session Routes → Workflow Service: starts workflow
backend/app/api/sessions.py - Workflow Service → Workflow Graph: creates and runs
backend/app/services/workflow_service.py - Workflow Service → Review Sessions: updates status
backend/app/services/workflow_service.py - Review Sessions → PostgreSQL: persists records
- Workflow Graph → Paradigm Classification: dispatches
backend/app/workflows/graph.py - Workflow Graph → Checklist Generation: dispatches
backend/app/workflows/graph.py - Workflow Graph → Human Approval: dispatches
backend/app/workflows/graph.py - Workflow Graph → Methodology Review: dispatches
backend/app/workflows/graph.py - Workflow Graph → Consistency Check: dispatches
backend/app/workflows/graph.py - Workflow Graph → Assessment Synthesis: dispatches
backend/app/workflows/graph.py - Paradigm Classification → Checklist Generation: precedes
README.md - Checklist Generation → Human Approval: pauses for review
README.md - Human Approval → Methodology Review: resumes after approval
README.md - Methodology Review → Consistency Check: precedes
README.md - Consistency Check → Assessment Synthesis: precedes
README.md - Checklist Generation → LLM Gateway: generates criteria
backend/app/workflows/nodes/checklist.py - Methodology Review → LLM Gateway: evaluates paper
backend/app/workflows/nodes/review.py - Grounded Answers → LLM Gateway: answers question
backend/app/workflows/nodes/qna.py - Workflow Service → Grounded Answers: delegates answers
backend/app/services/workflow_service.py - Review Routes → Workflow Service: reads snapshot
backend/app/api/reviews.py - Q&A Route → Workflow Service: requests answer
- Checklist Routes → Workflow Service: resumes review