[TASK-006] feat: Add HR entities and DTOs
Add TypeORM entities for the HR module: - Department: Organizational departments with hierarchy - JobPosition: Job titles/positions - Employee: Employee records with manager self-reference - Contract: Employment contracts - LeaveType: Configurable leave types - LeaveAllocation: Employee leave allocations - Leave: Leave requests Add DTOs with class-validator: - CreateEmployeeDto, UpdateEmployeeDto - CreateContractDto, UpdateContractDto, ActivateContractDto, TerminateContractDto - CreateLeaveDto, UpdateLeaveDto, ApproveLeaveDto, RejectLeaveDto - Filter DTOs for all entities - HrPaginationDto Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes
parent
8565056de3
commit
56f5663583
218
src/modules/hr/dto/create-contract.dto.ts
Normal file
218
src/modules/hr/dto/create-contract.dto.ts
Normal file
@ -0,0 +1,218 @@
|
||||
import {
|
||||
IsString,
|
||||
IsUUID,
|
||||
IsOptional,
|
||||
IsDateString,
|
||||
IsEnum,
|
||||
IsNumber,
|
||||
IsPositive,
|
||||
MaxLength,
|
||||
MinLength,
|
||||
Min,
|
||||
Max,
|
||||
} from 'class-validator';
|
||||
import { ContractType, ContractStatus, WageType } from '../entities/contract.entity';
|
||||
|
||||
/**
|
||||
* DTO for creating a new employment contract
|
||||
*/
|
||||
export class CreateContractDto {
|
||||
@IsUUID()
|
||||
companyId: string;
|
||||
|
||||
@IsUUID()
|
||||
employeeId: string;
|
||||
|
||||
@IsString()
|
||||
@MinLength(1)
|
||||
@MaxLength(255)
|
||||
name: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
reference?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['permanent', 'temporary', 'contractor', 'internship', 'part_time'])
|
||||
contractType?: ContractType;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['draft', 'active', 'expired', 'terminated', 'cancelled'])
|
||||
status?: ContractStatus;
|
||||
|
||||
@IsDateString()
|
||||
dateStart: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateEnd?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
jobPositionId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
departmentId?: string;
|
||||
|
||||
// Compensation
|
||||
@IsNumber()
|
||||
@IsPositive()
|
||||
wage: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['hourly', 'daily', 'weekly', 'biweekly', 'monthly', 'annual'])
|
||||
wageType?: WageType;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(3)
|
||||
currency?: string;
|
||||
|
||||
// Schedule
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(0)
|
||||
@Max(168)
|
||||
hoursPerWeek?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
scheduleType?: string;
|
||||
|
||||
// Trial period
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(0)
|
||||
@Max(12)
|
||||
trialPeriodMonths?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
trialDateEnd?: string;
|
||||
|
||||
// Metadata
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
notes?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
documentUrl?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* DTO for updating an existing contract
|
||||
*/
|
||||
export class UpdateContractDto {
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MinLength(1)
|
||||
@MaxLength(255)
|
||||
name?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
reference?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['permanent', 'temporary', 'contractor', 'internship', 'part_time'])
|
||||
contractType?: ContractType;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['draft', 'active', 'expired', 'terminated', 'cancelled'])
|
||||
status?: ContractStatus;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateStart?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateEnd?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
jobPositionId?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
departmentId?: string | null;
|
||||
|
||||
// Compensation
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@IsPositive()
|
||||
wage?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['hourly', 'daily', 'weekly', 'biweekly', 'monthly', 'annual'])
|
||||
wageType?: WageType;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(3)
|
||||
currency?: string;
|
||||
|
||||
// Schedule
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(0)
|
||||
@Max(168)
|
||||
hoursPerWeek?: number | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
scheduleType?: string | null;
|
||||
|
||||
// Trial period
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(0)
|
||||
@Max(12)
|
||||
trialPeriodMonths?: number | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
trialDateEnd?: string | null;
|
||||
|
||||
// Metadata
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
notes?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
documentUrl?: string | null;
|
||||
|
||||
// Termination (only for termination flow)
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
terminationReason?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* DTO for activating a contract
|
||||
*/
|
||||
export class ActivateContractDto {
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
activatedAt?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* DTO for terminating a contract
|
||||
*/
|
||||
export class TerminateContractDto {
|
||||
@IsString()
|
||||
@MinLength(1)
|
||||
terminationReason: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
terminatedAt?: string;
|
||||
}
|
||||
180
src/modules/hr/dto/create-employee.dto.ts
Normal file
180
src/modules/hr/dto/create-employee.dto.ts
Normal file
@ -0,0 +1,180 @@
|
||||
import {
|
||||
IsString,
|
||||
IsUUID,
|
||||
IsOptional,
|
||||
IsDateString,
|
||||
IsEmail,
|
||||
IsEnum,
|
||||
MaxLength,
|
||||
MinLength,
|
||||
} from 'class-validator';
|
||||
import { EmployeeStatus } from '../entities/employee.entity';
|
||||
|
||||
/**
|
||||
* DTO for creating a new employee
|
||||
*/
|
||||
export class CreateEmployeeDto {
|
||||
@IsUUID()
|
||||
companyId: string;
|
||||
|
||||
@IsString()
|
||||
@MinLength(1)
|
||||
@MaxLength(50)
|
||||
employeeNumber: string;
|
||||
|
||||
@IsString()
|
||||
@MinLength(1)
|
||||
@MaxLength(100)
|
||||
firstName: string;
|
||||
|
||||
@IsString()
|
||||
@MinLength(1)
|
||||
@MaxLength(100)
|
||||
lastName: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
userId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
partnerId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
departmentId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
jobPositionId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
managerId?: string;
|
||||
|
||||
// Work contact
|
||||
@IsOptional()
|
||||
@IsEmail()
|
||||
@MaxLength(255)
|
||||
workEmail?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
workPhone?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
workMobile?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(255)
|
||||
workLocation?: string;
|
||||
|
||||
// Personal data
|
||||
@IsOptional()
|
||||
@IsEmail()
|
||||
@MaxLength(255)
|
||||
personalEmail?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
personalPhone?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
birthDate?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(20)
|
||||
gender?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(20)
|
||||
maritalStatus?: string;
|
||||
|
||||
// Identification
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
identificationType?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(100)
|
||||
identificationNumber?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
taxId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
socialSecurityNumber?: string;
|
||||
|
||||
// Address
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(255)
|
||||
street?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(100)
|
||||
city?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(100)
|
||||
state?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(20)
|
||||
postalCode?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(100)
|
||||
country?: string;
|
||||
|
||||
// Employment
|
||||
@IsDateString()
|
||||
hireDate: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['active', 'inactive', 'on_leave', 'terminated'])
|
||||
status?: EmployeeStatus;
|
||||
|
||||
// Emergency contact
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(255)
|
||||
emergencyContactName?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
emergencyContactPhone?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
emergencyContactRelationship?: string;
|
||||
|
||||
// Metadata
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
notes?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
avatarUrl?: string;
|
||||
}
|
||||
267
src/modules/hr/dto/create-leave.dto.ts
Normal file
267
src/modules/hr/dto/create-leave.dto.ts
Normal file
@ -0,0 +1,267 @@
|
||||
import {
|
||||
IsString,
|
||||
IsUUID,
|
||||
IsOptional,
|
||||
IsDateString,
|
||||
IsEnum,
|
||||
IsNumber,
|
||||
IsBoolean,
|
||||
IsPositive,
|
||||
MaxLength,
|
||||
MinLength,
|
||||
} from 'class-validator';
|
||||
import { LeaveStatus, HalfDayType } from '../entities/leave.entity';
|
||||
|
||||
/**
|
||||
* DTO for creating a new leave request
|
||||
*/
|
||||
export class CreateLeaveDto {
|
||||
@IsUUID()
|
||||
companyId: string;
|
||||
|
||||
@IsUUID()
|
||||
employeeId: string;
|
||||
|
||||
@IsUUID()
|
||||
leaveTypeId: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
allocationId?: string;
|
||||
|
||||
@IsDateString()
|
||||
dateFrom: string;
|
||||
|
||||
@IsDateString()
|
||||
dateTo: string;
|
||||
|
||||
@IsNumber()
|
||||
@IsPositive()
|
||||
daysRequested: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
isHalfDay?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['morning', 'afternoon'])
|
||||
halfDayType?: HalfDayType;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['draft', 'submitted', 'approved', 'rejected', 'cancelled'])
|
||||
status?: LeaveStatus;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
requestReason?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
documentUrl?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
notes?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* DTO for updating an existing leave request
|
||||
*/
|
||||
export class UpdateLeaveDto {
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
leaveTypeId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
allocationId?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateFrom?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateTo?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@IsPositive()
|
||||
daysRequested?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
isHalfDay?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['morning', 'afternoon'])
|
||||
halfDayType?: HalfDayType | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['draft', 'submitted', 'approved', 'rejected', 'cancelled'])
|
||||
status?: LeaveStatus;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
requestReason?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
documentUrl?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
notes?: string | null;
|
||||
}
|
||||
|
||||
/**
|
||||
* DTO for submitting a leave request for approval
|
||||
*/
|
||||
export class SubmitLeaveDto {
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
requestReason?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* DTO for approving a leave request
|
||||
*/
|
||||
export class ApproveLeaveDto {
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
notes?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* DTO for rejecting a leave request
|
||||
*/
|
||||
export class RejectLeaveDto {
|
||||
@IsString()
|
||||
@MinLength(1)
|
||||
@MaxLength(1000)
|
||||
rejectionReason: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* DTO for cancelling a leave request
|
||||
*/
|
||||
export class CancelLeaveDto {
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(1000)
|
||||
reason?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* DTO for creating a leave type
|
||||
*/
|
||||
export class CreateLeaveTypeDto {
|
||||
@IsUUID()
|
||||
companyId: string;
|
||||
|
||||
@IsString()
|
||||
@MinLength(1)
|
||||
@MaxLength(255)
|
||||
name: string;
|
||||
|
||||
@IsString()
|
||||
@MinLength(1)
|
||||
@MaxLength(50)
|
||||
code: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
description?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(7)
|
||||
color?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['vacation', 'sick', 'personal', 'maternity', 'paternity', 'bereavement', 'unpaid', 'other'])
|
||||
leaveCategory?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['fixed', 'accrual', 'unlimited'])
|
||||
allocationType?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
requiresApproval?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
requiresDocument?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
maxDaysPerRequest?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
maxDaysPerYear?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
minDaysNotice?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
isPaid?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
payPercentage?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
isActive?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* DTO for creating a leave allocation
|
||||
*/
|
||||
export class CreateLeaveAllocationDto {
|
||||
@IsUUID()
|
||||
employeeId: string;
|
||||
|
||||
@IsUUID()
|
||||
leaveTypeId: string;
|
||||
|
||||
@IsNumber()
|
||||
@IsPositive()
|
||||
daysAllocated: number;
|
||||
|
||||
@IsDateString()
|
||||
dateFrom: string;
|
||||
|
||||
@IsDateString()
|
||||
dateTo: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
notes?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* DTO for updating a leave allocation
|
||||
*/
|
||||
export class UpdateLeaveAllocationDto {
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@IsPositive()
|
||||
daysAllocated?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateFrom?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateTo?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
notes?: string | null;
|
||||
}
|
||||
260
src/modules/hr/dto/hr-filters.dto.ts
Normal file
260
src/modules/hr/dto/hr-filters.dto.ts
Normal file
@ -0,0 +1,260 @@
|
||||
import {
|
||||
IsString,
|
||||
IsUUID,
|
||||
IsOptional,
|
||||
IsDateString,
|
||||
IsEnum,
|
||||
IsBoolean,
|
||||
IsNumber,
|
||||
Min,
|
||||
} from 'class-validator';
|
||||
import { EmployeeStatus } from '../entities/employee.entity';
|
||||
import { ContractStatus, ContractType } from '../entities/contract.entity';
|
||||
import { LeaveStatus } from '../entities/leave.entity';
|
||||
import { LeaveTypeCategory } from '../entities/leave-type.entity';
|
||||
|
||||
/**
|
||||
* Filters for querying employees
|
||||
*/
|
||||
export class EmployeeFiltersDto {
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
companyId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
departmentId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
jobPositionId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
managerId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['active', 'inactive', 'on_leave', 'terminated'])
|
||||
status?: EmployeeStatus;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
hasUser?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
search?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
hireDateFrom?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
hireDateTo?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Filters for querying departments
|
||||
*/
|
||||
export class DepartmentFiltersDto {
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
companyId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
parentId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
isActive?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
isRoot?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
search?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Filters for querying job positions
|
||||
*/
|
||||
export class JobPositionFiltersDto {
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
companyId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
departmentId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
isActive?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
search?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Filters for querying contracts
|
||||
*/
|
||||
export class ContractFiltersDto {
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
companyId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
employeeId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['permanent', 'temporary', 'contractor', 'internship', 'part_time'])
|
||||
contractType?: ContractType;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['draft', 'active', 'expired', 'terminated', 'cancelled'])
|
||||
status?: ContractStatus;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateStartFrom?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateStartTo?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateEndFrom?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateEndTo?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
expiringWithinDays?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
search?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Filters for querying leave types
|
||||
*/
|
||||
export class LeaveTypeFiltersDto {
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
companyId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['vacation', 'sick', 'personal', 'maternity', 'paternity', 'bereavement', 'unpaid', 'other'])
|
||||
leaveCategory?: LeaveTypeCategory;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
isActive?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
isPaid?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
requiresApproval?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
search?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Filters for querying leaves
|
||||
*/
|
||||
export class LeaveFiltersDto {
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
companyId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
employeeId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
leaveTypeId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
approverId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['draft', 'submitted', 'approved', 'rejected', 'cancelled'])
|
||||
status?: LeaveStatus;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateFrom?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
dateTo?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
pendingApproval?: boolean;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
search?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Filters for querying leave allocations
|
||||
*/
|
||||
export class LeaveAllocationFiltersDto {
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
employeeId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
leaveTypeId?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
asOfDate?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsBoolean()
|
||||
hasRemainingDays?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Pagination parameters for HR queries
|
||||
*/
|
||||
export class HrPaginationDto {
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(1)
|
||||
page?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsNumber()
|
||||
@Min(1)
|
||||
limit?: number;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
sortBy?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['asc', 'desc', 'ASC', 'DESC'])
|
||||
sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC';
|
||||
}
|
||||
29
src/modules/hr/dto/index.ts
Normal file
29
src/modules/hr/dto/index.ts
Normal file
@ -0,0 +1,29 @@
|
||||
export { CreateEmployeeDto } from './create-employee.dto';
|
||||
export { UpdateEmployeeDto } from './update-employee.dto';
|
||||
export {
|
||||
CreateContractDto,
|
||||
UpdateContractDto,
|
||||
ActivateContractDto,
|
||||
TerminateContractDto,
|
||||
} from './create-contract.dto';
|
||||
export {
|
||||
CreateLeaveDto,
|
||||
UpdateLeaveDto,
|
||||
SubmitLeaveDto,
|
||||
ApproveLeaveDto,
|
||||
RejectLeaveDto,
|
||||
CancelLeaveDto,
|
||||
CreateLeaveTypeDto,
|
||||
CreateLeaveAllocationDto,
|
||||
UpdateLeaveAllocationDto,
|
||||
} from './create-leave.dto';
|
||||
export {
|
||||
EmployeeFiltersDto,
|
||||
DepartmentFiltersDto,
|
||||
JobPositionFiltersDto,
|
||||
ContractFiltersDto,
|
||||
LeaveTypeFiltersDto,
|
||||
LeaveFiltersDto,
|
||||
LeaveAllocationFiltersDto,
|
||||
HrPaginationDto,
|
||||
} from './hr-filters.dto';
|
||||
180
src/modules/hr/dto/update-employee.dto.ts
Normal file
180
src/modules/hr/dto/update-employee.dto.ts
Normal file
@ -0,0 +1,180 @@
|
||||
import {
|
||||
IsString,
|
||||
IsUUID,
|
||||
IsOptional,
|
||||
IsDateString,
|
||||
IsEmail,
|
||||
IsEnum,
|
||||
MaxLength,
|
||||
MinLength,
|
||||
} from 'class-validator';
|
||||
import { EmployeeStatus } from '../entities/employee.entity';
|
||||
|
||||
/**
|
||||
* DTO for updating an existing employee
|
||||
* All fields are optional since it's a partial update
|
||||
*/
|
||||
export class UpdateEmployeeDto {
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MinLength(1)
|
||||
@MaxLength(100)
|
||||
firstName?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MinLength(1)
|
||||
@MaxLength(100)
|
||||
lastName?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
userId?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
partnerId?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
departmentId?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
jobPositionId?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsUUID()
|
||||
managerId?: string | null;
|
||||
|
||||
// Work contact
|
||||
@IsOptional()
|
||||
@IsEmail()
|
||||
@MaxLength(255)
|
||||
workEmail?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
workPhone?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
workMobile?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(255)
|
||||
workLocation?: string | null;
|
||||
|
||||
// Personal data
|
||||
@IsOptional()
|
||||
@IsEmail()
|
||||
@MaxLength(255)
|
||||
personalEmail?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
personalPhone?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
birthDate?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(20)
|
||||
gender?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(20)
|
||||
maritalStatus?: string | null;
|
||||
|
||||
// Identification
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
identificationType?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(100)
|
||||
identificationNumber?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
taxId?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
socialSecurityNumber?: string | null;
|
||||
|
||||
// Address
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(255)
|
||||
street?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(100)
|
||||
city?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(100)
|
||||
state?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(20)
|
||||
postalCode?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(100)
|
||||
country?: string | null;
|
||||
|
||||
// Employment
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
hireDate?: string;
|
||||
|
||||
@IsOptional()
|
||||
@IsDateString()
|
||||
terminationDate?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsEnum(['active', 'inactive', 'on_leave', 'terminated'])
|
||||
status?: EmployeeStatus;
|
||||
|
||||
// Emergency contact
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(255)
|
||||
emergencyContactName?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
emergencyContactPhone?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
@MaxLength(50)
|
||||
emergencyContactRelationship?: string | null;
|
||||
|
||||
// Metadata
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
notes?: string | null;
|
||||
|
||||
@IsOptional()
|
||||
@IsString()
|
||||
avatarUrl?: string | null;
|
||||
}
|
||||
168
src/modules/hr/entities/contract.entity.ts
Normal file
168
src/modules/hr/entities/contract.entity.ts
Normal file
@ -0,0 +1,168 @@
|
||||
import {
|
||||
Entity,
|
||||
PrimaryGeneratedColumn,
|
||||
Column,
|
||||
CreateDateColumn,
|
||||
UpdateDateColumn,
|
||||
Index,
|
||||
ManyToOne,
|
||||
JoinColumn,
|
||||
} from 'typeorm';
|
||||
import { Employee } from './employee.entity';
|
||||
import { Department } from './department.entity';
|
||||
import { JobPosition } from './job-position.entity';
|
||||
|
||||
/**
|
||||
* Contract Type Enum
|
||||
*/
|
||||
export type ContractType = 'permanent' | 'temporary' | 'contractor' | 'internship' | 'part_time';
|
||||
|
||||
/**
|
||||
* Contract Status Enum
|
||||
*/
|
||||
export type ContractStatus = 'draft' | 'active' | 'expired' | 'terminated' | 'cancelled';
|
||||
|
||||
/**
|
||||
* Wage Type for payment frequency
|
||||
*/
|
||||
export type WageType = 'hourly' | 'daily' | 'weekly' | 'biweekly' | 'monthly' | 'annual';
|
||||
|
||||
/**
|
||||
* Contract Entity (schema: hr.contracts)
|
||||
*
|
||||
* Employment contracts with details about compensation, duration,
|
||||
* and terms of employment. Tracks contract lifecycle from draft to termination.
|
||||
*
|
||||
* RLS Policy: tenant_id = current_setting('app.current_tenant_id')
|
||||
*/
|
||||
@Entity({ name: 'contracts', schema: 'hr' })
|
||||
export class Contract {
|
||||
@PrimaryGeneratedColumn('uuid')
|
||||
id: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'tenant_id', type: 'uuid' })
|
||||
tenantId: string;
|
||||
|
||||
@Column({ name: 'company_id', type: 'uuid' })
|
||||
companyId: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'employee_id', type: 'uuid' })
|
||||
employeeId: string;
|
||||
|
||||
@ManyToOne(() => Employee, (employee) => employee.contracts, {
|
||||
onDelete: 'CASCADE',
|
||||
})
|
||||
@JoinColumn({ name: 'employee_id' })
|
||||
employee: Employee;
|
||||
|
||||
@Column({ name: 'name', type: 'varchar', length: 255 })
|
||||
name: string;
|
||||
|
||||
@Column({ name: 'reference', type: 'varchar', length: 50, nullable: true })
|
||||
reference: string | null;
|
||||
|
||||
@Index()
|
||||
@Column({
|
||||
name: 'contract_type',
|
||||
type: 'enum',
|
||||
enum: ['permanent', 'temporary', 'contractor', 'internship', 'part_time'],
|
||||
enumName: 'hr_contract_type',
|
||||
default: 'permanent',
|
||||
})
|
||||
contractType: ContractType;
|
||||
|
||||
@Index()
|
||||
@Column({
|
||||
name: 'status',
|
||||
type: 'enum',
|
||||
enum: ['draft', 'active', 'expired', 'terminated', 'cancelled'],
|
||||
enumName: 'hr_contract_status',
|
||||
default: 'draft',
|
||||
})
|
||||
status: ContractStatus;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'date_start', type: 'date' })
|
||||
dateStart: Date;
|
||||
|
||||
@Column({ name: 'date_end', type: 'date', nullable: true })
|
||||
dateEnd: Date | null;
|
||||
|
||||
@Column({ name: 'job_position_id', type: 'uuid', nullable: true })
|
||||
jobPositionId: string | null;
|
||||
|
||||
@ManyToOne(() => JobPosition, { onDelete: 'SET NULL' })
|
||||
@JoinColumn({ name: 'job_position_id' })
|
||||
jobPosition: JobPosition | null;
|
||||
|
||||
@Column({ name: 'department_id', type: 'uuid', nullable: true })
|
||||
departmentId: string | null;
|
||||
|
||||
@ManyToOne(() => Department, { onDelete: 'SET NULL' })
|
||||
@JoinColumn({ name: 'department_id' })
|
||||
department: Department | null;
|
||||
|
||||
// Compensation
|
||||
@Column({ name: 'wage', type: 'decimal', precision: 15, scale: 2 })
|
||||
wage: number;
|
||||
|
||||
@Column({
|
||||
name: 'wage_type',
|
||||
type: 'varchar',
|
||||
length: 20,
|
||||
default: 'monthly',
|
||||
})
|
||||
wageType: WageType;
|
||||
|
||||
@Column({ name: 'currency', type: 'varchar', length: 3, default: 'MXN' })
|
||||
currency: string;
|
||||
|
||||
// Schedule
|
||||
@Column({
|
||||
name: 'hours_per_week',
|
||||
type: 'decimal',
|
||||
precision: 5,
|
||||
scale: 2,
|
||||
nullable: true,
|
||||
default: 48,
|
||||
})
|
||||
hoursPerWeek: number | null;
|
||||
|
||||
@Column({ name: 'schedule_type', type: 'varchar', length: 50, nullable: true })
|
||||
scheduleType: string | null;
|
||||
|
||||
// Trial period
|
||||
@Column({ name: 'trial_period_months', type: 'integer', nullable: true, default: 0 })
|
||||
trialPeriodMonths: number | null;
|
||||
|
||||
@Column({ name: 'trial_date_end', type: 'date', nullable: true })
|
||||
trialDateEnd: Date | null;
|
||||
|
||||
// Metadata
|
||||
@Column({ name: 'notes', type: 'text', nullable: true })
|
||||
notes: string | null;
|
||||
|
||||
@Column({ name: 'document_url', type: 'text', nullable: true })
|
||||
documentUrl: string | null;
|
||||
|
||||
// Audit
|
||||
@CreateDateColumn({ name: 'created_at', type: 'timestamptz' })
|
||||
createdAt: Date;
|
||||
|
||||
@UpdateDateColumn({ name: 'updated_at', type: 'timestamptz' })
|
||||
updatedAt: Date;
|
||||
|
||||
@Column({ name: 'activated_at', type: 'timestamptz', nullable: true })
|
||||
activatedAt: Date | null;
|
||||
|
||||
@Column({ name: 'terminated_at', type: 'timestamptz', nullable: true })
|
||||
terminatedAt: Date | null;
|
||||
|
||||
@Column({ name: 'terminated_by', type: 'uuid', nullable: true })
|
||||
terminatedBy: string | null;
|
||||
|
||||
@Column({ name: 'termination_reason', type: 'text', nullable: true })
|
||||
terminationReason: string | null;
|
||||
}
|
||||
80
src/modules/hr/entities/department.entity.ts
Normal file
80
src/modules/hr/entities/department.entity.ts
Normal file
@ -0,0 +1,80 @@
|
||||
import {
|
||||
Entity,
|
||||
PrimaryGeneratedColumn,
|
||||
Column,
|
||||
CreateDateColumn,
|
||||
UpdateDateColumn,
|
||||
Index,
|
||||
ManyToOne,
|
||||
OneToMany,
|
||||
JoinColumn,
|
||||
} from 'typeorm';
|
||||
import { Employee } from './employee.entity';
|
||||
|
||||
/**
|
||||
* Department Entity (schema: hr.departments)
|
||||
*
|
||||
* Organizational departments with self-referential hierarchy.
|
||||
* Supports parent/child relationships for department structure.
|
||||
*
|
||||
* RLS Policy: tenant_id = current_setting('app.current_tenant_id')
|
||||
*/
|
||||
@Entity({ name: 'departments', schema: 'hr' })
|
||||
@Index(['tenantId', 'companyId', 'code'], { unique: true })
|
||||
export class Department {
|
||||
@PrimaryGeneratedColumn('uuid')
|
||||
id: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'tenant_id', type: 'uuid' })
|
||||
tenantId: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'company_id', type: 'uuid' })
|
||||
companyId: string;
|
||||
|
||||
@Column({ name: 'name', type: 'varchar', length: 255 })
|
||||
name: string;
|
||||
|
||||
@Column({ name: 'code', type: 'varchar', length: 50, nullable: true })
|
||||
code: string | null;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'parent_id', type: 'uuid', nullable: true })
|
||||
parentId: string | null;
|
||||
|
||||
@ManyToOne(() => Department, (department) => department.children, {
|
||||
onDelete: 'SET NULL',
|
||||
})
|
||||
@JoinColumn({ name: 'parent_id' })
|
||||
parent: Department | null;
|
||||
|
||||
@OneToMany(() => Department, (department) => department.parent)
|
||||
children: Department[];
|
||||
|
||||
@Column({ name: 'manager_id', type: 'uuid', nullable: true })
|
||||
managerId: string | null;
|
||||
|
||||
@ManyToOne(() => Employee, { onDelete: 'SET NULL' })
|
||||
@JoinColumn({ name: 'manager_id' })
|
||||
manager: Employee | null;
|
||||
|
||||
@OneToMany(() => Employee, (employee) => employee.department)
|
||||
employees: Employee[];
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'is_active', type: 'boolean', default: true })
|
||||
isActive: boolean;
|
||||
|
||||
@Column({ name: 'description', type: 'text', nullable: true })
|
||||
description: string | null;
|
||||
|
||||
@Column({ name: 'color', type: 'varchar', length: 7, nullable: true })
|
||||
color: string | null;
|
||||
|
||||
@CreateDateColumn({ name: 'created_at', type: 'timestamptz' })
|
||||
createdAt: Date;
|
||||
|
||||
@UpdateDateColumn({ name: 'updated_at', type: 'timestamptz' })
|
||||
updatedAt: Date;
|
||||
}
|
||||
223
src/modules/hr/entities/employee.entity.ts
Normal file
223
src/modules/hr/entities/employee.entity.ts
Normal file
@ -0,0 +1,223 @@
|
||||
import {
|
||||
Entity,
|
||||
PrimaryGeneratedColumn,
|
||||
Column,
|
||||
CreateDateColumn,
|
||||
UpdateDateColumn,
|
||||
Index,
|
||||
ManyToOne,
|
||||
OneToMany,
|
||||
JoinColumn,
|
||||
} from 'typeorm';
|
||||
import { Department } from './department.entity';
|
||||
import { JobPosition } from './job-position.entity';
|
||||
import { Contract } from './contract.entity';
|
||||
import { Leave } from './leave.entity';
|
||||
import { LeaveAllocation } from './leave-allocation.entity';
|
||||
|
||||
/**
|
||||
* Employee Status Enum
|
||||
*/
|
||||
export type EmployeeStatus = 'active' | 'inactive' | 'on_leave' | 'terminated';
|
||||
|
||||
/**
|
||||
* Employee Entity (schema: hr.employees)
|
||||
*
|
||||
* Core employee information including personal data, organization assignment,
|
||||
* and employment details. Supports self-referential manager relationship.
|
||||
*
|
||||
* Relations:
|
||||
* - user_id: References auth.users (optional - employee may not have system access)
|
||||
* - partner_id: References partners.partners (optional - employee as business contact)
|
||||
* - department_id: Current department assignment
|
||||
* - job_position_id: Current job position
|
||||
* - manager_id: Direct manager (self-reference)
|
||||
*
|
||||
* RLS Policy: tenant_id = current_setting('app.current_tenant_id')
|
||||
*/
|
||||
@Entity({ name: 'employees', schema: 'hr' })
|
||||
@Index(['tenantId', 'employeeNumber'], { unique: true })
|
||||
export class Employee {
|
||||
@PrimaryGeneratedColumn('uuid')
|
||||
id: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'tenant_id', type: 'uuid' })
|
||||
tenantId: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'company_id', type: 'uuid' })
|
||||
companyId: string;
|
||||
|
||||
@Column({ name: 'employee_number', type: 'varchar', length: 50 })
|
||||
employeeNumber: string;
|
||||
|
||||
@Column({ name: 'first_name', type: 'varchar', length: 100 })
|
||||
firstName: string;
|
||||
|
||||
@Column({ name: 'last_name', type: 'varchar', length: 100 })
|
||||
lastName: string;
|
||||
|
||||
/**
|
||||
* Generated column in PostgreSQL: first_name || ' ' || last_name
|
||||
* Mark as insert: false, update: false since it's computed by DB
|
||||
*/
|
||||
@Index()
|
||||
@Column({
|
||||
name: 'full_name',
|
||||
type: 'varchar',
|
||||
length: 255,
|
||||
insert: false,
|
||||
update: false,
|
||||
nullable: true,
|
||||
})
|
||||
fullName: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'user_id', type: 'uuid', nullable: true })
|
||||
userId: string | null;
|
||||
|
||||
@Column({ name: 'partner_id', type: 'uuid', nullable: true })
|
||||
partnerId: string | null;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'department_id', type: 'uuid', nullable: true })
|
||||
departmentId: string | null;
|
||||
|
||||
@ManyToOne(() => Department, (department) => department.employees, {
|
||||
onDelete: 'SET NULL',
|
||||
})
|
||||
@JoinColumn({ name: 'department_id' })
|
||||
department: Department | null;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'job_position_id', type: 'uuid', nullable: true })
|
||||
jobPositionId: string | null;
|
||||
|
||||
@ManyToOne(() => JobPosition, (position) => position.employees, {
|
||||
onDelete: 'SET NULL',
|
||||
})
|
||||
@JoinColumn({ name: 'job_position_id' })
|
||||
jobPosition: JobPosition | null;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'manager_id', type: 'uuid', nullable: true })
|
||||
managerId: string | null;
|
||||
|
||||
@ManyToOne(() => Employee, (employee) => employee.subordinates, {
|
||||
onDelete: 'SET NULL',
|
||||
})
|
||||
@JoinColumn({ name: 'manager_id' })
|
||||
manager: Employee | null;
|
||||
|
||||
@OneToMany(() => Employee, (employee) => employee.manager)
|
||||
subordinates: Employee[];
|
||||
|
||||
// Work contact
|
||||
@Column({ name: 'work_email', type: 'varchar', length: 255, nullable: true })
|
||||
workEmail: string | null;
|
||||
|
||||
@Column({ name: 'work_phone', type: 'varchar', length: 50, nullable: true })
|
||||
workPhone: string | null;
|
||||
|
||||
@Column({ name: 'work_mobile', type: 'varchar', length: 50, nullable: true })
|
||||
workMobile: string | null;
|
||||
|
||||
@Column({ name: 'work_location', type: 'varchar', length: 255, nullable: true })
|
||||
workLocation: string | null;
|
||||
|
||||
// Personal data
|
||||
@Column({ name: 'personal_email', type: 'varchar', length: 255, nullable: true })
|
||||
personalEmail: string | null;
|
||||
|
||||
@Column({ name: 'personal_phone', type: 'varchar', length: 50, nullable: true })
|
||||
personalPhone: string | null;
|
||||
|
||||
@Column({ name: 'birth_date', type: 'date', nullable: true })
|
||||
birthDate: Date | null;
|
||||
|
||||
@Column({ name: 'gender', type: 'varchar', length: 20, nullable: true })
|
||||
gender: string | null;
|
||||
|
||||
@Column({ name: 'marital_status', type: 'varchar', length: 20, nullable: true })
|
||||
maritalStatus: string | null;
|
||||
|
||||
// Official identification
|
||||
@Column({ name: 'identification_type', type: 'varchar', length: 50, nullable: true })
|
||||
identificationType: string | null;
|
||||
|
||||
@Column({ name: 'identification_number', type: 'varchar', length: 100, nullable: true })
|
||||
identificationNumber: string | null;
|
||||
|
||||
@Column({ name: 'tax_id', type: 'varchar', length: 50, nullable: true })
|
||||
taxId: string | null;
|
||||
|
||||
@Column({ name: 'social_security_number', type: 'varchar', length: 50, nullable: true })
|
||||
socialSecurityNumber: string | null;
|
||||
|
||||
// Address
|
||||
@Column({ name: 'street', type: 'varchar', length: 255, nullable: true })
|
||||
street: string | null;
|
||||
|
||||
@Column({ name: 'city', type: 'varchar', length: 100, nullable: true })
|
||||
city: string | null;
|
||||
|
||||
@Column({ name: 'state', type: 'varchar', length: 100, nullable: true })
|
||||
state: string | null;
|
||||
|
||||
@Column({ name: 'postal_code', type: 'varchar', length: 20, nullable: true })
|
||||
postalCode: string | null;
|
||||
|
||||
@Column({ name: 'country', type: 'varchar', length: 100, nullable: true })
|
||||
country: string | null;
|
||||
|
||||
// Employment
|
||||
@Column({ name: 'hire_date', type: 'date' })
|
||||
hireDate: Date;
|
||||
|
||||
@Column({ name: 'termination_date', type: 'date', nullable: true })
|
||||
terminationDate: Date | null;
|
||||
|
||||
@Index()
|
||||
@Column({
|
||||
name: 'status',
|
||||
type: 'enum',
|
||||
enum: ['active', 'inactive', 'on_leave', 'terminated'],
|
||||
enumName: 'hr_employee_status',
|
||||
default: 'active',
|
||||
})
|
||||
status: EmployeeStatus;
|
||||
|
||||
// Emergency contact
|
||||
@Column({ name: 'emergency_contact_name', type: 'varchar', length: 255, nullable: true })
|
||||
emergencyContactName: string | null;
|
||||
|
||||
@Column({ name: 'emergency_contact_phone', type: 'varchar', length: 50, nullable: true })
|
||||
emergencyContactPhone: string | null;
|
||||
|
||||
@Column({ name: 'emergency_contact_relationship', type: 'varchar', length: 50, nullable: true })
|
||||
emergencyContactRelationship: string | null;
|
||||
|
||||
// Metadata
|
||||
@Column({ name: 'notes', type: 'text', nullable: true })
|
||||
notes: string | null;
|
||||
|
||||
@Column({ name: 'avatar_url', type: 'text', nullable: true })
|
||||
avatarUrl: string | null;
|
||||
|
||||
// Relations
|
||||
@OneToMany(() => Contract, (contract) => contract.employee)
|
||||
contracts: Contract[];
|
||||
|
||||
@OneToMany(() => Leave, (leave) => leave.employee)
|
||||
leaves: Leave[];
|
||||
|
||||
@OneToMany(() => LeaveAllocation, (allocation) => allocation.employee)
|
||||
leaveAllocations: LeaveAllocation[];
|
||||
|
||||
@CreateDateColumn({ name: 'created_at', type: 'timestamptz' })
|
||||
createdAt: Date;
|
||||
|
||||
@UpdateDateColumn({ name: 'updated_at', type: 'timestamptz' })
|
||||
updatedAt: Date;
|
||||
}
|
||||
7
src/modules/hr/entities/index.ts
Normal file
7
src/modules/hr/entities/index.ts
Normal file
@ -0,0 +1,7 @@
|
||||
export { Department } from './department.entity';
|
||||
export { JobPosition } from './job-position.entity';
|
||||
export { Employee, EmployeeStatus } from './employee.entity';
|
||||
export { Contract, ContractType, ContractStatus, WageType } from './contract.entity';
|
||||
export { LeaveType, LeaveTypeCategory, AllocationType } from './leave-type.entity';
|
||||
export { LeaveAllocation } from './leave-allocation.entity';
|
||||
export { Leave, LeaveStatus, HalfDayType } from './leave.entity';
|
||||
65
src/modules/hr/entities/job-position.entity.ts
Normal file
65
src/modules/hr/entities/job-position.entity.ts
Normal file
@ -0,0 +1,65 @@
|
||||
import {
|
||||
Entity,
|
||||
PrimaryGeneratedColumn,
|
||||
Column,
|
||||
CreateDateColumn,
|
||||
UpdateDateColumn,
|
||||
Index,
|
||||
ManyToOne,
|
||||
OneToMany,
|
||||
JoinColumn,
|
||||
} from 'typeorm';
|
||||
import { Department } from './department.entity';
|
||||
import { Employee } from './employee.entity';
|
||||
|
||||
/**
|
||||
* Job Position Entity (schema: hr.job_positions)
|
||||
*
|
||||
* Defines job titles/positions within the organization.
|
||||
* Can be associated with a specific department.
|
||||
*
|
||||
* RLS Policy: tenant_id = current_setting('app.current_tenant_id')
|
||||
*/
|
||||
@Entity({ name: 'job_positions', schema: 'hr' })
|
||||
@Index(['tenantId', 'companyId', 'code'], { unique: true })
|
||||
export class JobPosition {
|
||||
@PrimaryGeneratedColumn('uuid')
|
||||
id: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'tenant_id', type: 'uuid' })
|
||||
tenantId: string;
|
||||
|
||||
@Column({ name: 'company_id', type: 'uuid' })
|
||||
companyId: string;
|
||||
|
||||
@Column({ name: 'name', type: 'varchar', length: 255 })
|
||||
name: string;
|
||||
|
||||
@Column({ name: 'code', type: 'varchar', length: 50, nullable: true })
|
||||
code: string | null;
|
||||
|
||||
@Column({ name: 'description', type: 'text', nullable: true })
|
||||
description: string | null;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'department_id', type: 'uuid', nullable: true })
|
||||
departmentId: string | null;
|
||||
|
||||
@ManyToOne(() => Department, { onDelete: 'SET NULL' })
|
||||
@JoinColumn({ name: 'department_id' })
|
||||
department: Department | null;
|
||||
|
||||
@OneToMany(() => Employee, (employee) => employee.jobPosition)
|
||||
employees: Employee[];
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'is_active', type: 'boolean', default: true })
|
||||
isActive: boolean;
|
||||
|
||||
@CreateDateColumn({ name: 'created_at', type: 'timestamptz' })
|
||||
createdAt: Date;
|
||||
|
||||
@UpdateDateColumn({ name: 'updated_at', type: 'timestamptz' })
|
||||
updatedAt: Date;
|
||||
}
|
||||
89
src/modules/hr/entities/leave-allocation.entity.ts
Normal file
89
src/modules/hr/entities/leave-allocation.entity.ts
Normal file
@ -0,0 +1,89 @@
|
||||
import {
|
||||
Entity,
|
||||
PrimaryGeneratedColumn,
|
||||
Column,
|
||||
CreateDateColumn,
|
||||
UpdateDateColumn,
|
||||
Index,
|
||||
ManyToOne,
|
||||
JoinColumn,
|
||||
} from 'typeorm';
|
||||
import { Employee } from './employee.entity';
|
||||
import { LeaveType } from './leave-type.entity';
|
||||
|
||||
/**
|
||||
* Leave Allocation Entity (schema: hr.leave_allocations)
|
||||
*
|
||||
* Tracks allocated leave days per employee and leave type.
|
||||
* Supports period-based allocations with used/remaining tracking.
|
||||
*
|
||||
* Note: days_remaining is a computed column in PostgreSQL
|
||||
*
|
||||
* RLS Policy: tenant_id = current_setting('app.current_tenant_id')
|
||||
*/
|
||||
@Entity({ name: 'leave_allocations', schema: 'hr' })
|
||||
export class LeaveAllocation {
|
||||
@PrimaryGeneratedColumn('uuid')
|
||||
id: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'tenant_id', type: 'uuid' })
|
||||
tenantId: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'employee_id', type: 'uuid' })
|
||||
employeeId: string;
|
||||
|
||||
@ManyToOne(() => Employee, (employee) => employee.leaveAllocations, {
|
||||
onDelete: 'CASCADE',
|
||||
})
|
||||
@JoinColumn({ name: 'employee_id' })
|
||||
employee: Employee;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'leave_type_id', type: 'uuid' })
|
||||
leaveTypeId: string;
|
||||
|
||||
@ManyToOne(() => LeaveType, (leaveType) => leaveType.allocations, {
|
||||
onDelete: 'CASCADE',
|
||||
})
|
||||
@JoinColumn({ name: 'leave_type_id' })
|
||||
leaveType: LeaveType;
|
||||
|
||||
@Column({ name: 'days_allocated', type: 'decimal', precision: 5, scale: 2 })
|
||||
daysAllocated: number;
|
||||
|
||||
@Column({ name: 'days_used', type: 'decimal', precision: 5, scale: 2, default: 0 })
|
||||
daysUsed: number;
|
||||
|
||||
/**
|
||||
* Generated column in PostgreSQL: days_allocated - days_used
|
||||
* Mark as insert: false, update: false since it's computed by DB
|
||||
*/
|
||||
@Column({
|
||||
name: 'days_remaining',
|
||||
type: 'decimal',
|
||||
precision: 5,
|
||||
scale: 2,
|
||||
insert: false,
|
||||
update: false,
|
||||
nullable: true,
|
||||
})
|
||||
daysRemaining: number;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'date_from', type: 'date' })
|
||||
dateFrom: Date;
|
||||
|
||||
@Column({ name: 'date_to', type: 'date' })
|
||||
dateTo: Date;
|
||||
|
||||
@Column({ name: 'notes', type: 'text', nullable: true })
|
||||
notes: string | null;
|
||||
|
||||
@CreateDateColumn({ name: 'created_at', type: 'timestamptz' })
|
||||
createdAt: Date;
|
||||
|
||||
@UpdateDateColumn({ name: 'updated_at', type: 'timestamptz' })
|
||||
updatedAt: Date;
|
||||
}
|
||||
131
src/modules/hr/entities/leave-type.entity.ts
Normal file
131
src/modules/hr/entities/leave-type.entity.ts
Normal file
@ -0,0 +1,131 @@
|
||||
import {
|
||||
Entity,
|
||||
PrimaryGeneratedColumn,
|
||||
Column,
|
||||
CreateDateColumn,
|
||||
UpdateDateColumn,
|
||||
Index,
|
||||
OneToMany,
|
||||
} from 'typeorm';
|
||||
import { Leave } from './leave.entity';
|
||||
import { LeaveAllocation } from './leave-allocation.entity';
|
||||
|
||||
/**
|
||||
* Leave Type Category Enum
|
||||
*/
|
||||
export type LeaveTypeCategory =
|
||||
| 'vacation'
|
||||
| 'sick'
|
||||
| 'personal'
|
||||
| 'maternity'
|
||||
| 'paternity'
|
||||
| 'bereavement'
|
||||
| 'unpaid'
|
||||
| 'other';
|
||||
|
||||
/**
|
||||
* Allocation Type Enum
|
||||
*/
|
||||
export type AllocationType = 'fixed' | 'accrual' | 'unlimited';
|
||||
|
||||
/**
|
||||
* Leave Type Entity (schema: hr.leave_types)
|
||||
*
|
||||
* Configurable leave/absence types for the organization.
|
||||
* Defines rules for approval, allocation, and payment.
|
||||
*
|
||||
* Examples: Vacation, Sick Leave, Maternity, etc.
|
||||
*
|
||||
* RLS Policy: tenant_id = current_setting('app.current_tenant_id')
|
||||
*/
|
||||
@Entity({ name: 'leave_types', schema: 'hr' })
|
||||
@Index(['tenantId', 'companyId', 'code'], { unique: true })
|
||||
export class LeaveType {
|
||||
@PrimaryGeneratedColumn('uuid')
|
||||
id: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'tenant_id', type: 'uuid' })
|
||||
tenantId: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'company_id', type: 'uuid' })
|
||||
companyId: string;
|
||||
|
||||
@Column({ name: 'name', type: 'varchar', length: 255 })
|
||||
name: string;
|
||||
|
||||
@Column({ name: 'code', type: 'varchar', length: 50 })
|
||||
code: string;
|
||||
|
||||
@Column({ name: 'description', type: 'text', nullable: true })
|
||||
description: string | null;
|
||||
|
||||
@Column({ name: 'color', type: 'varchar', length: 7, default: '#3B82F6' })
|
||||
color: string;
|
||||
|
||||
@Index()
|
||||
@Column({
|
||||
name: 'leave_category',
|
||||
type: 'enum',
|
||||
enum: ['vacation', 'sick', 'personal', 'maternity', 'paternity', 'bereavement', 'unpaid', 'other'],
|
||||
enumName: 'hr_leave_type_category',
|
||||
default: 'other',
|
||||
})
|
||||
leaveCategory: LeaveTypeCategory;
|
||||
|
||||
@Column({
|
||||
name: 'allocation_type',
|
||||
type: 'enum',
|
||||
enum: ['fixed', 'accrual', 'unlimited'],
|
||||
enumName: 'hr_allocation_type',
|
||||
default: 'fixed',
|
||||
})
|
||||
allocationType: AllocationType;
|
||||
|
||||
@Column({ name: 'requires_approval', type: 'boolean', default: true })
|
||||
requiresApproval: boolean;
|
||||
|
||||
@Column({ name: 'requires_document', type: 'boolean', default: false })
|
||||
requiresDocument: boolean;
|
||||
|
||||
// Limits
|
||||
@Column({ name: 'max_days_per_request', type: 'integer', nullable: true })
|
||||
maxDaysPerRequest: number | null;
|
||||
|
||||
@Column({ name: 'max_days_per_year', type: 'integer', nullable: true })
|
||||
maxDaysPerYear: number | null;
|
||||
|
||||
@Column({ name: 'min_days_notice', type: 'integer', default: 0 })
|
||||
minDaysNotice: number;
|
||||
|
||||
// Payment
|
||||
@Column({ name: 'is_paid', type: 'boolean', default: true })
|
||||
isPaid: boolean;
|
||||
|
||||
@Column({
|
||||
name: 'pay_percentage',
|
||||
type: 'decimal',
|
||||
precision: 5,
|
||||
scale: 2,
|
||||
default: 100,
|
||||
})
|
||||
payPercentage: number;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'is_active', type: 'boolean', default: true })
|
||||
isActive: boolean;
|
||||
|
||||
// Relations
|
||||
@OneToMany(() => Leave, (leave) => leave.leaveType)
|
||||
leaves: Leave[];
|
||||
|
||||
@OneToMany(() => LeaveAllocation, (allocation) => allocation.leaveType)
|
||||
allocations: LeaveAllocation[];
|
||||
|
||||
@CreateDateColumn({ name: 'created_at', type: 'timestamptz' })
|
||||
createdAt: Date;
|
||||
|
||||
@UpdateDateColumn({ name: 'updated_at', type: 'timestamptz' })
|
||||
updatedAt: Date;
|
||||
}
|
||||
142
src/modules/hr/entities/leave.entity.ts
Normal file
142
src/modules/hr/entities/leave.entity.ts
Normal file
@ -0,0 +1,142 @@
|
||||
import {
|
||||
Entity,
|
||||
PrimaryGeneratedColumn,
|
||||
Column,
|
||||
CreateDateColumn,
|
||||
UpdateDateColumn,
|
||||
Index,
|
||||
ManyToOne,
|
||||
JoinColumn,
|
||||
} from 'typeorm';
|
||||
import { Employee } from './employee.entity';
|
||||
import { LeaveType } from './leave-type.entity';
|
||||
import { LeaveAllocation } from './leave-allocation.entity';
|
||||
|
||||
/**
|
||||
* Leave Status Enum
|
||||
*/
|
||||
export type LeaveStatus = 'draft' | 'submitted' | 'approved' | 'rejected' | 'cancelled';
|
||||
|
||||
/**
|
||||
* Half Day Type
|
||||
*/
|
||||
export type HalfDayType = 'morning' | 'afternoon';
|
||||
|
||||
/**
|
||||
* Leave Entity (schema: hr.leaves)
|
||||
*
|
||||
* Leave/absence requests from employees.
|
||||
* Tracks the full lifecycle from draft to approval/rejection.
|
||||
*
|
||||
* RLS Policy: tenant_id = current_setting('app.current_tenant_id')
|
||||
*/
|
||||
@Entity({ name: 'leaves', schema: 'hr' })
|
||||
export class Leave {
|
||||
@PrimaryGeneratedColumn('uuid')
|
||||
id: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'tenant_id', type: 'uuid' })
|
||||
tenantId: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'company_id', type: 'uuid' })
|
||||
companyId: string;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'employee_id', type: 'uuid' })
|
||||
employeeId: string;
|
||||
|
||||
@ManyToOne(() => Employee, (employee) => employee.leaves, {
|
||||
onDelete: 'CASCADE',
|
||||
})
|
||||
@JoinColumn({ name: 'employee_id' })
|
||||
employee: Employee;
|
||||
|
||||
@Index()
|
||||
@Column({ name: 'leave_type_id', type: 'uuid' })
|
||||
leaveTypeId: string;
|
||||
|
||||
@ManyToOne(() => LeaveType, (leaveType) => leaveType.leaves, {
|
||||
onDelete: 'RESTRICT',
|
||||
})
|
||||
@JoinColumn({ name: 'leave_type_id' })
|
||||
leaveType: LeaveType;
|
||||
|
||||
@Column({ name: 'allocation_id', type: 'uuid', nullable: true })
|
||||
allocationId: string | null;
|
||||
|
||||
@ManyToOne(() => LeaveAllocation, { onDelete: 'SET NULL' })
|
||||
@JoinColumn({ name: 'allocation_id' })
|
||||
allocation: LeaveAllocation | null;
|
||||
|
||||
// Period
|
||||
@Index()
|
||||
@Column({ name: 'date_from', type: 'date' })
|
||||
dateFrom: Date;
|
||||
|
||||
@Column({ name: 'date_to', type: 'date' })
|
||||
dateTo: Date;
|
||||
|
||||
@Column({ name: 'days_requested', type: 'decimal', precision: 5, scale: 2 })
|
||||
daysRequested: number;
|
||||
|
||||
// Half day support
|
||||
@Column({ name: 'is_half_day', type: 'boolean', default: false })
|
||||
isHalfDay: boolean;
|
||||
|
||||
@Column({
|
||||
name: 'half_day_type',
|
||||
type: 'varchar',
|
||||
length: 20,
|
||||
nullable: true,
|
||||
})
|
||||
halfDayType: HalfDayType | null;
|
||||
|
||||
@Index()
|
||||
@Column({
|
||||
name: 'status',
|
||||
type: 'enum',
|
||||
enum: ['draft', 'submitted', 'approved', 'rejected', 'cancelled'],
|
||||
enumName: 'hr_leave_status',
|
||||
default: 'draft',
|
||||
})
|
||||
status: LeaveStatus;
|
||||
|
||||
// Approval
|
||||
@Index()
|
||||
@Column({ name: 'approver_id', type: 'uuid', nullable: true })
|
||||
approverId: string | null;
|
||||
|
||||
@Column({ name: 'approved_at', type: 'timestamptz', nullable: true })
|
||||
approvedAt: Date | null;
|
||||
|
||||
@Column({ name: 'rejection_reason', type: 'text', nullable: true })
|
||||
rejectionReason: string | null;
|
||||
|
||||
// Metadata
|
||||
@Column({ name: 'request_reason', type: 'text', nullable: true })
|
||||
requestReason: string | null;
|
||||
|
||||
@Column({ name: 'document_url', type: 'text', nullable: true })
|
||||
documentUrl: string | null;
|
||||
|
||||
@Column({ name: 'notes', type: 'text', nullable: true })
|
||||
notes: string | null;
|
||||
|
||||
// Audit
|
||||
@CreateDateColumn({ name: 'created_at', type: 'timestamptz' })
|
||||
createdAt: Date;
|
||||
|
||||
@UpdateDateColumn({ name: 'updated_at', type: 'timestamptz' })
|
||||
updatedAt: Date;
|
||||
|
||||
@Column({ name: 'submitted_at', type: 'timestamptz', nullable: true })
|
||||
submittedAt: Date | null;
|
||||
|
||||
@Column({ name: 'cancelled_at', type: 'timestamptz', nullable: true })
|
||||
cancelledAt: Date | null;
|
||||
|
||||
@Column({ name: 'cancelled_by', type: 'uuid', nullable: true })
|
||||
cancelledBy: string | null;
|
||||
}
|
||||
Loading…
Reference in New Issue
Block a user