Getting Started

BATCH IQ is a simulated Quality Control platform that combines MES, LIMS, and an Agent Console UI on top of a shared Convex backend. Each frontend is its own app, but they share auth, scheduling logic, and data.

Prerequisites

Node.js 18+
pnpm package manager
A Convex account (for backend)

Installation

Clone the repository and install dependencies:

git clone <repository-url>
cd qc-test-agent
pnpm install

Start everything with Turbo (recommended):

pnpm dev

Or run individual apps:

# LIMS App
pnpm --filter @qc/lims-app dev

# MES App
pnpm --filter @qc/mes-app dev

# Agent Console
pnpm --filter @qc/agent-console dev

Start the Convex backend:

pnpm --filter @qc/backend dev

This requires a CONVEX_DEPLOYMENT environment variable or local Convex setup.

Seeding Data

Seed data lives in packages/backend/convex/seed_data/*.json. To seed the database:

pnpm --filter @qc/backend run seed

Update the JSON files and Convex schema before seeding if you need custom data.

Next Steps

Explore the Architecture to understand how the platform is structured
Check out individual app guides for LIMS, MES, and Agent Console