How zabrodsk/proof works
Proof is a web app for reviewing AP Seminar drafts, discovering scholarly sources, and producing MLA citations, alongside a separate landing page and waitlist. The main workflow is: a student imports or uploads a draft and sources, submits a review, and receives findings and evidence; the Studio workflow persists account-owned documents and runs through a worker, while the class workspace keeps review data in browser storage. The graph also preserves discovery, integrations, citation tools, and the separate waitlist. Some domain modules are represented from README capabilities and the source index; their internal calls are omitted where excerpts do not establish them.
Main entry points: main.tsx App entry · StudioSession.tsx Studio session · Classroom.tsx Class workspace · classroom.ts Class review jobs
Components 25
Application experience
- App entry
src/main.tsx - Studio workspace
src/Studio.tsx - Studio session
src/StudioSession.tsx - Studio API client
src/studio-api.ts - Class workspace
src/Classroom.tsx - Integration workspace
src/IntegrationWorkspace.tsx
Draft review
- Class review jobs
server/classroom.ts - Document parsing
server/documents.ts - Claim assessment
server/judge.ts
Persistent analysis
- Backend API
server/backend/router.ts - Run management
server/backend/service.ts - Analysis engine
server/backend/engine.ts - Source library
server/backend/library.ts - Job worker
server/worker.ts - PostgreSQL
server/backend/db.ts - Private file storage
server/backend/storage.ts
Research and citations
- Source discovery
server/discovery.ts - Scholarly source checks
server/scholarly.ts - MLA citations
shared/mla.ts
Connected services
- Integration service
server/integrations/service.ts - MCP connection
server/integrations/mcp.ts
Landing and signup
- Landing page
site/src/Landing.tsx - Waitlist service
site/worker/index.ts - Waitlist database
site/db/waitlist.ts
Other components
- Student
Connections 27
- Student → App entry: opens app
- App entry → Studio session: routes to
src/main.tsx - App entry → Class workspace: routes to
src/main.tsx - App entry → Integration workspace: routes to
src/main.tsx - Studio session → Studio workspace: renders
src/StudioSession.tsx - Studio session → Studio API client: uses
src/StudioSession.tsx - Studio API client → Backend API: calls API
- Class workspace → Class review jobs: submits reviews
- Class review jobs → Document parsing: parses documents
server/classroom.ts - Class review jobs → Claim assessment: assesses claims
server/classroom.ts - Class workspace → MLA citations: formats class citations
- Backend API → Source library: creates assets
server/backend/router.ts - Backend API → Run management: manages runs
server/backend/router.ts - Run management → PostgreSQL: stores run
server/backend/service.ts - Run management → Job worker: enqueues run
server/backend/service.ts - Job worker → Analysis engine: processes jobs
server/worker.ts - Analysis engine → Source library: retrieves evidence
server/backend/engine.ts - Analysis engine → PostgreSQL: stores findings
server/backend/engine.ts - Source library → Private file storage: persists files
server/backend/library.ts - Student → Source discovery: finds sources
- Student → Scholarly source checks: checks scholarship
- Student → MLA citations: generates citations
- Integration workspace → Integration service: uses integrations
- Integration service → MCP connection: supports MCP
- Student → Landing page: visits site
- Landing page → Waitlist service: submits signup
- Waitlist service → Waitlist database: stores signup
site/worker/index.ts