@hed-hog/operations 0.0.302 → 0.0.304

package/src/controllers/operations-tasks.controller.ts

@@ -0,0 +1,52 @@
+import { Role, User } from '@hed-hog/api';
+import { Pagination } from '@hed-hog/api-pagination';
+import {
+    Body,
+    Controller,
+    Delete,
+    Get,
+    Param,
+    ParseIntPipe,
+    Patch,
+    Post,
+} from '@nestjs/common';
+import { CreateOperationsTaskDto } from '../dto/create-task.dto';
+import { ListOperationsTasksDto } from '../dto/list-tasks.dto';
+import { UpdateOperationsTaskDto } from '../dto/update-task.dto';
+import { OperationsService } from '../operations.service';
+
+@Role()
+@Controller('operations')
+export class OperationsTasksController {
+  constructor(private readonly operationsService: OperationsService) {}
+
+  @Get('tasks')
+  listTasks(
+    @User() user,
+    @Pagination() paginationParams: ListOperationsTasksDto,
+  ) {
+    return this.operationsService.listTasks(
+      Number(user?.id || 0),
+      paginationParams,
+    );
+  }
+
+  @Post('tasks')
+  createTask(@User() user, @Body() data: CreateOperationsTaskDto) {
+    return this.operationsService.createTask(Number(user?.id || 0), data);
+  }
+
+  @Patch('tasks/:id')
+  updateTask(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data: UpdateOperationsTaskDto,
+  ) {
+    return this.operationsService.updateTask(Number(user?.id || 0), id, data);
+  }
+
+  @Delete('tasks/:id')
+  removeTask(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.removeTask(Number(user?.id || 0), id);
+  }
+}

package/src/controllers/operations-timesheets.controller.ts

@@ -0,0 +1,100 @@
+import { Role, User } from '@hed-hog/api';
+import { Pagination } from '@hed-hog/api-pagination';
+import {
+    Body,
+    Controller,
+    Delete,
+    Get,
+    Param,
+    ParseIntPipe,
+    Patch,
+    Post,
+} from '@nestjs/common';
+import { CreateScheduleAdjustmentRequestDto } from '../dto/create-schedule-adjustment-request.dto';
+import { CreateTimeOffRequestDto } from '../dto/create-time-off-request.dto';
+import { CreateTimesheetEntryDto } from '../dto/create-timesheet-entry.dto';
+import { ListTimesheetEntriesDto } from '../dto/list-timesheet-entries.dto';
+import { OperationsService } from '../operations.service';
+
+@Role()
+@Controller('operations')
+export class OperationsTimesheetsController {
+  constructor(private readonly operationsService: OperationsService) {}
+
+  @Get('timesheets')
+  listTimesheets(@User() user) {
+    return this.operationsService.listTimesheets(Number(user?.id || 0));
+  }
+
+  @Get('timesheet-entries')
+  listTimesheetEntries(
+    @User() user,
+    @Pagination() paginationParams: ListTimesheetEntriesDto,
+  ) {
+    return this.operationsService.listTimesheetEntries(
+      Number(user?.id || 0),
+      paginationParams,
+    );
+  }
+
+  @Post('timesheet-entries')
+  createTimesheetEntry(@User() user, @Body() data: CreateTimesheetEntryDto) {
+    return this.operationsService.createTimesheetEntry(
+      Number(user?.id || 0),
+      data,
+    );
+  }
+
+  @Delete('timesheet-entries/:id')
+  removeTimesheetEntry(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.removeTimesheetEntry(Number(user?.id || 0), id);
+  }
+
+  @Post('timesheets')
+  createTimesheet(@User() user, @Body() data) {
+    return this.operationsService.createTimesheet(Number(user?.id || 0), data);
+  }
+
+  @Patch('timesheets/:id')
+  updateTimesheet(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data,
+  ) {
+    return this.operationsService.updateTimesheet(Number(user?.id || 0), id, data);
+  }
+
+  @Post('timesheets/:id/submit')
+  submitTimesheet(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.submitTimesheet(Number(user?.id || 0), id);
+  }
+
+  @Get('time-off')
+  listTimeOffRequests(@User() user) {
+    return this.operationsService.listTimeOffRequests(Number(user?.id || 0));
+  }
+
+  @Post('time-off')
+  createTimeOffRequest(
+    @User() user,
+    @Body() data: CreateTimeOffRequestDto,
+  ) {
+    return this.operationsService.createTimeOffRequest(Number(user?.id || 0), data);
+  }
+
+  @Get('schedule-adjustments')
+  listScheduleAdjustments(@User() user) {
+    return this.operationsService.listScheduleAdjustments(Number(user?.id || 0));
+  }
+
+  @Post('schedule-adjustments')
+  createScheduleAdjustmentRequest(
+    @User() user,
+    @Body() data: CreateScheduleAdjustmentRequestDto,
+  ) {
+    return this.operationsService.createScheduleAdjustmentRequest(
+      Number(user?.id || 0),
+      data,
+    );
+  }
+}

package/src/dto/create-collaborator-type.dto.ts

@@ -0,0 +1,43 @@
+import { Transform } from 'class-transformer';
+import {
+  IsBoolean,
+  IsInt,
+  IsOptional,
+  IsString,
+  MaxLength,
+} from 'class-validator';
+
+export class CreateCollaboratorTypeDto {
+  @IsString()
+  @MaxLength(120)
+  name!: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(80)
+  slug?: string | null;
+
+  @IsOptional()
+  @IsString()
+  description?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(60)
+  category?: string | null;
+
+  @IsOptional()
+  @IsBoolean()
+  isActive?: boolean;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt()
+  sortOrder?: number | null;
+
+  @IsOptional()
+  @IsString()
+  status?: 'active' | 'inactive';
+}

package/src/dto/create-collaborator.dto.ts

@@ -0,0 +1,223 @@
+import { Transform, Type } from 'class-transformer';
+import {
+  IsBoolean,
+  IsIn,
+  IsInt,
+  IsNumber,
+  IsObject,
+  IsOptional,
+  IsString,
+  MaxLength,
+  ValidateNested,
+} from 'class-validator';
+
+class CollaboratorWeeklyScheduleDayDto {
+  @IsString()
+  @IsIn([
+    'monday',
+    'tuesday',
+    'wednesday',
+    'thursday',
+    'friday',
+    'saturday',
+    'sunday',
+  ])
+  weekday!:
+    | 'monday'
+    | 'tuesday'
+    | 'wednesday'
+    | 'thursday'
+    | 'friday'
+    | 'saturday'
+    | 'sunday';
+
+  @IsOptional()
+  @IsBoolean()
+  isWorkingDay?: boolean;
+
+  @IsOptional()
+  @IsString()
+  startTime?: string | null;
+
+  @IsOptional()
+  @IsString()
+  endTime?: string | null;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsNumber()
+  breakMinutes?: number | null;
+}
+
+export class CollaboratorEquityParticipationDto {
+  @IsOptional()
+  @IsIn([
+    'partner_quota_holder',
+    'common_shareholder',
+    'preferred_shareholder',
+    'administrator',
+    'other',
+  ])
+  participationType?:
+    | 'partner_quota_holder'
+    | 'common_shareholder'
+    | 'preferred_shareholder'
+    | 'administrator'
+    | 'other';
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsNumber()
+  percentage?: number | null;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsNumber()
+  votingPower?: number | null;
+
+  @IsOptional()
+  @IsString()
+  startDate?: string | null;
+
+  @IsOptional()
+  @IsString()
+  endDate?: string | null;
+
+  @IsOptional()
+  @IsString()
+  notes?: string | null;
+}
+
+export class CreateCollaboratorDto {
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt()
+  userId?: number | null;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt()
+  personId?: number | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(32)
+  code?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(180)
+  displayName?: string | null;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt()
+  collaboratorTypeId?: number | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(80)
+  collaboratorTypeSlug?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(80)
+  collaboratorType?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(120)
+  department?: string | null;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt()
+  departmentId?: number | null;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt()
+  jobTitleId?: number | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(120)
+  title?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(120)
+  levelLabel?: string | null;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt()
+  supervisorCollaboratorId?: number | null;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsNumber()
+  weeklyCapacityHours?: number | null;
+
+  @IsOptional()
+  @IsIn(['draft', 'active', 'on_leave', 'inactive'])
+  status?: 'draft' | 'active' | 'on_leave' | 'inactive';
+
+  @IsOptional()
+  @IsString()
+  joinedAt?: string | null;
+
+  @IsOptional()
+  @IsString()
+  leftAt?: string | null;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsNumber()
+  compensationAmount?: number | null;
+
+  @IsOptional()
+  @IsString()
+  contractDescription?: string | null;
+
+  @IsOptional()
+  @IsBoolean()
+  autoGenerateContractDraft?: boolean;
+
+  @IsOptional()
+  @ValidateNested({ each: true })
+  @Type(() => CollaboratorWeeklyScheduleDayDto)
+  weeklySchedule?: CollaboratorWeeklyScheduleDayDto[];
+
+  @IsOptional()
+  @IsObject()
+  @ValidateNested()
+  @Type(() => CollaboratorEquityParticipationDto)
+  equityParticipation?: CollaboratorEquityParticipationDto | null;
+
+  @IsOptional()
+  @IsString()
+  notes?: string | null;
+}

package/src/dto/create-schedule-adjustment-request.dto.ts

@@ -0,0 +1,91 @@
+import { Transform, Type } from 'class-transformer';
+import {
+  ArrayMinSize,
+  IsBoolean,
+  IsDateString,
+  IsIn,
+  IsInt,
+  IsNumber,
+  IsOptional,
+  IsString,
+  MaxLength,
+  Min,
+  ValidateNested,
+} from 'class-validator';
+
+class ScheduleAdjustmentDayDto {
+  @IsString({ message: 'weekday must be a string' })
+  @IsIn(
+    ['monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday', 'sunday'],
+    {
+      message:
+        'weekday must be monday, tuesday, wednesday, thursday, friday, saturday, or sunday',
+    }
+  )
+  weekday!:
+    | 'monday'
+    | 'tuesday'
+    | 'wednesday'
+    | 'thursday'
+    | 'friday'
+    | 'saturday'
+    | 'sunday';
+
+  @IsOptional()
+  @IsBoolean({ message: 'isWorkingDay must be a boolean' })
+  isWorkingDay?: boolean;
+
+  @IsOptional()
+  @IsString({ message: 'startTime must be a string' })
+  startTime?: string | null;
+
+  @IsOptional()
+  @IsString({ message: 'endTime must be a string' })
+  endTime?: string | null;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsNumber({}, { message: 'breakMinutes must be a number' })
+  @Min(0, { message: 'breakMinutes must be 0 or greater' })
+  breakMinutes?: number | null;
+}
+
+export class CreateScheduleAdjustmentRequestDto {
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt({ message: 'collaboratorId must be an integer' })
+  collaboratorId?: number;
+
+  @IsOptional()
+  @IsIn(['temporary', 'permanent'], {
+    message: 'requestScope must be temporary or permanent',
+  })
+  requestScope?: 'temporary' | 'permanent';
+
+  @IsDateString({}, {
+    message: 'effectiveStartDate must be a valid ISO date string',
+  })
+  effectiveStartDate!: string;
+
+  @IsOptional()
+  @IsDateString({}, {
+    message: 'effectiveEndDate must be a valid ISO date string',
+  })
+  effectiveEndDate?: string | null;
+
+  @IsOptional()
+  @IsString({ message: 'reason must be a string' })
+  @MaxLength(500, {
+    message: 'reason must have at most 500 characters',
+  })
+  reason?: string;
+
+  @ValidateNested({ each: true })
+  @Type(() => ScheduleAdjustmentDayDto)
+  @ArrayMinSize(1, { message: 'days must contain at least one schedule day' })
+  days!: ScheduleAdjustmentDayDto[];
+}

package/src/dto/create-task.dto.ts

@@ -0,0 +1,35 @@
+import { Transform } from 'class-transformer';
+import { IsIn, IsInt, IsOptional, IsString, MaxLength } from 'class-validator';
+
+export class CreateOperationsTaskDto {
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt({ message: 'projectId must be an integer' })
+  projectId?: number;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt({ message: 'projectAssignmentId must be an integer' })
+  projectAssignmentId?: number;
+
+  @IsString({ message: 'name must be a string' })
+  @MaxLength(180, { message: 'name must have at most 180 characters' })
+  name!: string;
+
+  @IsOptional()
+  @IsString({ message: 'description must be a string' })
+  @MaxLength(500, {
+    message: 'description must have at most 500 characters',
+  })
+  description?: string;
+
+  @IsOptional()
+  @IsIn(['active', 'completed', 'archived'], {
+    message: 'status must be active, completed, or archived',
+  })
+  status?: 'active' | 'completed' | 'archived';
+}

package/src/dto/create-time-off-request.dto.ts

@@ -0,0 +1,53 @@
+import { Transform } from 'class-transformer';
+import {
+  IsDateString,
+  IsIn,
+  IsInt,
+  IsNumber,
+  IsOptional,
+  IsString,
+  MaxLength,
+  Min,
+} from 'class-validator';
+
+export class CreateTimeOffRequestDto {
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt({ message: 'collaboratorId must be an integer' })
+  collaboratorId?: number;
+
+  @IsOptional()
+  @IsIn(['vacation', 'personal_time', 'sick_leave', 'unpaid_leave', 'other'], {
+    message:
+      'requestType must be vacation, personal_time, sick_leave, unpaid_leave, or other',
+  })
+  requestType?:
+    | 'vacation'
+    | 'personal_time'
+    | 'sick_leave'
+    | 'unpaid_leave'
+    | 'other';
+
+  @IsDateString({}, { message: 'startDate must be a valid ISO date string' })
+  startDate!: string;
+
+  @IsDateString({}, { message: 'endDate must be a valid ISO date string' })
+  endDate!: string;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsNumber({}, { message: 'totalDays must be a number' })
+  @Min(0.01, { message: 'totalDays must be greater than 0' })
+  totalDays?: number | null;
+
+  @IsOptional()
+  @IsString({ message: 'reason must be a string' })
+  @MaxLength(500, {
+    message: 'reason must have at most 500 characters',
+  })
+  reason?: string;
+}

package/src/dto/create-timesheet-entry.dto.ts

@@ -0,0 +1,67 @@
+import { Transform } from 'class-transformer';
+import {
+    IsDateString,
+    IsIn,
+    IsInt,
+    IsNumber,
+    IsOptional,
+    IsString,
+    MaxLength,
+    Min,
+} from 'class-validator';
+
+export class CreateTimesheetEntryDto {
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt({ message: 'projectId must be an integer' })
+  projectId?: number;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt({ message: 'projectAssignmentId must be an integer' })
+  projectAssignmentId?: number;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsInt({ message: 'taskId must be an integer' })
+  taskId?: number;
+
+  @IsOptional()
+  @IsString({ message: 'taskName must be a string' })
+  @MaxLength(180, { message: 'taskName must have at most 180 characters' })
+  taskName?: string;
+
+  @IsOptional()
+  @IsString({ message: 'activityLabel must be a string' })
+  @MaxLength(180, {
+    message: 'activityLabel must have at most 180 characters',
+  })
+  activityLabel?: string;
+
+  @IsDateString({}, { message: 'workDate must be a valid ISO date string' })
+  workDate!: string;
+
+  @Transform(({ value }) => Number(value))
+  @IsNumber({}, { message: 'duration must be a number' })
+  @Min(0.01, { message: 'duration must be greater than 0' })
+  duration!: number;
+
+  @IsOptional()
+  @IsIn(['hours', 'minutes'], {
+    message: 'unit must be either hours or minutes',
+  })
+  unit?: 'hours' | 'minutes';
+
+  @IsOptional()
+  @IsString({ message: 'description must be a string' })
+  @MaxLength(500, {
+    message: 'description must have at most 500 characters',
+  })
+  description?: string;
+}

package/src/dto/list-collaborator-types.dto.ts

@@ -0,0 +1,15 @@
+import { Transform } from 'class-transformer';
+import { IsBoolean, IsOptional } from 'class-validator';
+
+export class ListCollaboratorTypesDto {
+  @IsOptional()
+  @Transform(({ value }) => {
+    if (value === '' || value === undefined || value === null) {
+      return undefined;
+    }
+
+    return value === true || value === 'true' || value === '1';
+  })
+  @IsBoolean()
+  active?: boolean;
+}