@hed-hog/operations 0.0.304 → 0.0.305

package/src/operations.service.ts

@@ -107,7 +107,7 @@ const FINANCIAL_TERM_TYPE_VALUES = ['value', 'payment', 'revenue', 'fine', 'othe
 const RECURRENCE_VALUES = ['one_time', 'monthly', 'quarterly', 'yearly', 'other'] as const;
 const REVISION_TYPE_VALUES = ['amendment', 'renewal', 'revision', 'addendum', 'other'] as const;
 const REVISION_STATUS_VALUES = ['draft', 'active', 'completed', 'cancelled'] as const;
-const TASK_STATUS_VALUES = ['active', 'completed', 'archived'] as const;
+const TASK_STATUS_VALUES = ['todo', 'doing', 'review', 'done'] as const;
 
 type ApprovalAction = 'approve' | 'reject';
 type ApprovalTargetType =
@@ -548,6 +548,7 @@ type ProjectPayload = {
   contractId?: number | null;
   contractTemplateId?: number | null;
   managerCollaboratorId?: number | null;
+  clientPersonId?: number | null;
   code: string;
   name: string;
   clientName?: string | null;
@@ -606,9 +607,15 @@ type TimesheetEntryPayload = {
 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 = {
@@ -1743,6 +1750,28 @@ export class OperationsService {
           data.equityParticipation
         );
       }
+
+      if (
+        data.compensationAmount !== undefined ||
+        data.contractDescription !== undefined ||
+        data.autoGenerateContractDraft !== undefined ||
+        data.joinedAt !== undefined ||
+        data.weeklyCapacityHours !== undefined ||
+        data.supervisorCollaboratorId !== undefined ||
+        data.collaboratorType !== undefined ||
+        data.collaboratorTypeId !== undefined ||
+        data.collaboratorTypeSlug !== undefined ||
+        data.code !== undefined ||
+        data.personId !== undefined ||
+        data.displayName !== undefined
+      ) {
+        await this.syncHiringContractDraft(
+          tx as any,
+          actor.userId,
+          collaboratorId,
+          data
+        );
+      }
     });
 
     return this.getCollaboratorByIdForUser(userId, collaboratorId);
@@ -2002,8 +2031,8 @@ export class OperationsService {
               p.progress_percent AS "progressPercent",
               p.delivery_model AS "deliveryModel",
               p.budget_amount AS "budgetAmount",
-              p.start_date AS "startDate",
-              p.end_date AS "endDate",
+              TO_CHAR(p.start_date, 'YYYY-MM-DD') AS "startDate",
+              TO_CHAR(p.end_date, 'YYYY-MM-DD') AS "endDate",
               c.name AS "contractName",
               c.status AS "contractStatus",
               m.display_name AS "managerName",
@@ -2105,8 +2134,8 @@ export class OperationsService {
               MAX(pa.id)::int AS "projectAssignmentId",
               MAX(pa.role_label) AS "roleLabel",
               p.status,
-              p.start_date AS "startDate",
-              p.end_date AS "endDate"
+              TO_CHAR(p.start_date, 'YYYY-MM-DD') AS "startDate",
+              TO_CHAR(p.end_date, 'YYYY-MM-DD') AS "endDate"
          FROM operations_project_assignment pa
          JOIN operations_project p
            ON p.id = pa.project_id
@@ -2255,54 +2284,92 @@ export class OperationsService {
 
   async createTask(userId: number, data: TaskPayload) {
     const actor = await this.getActorContext(userId);
-    this.ensureCollaborator(actor);
+    if (!actor.isCollaborator && !actor.isDirector && !actor.isSupervisor) {
+      throw new ForbiddenException(
+        'Operations collaborator access is required.'
+      );
+    }
     this.requireFields(data as Record<string, unknown>, ['name']);
 
-    if (!actor.collaboratorId) {
-      throw new BadRequestException('Collaborator context is required.');
+    let assignmentId: number | null = null;
+    let projectId: number | null = null;
+
+    if (data.projectId || data.projectAssignmentId) {
+      const assignment = await this.resolveProjectAssignmentForActor(
+        this.prisma,
+        actor,
+        {
+          projectId: data.projectId ?? null,
+          projectAssignmentId: data.projectAssignmentId ?? null,
+        }
+      );
+      await this.assertProjectAccess(actor, assignment.projectId);
+      assignmentId = assignment.id;
+      projectId = assignment.projectId;
+    } else if (data.projectId) {
+      projectId = data.projectId;
+      await this.assertProjectAccess(actor, projectId);
+    } else {
+      throw new BadRequestException('Either projectId or projectAssignmentId is required.');
     }
 
-    const assignment = await this.resolveOwnedProjectAssignment(
-      this.prisma,
-      actor.collaboratorId,
-      {
-        projectId: data.projectId ?? null,
-        projectAssignmentId: data.projectAssignmentId ?? null,
-      }
-    );
-    await this.assertProjectAccess(actor, assignment.projectId);
+    if (!projectId) {
+      projectId = data.projectId ?? null;
+    }
 
     const name = this.normalizeOptionalText(data.name);
     if (!name) {
       throw new BadRequestException('Field "name" is required.');
     }
 
+    const maxPositionRow = await this.querySingle<{ max_pos: number | null }>(
+      `SELECT MAX(position) AS max_pos
+         FROM operations_task
+        WHERE project_id = $1
+          AND status = $2::operations_task_status_574c143dbe_enum
+          AND deleted_at IS NULL`,
+      [projectId, data.status ?? 'todo']
+    );
+    const nextPosition = ((maxPositionRow?.max_pos ?? -1) as number) + 1;
+
     const created = await this.querySingle<{ id: number }>(
       `INSERT INTO operations_task (
+        project_id,
         project_assignment_id,
+        assignee_collaborator_id,
         name,
         description,
+        priority,
         status,
+        due_date,
+        estimate_hours,
+        position,
+        tags,
         created_at,
         updated_at
       ) VALUES (
-        $1,
-        $2,
-        $3,
-        $4,
-        NOW(),
-        NOW()
+        $1, $2, $3, $4, $5,
+        $6::operations_task_priority_394ab327eb_enum,
+        $7::operations_task_status_574c143dbe_enum,
+        $8::date, $9::decimal, $10, $11, NOW(), NOW()
       )
       RETURNING id`,
       [
-        assignment.id,
+        projectId,
+        assignmentId,
+        data.assigneeCollaboratorId ?? null,
         name,
         this.normalizeOptionalText(data.description),
-        data.status ?? 'active',
+        data.priority ?? 'medium',
+        data.status ?? 'todo',
+        data.dueDate ?? null,
+        data.estimateHours ?? null,
+        data.position ?? nextPosition,
+        data.tags ?? null,
       ]
     );
 
-    return this.getTaskOptionById(actor.collaboratorId, created?.id ?? 0);
+    return this.getProjectBoardTask(created?.id ?? 0);
   }
 
   async updateTask(
@@ -2311,15 +2378,15 @@ export class OperationsService {
     data: Partial<TaskPayload>
   ) {
     const actor = await this.getActorContext(userId);
-    this.ensureCollaborator(actor);
-
-    if (!actor.collaboratorId) {
-      throw new BadRequestException('Collaborator context is required.');
+    if (!actor.isCollaborator && !actor.isDirector && !actor.isSupervisor) {
+      throw new ForbiddenException(
+        'Operations collaborator access is required.'
+      );
     }
 
-    const current = await this.getOwnedTaskRecord(
+    const current = await this.getTaskRecordForActor(
       this.prisma,
-      actor.collaboratorId,
+      actor,
       taskId
     );
     await this.assertProjectAccess(actor, current.projectId);
@@ -2334,56 +2401,72 @@ export class OperationsService {
     }
 
     await this.prisma.$transaction(async (tx) => {
-      const nextAssignment =
-        data.projectId !== undefined || data.projectAssignmentId !== undefined
-          ? await this.resolveOwnedProjectAssignment(
-              tx as any,
-              actor.collaboratorId as number,
-              {
-                projectId: data.projectId ?? null,
-                projectAssignmentId: data.projectAssignmentId ?? null,
-              }
-            )
-          : {
-              id: current.projectAssignmentId,
-              projectId: current.projectId,
-            };
+      let nextAssignmentId = current.projectAssignmentId;
+      let nextProjectId = current.projectId;
 
-      await this.assertProjectAccess(actor, nextAssignment.projectId);
+      if (data.projectId !== undefined || data.projectAssignmentId !== undefined) {
+        const nextAssignment = await this.resolveProjectAssignmentForActor(
+          tx as any,
+          actor,
+          {
+            projectId: data.projectId ?? null,
+            projectAssignmentId: data.projectAssignmentId ?? null,
+          }
+        );
+        await this.assertProjectAccess(actor, nextAssignment.projectId);
+        nextAssignmentId = nextAssignment.id;
+        nextProjectId = nextAssignment.projectId;
+      }
 
       await (tx as any).$executeRawUnsafe(
         `UPDATE operations_task
-            SET project_assignment_id = $1,
-                name = $2,
-                description = $3,
-                status = $4,
+            SET project_id = $1,
+                project_assignment_id = $2,
+                assignee_collaborator_id = $3,
+                name = $4,
+                description = $5,
+                priority = $6::operations_task_priority_394ab327eb_enum,
+                status = $7::operations_task_status_574c143dbe_enum,
+                due_date = $8::date,
+                estimate_hours = $9::decimal,
+                position = $10,
+                tags = $11,
                 updated_at = NOW()
-          WHERE id = $5
+          WHERE id = $12
             AND deleted_at IS NULL`,
-        nextAssignment.id,
+        nextProjectId,
+        nextAssignmentId,
+        data.assigneeCollaboratorId !== undefined
+          ? (data.assigneeCollaboratorId ?? null)
+          : current.assigneeCollaboratorId,
         nextName,
         data.description !== undefined
           ? this.normalizeOptionalText(data.description)
           : (current.description ?? null),
+        data.priority ?? current.priority,
         data.status ?? current.status,
+        data.dueDate !== undefined ? (data.dueDate ?? null) : current.dueDate,
+        data.estimateHours !== undefined ? (data.estimateHours ?? null) : current.estimateHours,
+        data.position !== undefined ? data.position : current.position,
+        data.tags !== undefined ? (data.tags ?? null) : current.tags,
         taskId
       );
     });
 
-    return this.getTaskOptionById(actor.collaboratorId, taskId);
+    return this.getProjectBoardTask(taskId);
   }
 
   async removeTask(userId: number, taskId: number) {
     const actor = await this.getActorContext(userId);
-    this.ensureCollaborator(actor);
-
-    if (!actor.collaboratorId) {
-      throw new BadRequestException('Collaborator context is required.');
+    if (!actor.isCollaborator && !actor.isDirector && !actor.isSupervisor) {
+      throw new ForbiddenException(
+        'Operations collaborator access is required.'
+      );
     }
 
-    const current = await this.getOwnedTaskRecord(
+    const current = await this.getTaskRecordForActor(
       this.prisma,
-      actor.collaboratorId,
+      actor,
       taskId
     );
     await this.assertProjectAccess(actor, current.projectId);
@@ -2392,7 +2475,6 @@ export class OperationsService {
       await (tx as any).$executeRawUnsafe(
         `UPDATE operations_task
             SET deleted_at = COALESCE(deleted_at, NOW()),
-                status = 'archived',
                 updated_at = NOW()
           WHERE id = $1
             AND deleted_at IS NULL`,
@@ -2732,6 +2814,7 @@ export class OperationsService {
         `INSERT INTO operations_project (
           contract_id,
           manager_collaborator_id,
+          client_person_id,
           code,
           name,
           client_name,
@@ -2745,15 +2828,16 @@ export class OperationsService {
           created_at,
           updated_at
         ) VALUES (
-          $1, $2, $3, $4, $5, $6,
-          $7::operations_project_status_965e8d4b2d_enum,
-          $8,
-          $9::operations_project_delivery_model_75ee11b3b7_enum,
-          $10, $11::date, $12::date, NOW(), NOW()
+          $1, $2, $3, $4, $5, $6, $7,
+          $8::operations_project_status_965e8d4b2d_enum,
+          $9,
+          $10::operations_project_delivery_model_75ee11b3b7_enum,
+          $11, $12::date, $13::date, NOW(), NOW()
         )
         RETURNING id`,
         data.contractId ?? null,
         data.managerCollaboratorId ?? null,
+        data.clientPersonId ?? null,
         data.code,
         data.name,
         data.clientName ?? null,
@@ -2823,6 +2907,7 @@ export class OperationsService {
     const params: unknown[] = [];
     this.pushUpdate(updates, params, 'contract_id', data.contractId);
     this.pushUpdate(updates, params, 'manager_collaborator_id', data.managerCollaboratorId);
+    this.pushUpdate(updates, params, 'client_person_id', data.clientPersonId);
     this.pushUpdate(updates, params, 'code', data.code);
     this.pushUpdate(updates, params, 'name', data.name);
     this.pushUpdate(updates, params, 'client_name', data.clientName);
@@ -2839,7 +2924,7 @@ export class OperationsService {
       updates,
       params,
       'delivery_model',
-      data.deliveryModel,
+      (data.deliveryModel as string | null | undefined) === '' ? null : data.deliveryModel,
       'operations_project_delivery_model_75ee11b3b7_enum'
     );
     this.pushUpdate(updates, params, 'budget_amount', data.budgetAmount);
@@ -2869,7 +2954,7 @@ export class OperationsService {
       const nextContractId =
         data.contractId !== undefined
           ? data.contractId
-          : (currentProject.contractId ?? null);
+          : (currentProject.relatedContract?.id ?? null);
       const shouldGenerateDraft =
         !nextContractId && data.autoGenerateContractDraft === true;
 
@@ -2922,6 +3007,39 @@ export class OperationsService {
           contractId,
           projectId
         );
+      } else if (
+        nextContractId &&
+        (data.monthlyHourCap !== undefined || data.billingModel !== undefined)
+      ) {
+        const contractUpdates: string[] = [];
+        const contractParams: unknown[] = [];
+
+        this.pushUpdate(
+          contractUpdates,
+          contractParams,
+          'monthly_hour_cap',
+          data.monthlyHourCap
+        );
+        this.pushUpdate(
+          contractUpdates,
+          contractParams,
+          'billing_model',
+          (data.billingModel as string | null | undefined) === ''
+            ? null
+            : data.billingModel,
+          'operations_contract_billing_model_409dc7fea2_enum'
+        );
+
+        if (contractUpdates.length) {
+          contractParams.push(nextContractId);
+          await (tx as any).$executeRawUnsafe(
+            `UPDATE operations_contract
+                SET ${contractUpdates.join(', ')},
+                    updated_at = NOW()
+              WHERE id = $${contractParams.length}`,
+            ...contractParams
+          );
+        }
       }
     });
 
@@ -6608,6 +6726,8 @@ export class OperationsService {
       id: number;
       contractId: number | null;
       managerCollaboratorId: number | null;
+      clientPersonId: number | null;
+      clientAvatarId: number | null;
       code: string;
       name: string;
       clientName: string | null;
@@ -6629,6 +6749,8 @@ export class OperationsService {
       `SELECT p.id,
               p.contract_id AS "contractId",
               p.manager_collaborator_id AS "managerCollaboratorId",
+              p.client_person_id AS "clientPersonId",
+              client_person.avatar_id AS "clientAvatarId",
               p.code,
               p.name,
               p.client_name AS "clientName",
@@ -6637,8 +6759,8 @@ export class OperationsService {
               p.progress_percent AS "progressPercent",
               p.delivery_model AS "deliveryModel",
               p.budget_amount AS "budgetAmount",
-              p.start_date AS "startDate",
-              p.end_date AS "endDate",
+              TO_CHAR(p.start_date, 'YYYY-MM-DD') AS "startDate",
+              TO_CHAR(p.end_date, 'YYYY-MM-DD') AS "endDate",
               c.name AS "contractName",
               c.status AS "contractStatus",
               c.contract_category AS "contractCategory",
@@ -6649,6 +6771,7 @@ export class OperationsService {
          FROM operations_project p
          LEFT JOIN operations_contract c ON c.id = p.contract_id
          LEFT JOIN operations_collaborator m ON m.id = p.manager_collaborator_id
+         LEFT JOIN person client_person ON client_person.id = p.client_person_id
          LEFT JOIN operations_project_assignment pa
            ON pa.project_id = p.id
           AND pa.deleted_at IS NULL
@@ -6664,7 +6787,7 @@ export class OperationsService {
          ) project_role_locale ON TRUE
         WHERE p.id = $1
           AND p.deleted_at IS NULL
-        GROUP BY p.id, c.id, m.id`,
+        GROUP BY p.id, c.id, m.id, client_person.id`,
       [projectId, actorCollaboratorId ?? null]
     );
 
@@ -6677,6 +6800,9 @@ export class OperationsService {
         this.queryRows<{
           id: number;
           collaboratorId: number;
+          userId: number | null;
+          personAvatarId: number | null;
+          userPhotoId: number | null;
           collaboratorName: string;
           projectRoleId: number | null;
           roleLabel: string | null;
@@ -6689,17 +6815,22 @@ export class OperationsService {
         }>(
           `SELECT pa.id,
                   pa.collaborator_id AS "collaboratorId",
+              c.user_id AS "userId",
+              person_record.avatar_id AS "personAvatarId",
+              collaborator_user.photo_id AS "userPhotoId",
                   c.display_name AS "collaboratorName",
                   pa.project_role_id AS "projectRoleId",
                   COALESCE(project_role_locale.name, pa.role_label) AS "roleLabel",
                   pa.allocation_percent AS "allocationPercent",
                   pa.weekly_hours AS "weeklyHours",
                   pa.is_billable AS "isBillable",
-                  pa.start_date AS "startDate",
-                  pa.end_date AS "endDate",
+                  TO_CHAR(pa.start_date, 'YYYY-MM-DD') AS "startDate",
+                  TO_CHAR(pa.end_date, 'YYYY-MM-DD') AS "endDate",
                   pa.status
              FROM operations_project_assignment pa
              JOIN operations_collaborator c ON c.id = pa.collaborator_id
+             LEFT JOIN person person_record ON person_record.id = c.person_id
+             LEFT JOIN "user" collaborator_user ON collaborator_user.id = c.user_id
              LEFT JOIN operations_project_role project_role
                ON project_role.id = pa.project_role_id
               AND project_role.deleted_at IS NULL
@@ -6739,8 +6870,8 @@ export class OperationsService {
                       contract_category AS "contractCategory",
                       billing_model AS "billingModel",
                       status,
-                      start_date AS "startDate",
-                      end_date AS "endDate",
+                      TO_CHAR(start_date, 'YYYY-MM-DD') AS "startDate",
+                      TO_CHAR(end_date, 'YYYY-MM-DD') AS "endDate",
                       budget_amount AS "budgetAmount",
                       monthly_hour_cap AS "monthlyHourCap",
                       description,
@@ -6951,7 +7082,8 @@ export class OperationsService {
              FROM operations_contract c
             WHERE c.related_collaborator_id = $1
               AND c.deleted_at IS NULL
-            ORDER BY c.created_at DESC`,
+            ORDER BY CASE WHEN c.origin_type = 'employee_hiring' THEN 0 ELSE 1 END,
+                     c.created_at DESC`,
           [collaboratorId]
         ),
         this.queryRows(
@@ -7137,6 +7269,69 @@ export class OperationsService {
     return assignment[0];
   }
 
+  private async resolveProjectAssignmentForActor(
+    client: any,
+    actor: ActorContext,
+    input: {
+      projectId?: number | null;
+      projectAssignmentId?: number | null;
+    }
+  ) {
+    if (actor.collaboratorId && !actor.isDirector && !actor.isSupervisor) {
+      return this.resolveOwnedProjectAssignment(
+        client,
+        actor.collaboratorId,
+        input
+      );
+    }
+
+    if (!input.projectId && !input.projectAssignmentId) {
+      throw new BadRequestException(
+        'Either projectId or projectAssignmentId is required.'
+      );
+    }
+
+    const params: unknown[] = [];
+    const filters = ['pa.deleted_at IS NULL', 'p.deleted_at IS NULL'];
+
+    if (input.projectAssignmentId) {
+      filters.push(`pa.id = ${this.param(params, input.projectAssignmentId)}`);
+    }
+
+    if (input.projectId) {
+      filters.push(`pa.project_id = ${this.param(params, input.projectId)}`);
+    }
+
+    const assignment = (await client.$queryRawUnsafe(
+      `SELECT pa.id,
+              pa.project_id AS "projectId",
+              p.name AS "projectName",
+              p.code AS "projectCode",
+              pa.role_label AS "roleLabel"
+         FROM operations_project_assignment pa
+         JOIN operations_project p
+           ON p.id = pa.project_id
+        WHERE ${filters.join(' AND ')}
+        ORDER BY CASE WHEN pa.status = 'active' THEN 0 ELSE 1 END,
+                 pa.start_date DESC NULLS LAST,
+                 pa.id DESC
+        LIMIT 1`,
+      ...params
+    )) as Array<{
+      id: number;
+      projectId: number;
+      projectName: string;
+      projectCode: string | null;
+      roleLabel: string | null;
+    }>;
+
+    if (!assignment[0]) {
+      throw new NotFoundException('Project assignment not found.');
+    }
+
+    return assignment[0];
+  }
+
   private async getOwnedTaskRecord(
     client: any,
     collaboratorId: number,
@@ -7146,21 +7341,33 @@ export class OperationsService {
       `SELECT t.id,
               t.name,
               t.description,
+              t.priority,
               t.status,
+              t.due_date AS "dueDate",
+              t.estimate_hours AS "estimateHours",
+              t.position,
+              t.tags,
+              t.assignee_collaborator_id AS "assigneeCollaboratorId",
               t.project_assignment_id AS "projectAssignmentId",
-              pa.project_id AS "projectId",
+              COALESCE(t.project_id, pa.project_id) AS "projectId",
               p.name AS "projectName",
               p.code AS "projectCode"
          FROM operations_task t
-         JOIN operations_project_assignment pa
+         LEFT JOIN operations_project_assignment pa
            ON pa.id = t.project_assignment_id
           AND pa.deleted_at IS NULL
-         JOIN operations_project p
-           ON p.id = pa.project_id
+         LEFT JOIN operations_project p
+           ON p.id = COALESCE(t.project_id, pa.project_id)
           AND p.deleted_at IS NULL
         WHERE t.id = $1
           AND t.deleted_at IS NULL
-          AND pa.collaborator_id = $2
+          AND (
+            pa.collaborator_id = $2
+            OR t.project_id IN (
+              SELECT pa2.project_id FROM operations_project_assignment pa2
+               WHERE pa2.collaborator_id = $2 AND pa2.deleted_at IS NULL
+            )
+          )
         LIMIT 1`,
       taskId,
       collaboratorId
@@ -7168,8 +7375,14 @@ export class OperationsService {
       id: number;
       name: string;
       description: string | null;
+      priority: string;
       status: string;
-      projectAssignmentId: number;
+      dueDate: string | null;
+      estimateHours: number | null;
+      position: number;
+      tags: string | null;
+      assigneeCollaboratorId: number | null;
+      projectAssignmentId: number | null;
       projectId: number;
       projectName: string;
       projectCode: string | null;
@@ -7184,12 +7397,127 @@ export class OperationsService {
     return task[0];
   }
 
-  private async getTaskOptionById(collaboratorId: number, taskId: number) {
-    const task = await this.getOwnedTaskRecord(this.prisma, collaboratorId, taskId);
-    return {
-      ...task,
-      label: [task.name, task.projectName].filter(Boolean).join(' • '),
-    };
+  private async getTaskRecordForActor(
+    client: any,
+    actor: ActorContext,
+    taskId: number
+  ) {
+    if (actor.collaboratorId && !actor.isDirector && !actor.isSupervisor) {
+      return this.getOwnedTaskRecord(client, actor.collaboratorId, taskId);
+    }
+
+    const task = await this.getProjectBoardTask(taskId);
+    if (!task?.projectId) {
+      throw new NotFoundException('Task not found.');
+    }
+
+    return task;
+  }
+
+  async listProjectBoardTasks(userId: number, projectId: number) {
+    const actor = await this.getActorContext(userId);
+    this.ensureCollaborator(actor);
+    await this.assertProjectAccess(actor, projectId);
+
+    const rows = await this.queryRows<{
+      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;
+    }>(
+      `SELECT t.id,
+              t.name,
+              t.description,
+              t.priority,
+              t.status,
+              t.due_date AS "dueDate",
+              t.estimate_hours AS "estimateHours",
+              t.position,
+              t.tags,
+              t.assignee_collaborator_id AS "assigneeCollaboratorId",
+              ac.display_name AS "assigneeName",
+              au.photo_id AS "assigneeUserPhotoId",
+              ap.avatar_id AS "assigneePersonAvatarId",
+              t.project_assignment_id AS "projectAssignmentId",
+              t.created_at AS "createdAt"
+         FROM operations_task t
+         LEFT JOIN operations_collaborator ac
+           ON ac.id = t.assignee_collaborator_id AND ac.deleted_at IS NULL
+         LEFT JOIN "user" au
+           ON au.id = ac.user_id
+         LEFT JOIN person ap
+           ON ap.id = ac.person_id
+        WHERE COALESCE(t.project_id, (
+                SELECT pa.project_id FROM operations_project_assignment pa
+                 WHERE pa.id = t.project_assignment_id AND pa.deleted_at IS NULL
+                 LIMIT 1
+              )) = $1
+          AND t.deleted_at IS NULL
+        ORDER BY t.status ASC, t.position ASC, t.id ASC`,
+      [projectId]
+    );
+
+    return rows;
+  }
+
+  private async getProjectBoardTask(taskId: number) {
+    const rows = await this.queryRows<{
+      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;
+    }>(
+      `SELECT t.id,
+              t.name,
+              t.description,
+              t.priority,
+              t.status,
+              t.due_date AS "dueDate",
+              t.estimate_hours AS "estimateHours",
+              t.position,
+              t.tags,
+              t.assignee_collaborator_id AS "assigneeCollaboratorId",
+              ac.display_name AS "assigneeName",
+              au.photo_id AS "assigneeUserPhotoId",
+              ap.avatar_id AS "assigneePersonAvatarId",
+              t.project_assignment_id AS "projectAssignmentId",
+              COALESCE(t.project_id, pa.project_id) AS "projectId",
+              t.created_at AS "createdAt"
+         FROM operations_task t
+         LEFT JOIN operations_collaborator ac
+           ON ac.id = t.assignee_collaborator_id AND ac.deleted_at IS NULL
+         LEFT JOIN "user" au ON au.id = ac.user_id
+         LEFT JOIN person ap ON ap.id = ac.person_id
+         LEFT JOIN operations_project_assignment pa
+           ON pa.id = t.project_assignment_id AND pa.deleted_at IS NULL
+        WHERE t.id = $1`,
+      [taskId]
+    );
+
+    return rows[0] ?? null;
   }
 
   private async getOrCreateTimesheetForWorkDate(
@@ -8055,6 +8383,146 @@ export class OperationsService {
     );
   }
 
+  private async syncHiringContractDraft(
+    client: any,
+    updatedByUserId: number,
+    collaboratorId: number,
+    data: Partial<CollaboratorPayload>
+  ) {
+    const collaborator = await client.$queryRawUnsafe(
+      `SELECT c.id,
+              c.code,
+              COALESCE(NULLIF(c.display_name, ''), person_record.name) AS "displayName",
+              collaborator_type.slug AS "collaboratorTypeSlug",
+              c.supervisor_collaborator_id AS "supervisorCollaboratorId",
+              c.joined_at AS "joinedAt",
+              c.weekly_capacity_hours AS "weeklyCapacityHours"
+         FROM operations_collaborator c
+         LEFT JOIN person person_record
+           ON person_record.id = c.person_id
+         LEFT JOIN operations_collaborator_type collaborator_type
+           ON collaborator_type.id = c.collaborator_type_id
+          AND collaborator_type.deleted_at IS NULL
+        WHERE c.id = $1
+          AND c.deleted_at IS NULL
+        LIMIT 1`,
+      collaboratorId
+    ) as Array<{
+      id: number;
+      code: string | null;
+      displayName: string | null;
+      collaboratorTypeSlug: string | null;
+      supervisorCollaboratorId: number | null;
+      joinedAt: string | null;
+      weeklyCapacityHours: number | null;
+    }>;
+
+    const currentCollaborator = collaborator[0] ?? null;
+
+    if (!currentCollaborator) {
+      throw new NotFoundException('Collaborator not found.');
+    }
+
+    const hiringContracts = (await client.$queryRawUnsafe(
+      `SELECT id,
+              budget_amount AS "budgetAmount",
+              description
+         FROM operations_contract
+        WHERE related_collaborator_id = $1
+          AND origin_type = 'employee_hiring'
+          AND deleted_at IS NULL
+        ORDER BY created_at DESC
+        LIMIT 1`,
+      collaboratorId
+    )) as Array<{
+      id: number;
+      budgetAmount: number | null;
+      description: string | null;
+    }>;
+
+    const hiringContract = hiringContracts[0] ?? null;
+    const collaboratorCode =
+      this.normalizeOptionalText(currentCollaborator.code) ??
+      `COL-${collaboratorId}`;
+    const displayName =
+      this.normalizeOptionalText(currentCollaborator.displayName) ??
+      `Collaborator ${collaboratorId}`;
+    const collaboratorTypeSlug =
+      this.normalizeOptionalText(currentCollaborator.collaboratorTypeSlug) ??
+      'other';
+    const startDate =
+      data.joinedAt !== undefined
+        ? data.joinedAt ?? null
+        : currentCollaborator.joinedAt ?? null;
+    const weeklyCapacityHours =
+      data.weeklyCapacityHours !== undefined
+        ? data.weeklyCapacityHours ?? null
+        : currentCollaborator.weeklyCapacityHours ?? null;
+    const compensationAmount =
+      data.compensationAmount !== undefined
+        ? data.compensationAmount ?? null
+        : hiringContract?.budgetAmount ?? null;
+    const description =
+      data.contractDescription !== undefined
+        ? this.normalizeOptionalText(data.contractDescription)
+        : hiringContract?.description ?? null;
+    const supervisorCollaboratorId =
+      data.supervisorCollaboratorId !== undefined
+        ? data.supervisorCollaboratorId ?? null
+        : currentCollaborator.supervisorCollaboratorId ?? null;
+
+    if (!hiringContract) {
+      if (data.autoGenerateContractDraft === false) {
+        return;
+      }
+
+      await this.createHiringContractDraft(client, updatedByUserId, {
+        collaboratorId,
+        collaboratorCode,
+        displayName,
+        collaboratorType: collaboratorTypeSlug,
+        supervisorCollaboratorId,
+        startDate,
+        weeklyCapacityHours,
+        compensationAmount,
+        description,
+      });
+      return;
+    }
+
+    await client.$executeRawUnsafe(
+      `UPDATE operations_contract
+          SET code = $1,
+              name = $2,
+              contract_category = $3::operations_contract_contract_category_70d553ea09_enum,
+              contract_type = $4::operations_contract_contract_type_48331e2ebf_enum,
+              client_name = $5,
+              billing_model = $6::operations_contract_billing_model_409dc7fea2_enum,
+              account_manager_collaborator_id = $7,
+              start_date = $8::date,
+              effective_date = $8::date,
+              budget_amount = $9,
+              monthly_hour_cap = $10,
+              description = $11,
+              updated_by_user_id = $12,
+              updated_at = NOW()
+        WHERE id = $13`,
+      `HIR-${collaboratorCode}`,
+      this.buildHiringContractName(displayName, collaboratorTypeSlug),
+      this.mapContractCategoryForCollaboratorType(collaboratorTypeSlug),
+      this.mapContractTypeForCollaboratorType(collaboratorTypeSlug),
+      displayName,
+      this.mapBillingModelForCollaboratorType(collaboratorTypeSlug),
+      supervisorCollaboratorId,
+      startDate ?? new Date().toISOString().slice(0, 10),
+      compensationAmount,
+      weeklyCapacityHours ? Math.round(Number(weeklyCapacityHours) * 4) : null,
+      description,
+      updatedByUserId,
+      hiringContract.id
+    );
+  }
+
   private async createProjectContractDraft(
     client: any,
     createdByUserId: number,