@hed-hog/operations 0.0.303 → 0.0.305

package/dist/operations.service.d.ts

@@ -1,5 +1,7 @@
+import { LocaleService } from '@hed-hog/api-locale';
 import { PrismaService } from '@hed-hog/api-prisma';
 import { AiService, FileService, IntegrationDeveloperApiService, SettingService } from '@hed-hog/core';
+import { OperationsAccessService } from './services/shared/operations-access.service';
 declare const CONTRACT_CATEGORY_VALUES: readonly ["employee", "contractor", "client", "supplier", "vendor", "partner", "internal", "other"];
 declare const CONTRACT_TYPE_VALUES: readonly ["clt", "pj", "freelancer_agreement", "service_agreement", "fixed_term", "recurring_service", "nda", "amendment", "addendum", "other"];
 declare const BILLING_MODEL_VALUES: readonly ["time_and_material", "monthly_retainer", "fixed_price"];
@@ -9,19 +11,23 @@ declare const CONTRACT_CREATION_MODE_VALUES: readonly ["blank", "template", "upl
 declare const ORIGIN_TYPE_VALUES: readonly ["manual", "employee_hiring", "client_project", "crm_proposal"];
 declare const CONTRACT_DOCUMENT_TYPE_VALUES: readonly ["source_upload", "generated_pdf", "attachment", "other"];
 declare const CONTRACT_DOCUMENT_EXTRACTION_STATUS_VALUES: readonly ["pending", "processing", "completed", "failed", "skipped"];
+declare const TASK_STATUS_VALUES: readonly ["todo", "doing", "review", "done"];
 type CollaboratorPayload = {
     userId?: number | null;
     personId?: number | null;
     code?: string | null;
     displayName?: string | null;
-    collaboratorType?: 'clt' | 'pj' | 'freelancer' | 'intern' | 'other';
+    collaboratorTypeId?: number | null;
+    collaboratorTypeSlug?: string | null;
+    collaboratorType?: string | null;
     department?: string | null;
     departmentId?: number | null;
+    jobTitleId?: number | null;
     title?: string | null;
     levelLabel?: string | null;
     supervisorCollaboratorId?: number | null;
     weeklyCapacityHours?: number | null;
-    status?: 'active' | 'on_leave' | 'inactive';
+    status?: 'draft' | 'active' | 'on_leave' | 'inactive';
     joinedAt?: string | null;
     leftAt?: string | null;
     compensationAmount?: number | null;
@@ -34,6 +40,14 @@ type CollaboratorPayload = {
         endTime?: string | null;
         breakMinutes?: number | null;
     }>;
+    equityParticipation?: {
+        participationType?: 'partner_quota_holder' | 'common_shareholder' | 'preferred_shareholder' | 'administrator' | 'other';
+        percentage?: number | null;
+        votingPower?: number | null;
+        startDate?: string | null;
+        endDate?: string | null;
+        notes?: string | null;
+    } | null;
     notes?: string | null;
 };
 type DepartmentPayload = {
@@ -42,6 +56,23 @@ type DepartmentPayload = {
     description?: string | null;
     status?: 'active' | 'inactive';
 };
+type JobTitlePayload = DepartmentPayload;
+type CollaboratorTypePayload = {
+    name?: string | null;
+    slug?: string | null;
+    description?: string | null;
+    category?: string | null;
+    isActive?: boolean;
+    sortOrder?: number | null;
+    status?: 'active' | 'inactive';
+};
+type ProjectRolePayload = {
+    code?: string | null;
+    name?: string | null;
+    description?: string | null;
+    isActive?: boolean;
+    sortOrder?: number | null;
+};
 type ContractPayload = {
     code?: string | null;
     name?: string | null;
@@ -300,6 +331,7 @@ type ProjectPayload = {
     contractId?: number | null;
     contractTemplateId?: number | null;
     managerCollaboratorId?: number | null;
+    clientPersonId?: number | null;
     code: string;
     name: string;
     clientName?: string | null;
@@ -318,6 +350,7 @@ type ProjectPayload = {
     autoGenerateContractDraft?: boolean;
     teamAssignments?: Array<{
         collaboratorId: number;
+        projectRoleId?: number | null;
         roleLabel?: string | null;
         allocationPercent?: number | null;
         weeklyHours?: number | null;
@@ -329,9 +362,38 @@ type ProjectPayload = {
 };
 type TimesheetEntryPayload = {
     projectAssignmentId?: number | null;
+    taskId?: number | null;
+    taskName?: string | null;
     activityLabel?: string | null;
     workDate: string;
-    hours: number;
+    hours?: number | null;
+    duration?: number | null;
+    durationMinutes?: number | null;
+    unit?: 'hours' | 'minutes';
+    description?: string | null;
+};
+type TaskPayload = {
+    projectId?: number | null;
+    projectAssignmentId?: number | null;
+    assigneeCollaboratorId?: number | null;
+    name?: string | null;
+    description?: string | null;
+    priority?: 'low' | 'medium' | 'high';
+    status?: (typeof TASK_STATUS_VALUES)[number];
+    dueDate?: string | null;
+    estimateHours?: number | null;
+    position?: number;
+    tags?: string | null;
+};
+type QuickTimesheetEntryPayload = {
+    projectId?: number | null;
+    projectAssignmentId?: number | null;
+    taskId?: number | null;
+    taskName?: string | null;
+    activityLabel?: string | null;
+    workDate: string;
+    duration: number;
+    unit?: 'hours' | 'minutes';
     description?: string | null;
 };
 type TimesheetPayload = {
@@ -386,8 +448,78 @@ export declare class OperationsService {
     private readonly integrationApi;
     private readonly fileService;
     private readonly settingService;
+    private readonly accessService;
+    private readonly localeService?;
     private readonly logger;
-    constructor(prisma: PrismaService, aiService: AiService, integrationApi: IntegrationDeveloperApiService, fileService: FileService, settingService: SettingService);
+    constructor(prisma: PrismaService, aiService: AiService, integrationApi: IntegrationDeveloperApiService, fileService: FileService, settingService: SettingService, accessService: OperationsAccessService, localeService?: LocaleService);
+    private normalizeLocaleCode;
+    private resolvePreferredLocaleId;
+    listCollaboratorTypes(userId: number, filters?: {
+        active?: boolean;
+    }): Promise<{
+        id: number;
+        slug: string;
+        name: string;
+        description: string | null;
+        category: string | null;
+        isActive: boolean;
+        sortOrder: number;
+        status: "active" | "inactive";
+        collaboratorCount: number;
+        createdAt: string;
+        updatedAt: string;
+    }[]>;
+    createCollaboratorType(userId: number, data: CollaboratorTypePayload): Promise<{
+        id: number;
+        slug: string;
+        name: string;
+        description: string | null;
+        category: string | null;
+        isActive: boolean;
+        sortOrder: number;
+        status: "active" | "inactive";
+        collaboratorCount: number;
+        createdAt: string | null;
+        updatedAt: string | null;
+        deletedAt: string | null;
+    }>;
+    updateCollaboratorType(userId: number, collaboratorTypeId: number, data: Partial<CollaboratorTypePayload>): Promise<{
+        id: number;
+        slug: string;
+        name: string;
+        description: string | null;
+        category: string | null;
+        isActive: boolean;
+        sortOrder: number;
+        status: "active" | "inactive";
+        collaboratorCount: number;
+        createdAt: string | null;
+        updatedAt: string | null;
+        deletedAt: string | null;
+    }>;
+    listProjectRoles(userId: number): Promise<{
+        id: number;
+        slug: string;
+        code: string | null;
+        name: string;
+        description: string | null;
+        isActive: boolean;
+        sortOrder: number;
+        createdAt: string;
+        updatedAt: string;
+    }[]>;
+    createProjectRole(userId: number, data: ProjectRolePayload): Promise<{
+        id: number;
+        slug: string;
+        code: string | null;
+        name: string;
+        description: string | null;
+        isActive: boolean;
+        sortOrder: number;
+        createdAt: string | null;
+        updatedAt: string | null;
+        deletedAt: string | null;
+    }>;
     getDashboard(userId: number): Promise<{
         actor: {
             roleScope: string;
@@ -418,6 +550,14 @@ export declare class OperationsService {
         assignedProjects: Record<string, unknown>[];
         relatedContracts: Record<string, unknown>[];
         weeklySchedule: Record<string, unknown>[];
+        equityParticipation: {
+            participationType: string;
+            percentage: number | null;
+            votingPower: number | null;
+            startDate: string | null;
+            endDate: string | null;
+            notes: string | null;
+        };
         timesheetSummary: {
             totalTimesheets: number;
             pendingTimesheets: number;
@@ -435,10 +575,13 @@ export declare class OperationsService {
         personName: string | null;
         personAvatarId: number | null;
         code: string;
-        collaboratorType: string;
+        collaboratorTypeId: number | null;
+        collaboratorTypeSlug: string | null;
+        collaboratorType: string | null;
         displayName: string;
         departmentId: number | null;
         department: string | null;
+        jobTitleId: number | null;
         title: string | null;
         levelLabel: string | null;
         weeklyCapacityHours: number | null;
@@ -450,12 +593,21 @@ export declare class OperationsService {
         supervisorName: string | null;
         contractId: number | null;
         contractStatus: string | null;
+        compensationAmount: number | null;
         activeAssignments: number;
     }>;
     getCollaboratorByIdForUser(userId: number, collaboratorId: number): Promise<{
         assignedProjects: Record<string, unknown>[];
         relatedContracts: Record<string, unknown>[];
         weeklySchedule: Record<string, unknown>[];
+        equityParticipation: {
+            participationType: string;
+            percentage: number | null;
+            votingPower: number | null;
+            startDate: string | null;
+            endDate: string | null;
+            notes: string | null;
+        };
         timesheetSummary: {
             totalTimesheets: number;
             pendingTimesheets: number;
@@ -473,10 +625,13 @@ export declare class OperationsService {
         personName: string | null;
         personAvatarId: number | null;
         code: string;
-        collaboratorType: string;
+        collaboratorTypeId: number | null;
+        collaboratorTypeSlug: string | null;
+        collaboratorType: string | null;
         displayName: string;
         departmentId: number | null;
         department: string | null;
+        jobTitleId: number | null;
         title: string | null;
         levelLabel: string | null;
         weeklyCapacityHours: number | null;
@@ -488,6 +643,7 @@ export declare class OperationsService {
         supervisorName: string | null;
         contractId: number | null;
         contractStatus: string | null;
+        compensationAmount: number | null;
         activeAssignments: number;
     }>;
     getTeam(userId: number): Promise<{
@@ -508,6 +664,14 @@ export declare class OperationsService {
         assignedProjects: Record<string, unknown>[];
         relatedContracts: Record<string, unknown>[];
         weeklySchedule: Record<string, unknown>[];
+        equityParticipation: {
+            participationType: string;
+            percentage: number | null;
+            votingPower: number | null;
+            startDate: string | null;
+            endDate: string | null;
+            notes: string | null;
+        };
         timesheetSummary: {
             totalTimesheets: number;
             pendingTimesheets: number;
@@ -525,10 +689,13 @@ export declare class OperationsService {
         personName: string | null;
         personAvatarId: number | null;
         code: string;
-        collaboratorType: string;
+        collaboratorTypeId: number | null;
+        collaboratorTypeSlug: string | null;
+        collaboratorType: string | null;
         displayName: string;
         departmentId: number | null;
         department: string | null;
+        jobTitleId: number | null;
         title: string | null;
         levelLabel: string | null;
         weeklyCapacityHours: number | null;
@@ -540,12 +707,21 @@ export declare class OperationsService {
         supervisorName: string | null;
         contractId: number | null;
         contractStatus: string | null;
+        compensationAmount: number | null;
         activeAssignments: number;
     }>;
     updateCollaborator(userId: number, collaboratorId: number, data: Partial<CollaboratorPayload>): Promise<{
         assignedProjects: Record<string, unknown>[];
         relatedContracts: Record<string, unknown>[];
         weeklySchedule: Record<string, unknown>[];
+        equityParticipation: {
+            participationType: string;
+            percentage: number | null;
+            votingPower: number | null;
+            startDate: string | null;
+            endDate: string | null;
+            notes: string | null;
+        };
         timesheetSummary: {
             totalTimesheets: number;
             pendingTimesheets: number;
@@ -563,10 +739,13 @@ export declare class OperationsService {
         personName: string | null;
         personAvatarId: number | null;
         code: string;
-        collaboratorType: string;
+        collaboratorTypeId: number | null;
+        collaboratorTypeSlug: string | null;
+        collaboratorType: string | null;
         displayName: string;
         departmentId: number | null;
         department: string | null;
+        jobTitleId: number | null;
         title: string | null;
         levelLabel: string | null;
         weeklyCapacityHours: number | null;
@@ -578,9 +757,22 @@ export declare class OperationsService {
         supervisorName: string | null;
         contractId: number | null;
         contractStatus: string | null;
+        compensationAmount: number | null;
         activeAssignments: number;
     }>;
     listDepartments(userId: number): Promise<Record<string, unknown>[]>;
+    listJobTitles(userId: number): Promise<Record<string, unknown>[]>;
+    createJobTitle(userId: number, data: JobTitlePayload): Promise<{
+        id: number;
+        slug: string;
+        code: string | null;
+        name: string;
+        description: string | null;
+        createdAt: string | null;
+        updatedAt: string | null;
+        deletedAt: string | null;
+        status: "active" | "inactive";
+    }>;
     createDepartment(userId: number, data: DepartmentPayload): Promise<{
         id: number;
         slug: string;
@@ -604,11 +796,174 @@ export declare class OperationsService {
         status: "active" | "inactive";
     }>;
     listProjects(userId: number): Promise<Record<string, unknown>[]>;
+    listProjectOptions(userId: number, paginationParams: {
+        page?: number;
+        pageSize?: number;
+        search?: string;
+        sortField?: string;
+        sortOrder?: string;
+    }): Promise<{
+        total: number;
+        lastPage: number;
+        page: number;
+        pageSize: number;
+        prev: number;
+        next: number;
+        data: {
+            label: string;
+            id: number;
+            code: string | null;
+            name: string;
+            clientName: string | null;
+            projectAssignmentId: number | null;
+            roleLabel: string | null;
+            status: string;
+            startDate: string | null;
+            endDate: string | null;
+        }[];
+    }>;
+    listTasks(userId: number, paginationParams: {
+        page?: number;
+        pageSize?: number;
+        search?: string;
+        sortField?: string;
+        sortOrder?: string;
+        projectId?: number;
+        projectAssignmentId?: number;
+        status?: string;
+    }): Promise<{
+        total: number;
+        lastPage: number;
+        page: number;
+        pageSize: number;
+        prev: number;
+        next: number;
+        data: {
+            label: string;
+            id: number;
+            name: string;
+            description: string | null;
+            status: string;
+            projectId: number;
+            projectAssignmentId: number;
+            projectName: string;
+            projectCode: string | null;
+            createdAt: string;
+        }[];
+    }>;
+    createTask(userId: number, data: TaskPayload): Promise<{
+        id: number;
+        name: string;
+        description: string | null;
+        priority: string;
+        status: string;
+        dueDate: string | null;
+        estimateHours: number | null;
+        position: number;
+        tags: string | null;
+        assigneeCollaboratorId: number | null;
+        assigneeName: string | null;
+        assigneeUserPhotoId: number | null;
+        assigneePersonAvatarId: number | null;
+        projectAssignmentId: number | null;
+        projectId: number | null;
+        createdAt: string;
+    }>;
+    updateTask(userId: number, taskId: number, data: Partial<TaskPayload>): Promise<{
+        id: number;
+        name: string;
+        description: string | null;
+        priority: string;
+        status: string;
+        dueDate: string | null;
+        estimateHours: number | null;
+        position: number;
+        tags: string | null;
+        assigneeCollaboratorId: number | null;
+        assigneeName: string | null;
+        assigneeUserPhotoId: number | null;
+        assigneePersonAvatarId: number | null;
+        projectAssignmentId: number | null;
+        projectId: number | null;
+        createdAt: string;
+    }>;
+    removeTask(userId: number, taskId: number): Promise<{
+        success: boolean;
+    }>;
+    listTimesheetEntries(userId: number, paginationParams: {
+        page?: number;
+        pageSize?: number;
+        search?: string;
+        sortField?: string;
+        sortOrder?: string;
+        projectId?: number;
+        projectAssignmentId?: number;
+        taskId?: number;
+        status?: string;
+        fromDate?: string;
+        toDate?: string;
+    }): Promise<{
+        total: number;
+        lastPage: number;
+        page: number;
+        pageSize: number;
+        prev: number;
+        next: number;
+        data: {
+            label: string;
+            id: number;
+            timesheetId: number;
+            collaboratorId: number;
+            projectId: number | null;
+            projectAssignmentId: number | null;
+            projectCode: string | null;
+            projectName: string | null;
+            taskId: number | null;
+            taskName: string | null;
+            activityLabel: string | null;
+            workDate: string;
+            durationMinutes: number | null;
+            hours: number | null;
+            description: string | null;
+            status: string;
+            weekStartDate: string;
+            weekEndDate: string;
+            createdAt: string;
+        }[];
+    }>;
+    createTimesheetEntry(userId: number, data: QuickTimesheetEntryPayload): Promise<{
+        label: string;
+        id: number;
+        timesheetId: number;
+        collaboratorId: number;
+        projectId: number | null;
+        projectAssignmentId: number | null;
+        projectCode: string | null;
+        projectName: string | null;
+        taskId: number | null;
+        taskName: string | null;
+        activityLabel: string | null;
+        workDate: string;
+        durationMinutes: number | null;
+        hours: number | null;
+        description: string | null;
+        status: string;
+        weekStartDate: string;
+        weekEndDate: string;
+        createdAt: string;
+    }>;
+    removeTimesheetEntry(userId: number, entryId: number): Promise<{
+        success: boolean;
+    }>;
     getProjectById(userId: number, projectId: number): Promise<{
         assignments: {
             id: number;
             collaboratorId: number;
+            userId: number | null;
+            personAvatarId: number | null;
+            userPhotoId: number | null;
             collaboratorName: string;
+            projectRoleId: number | null;
             roleLabel: string | null;
             allocationPercent: number | null;
             weeklyHours: number | null;
@@ -632,6 +987,8 @@ export declare class OperationsService {
         id: number;
         contractId: number | null;
         managerCollaboratorId: number | null;
+        clientPersonId: number | null;
+        clientAvatarId: number | null;
         code: string;
         name: string;
         clientName: string | null;
@@ -654,7 +1011,11 @@ export declare class OperationsService {
         assignments: {
             id: number;
             collaboratorId: number;
+            userId: number | null;
+            personAvatarId: number | null;
+            userPhotoId: number | null;
             collaboratorName: string;
+            projectRoleId: number | null;
             roleLabel: string | null;
             allocationPercent: number | null;
             weeklyHours: number | null;
@@ -678,6 +1039,8 @@ export declare class OperationsService {
         id: number;
         contractId: number | null;
         managerCollaboratorId: number | null;
+        clientPersonId: number | null;
+        clientAvatarId: number | null;
         code: string;
         name: string;
         clientName: string | null;
@@ -700,7 +1063,11 @@ export declare class OperationsService {
         assignments: {
             id: number;
             collaboratorId: number;
+            userId: number | null;
+            personAvatarId: number | null;
+            userPhotoId: number | null;
             collaboratorName: string;
+            projectRoleId: number | null;
             roleLabel: string | null;
             allocationPercent: number | null;
             weeklyHours: number | null;
@@ -724,6 +1091,8 @@ export declare class OperationsService {
         id: number;
         contractId: number | null;
         managerCollaboratorId: number | null;
+        clientPersonId: number | null;
+        clientAvatarId: number | null;
         code: string;
         name: string;
         clientName: string | null;
@@ -984,6 +1353,21 @@ export declare class OperationsService {
     private assertDepartmentCodeAvailable;
     private resolveDepartmentReference;
     private generateUniqueDepartmentSlug;
+    private getJobTitleById;
+    private assertJobTitleNameAvailable;
+    private assertJobTitleCodeAvailable;
+    private resolveJobTitleReference;
+    private generateUniqueJobTitleSlug;
+    private getCollaboratorTypeById;
+    private assertCollaboratorTypeNameAvailable;
+    private assertCollaboratorTypeSlugAvailable;
+    private buildCollaboratorTypeSlug;
+    private generateUniqueCollaboratorTypeSlug;
+    private getProjectRoleById;
+    private assertProjectRoleNameAvailable;
+    private assertProjectRoleCodeAvailable;
+    private generateUniqueProjectRoleSlug;
+    private resolveCollaboratorTypeReference;
     private getContractTemplateRecord;
     private assertContractTemplateNameAvailable;
     private assertContractTemplateCodeAvailable;
@@ -994,10 +1378,35 @@ export declare class OperationsService {
     private getCollaboratorDetails;
     private getDirectReportIds;
     private getAssignedProjectIds;
+    private resolveOwnedProjectAssignment;
+    private resolveProjectAssignmentForActor;
+    private getOwnedTaskRecord;
+    private getTaskRecordForActor;
+    listProjectBoardTasks(userId: number, projectId: number): Promise<{
+        id: number;
+        name: string;
+        description: string | null;
+        priority: string;
+        status: string;
+        dueDate: string | null;
+        estimateHours: number | null;
+        position: number;
+        tags: string | null;
+        assigneeCollaboratorId: number | null;
+        assigneeName: string | null;
+        assigneeUserPhotoId: number | null;
+        assigneePersonAvatarId: number | null;
+        projectAssignmentId: number | null;
+        createdAt: string;
+    }[]>;
+    private getProjectBoardTask;
+    private getOrCreateTimesheetForWorkDate;
+    private getTimesheetEntryByIdForActor;
     private getTimesheetById;
     private replaceTimesheetEntries;
     private refreshTimesheetTotal;
     private upsertApproval;
+    private applyApprovedScheduleAdjustmentIfNeeded;
     private insertApprovalHistory;
     private assertProjectAccess;
     private ensureCollaboratorAccess;
@@ -1008,10 +1417,14 @@ export declare class OperationsService {
     private defaultWeeklySchedule;
     private replaceCollaboratorScheduleDays;
     private replaceProjectAssignments;
+    private replaceCollaboratorEquityParticipation;
+    private normalizeCollaboratorTypeKey;
     private mapContractCategoryForCollaboratorType;
     private mapBillingModelForCollaboratorType;
     private mapContractTypeForCollaboratorType;
+    private buildHiringContractName;
     private createHiringContractDraft;
+    private syncHiringContractDraft;
     private createProjectContractDraft;
     private replaceContractParties;
     private replaceContractSignatures;
@@ -1037,6 +1450,14 @@ export declare class OperationsService {
     private parseAiJsonPayload;
     private normalizeContractExtractDraft;
     private normalizeExtractionString;
+    private normalizeDurationMinutes;
+    private resolveEntryDurationMinutes;
+    private normalizeDateOnly;
+    private parseDateOnly;
+    private formatDateOnly;
+    private getWorkWeekRange;
+    private normalizePaginationParams;
+    private buildPaginationResult;
     private normalizeExtractionBoolean;
     private normalizeExtractionNumber;
     private normalizeExtractionDate;