MarksyIB

MarksyIB is an IB education platform. Its visible product surface includes assessment feedback, oral-practice workflows, textbooks, simulations, past-paper-style tooling, subject guides, and exam planning utilities.

Product scope

The platform is not limited to one grading endpoint. It contains several product families:

• rubric-oriented assessment feedback for IA, EE, TOK, and subject-specific work,
• batch grading workflows,
• oral simulation and timed speaking workflows,
• educational content and interactive textbook surfaces,
• free calculators and subject guidance pages,
• public marketing, pricing, and support surfaces.

Application architecture

The repository is a full-stack Next.js application using:

• App Router,
• tRPC procedures,
• Prisma-backed persistence,
• Auth.js authentication,
• Stripe payments,
• OpenAI-backed model workflows,
• object/file-storage support,
• supporting scheduled/background tasks.

The codebase structure indicates a conventional SaaS split:

• route components and user-facing product pages in src/app,
• API procedures and server logic under src/server,
• Prisma schema and migrations for application state,
• prompts and rubric-related data for model workflows,
• scripts and supporting data for content generation and operational tasks.

Grading workflow

At a high level, the assessment feedback path is:

1. The user selects a supported assessment type or subject workflow.
2. The system receives a document upload or existing source asset.
3. A server-side grading flow evaluates the work against the relevant IB rubric shape.
4. The result is returned with criterion-level structure, highlighted support, and recommended revisions.
5. The result is persisted and shown through a product UI designed for repeated review.