Backend Overview

This guide provides a quick orientation to the backend services and how their docs are organized.

Projects

• Web Backend (NestJS): REST API for the web app
  • Docs: Web Backend API
  • Shared types: Shared Types API
• Praetor (microservice): solver orchestration and job dispatch
  • Docs: Praetor API
  • Solver engine: PRAXIS (Rust)

Tech stack

• NestJS 11.1.7
• Mongoose 8.19.2 for MongoDB
• TypeScript 5.9.3
• Nx 22.0.1 for orchestration; pnpm for package management

Conventions

• Modules, controllers, and services live under src/ grouped by feature.
• Mongoose schemas live under src/schemas and are injected via MongooseModule.forFeature.
• Routes are mounted under /api/... paths; keep controller paths stable.
• Types and DTOs come from apps/interfaces/shared-types.
• Zod validation pipe is used for request body validation.