@hed-hog/operations 0.0.318 → 0.0.321

package/src/controllers/operations-collaborator-costs.controller.ts

@@ -0,0 +1,147 @@
+import { Role, User } from '@hed-hog/api';
+import {
+    Body,
+    Controller,
+    Delete,
+    Get,
+    Param,
+    ParseIntPipe,
+    Patch,
+    Post,
+    Query,
+} from '@nestjs/common';
+import { CreateCollaboratorCostDto } from '../dto/create-collaborator-cost.dto';
+import { CreateCostTypeDto } from '../dto/create-cost-type.dto';
+import { ListCostTypesDto } from '../dto/list-cost-types.dto';
+import { UpdateCollaboratorCostDto } from '../dto/update-collaborator-cost.dto';
+import { OperationsService } from '../operations.service';
+
+@Role()
+@Controller('operations')
+export class OperationsCollaboratorCostsController {
+  constructor(private readonly operationsService: OperationsService) {}
+
+  // ─── Cost Types ──────────────────────────────────────────────────────────
+
+  @Get('cost-types')
+  listCostTypes(@User() user, @Query() filters: ListCostTypesDto) {
+    return this.operationsService.listCostTypes(
+      Number(user?.id || 0),
+      filters,
+    );
+  }
+
+  @Get('collaborator-cost-types')
+  listCollaboratorCostTypes(@User() user, @Query() filters: ListCostTypesDto) {
+    return this.operationsService.listCostTypes(
+      Number(user?.id || 0),
+      filters,
+    );
+  }
+
+  @Post('cost-types')
+  createCostType(@User() user, @Body() data: CreateCostTypeDto) {
+    return this.operationsService.createCostType(
+      Number(user?.id || 0),
+      data,
+    );
+  }
+
+  @Post('collaborator-cost-types')
+  createCollaboratorCostType(@User() user, @Body() data: CreateCostTypeDto) {
+    return this.operationsService.createCostType(
+      Number(user?.id || 0),
+      data,
+    );
+  }
+
+  // ─── Collaborator Costs ───────────────────────────────────────────────────
+
+  @Get('collaborators/:id/costs/summary')
+  getCollaboratorCostsSummary(
+    @User() user,
+    @Param('id', ParseIntPipe) collaboratorId: number,
+  ) {
+    return this.operationsService.getCollaboratorCostsSummary(
+      Number(user?.id || 0),
+      collaboratorId,
+    );
+  }
+
+  @Get('collaborators/:id/costs')
+  listCollaboratorCosts(
+    @User() user,
+    @Param('id', ParseIntPipe) collaboratorId: number,
+  ) {
+    return this.operationsService.listCollaboratorCosts(
+      Number(user?.id || 0),
+      collaboratorId,
+    );
+  }
+
+  @Post('collaborators/:id/costs')
+  createCollaboratorCost(
+    @User() user,
+    @Param('id', ParseIntPipe) collaboratorId: number,
+    @Body() data: CreateCollaboratorCostDto,
+  ) {
+    return this.operationsService.createCollaboratorCost(
+      Number(user?.id || 0),
+      collaboratorId,
+      data,
+    );
+  }
+
+  @Patch('collaborators/:id/costs/:costId')
+  updateCollaboratorCost(
+    @User() user,
+    @Param('id', ParseIntPipe) collaboratorId: number,
+    @Param('costId', ParseIntPipe) costId: number,
+    @Body() data: UpdateCollaboratorCostDto,
+  ) {
+    return this.operationsService.updateCollaboratorCost(
+      Number(user?.id || 0),
+      collaboratorId,
+      costId,
+      data,
+    );
+  }
+
+  @Patch('collaborator-costs/:id')
+  updateCollaboratorCostById(
+    @User() user,
+    @Param('id', ParseIntPipe) costId: number,
+    @Body() data: UpdateCollaboratorCostDto,
+  ) {
+    return this.operationsService.updateCollaboratorCost(
+      Number(user?.id || 0),
+      0,
+      costId,
+      data,
+    );
+  }
+
+  @Delete('collaborators/:id/costs/:costId')
+  deleteCollaboratorCost(
+    @User() user,
+    @Param('id', ParseIntPipe) collaboratorId: number,
+    @Param('costId', ParseIntPipe) costId: number,
+  ) {
+    return this.operationsService.deleteCollaboratorCost(
+      Number(user?.id || 0),
+      collaboratorId,
+      costId,
+    );
+  }
+
+  @Delete('collaborator-costs/:id')
+  deleteCollaboratorCostById(
+    @User() user,
+    @Param('id', ParseIntPipe) costId: number,
+  ) {
+    return this.operationsService.deleteCollaboratorCostById(
+      Number(user?.id || 0),
+      costId,
+    );
+  }
+}

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

@@ -1,13 +1,13 @@
 import { Role, User } from '@hed-hog/api';
 import {
-  Body,
-  Controller,
-  Get,
-  Param,
-  ParseIntPipe,
-  Patch,
-  Post,
-  Query,
+    Body,
+    Controller,
+    Get,
+    Param,
+    ParseIntPipe,
+    Patch,
+    Post,
+    Query,
 } from '@nestjs/common';
 import { CreateCollaboratorDto } from '../dto/create-collaborator.dto';
 import { ListCollaboratorsDto } from '../dto/list-collaborators.dto';
@@ -45,6 +45,17 @@ export class OperationsCollaboratorsController {
     return this.operationsService.getTeam(Number(user?.id || 0));
   }
 
+  @Get('collaborators/:id/compensation-history')
+  getCollaboratorCompensationHistory(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+  ) {
+    return this.operationsService.getCollaboratorCompensationHistory(
+      Number(user?.id || 0),
+      id,
+    );
+  }
+
   @Get('collaborators/:id')
   getCollaborator(@User() user, @Param('id', ParseIntPipe) id: number) {
     return this.operationsService.getCollaboratorByIdForUser(

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

@@ -1,14 +1,15 @@
 import { Role, User } from '@hed-hog/api';
 import {
-    Body,
-    Controller,
-    Get,
-    Param,
-    ParseIntPipe,
-    Patch,
-    Post,
-    Query,
+  Body,
+  Controller,
+  Get,
+  Param,
+  ParseIntPipe,
+  Patch,
+  Post,
+  Query,
 } from '@nestjs/common';
+import { ListMyProjectsDto } from '../dto/list-my-projects.dto';
 import { ListOperationsProjectOptionsDto } from '../dto/list-project-options.dto';
 import { ListProjectsDto } from '../dto/list-projects.dto';
 import { OperationsService } from '../operations.service';
@@ -29,6 +30,16 @@ export class OperationsProjectsController {
     );
   }
 
+  @Get('my-projects')
+  listMyProjects(@User() user, @Query() filters: ListMyProjectsDto) {
+    return this.operationsService.listMyProjects(Number(user?.id || 0), filters);
+  }
+
+  @Get('my-projects/:id/summary')
+  getMyProjectSummary(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.getMyProjectSummary(Number(user?.id || 0), id);
+  }
+
   @Get('projects')
   listProjects(@User() user, @Query() filters: ListProjectsDto) {
     return this.operationsService.listProjects(Number(user?.id || 0), filters);

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

@@ -0,0 +1,32 @@
+import { Role, User } from '@hed-hog/api';
+import { Controller, Get, Query } from '@nestjs/common';
+import {
+  ListCollaboratorsReportDto,
+  ListProjectsReportDto,
+} from '../dto/list-reports.dto';
+import { OperationsService } from '../operations.service';
+
+@Role()
+@Controller('operations')
+export class OperationsReportsController {
+  constructor(private readonly operationsService: OperationsService) {}
+
+  @Get('reports/projects')
+  getProjectsReport(@User() user, @Query() filters: ListProjectsReportDto) {
+    return this.operationsService.getProjectsReport(
+      Number(user?.id || 0),
+      filters,
+    );
+  }
+
+  @Get('reports/collaborators')
+  getCollaboratorsReport(
+    @User() user,
+    @Query() filters: ListCollaboratorsReportDto,
+  ) {
+    return this.operationsService.getCollaboratorsReport(
+      Number(user?.id || 0),
+      filters,
+    );
+  }
+}

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

@@ -1,16 +1,17 @@
 import { Role, User } from '@hed-hog/api';
-import { Pagination } from '@hed-hog/api-pagination';
 import {
-    Body,
-    Controller,
-    Delete,
-    Get,
-    Param,
-    ParseIntPipe,
-    Patch,
-    Post,
+  Body,
+  Controller,
+  Delete,
+  Get,
+  Param,
+  ParseIntPipe,
+  Patch,
+  Post,
+  Query,
 } from '@nestjs/common';
 import { CreateOperationsTaskDto } from '../dto/create-task.dto';
+import { ListMyTasksDto } from '../dto/list-my-tasks.dto';
 import { ListOperationsTasksDto } from '../dto/list-tasks.dto';
 import { UpdateOperationsTaskDto } from '../dto/update-task.dto';
 import { OperationsService } from '../operations.service';
@@ -23,7 +24,7 @@ export class OperationsTasksController {
   @Get('tasks')
   listTasks(
     @User() user,
-    @Pagination() paginationParams: ListOperationsTasksDto,
+    @Query() paginationParams: ListOperationsTasksDto,
   ) {
     return this.operationsService.listTasks(
       Number(user?.id || 0),
@@ -31,6 +32,17 @@ export class OperationsTasksController {
     );
   }
 
+  @Get('my-tasks')
+  listMyTasks(
+    @User() user,
+    @Query() paginationParams: ListMyTasksDto,
+  ) {
+    return this.operationsService.listMyTasks(
+      Number(user?.id || 0),
+      paginationParams,
+    );
+  }
+
   @Get('projects/:id/tasks')
   listProjectBoardTasks(
     @User() user,
@@ -57,7 +69,15 @@ export class OperationsTasksController {
   }
 
   @Delete('tasks/:id')
-  removeTask(@User() user, @Param('id', ParseIntPipe) id: number) {
-    return this.operationsService.removeTask(Number(user?.id || 0), id);
+  removeTask(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Query('permanent') permanent?: string,
+  ) {
+    return this.operationsService.removeTask(
+      Number(user?.id || 0),
+      id,
+      permanent === 'true'
+    );
   }
 }

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

@@ -0,0 +1,78 @@
+import { Transform } from 'class-transformer';
+import {
+    IsBoolean,
+    IsIn,
+    IsNumber,
+    IsOptional,
+    IsString,
+    MaxLength,
+    Min,
+} from 'class-validator';
+
+export const COST_RECURRENCE_VALUES = [
+  'one_time',
+  'monthly',
+  'quarterly',
+  'yearly',
+] as const;
+export type CostRecurrence = (typeof COST_RECURRENCE_VALUES)[number];
+
+export class CreateCollaboratorCostDto {
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsNumber()
+  costTypeId!: number;
+
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsNumber()
+  @Min(0)
+  amount!: number;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(3)
+  currency?: string;
+
+  @IsOptional()
+  @IsIn(COST_RECURRENCE_VALUES)
+  recurrence?: CostRecurrence;
+
+  @IsOptional()
+  @Transform(({ value }) => {
+    if (value === '' || value === undefined || value === null) return undefined;
+    return value === true || value === 'true' || value === '1';
+  })
+  @IsBoolean()
+  allocatable?: boolean;
+
+  @IsOptional()
+  @IsString()
+  referenceDate?: string | null;
+
+  @IsOptional()
+  @IsString()
+  startDate?: string | null;
+
+  @IsOptional()
+  @IsString()
+  endDate?: string | null;
+
+  @IsOptional()
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value)
+  )
+  @IsNumber()
+  @Min(1)
+  depreciationMonths?: number | null;
+
+  @IsOptional()
+  @IsString()
+  description?: string | null;
+
+  @IsOptional()
+  @IsString()
+  notes?: string | null;
+}

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

@@ -1,14 +1,14 @@
 import { Transform, Type } from 'class-transformer';
 import {
-  IsBoolean,
-  IsIn,
-  IsInt,
-  IsNumber,
-  IsObject,
-  IsOptional,
-  IsString,
-  MaxLength,
-  ValidateNested,
+    IsBoolean,
+    IsIn,
+    IsInt,
+    IsNumber,
+    IsObject,
+    IsOptional,
+    IsString,
+    MaxLength,
+    ValidateNested,
 } from 'class-validator';
 
 class CollaboratorWeeklyScheduleDayDto {
@@ -136,11 +136,6 @@ export class CreateCollaboratorDto {
   @MaxLength(80)
   collaboratorType?: string | null;
 
-  @IsOptional()
-  @IsString()
-  @MaxLength(120)
-  department?: string | null;
-
   @IsOptional()
   @Transform(({ value }) =>
     value === '' || value === undefined || value === null ? undefined : Number(value)

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

@@ -0,0 +1,62 @@
+import { Transform } from 'class-transformer';
+import { IsBoolean, IsIn, IsOptional, IsString, MaxLength } from 'class-validator';
+
+export const COST_TYPE_RECURRENCE_VALUES = [
+  'one_time',
+  'monthly',
+  'quarterly',
+  'yearly',
+] as const;
+
+export class CreateCostTypeDto {
+  @IsString()
+  @MaxLength(120)
+  name!: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(80)
+  slug?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(40)
+  code?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(80)
+  category?: string | null;
+
+  @IsOptional()
+  @IsString()
+  description?: string | null;
+
+  @IsOptional()
+  @IsIn(COST_TYPE_RECURRENCE_VALUES)
+  defaultRecurrence?: string | null;
+
+  @IsOptional()
+  @Transform(({ value }) => {
+    if (value === '' || value === undefined || value === null) return undefined;
+    return value === true || value === 'true' || value === '1';
+  })
+  @IsBoolean()
+  isAllocatable?: boolean | null;
+
+  @IsOptional()
+  @Transform(({ value }) => {
+    if (value === '' || value === undefined || value === null) return undefined;
+    return value === true || value === 'true' || value === '1';
+  })
+  @IsBoolean()
+  isDepreciable?: boolean | null;
+
+  @IsOptional()
+  @Transform(({ value }) => {
+    if (value === '' || value === undefined || value === null) return undefined;
+    return value === true || value === 'true' || value === '1';
+  })
+  @IsBoolean()
+  isActive?: boolean;
+}

package/src/dto/list-approvals.dto.ts

@@ -9,4 +9,12 @@ export class ListApprovalsDto extends PaginationDTO {
   @IsOptional()
   @IsString()
   targetType?: string;
+
+  @IsOptional()
+  @IsString()
+  dateFrom?: string;
+
+  @IsOptional()
+  @IsString()
+  dateTo?: string;
 }

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

@@ -0,0 +1,8 @@
+import { PaginationDTO } from '@hed-hog/api-pagination';
+import { IsOptional, IsString } from 'class-validator';
+
+export class ListCollaboratorCostsDto extends PaginationDTO {
+  @IsOptional()
+  @IsString()
+  declare search: string;
+}

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

@@ -0,0 +1,19 @@
+import { PaginationDTO } from '@hed-hog/api-pagination';
+import { Transform } from 'class-transformer';
+import { IsBoolean, IsOptional, IsString } from 'class-validator';
+
+export class ListCostTypesDto extends PaginationDTO {
+  @IsOptional()
+  @IsString()
+  declare search: string;
+
+  @IsOptional()
+  @Transform(({ value }) => {
+    if (value === '' || value === undefined || value === null) {
+      return undefined;
+    }
+    return value === true || value === 'true' || value === '1';
+  })
+  @IsBoolean()
+  active?: boolean;
+}

package/src/dto/list-my-projects.dto.ts

@@ -0,0 +1,8 @@
+import { PaginationDTO } from '@hed-hog/api-pagination';
+import { IsOptional, IsString } from 'class-validator';
+
+export class ListMyProjectsDto extends PaginationDTO {
+  @IsOptional()
+  @IsString()
+  status?: string;
+}

package/src/dto/list-my-tasks.dto.ts

@@ -0,0 +1,17 @@
+import { PaginationDTO } from '@hed-hog/api-pagination';
+import { IsIn, IsOptional } from 'class-validator';
+import { Transform } from 'class-transformer';
+import { IsBoolean } from 'class-validator';
+
+export class ListMyTasksDto extends PaginationDTO {
+  @IsOptional()
+  @IsIn(['todo', 'doing', 'review', 'done'], {
+    message: 'status must be todo, doing, review, or done',
+  })
+  status?: 'todo' | 'doing' | 'review' | 'done';
+
+  @IsOptional()
+  @Transform(({ value }) => value === 'true' || value === true)
+  @IsBoolean()
+  archived?: boolean;
+}

package/src/dto/list-projects.dto.ts

@@ -1,8 +1,14 @@
 import { PaginationDTO } from '@hed-hog/api-pagination';
-import { IsOptional, IsString } from 'class-validator';
+import { Transform } from 'class-transformer';
+import { IsBoolean, IsOptional, IsString } from 'class-validator';
 
 export class ListProjectsDto extends PaginationDTO {
   @IsOptional()
   @IsString()
   status?: string;
+
+  @IsOptional()
+  @Transform(({ value }) => value === 'true' || value === true)
+  @IsBoolean()
+  myOnly?: boolean;
 }

package/src/dto/list-reports.dto.ts

@@ -0,0 +1,51 @@
+import { IsIn, IsOptional, IsString } from 'class-validator';
+
+export const OPERATIONS_REPORT_SCENARIOS = [
+  'base',
+  'growth',
+  'conservative',
+] as const;
+
+export class ListProjectsReportDto {
+  @IsOptional()
+  @IsString()
+  from?: string;
+
+  @IsOptional()
+  @IsString()
+  to?: string;
+
+  @IsOptional()
+  @IsString()
+  status?: string;
+
+  @IsOptional()
+  @IsString()
+  client?: string;
+
+  @IsOptional()
+  @IsIn(OPERATIONS_REPORT_SCENARIOS)
+  scenario?: string;
+}
+
+export class ListCollaboratorsReportDto {
+  @IsOptional()
+  @IsString()
+  from?: string;
+
+  @IsOptional()
+  @IsString()
+  to?: string;
+
+  @IsOptional()
+  @IsString()
+  department?: string;
+
+  @IsOptional()
+  @IsString()
+  contractType?: string;
+
+  @IsOptional()
+  @IsIn(OPERATIONS_REPORT_SCENARIOS)
+  scenario?: string;
+}

package/src/dto/list-tasks.dto.ts

@@ -1,6 +1,6 @@
 import { PaginationDTO } from '@hed-hog/api-pagination';
 import { Transform } from 'class-transformer';
-import { IsIn, IsInt, IsOptional } from 'class-validator';
+import { IsBoolean, IsIn, IsInt, IsOptional } from 'class-validator';
 
 export class ListOperationsTasksDto extends PaginationDTO {
   @IsOptional()
@@ -22,4 +22,14 @@ export class ListOperationsTasksDto extends PaginationDTO {
     message: 'status must be todo, doing, review, or done',
   })
   status?: 'todo' | 'doing' | 'review' | 'done';
+
+  @IsOptional()
+  @Transform(({ value }) => value === 'true' || value === true)
+  @IsBoolean()
+  myOnly?: boolean;
+
+  @IsOptional()
+  @Transform(({ value }) => value === 'true' || value === true)
+  @IsBoolean()
+  archived?: boolean;
 }

package/src/dto/list-timesheets.dto.ts

@@ -5,4 +5,12 @@ export class ListTimesheetsDto extends PaginationDTO {
   @IsOptional()
   @IsString()
   status?: string;
+
+  @IsOptional()
+  @IsString()
+  dateFrom?: string;
+
+  @IsOptional()
+  @IsString()
+  dateTo?: string;
 }

package/src/dto/update-collaborator-cost.dto.ts

@@ -0,0 +1,4 @@
+import { PartialType } from '@nestjs/mapped-types';
+import { CreateCollaboratorCostDto } from './create-collaborator-cost.dto';
+
+export class UpdateCollaboratorCostDto extends PartialType(CreateCollaboratorCostDto) {}