chore(repo): restructure as monorepo with server and client workspaces

- move NestJS app into server/ subdirectory
- add client/ React+TypeScript (Vite) app with Hello World
- update docker-compose to build and run both services
- add root package.json declaring npm workspaces
- update .gitignore to cover node_modules and dist at all depths

server/src/scenario/dto/create-scenario-step.dto.ts

@@ -0,0 +1,45 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import {
+  IsIn,
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  Min,
+} from "class-validator";
+import { StepType } from "../scenario-step.entity";
+
+export class CreateScenarioStepDto {
+  @ApiProperty({ example: 0, description: "Execution order (ascending)" })
+  @IsInt()
+  @Min(0)
+  order: number;
+
+  @ApiProperty({ enum: ["login", "exec", "sign"], example: "exec" })
+  @IsIn(["login", "exec", "sign"])
+  type: StepType;
+
+  @ApiProperty({
+    description:
+      "Session name used by this step. login steps create it; exec steps consume it.",
+    example: "my-session",
+  })
+  @IsString()
+  @IsNotEmpty()
+  sessionName: string;
+
+  @ApiPropertyOptional({ example: "return await page.title();" })
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  execCode?: string;
+
+  @ApiPropertyOptional({
+    example:
+      'return { success: result !== null, description: "title present" };',
+  })
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  validateCode?: string;
+}

server/src/scenario/dto/create-scenario.dto.ts

@@ -0,0 +1,9 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { IsNotEmpty, IsString } from "class-validator";
+
+export class CreateScenarioDto {
+  @ApiProperty({ example: "Login and verify cabinet" })
+  @IsString()
+  @IsNotEmpty()
+  name: string;
+}

server/src/scenario/dto/pagination-query.dto.ts

@@ -0,0 +1 @@
+export { PaginationQueryDto } from "../../common/dto/pagination.dto";

server/src/scenario/dto/runs-query.dto.ts

@@ -0,0 +1,28 @@
+import { ApiPropertyOptional } from "@nestjs/swagger";
+import { Type } from "class-transformer";
+import { IsIn, IsInt, IsOptional, Min } from "class-validator";
+import { RunStatus } from "../scenario-run.entity";
+
+export class RunsQueryDto {
+  @ApiPropertyOptional({ example: 1, default: 1 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  page?: number = 1;
+
+  @ApiPropertyOptional({ example: 20, default: 20 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  limit?: number = 20;
+
+  @ApiPropertyOptional({
+    enum: ["pending", "in_progress", "pass", "fail"],
+    description: "Filter by run status",
+  })
+  @IsOptional()
+  @IsIn(["pending", "in_progress", "pass", "fail"])
+  status?: RunStatus;
+}

server/src/scenario/dto/scenario-export.dto.ts

@@ -0,0 +1,54 @@
+import { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
+import { Type } from "class-transformer";
+import {
+  IsArray,
+  IsIn,
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  Min,
+  ValidateNested,
+} from "class-validator";
+import { StepType } from "../scenario-step.entity";
+
+export class ScenarioStepExportDto {
+  @ApiProperty()
+  @IsInt()
+  @Min(0)
+  order: number;
+
+  @ApiProperty({ enum: ["login", "exec", "sign"] })
+  @IsIn(["login", "exec", "sign"])
+  type: StepType;
+
+  @ApiProperty()
+  @IsString()
+  @IsNotEmpty()
+  sessionName: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  execCode: string | null;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  validateCode: string | null;
+}
+
+export class ScenarioExportDto {
+  @ApiProperty()
+  @IsString()
+  @IsNotEmpty()
+  name: string;
+
+  @ApiProperty({ type: [ScenarioStepExportDto] })
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => ScenarioStepExportDto)
+  steps: ScenarioStepExportDto[];
+}

server/src/scenario/dto/update-scenario-step.dto.ts

@@ -0,0 +1,41 @@
+import { ApiPropertyOptional } from "@nestjs/swagger";
+import {
+  IsIn,
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  Min,
+} from "class-validator";
+import { StepType } from "../scenario-step.entity";
+
+export class UpdateScenarioStepDto {
+  @ApiPropertyOptional({ example: 0 })
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  order?: number;
+
+  @ApiPropertyOptional({ enum: ["login", "exec", "sign"] })
+  @IsOptional()
+  @IsIn(["login", "exec", "sign"])
+  type?: StepType;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  sessionName?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  execCode?: string;
+
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  validateCode?: string;
+}

server/src/scenario/dto/update-scenario.dto.ts

@@ -0,0 +1,10 @@
+import { ApiPropertyOptional } from "@nestjs/swagger";
+import { IsOptional, IsString, IsNotEmpty } from "class-validator";
+
+export class UpdateScenarioDto {
+  @ApiPropertyOptional({ example: "Updated scenario name" })
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  name?: string;
+}