@hed-hog/operations 0.0.295 → 0.0.296

package/dist/operations.service.d.ts

@@ -1,178 +1,614 @@
+import { PrismaService } from '@hed-hog/api-prisma';
+import { IntegrationDeveloperApiService } from '@hed-hog/core';
+type CollaboratorPayload = {
+    userId: number;
+    code: string;
+    displayName: string;
+    collaboratorType?: 'clt' | 'pj' | 'freelancer' | 'intern' | 'other';
+    department?: string | null;
+    title?: string | null;
+    levelLabel?: string | null;
+    supervisorCollaboratorId?: number | null;
+    weeklyCapacityHours?: number | null;
+    status?: 'active' | 'on_leave' | 'inactive';
+    joinedAt?: string | null;
+    leftAt?: string | null;
+    compensationAmount?: number | null;
+    contractDescription?: string | null;
+    autoGenerateContractDraft?: boolean;
+    weeklySchedule?: Array<{
+        weekday: 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+        isWorkingDay?: boolean;
+        startTime?: string | null;
+        endTime?: string | null;
+        breakMinutes?: number | null;
+    }>;
+    notes?: string | null;
+};
+type ContractPayload = {
+    code: string;
+    name: string;
+    clientName: string;
+    contractCategory?: 'employee' | 'contractor' | 'client' | 'supplier' | 'vendor' | 'partner' | 'internal' | 'other';
+    contractType?: 'clt' | 'pj' | 'freelancer_agreement' | 'service_agreement' | 'fixed_term' | 'recurring_service' | 'nda' | 'amendment' | 'addendum' | 'other';
+    billingModel?: 'time_and_material' | 'monthly_retainer' | 'fixed_price';
+    signatureStatus?: 'not_started' | 'pending' | 'partially_signed' | 'signed' | 'expired';
+    isActive?: boolean;
+    accountManagerCollaboratorId?: number | null;
+    relatedCollaboratorId?: number | null;
+    originType?: 'manual' | 'employee_hiring' | 'client_project';
+    originId?: number | null;
+    startDate: string;
+    endDate?: string | null;
+    signedAt?: string | null;
+    effectiveDate?: string | null;
+    budgetAmount?: number | null;
+    monthlyHourCap?: number | null;
+    status?: 'draft' | 'under_review' | 'active' | 'renewal' | 'expired' | 'closed' | 'archived';
+    description?: string | null;
+    contentHtml?: string | null;
+    parties?: Array<{
+        partyRole?: 'employee' | 'employer' | 'client' | 'supplier' | 'vendor' | 'partner' | 'witness' | 'internal_owner' | 'other';
+        partyType?: 'individual' | 'company' | 'internal_team' | 'other';
+        displayName: string;
+        documentNumber?: string | null;
+        email?: string | null;
+        phone?: string | null;
+        isPrimary?: boolean;
+    }>;
+    signatures?: Array<{
+        signerName: string;
+        signerRole?: string | null;
+        signerEmail?: string | null;
+        status?: 'pending' | 'signed' | 'rejected';
+        signedAt?: string | null;
+    }>;
+    financialTerms?: Array<{
+        termType?: 'value' | 'payment' | 'revenue' | 'fine' | 'other';
+        label: string;
+        amount: number;
+        recurrence?: 'one_time' | 'monthly' | 'quarterly' | 'yearly' | 'other';
+        dueDay?: number | null;
+        notes?: string | null;
+    }>;
+    revisions?: Array<{
+        revisionType?: 'amendment' | 'renewal' | 'revision' | 'addendum' | 'other';
+        title: string;
+        effectiveDate?: string | null;
+        status?: 'draft' | 'active' | 'completed' | 'cancelled';
+        summary?: string | null;
+    }>;
+    replaceUploadedPdfDocument?: {
+        fileName: string;
+        mimeType: string;
+        fileContentBase64: string;
+        notes?: string | null;
+    } | null;
+};
+type ProjectPayload = {
+    contractId?: number | null;
+    managerCollaboratorId?: number | null;
+    code: string;
+    name: string;
+    clientName?: string | null;
+    summary?: string | null;
+    status?: 'planning' | 'active' | 'at_risk' | 'paused' | 'completed' | 'archived';
+    progressPercent?: number | null;
+    deliveryModel?: 'dedicated_team' | 'shared_team' | 'project_delivery' | 'support';
+    budgetAmount?: number | null;
+    startDate?: string | null;
+    endDate?: string | null;
+    billingModel?: 'time_and_material' | 'monthly_retainer' | 'fixed_price';
+    monthlyHourCap?: number | null;
+    contractCode?: string | null;
+    contractName?: string | null;
+    contractDescription?: string | null;
+    autoGenerateContractDraft?: boolean;
+    teamAssignments?: Array<{
+        collaboratorId: number;
+        roleLabel?: string | null;
+        allocationPercent?: number | null;
+        weeklyHours?: number | null;
+        isBillable?: boolean;
+        startDate?: string | null;
+        endDate?: string | null;
+        status?: 'planned' | 'active' | 'completed' | 'cancelled';
+    }>;
+};
+type TimesheetEntryPayload = {
+    projectAssignmentId?: number | null;
+    activityLabel?: string | null;
+    workDate: string;
+    hours: number;
+    description?: string | null;
+};
+type TimesheetPayload = {
+    collaboratorId?: number | null;
+    weekStartDate: string;
+    weekEndDate: string;
+    notes?: string | null;
+    entries?: TimesheetEntryPayload[];
+};
+type TimeOffPayload = {
+    collaboratorId?: number | null;
+    requestType?: 'vacation' | 'personal_time' | 'sick_leave' | 'unpaid_leave' | 'other';
+    startDate: string;
+    endDate: string;
+    totalDays?: number | null;
+    reason?: string | null;
+};
+type ScheduleAdjustmentDayPayload = {
+    weekday: 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+    isWorkingDay?: boolean;
+    startTime?: string | null;
+    endTime?: string | null;
+    breakMinutes?: number | null;
+};
+type ScheduleAdjustmentPayload = {
+    collaboratorId?: number | null;
+    requestScope?: 'temporary' | 'permanent';
+    effectiveStartDate: string;
+    effectiveEndDate?: string | null;
+    reason?: string | null;
+    days: ScheduleAdjustmentDayPayload[];
+};
+type DecisionPayload = {
+    note?: string | null;
+};
+type PublishAccountsPayableReferencePayload = {
+    sourceEntityId: string;
+    sourceEntityType?: string;
+    personId: number;
+    dueDate: string;
+    totalAmount: number;
+    documentNumber: string;
+    description?: string | null;
+    paymentChannel?: string | null;
+    financeCategoryId?: number | null;
+    costCenterId?: number | null;
+    locale?: string;
+};
 export declare class OperationsService {
-    getDashboard(): {
-        module: string;
-        operationalCollections: {
-            contracts: {
-                id: number;
-                code: string;
-                name: string;
-                status: string;
-            }[];
-            projects: {
-                id: number;
-                code: string;
-                name: string;
-                status: string;
-            }[];
-            allocations: {
-                id: number;
-                employeeId: number;
-                projectId: number;
-                weeklyHours: number;
-                allocationPercent: number;
-            }[];
-            tasks: {
-                id: number;
-                title: string;
-                status: string;
-            }[];
-            timesheets: {
-                id: number;
-                employeeId: number;
-                status: string;
-                cycleStartDate: string;
-            }[];
-            approvals: {
-                id: number;
-                employeeId: number;
-                status: string;
-                hours: number;
-            }[];
-        };
-        growthCollections: {
-            growth: {
-                topSignals: string[];
-                note: string;
-            };
-            evaluations: {
-                id: number;
-                employeeId: number;
-                cycle: string;
-                status: string;
-                generatedScore: number;
-            }[];
-            goals: {
-                id: number;
-                employeeId: number;
-                title: string;
-                status: string;
-                progressPercent: number;
-            }[];
-            certifications: {
-                id: number;
-                slug: string;
-                status: string;
-            }[];
-            rewards: {
-                id: number;
-                employeeId: number;
-                rewardType: string;
-                status: string;
-            }[];
-            career: {
-                id: number;
-                track: string;
-                currentLevel: string;
-                nextLevel: string;
-            }[];
-            manager: {
-                summary: {
-                    promotionEligible: number;
-                    goalsAtRisk: number;
-                    pendingCertifications: number;
-                };
-            };
-        };
-    };
-    listContracts(): {
+    private readonly prisma;
+    private readonly integrationApi;
+    constructor(prisma: PrismaService, integrationApi: IntegrationDeveloperApiService);
+    getDashboard(userId: number): Promise<{
+        actor: {
+            roleScope: string;
+            collaboratorId: number;
+            collaboratorName: string;
+            teamSize: number;
+        };
+        cards: {
+            projectsTotal: number;
+            activeProjects: number;
+            visibleTimesheets: number;
+            pendingTimesheets: number;
+            timeOffRequests: number;
+            scheduleAdjustmentRequests: number;
+            pendingApprovals: number;
+        };
+        recentTimesheets: {
+            id: number;
+            collaboratorName: string;
+            weekStartDate: string;
+            weekEndDate: string;
+            totalHours: number | null;
+            status: string;
+        }[];
+    }>;
+    listCollaborators(userId: number): Promise<Record<string, unknown>[]>;
+    getMyCollaborator(userId: number): Promise<{
+        assignedProjects: Record<string, unknown>[];
+        relatedContracts: Record<string, unknown>[];
+        weeklySchedule: Record<string, unknown>[];
+        timesheetSummary: {
+            totalTimesheets: number;
+            pendingTimesheets: number;
+            totalHours: number;
+        };
+        timeOffSummary: {
+            totalRequests: number;
+            pendingRequests: number;
+            approvedRequests: number;
+        };
+        scheduleAdjustmentRequests: Record<string, unknown>[];
         id: number;
+        userId: number;
         code: string;
-        name: string;
+        collaboratorType: string;
+        displayName: string;
+        department: string | null;
+        title: string | null;
+        levelLabel: string | null;
+        weeklyCapacityHours: number | null;
         status: string;
-    }[];
-    getContractById(id: number): {
+        joinedAt: string | null;
+        leftAt: string | null;
+        notes: string | null;
+        supervisorId: number | null;
+        supervisorName: string | null;
+        contractId: number | null;
+        contractStatus: string | null;
+        activeAssignments: number;
+    }>;
+    getCollaboratorByIdForUser(userId: number, collaboratorId: number): Promise<{
+        assignedProjects: Record<string, unknown>[];
+        relatedContracts: Record<string, unknown>[];
+        weeklySchedule: Record<string, unknown>[];
+        timesheetSummary: {
+            totalTimesheets: number;
+            pendingTimesheets: number;
+            totalHours: number;
+        };
+        timeOffSummary: {
+            totalRequests: number;
+            pendingRequests: number;
+            approvedRequests: number;
+        };
+        scheduleAdjustmentRequests: Record<string, unknown>[];
         id: number;
+        userId: number;
         code: string;
-        name: string;
+        collaboratorType: string;
+        displayName: string;
+        department: string | null;
+        title: string | null;
+        levelLabel: string | null;
+        weeklyCapacityHours: number | null;
         status: string;
-    };
-    listProjects(): {
+        joinedAt: string | null;
+        leftAt: string | null;
+        notes: string | null;
+        supervisorId: number | null;
+        supervisorName: string | null;
+        contractId: number | null;
+        contractStatus: string | null;
+        activeAssignments: number;
+    }>;
+    getTeam(userId: number): Promise<{
+        teamMembers: Record<string, unknown>[];
+        projectCount: number;
+        pendingApprovals: number;
+        pendingItems: {
+            timesheets: number;
+            timeOffRequests: number;
+            scheduleAdjustmentRequests: number;
+        };
+        teamProjects: Record<string, unknown>[];
+        pendingApprovalQueue: Record<string, unknown>[];
+        pendingTimeOffRequests: Record<string, unknown>[];
+        pendingScheduleAdjustmentRequests: Record<string, unknown>[];
+    }>;
+    createCollaborator(userId: number, data: CollaboratorPayload): Promise<{
+        assignedProjects: Record<string, unknown>[];
+        relatedContracts: Record<string, unknown>[];
+        weeklySchedule: Record<string, unknown>[];
+        timesheetSummary: {
+            totalTimesheets: number;
+            pendingTimesheets: number;
+            totalHours: number;
+        };
+        timeOffSummary: {
+            totalRequests: number;
+            pendingRequests: number;
+            approvedRequests: number;
+        };
+        scheduleAdjustmentRequests: Record<string, unknown>[];
         id: number;
+        userId: number;
         code: string;
-        name: string;
+        collaboratorType: string;
+        displayName: string;
+        department: string | null;
+        title: string | null;
+        levelLabel: string | null;
+        weeklyCapacityHours: number | null;
         status: string;
-    }[];
-    getProjectById(id: number): {
+        joinedAt: string | null;
+        leftAt: string | null;
+        notes: string | null;
+        supervisorId: number | null;
+        supervisorName: string | null;
+        contractId: number | null;
+        contractStatus: string | null;
+        activeAssignments: number;
+    }>;
+    updateCollaborator(userId: number, collaboratorId: number, data: Partial<CollaboratorPayload>): Promise<{
+        assignedProjects: Record<string, unknown>[];
+        relatedContracts: Record<string, unknown>[];
+        weeklySchedule: Record<string, unknown>[];
+        timesheetSummary: {
+            totalTimesheets: number;
+            pendingTimesheets: number;
+            totalHours: number;
+        };
+        timeOffSummary: {
+            totalRequests: number;
+            pendingRequests: number;
+            approvedRequests: number;
+        };
+        scheduleAdjustmentRequests: Record<string, unknown>[];
         id: number;
+        userId: number;
         code: string;
-        name: string;
-        status: string;
-    };
-    listAllocations(): {
-        id: number;
-        employeeId: number;
-        projectId: number;
-        weeklyHours: number;
-        allocationPercent: number;
-    }[];
-    listTasks(): {
-        id: number;
-        title: string;
+        collaboratorType: string;
+        displayName: string;
+        department: string | null;
+        title: string | null;
+        levelLabel: string | null;
+        weeklyCapacityHours: number | null;
         status: string;
-    }[];
-    listTimesheets(): {
-        id: number;
-        employeeId: number;
-        status: string;
-        cycleStartDate: string;
-    }[];
-    listApprovals(): {
+        joinedAt: string | null;
+        leftAt: string | null;
+        notes: string | null;
+        supervisorId: number | null;
+        supervisorName: string | null;
+        contractId: number | null;
+        contractStatus: string | null;
+        activeAssignments: number;
+    }>;
+    listProjects(userId: number): Promise<Record<string, unknown>[]>;
+    getProjectById(userId: number, projectId: number): Promise<{
+        assignments: {
+            id: number;
+            collaboratorId: number;
+            collaboratorName: string;
+            roleLabel: string | null;
+            allocationPercent: number | null;
+            weeklyHours: number | null;
+            isBillable: boolean;
+            startDate: string | null;
+            endDate: string | null;
+            status: string;
+        }[];
+        relatedContract: any;
+        timesheetSummary: {
+            totalTimesheets: number;
+            pendingTimesheets: number;
+            totalHours: number;
+        };
+        operationalIndicators: {
+            activeAssignments: number;
+            billableAssignments: number;
+            averageAllocation: number;
+            totalWeeklyHours: number;
+        };
         id: number;
-        employeeId: number;
+        contractId: number | null;
+        managerCollaboratorId: number | null;
+        code: string;
+        name: string;
+        clientName: string | null;
+        summary: string | null;
         status: string;
-        hours: number;
-    }[];
-    getGrowthDashboard(): {
-        topSignals: string[];
-        note: string;
-    };
-    listEvaluations(): {
+        progressPercent: number | null;
+        deliveryModel: string | null;
+        budgetAmount: number | null;
+        startDate: string | null;
+        endDate: string | null;
+        contractName: string | null;
+        contractStatus: string | null;
+        contractCategory: string | null;
+        managerName: string | null;
+        myAssignmentId: number | null;
+        myRoleLabel: string | null;
+        teamSize: number;
+    }>;
+    createProject(userId: number, data: ProjectPayload): Promise<{
+        assignments: {
+            id: number;
+            collaboratorId: number;
+            collaboratorName: string;
+            roleLabel: string | null;
+            allocationPercent: number | null;
+            weeklyHours: number | null;
+            isBillable: boolean;
+            startDate: string | null;
+            endDate: string | null;
+            status: string;
+        }[];
+        relatedContract: any;
+        timesheetSummary: {
+            totalTimesheets: number;
+            pendingTimesheets: number;
+            totalHours: number;
+        };
+        operationalIndicators: {
+            activeAssignments: number;
+            billableAssignments: number;
+            averageAllocation: number;
+            totalWeeklyHours: number;
+        };
         id: number;
-        employeeId: number;
-        cycle: string;
+        contractId: number | null;
+        managerCollaboratorId: number | null;
+        code: string;
+        name: string;
+        clientName: string | null;
+        summary: string | null;
         status: string;
-        generatedScore: number;
-    }[];
-    listGoals(): {
+        progressPercent: number | null;
+        deliveryModel: string | null;
+        budgetAmount: number | null;
+        startDate: string | null;
+        endDate: string | null;
+        contractName: string | null;
+        contractStatus: string | null;
+        contractCategory: string | null;
+        managerName: string | null;
+        myAssignmentId: number | null;
+        myRoleLabel: string | null;
+        teamSize: number;
+    }>;
+    updateProject(userId: number, projectId: number, data: Partial<ProjectPayload>): Promise<{
+        assignments: {
+            id: number;
+            collaboratorId: number;
+            collaboratorName: string;
+            roleLabel: string | null;
+            allocationPercent: number | null;
+            weeklyHours: number | null;
+            isBillable: boolean;
+            startDate: string | null;
+            endDate: string | null;
+            status: string;
+        }[];
+        relatedContract: any;
+        timesheetSummary: {
+            totalTimesheets: number;
+            pendingTimesheets: number;
+            totalHours: number;
+        };
+        operationalIndicators: {
+            activeAssignments: number;
+            billableAssignments: number;
+            averageAllocation: number;
+            totalWeeklyHours: number;
+        };
         id: number;
-        employeeId: number;
-        title: string;
+        contractId: number | null;
+        managerCollaboratorId: number | null;
+        code: string;
+        name: string;
+        clientName: string | null;
+        summary: string | null;
         status: string;
-        progressPercent: number;
-    }[];
-    listCertifications(): {
+        progressPercent: number | null;
+        deliveryModel: string | null;
+        budgetAmount: number | null;
+        startDate: string | null;
+        endDate: string | null;
+        contractName: string | null;
+        contractStatus: string | null;
+        contractCategory: string | null;
+        managerName: string | null;
+        myAssignmentId: number | null;
+        myRoleLabel: string | null;
+        teamSize: number;
+    }>;
+    listContracts(userId: number): Promise<Record<string, unknown>[]>;
+    getContractById(userId: number, contractId: number): Promise<{
+        mainRelatedPartyName: unknown;
+        projects: Record<string, unknown>[];
+        scheduleSummary: any[];
+        parties: Record<string, unknown>[];
+        signatures: Record<string, unknown>[];
+        financialTerms: Record<string, unknown>[];
+        documents: Record<string, unknown>[];
+        revisions: Record<string, unknown>[];
+        history: Record<string, unknown>[];
+    }>;
+    createContract(userId: number, data: ContractPayload): Promise<{
+        mainRelatedPartyName: unknown;
+        projects: Record<string, unknown>[];
+        scheduleSummary: any[];
+        parties: Record<string, unknown>[];
+        signatures: Record<string, unknown>[];
+        financialTerms: Record<string, unknown>[];
+        documents: Record<string, unknown>[];
+        revisions: Record<string, unknown>[];
+        history: Record<string, unknown>[];
+    }>;
+    updateContract(userId: number, contractId: number, data: Partial<ContractPayload>): Promise<{
+        mainRelatedPartyName: unknown;
+        projects: Record<string, unknown>[];
+        scheduleSummary: any[];
+        parties: Record<string, unknown>[];
+        signatures: Record<string, unknown>[];
+        financialTerms: Record<string, unknown>[];
+        documents: Record<string, unknown>[];
+        revisions: Record<string, unknown>[];
+        history: Record<string, unknown>[];
+    }>;
+    listTimesheets(userId: number): Promise<{
         id: number;
-        slug: string;
+        collaboratorId: number;
+        collaboratorName: string;
+        approverCollaboratorId: number | null;
+        approverName: string | null;
+        weekStartDate: string;
+        weekEndDate: string;
+        totalHours: number | null;
         status: string;
-    }[];
-    listRewards(): {
+        submittedAt: string | null;
+        reviewedAt: string | null;
+        notes: string | null;
+        decisionNote: string | null;
+    }[]>;
+    createTimesheet(userId: number, data: TimesheetPayload): Promise<any>;
+    updateTimesheet(userId: number, timesheetId: number, data: Partial<TimesheetPayload>): Promise<any>;
+    submitTimesheet(userId: number, timesheetId: number): Promise<any>;
+    listTimeOffRequests(userId: number): Promise<Record<string, unknown>[]>;
+    createTimeOffRequest(userId: number, data: TimeOffPayload): Promise<Record<string, unknown>>;
+    listScheduleAdjustments(userId: number): Promise<{
         id: number;
-        employeeId: number;
-        rewardType: string;
+        collaboratorId: number;
+        collaboratorName: string;
+        approverCollaboratorId: number | null;
+        approverName: string | null;
+        requestScope: string;
+        effectiveStartDate: string;
+        effectiveEndDate: string | null;
         status: string;
-    }[];
-    listCareerPaths(): {
-        id: number;
-        track: string;
-        currentLevel: string;
-        nextLevel: string;
-    }[];
-    getManagerOverview(): {
-        summary: {
-            promotionEligible: number;
-            goalsAtRisk: number;
-            pendingCertifications: number;
-        };
-    };
+        reason: string | null;
+        submittedAt: string | null;
+        reviewedAt: string | null;
+        approverNote: string | null;
+    }[]>;
+    createScheduleAdjustmentRequest(userId: number, data: ScheduleAdjustmentPayload): Promise<Record<string, unknown>>;
+    listApprovals(userId: number): Promise<Record<string, unknown>[]>;
+    approve(userId: number, approvalId: number, data: DecisionPayload): Promise<Record<string, unknown>>;
+    reject(userId: number, approvalId: number, data: DecisionPayload): Promise<Record<string, unknown>>;
+    publishAccountsPayableReference(userId: number, data: PublishAccountsPayableReferencePayload): Promise<{
+        queued: boolean;
+        eventId: string;
+        eventName: string;
+        sourceEntityType: string;
+        sourceEntityId: string;
+    }>;
+    private decideApproval;
+    private getActorContext;
+    private getCollaboratorByUserId;
+    private getCollaboratorById;
+    private getProjectDetails;
+    private getCollaboratorDetails;
+    private getDirectReportIds;
+    private getAssignedProjectIds;
+    private getTimesheetById;
+    private replaceTimesheetEntries;
+    private refreshTimesheetTotal;
+    private upsertApproval;
+    private insertApprovalHistory;
+    private assertProjectAccess;
+    private ensureCollaboratorAccess;
+    private listSingleTimesheet;
+    private ensureDirector;
+    private ensureSupervisor;
+    private ensureCollaborator;
+    private defaultWeeklySchedule;
+    private replaceCollaboratorScheduleDays;
+    private replaceProjectAssignments;
+    private mapContractCategoryForCollaboratorType;
+    private mapBillingModelForCollaboratorType;
+    private mapContractTypeForCollaboratorType;
+    private createHiringContractDraft;
+    private createProjectContractDraft;
+    private replaceContractParties;
+    private replaceContractSignatures;
+    private replaceContractFinancialTerms;
+    private replaceContractRevisions;
+    private replaceContractPdfDocument;
+    private insertContractHistory;
+    private requireFields;
+    private buildIdFilter;
+    private uniqueNumbers;
+    private pushUpdate;
+    private param;
+    private groupBy;
+    private queryRows;
+    private querySingle;
+    private execute;
 }
+export {};
 //# sourceMappingURL=operations.service.d.ts.map