Discriminator v2 - Interior Design Validation Engine

Discriminator is a technical validation service designed to analyze interior design data. It evaluates spatial layouts against a set of predefined rules covering capacity, zoning, ergonomics, visual aesthetics, and physical geometry.

Prerequisites

• Node.js (v24 or higher recommended)
• npm
• .env file with the following variables:
  • PORT (required)
  • REQUEST_BODY_SIZE (optional)
  • CORS_ORIGIN (optional)
  • SAVE_SVG (optional)

Development Commands

# Install dependencies
npm install

# Start the production server
npm start

# Start the development server with hot-reload
npm run dev

# Run the test suite
npm test

# Run typecheck
npm run typecheck

API Documentation

Data Model

Coordinate System & Geometry

• Axes: The X and Z axes are horizontal, while the Y axis is vertical (with 0 being the floor level).
• Positioning:
  • Objects: The position coordinates (x, z) represent the horizontal center of the object, while y represents the bottom of the object.
  • Room: The room's global position is always centered at X = 0 and Z = 0, with the floor at Y = 0.
• Size & Bounding Box:
  • The size dictates the physical footprint around the position. An object's physical boundaries span from -x/2 to +x/2 (relative to position.x), from -z/2 to +z/2 (relative to position.z), and from 0 to y (relative to position.y).
• Units: All spatial dimensions are explicitly specified in millimeters (mm).
• Angles: All spatial rotations are defined in radians (rad).

Object Properties (roomData.objects)

• id: Unique identifier of the object.
• name: Name of the object, provided in the language defined by the root lang property.
• categoryId: External UUID referencing the category the object belongs to.
• rotation: Rotation applied around the Y-axis in radians. The natural "front" of the object faces the Z-axis when rotation is 0.
• colors: Array of RGB configurations, sorted by priority. The first element defines the primary/dominant color.
• material: Array of the materials used on the object, sorted by priority. The first element is the primary/dominant material.
• designStyle: Array containing names of the corresponding design styles.
• seatingCapacity: Represents how many people the object can accommodate (crucial for sofas, dining chairs, etc.).
• zoneId: If specified, this object acts as an anchor point defining the location of the respective zone within the room.
• isDominant: Flag indicating whether the object serves as a dominant focal point in the room.
• isZoneDev: Flag indicating whether the object has the visual/structural volume to separate different zones.
• isBorder: Flag indicating whether the object must actively be placed on the boundary between zones to visually separate them.

Request

type Point = [number, number];
type Position = { x: number; y: number; z: number };
type RGB = { r: number; g: number; b: number };

type ValidationRequest = {
  lang: 'en' | 'cs';
  roomData: {
    size: Position;
    objects: Array<{
      id: string;
      name: string;
      categoryId: string;
      position: Position;
      size: Position;
      rotation: number;
      colors: RGB[];
      designStyle: string[];
      material: string[];
      seatingCapacity: number;
      zoneId: null | string;
      isDominant: boolean;
      isZoneDev: boolean;
      isBorder: boolean;
    }>;
  };
  questionnaire: {
    numberOfAdults: number;
    numberOfChildren: number;
    numberOfGuests: number;
    workplace: boolean;
    playground: boolean;
  };
  zones: null | Array<{ id: string; polygon: Point[] }>;
  paths: null | Array<{ objectIdFrom: string; objectIdTo: string; points: Point[] }>;
};

Responses

200 OK (Success)

Standard successful response.

type ValidateResult = {
  executionTime: number;
  summary: {
    totalRules: number;
    passed: number;
    failed: number;
    warnings: number;
    passRate: number;
    overallStatus: 'pass' | 'fail' | 'warning';
  };
  zones: Array<{ id: string; polygon: Point[] }>;
  paths: Array<{ objectIdFrom: string; objectIdTo: string; points: Point[] }>;
  results: Array<{
    status: 'pass' | 'warning' | 'fail';
    ruleId: string;
    userMessage: string;
    userRepairInstructions?: string; // only for fail and warning
    impactedObjectId?: string;
    measuredValue?: number;
    errorValue?: number;
  }>;
};

400 Bad Request

Returned when the request data fails schema validation.

{
  "error": "Invalid request",
  "message": "Detailed validation error message"
}

500 Internal Server Error

Returned when an unexpected error occurs during processing.

{
  "error": "Internal Server Error",
  "message": "Detailed error message"
}

Computational Logic

Automatic Zone Detection

The engine processes all objects with a zoneId. The room's total area is partitioned into specific polygons based on the distribution of these anchored objects.

Pathfinding (PATH)

The algorithm generates a movement graph based on:

• Paths between all doors and windows.
• Access paths to all detected zones.
• Paths must maintain a minimum width of 600 mm without furniture collisions.