@hed-hog/operations 0.0.300 → 0.0.301

package/dist/operations.service.js

@@ -8,6 +8,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OperationsService = void 0;
 const api_prisma_1 = require("@hed-hog/api-prisma");
@@ -16,10 +19,98 @@ const common_1 = require("@nestjs/common");
 const COLLABORATOR_ROLE = 'admin-operations-collaborator';
 const SUPERVISOR_ROLE = 'admin-operations-supervisor';
 const DIRECTOR_ROLE = 'admin-operations-director';
+const CONTRACT_CATEGORY_VALUES = [
+    'employee',
+    'contractor',
+    'client',
+    'supplier',
+    'vendor',
+    'partner',
+    'internal',
+    'other',
+];
+const CONTRACT_TYPE_VALUES = [
+    'clt',
+    'pj',
+    'freelancer_agreement',
+    'service_agreement',
+    'fixed_term',
+    'recurring_service',
+    'nda',
+    'amendment',
+    'addendum',
+    'other',
+];
+const BILLING_MODEL_VALUES = [
+    'time_and_material',
+    'monthly_retainer',
+    'fixed_price',
+];
+const SIGNATURE_STATUS_VALUES = [
+    'not_started',
+    'pending',
+    'partially_signed',
+    'signed',
+    'expired',
+];
+const CONTRACT_STATUS_VALUES = [
+    'draft',
+    'under_review',
+    'active',
+    'renewal',
+    'expired',
+    'closed',
+    'archived',
+];
+const CONTRACT_CREATION_MODE_VALUES = [
+    'blank',
+    'template',
+    'upload',
+    'duplicate',
+];
+const ORIGIN_TYPE_VALUES = [
+    'manual',
+    'employee_hiring',
+    'client_project',
+    'crm_proposal',
+];
+const CONTRACT_DOCUMENT_TYPE_VALUES = [
+    'source_upload',
+    'generated_pdf',
+    'attachment',
+    'other',
+];
+const CONTRACT_DOCUMENT_EXTRACTION_STATUS_VALUES = [
+    'pending',
+    'processing',
+    'completed',
+    'failed',
+    'skipped',
+];
+const PARTY_ROLE_VALUES = [
+    'employee',
+    'employer',
+    'client',
+    'supplier',
+    'vendor',
+    'partner',
+    'witness',
+    'internal_owner',
+    'other',
+];
+const PARTY_TYPE_VALUES = ['individual', 'company', 'internal_team', 'other'];
+const SIGNATURE_ITEM_STATUS_VALUES = ['pending', 'signed', 'rejected'];
+const FINANCIAL_TERM_TYPE_VALUES = ['value', 'payment', 'revenue', 'fine', 'other'];
+const RECURRENCE_VALUES = ['one_time', 'monthly', 'quarterly', 'yearly', 'other'];
+const REVISION_TYPE_VALUES = ['amendment', 'renewal', 'revision', 'addendum', 'other'];
+const REVISION_STATUS_VALUES = ['draft', 'active', 'completed', 'cancelled'];
 let OperationsService = class OperationsService {
-    constructor(prisma, integrationApi) {
+    constructor(prisma, aiService, integrationApi, fileService, settingService) {
         this.prisma = prisma;
+        this.aiService = aiService;
         this.integrationApi = integrationApi;
+        this.fileService = fileService;
+        this.settingService = settingService;
     }
     async getDashboard(userId) {
         var _a, _b, _c, _d, _e, _f, _g;
@@ -97,10 +188,14 @@ let OperationsService = class OperationsService {
         const filter = this.buildIdFilter(actor.visibleCollaboratorIds, 'c.id', actor.isDirector);
         return this.queryRows(`SELECT c.id,
               c.user_id AS "userId",
+              c.person_id AS "personId",
               c.code,
               c.collaborator_type AS "collaboratorType",
-              c.display_name AS "displayName",
-              c.department,
+              COALESCE(NULLIF(c.display_name, ''), person_record.name) AS "displayName",
+              person_record.name AS "personName",
+              person_record.avatar_id AS "personAvatarId",
+              c.department_id AS "departmentId",
+              COALESCE(NULLIF(department_record.name, ''), NULLIF(c.department, '')) AS "department",
               c.title,
               c.level_label AS "levelLabel",
               c.weekly_capacity_hours AS "weeklyCapacityHours",
@@ -114,6 +209,11 @@ let OperationsService = class OperationsService {
               hiring_contract.status AS "contractStatus",
               COUNT(DISTINCT pa.id)::int AS "activeAssignments"
          FROM operations_collaborator c
+         LEFT JOIN person person_record
+           ON person_record.id = c.person_id
+         LEFT JOIN operations_department department_record
+           ON department_record.id = c.department_id
+          AND department_record.deleted_at IS NULL
          LEFT JOIN operations_collaborator s
            ON s.id = c.supervisor_collaborator_id
          LEFT JOIN operations_project_assignment pa
@@ -131,8 +231,8 @@ let OperationsService = class OperationsService {
          ) hiring_contract ON TRUE
         WHERE c.deleted_at IS NULL
           AND ${filter.clause}
-        GROUP BY c.id, s.id, hiring_contract.id, hiring_contract.status
-        ORDER BY c.display_name ASC`, filter.params);
+        GROUP BY c.id, person_record.id, department_record.id, s.id, hiring_contract.id, hiring_contract.status
+        ORDER BY COALESCE(NULLIF(c.display_name, ''), person_record.name) ASC`, filter.params);
     }
     async getMyCollaborator(userId) {
         const actor = await this.getActorContext(userId);
@@ -169,10 +269,14 @@ let OperationsService = class OperationsService {
         const teamFilter = this.buildIdFilter(actor.teamCollaboratorIds, 'c.id', false);
         const teamMembers = await this.queryRows(`SELECT c.id,
               c.user_id AS "userId",
+              c.person_id AS "personId",
               c.code,
-              c.display_name AS "displayName",
+              COALESCE(NULLIF(c.display_name, ''), person_record.name) AS "displayName",
+              person_record.name AS "personName",
+              person_record.avatar_id AS "personAvatarId",
               c.collaborator_type AS "collaboratorType",
-              c.department,
+              c.department_id AS "departmentId",
+              COALESCE(NULLIF(department_record.name, ''), NULLIF(c.department, '')) AS "department",
               c.title,
               c.status,
               COUNT(DISTINCT pa.id)::int AS "activeAssignments",
@@ -180,6 +284,11 @@ let OperationsService = class OperationsService {
               COUNT(DISTINCT tor.id) FILTER (WHERE tor.status = 'submitted')::int AS "pendingTimeOffRequests",
               COUNT(DISTINCT sar.id) FILTER (WHERE sar.status = 'submitted')::int AS "pendingScheduleAdjustmentRequests"
          FROM operations_collaborator c
+         LEFT JOIN person person_record
+           ON person_record.id = c.person_id
+         LEFT JOIN operations_department department_record
+           ON department_record.id = c.department_id
+          AND department_record.deleted_at IS NULL
          LEFT JOIN operations_project_assignment pa
            ON pa.collaborator_id = c.id
           AND pa.deleted_at IS NULL
@@ -197,8 +306,8 @@ let OperationsService = class OperationsService {
           AND sar.deleted_at IS NULL
           AND sar.status = 'submitted'
         WHERE c.deleted_at IS NULL AND ${teamFilter.clause}
-        GROUP BY c.id
-        ORDER BY c.display_name ASC`, teamFilter.params);
+        GROUP BY c.id, person_record.id, department_record.id
+        ORDER BY COALESCE(NULLIF(c.display_name, ''), person_record.name) ASC`, teamFilter.params);
         const [teamProjects, pendingApprovalQueue, pendingTimeOffRequests, pendingScheduleAdjustmentRequests] = await Promise.all([
             this.queryRows(`SELECT p.id,
                   p.code,
@@ -341,18 +450,33 @@ let OperationsService = class OperationsService {
         };
     }
     async createCollaborator(userId, data) {
+        var _a, _b, _c, _d;
         const actor = await this.getActorContext(userId);
         this.ensureDirector(actor);
-        this.requireFields(data, ['userId', 'code', 'displayName']);
+        const resolvedPerson = data.personId
+            ? await this.getPersonById(Number(data.personId))
+            : null;
+        const resolvedDisplayName = (_d = (_b = (_a = resolvedPerson === null || resolvedPerson === void 0 ? void 0 : resolvedPerson.name) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : (_c = data.displayName) === null || _c === void 0 ? void 0 : _c.trim()) !== null && _d !== void 0 ? _d : '';
+        if (!resolvedDisplayName) {
+            throw new common_1.BadRequestException('Field "personId" is required.');
+        }
         const collaboratorId = await this.prisma.$transaction(async (tx) => {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
+            const normalizedCode = String((_a = data.code) !== null && _a !== void 0 ? _a : '').trim() ||
+                (await this.generateCollaboratorCode(tx));
+            const resolvedDepartment = await this.resolveDepartmentReference(tx, {
+                departmentId: (_b = data.departmentId) !== null && _b !== void 0 ? _b : null,
+                departmentName: data.department,
+            });
             const created = (await tx.$queryRawUnsafe(`INSERT INTO operations_collaborator (
           user_id,
+          person_id,
           supervisor_collaborator_id,
           code,
           collaborator_type,
           display_name,
           department,
+          department_id,
           title,
           level_label,
           weekly_capacity_hours,
@@ -363,23 +487,26 @@ let OperationsService = class OperationsService {
           created_at,
           updated_at
         ) VALUES (
-          $1, $2, $3, COALESCE($4, 'other'), $5, $6, $7, $8, $9,
-          COALESCE($10, 'active'), $11, $12, $13, NOW(), NOW()
+          $1, $2, $3, $4,
+          $5::operations_collaborator_collaborator_type_7dd7b0ada2_enum,
+          $6, $7, $8, $9, $10, $11,
+          $12::operations_collaborator_status_ef779877d4_enum,
+          $13::date, $14::date, $15, NOW(), NOW()
         )
-        RETURNING id`, data.userId, (_a = data.supervisorCollaboratorId) !== null && _a !== void 0 ? _a : null, data.code, (_b = data.collaboratorType) !== null && _b !== void 0 ? _b : 'other', data.displayName, (_c = data.department) !== null && _c !== void 0 ? _c : null, (_d = data.title) !== null && _d !== void 0 ? _d : null, (_e = data.levelLabel) !== null && _e !== void 0 ? _e : null, (_f = data.weeklyCapacityHours) !== null && _f !== void 0 ? _f : null, (_g = data.status) !== null && _g !== void 0 ? _g : 'active', (_h = data.joinedAt) !== null && _h !== void 0 ? _h : null, (_j = data.leftAt) !== null && _j !== void 0 ? _j : null, (_k = data.notes) !== null && _k !== void 0 ? _k : null));
-            const createdCollaboratorId = (_l = created[0]) === null || _l === void 0 ? void 0 : _l.id;
+        RETURNING id`, (_c = data.userId) !== null && _c !== void 0 ? _c : null, (_d = resolvedPerson === null || resolvedPerson === void 0 ? void 0 : resolvedPerson.id) !== null && _d !== void 0 ? _d : null, (_e = data.supervisorCollaboratorId) !== null && _e !== void 0 ? _e : null, normalizedCode, (_f = data.collaboratorType) !== null && _f !== void 0 ? _f : 'other', resolvedDisplayName, (_g = resolvedDepartment === null || resolvedDepartment === void 0 ? void 0 : resolvedDepartment.name) !== null && _g !== void 0 ? _g : null, (_h = resolvedDepartment === null || resolvedDepartment === void 0 ? void 0 : resolvedDepartment.id) !== null && _h !== void 0 ? _h : null, (_j = data.title) !== null && _j !== void 0 ? _j : null, (_k = data.levelLabel) !== null && _k !== void 0 ? _k : null, (_l = data.weeklyCapacityHours) !== null && _l !== void 0 ? _l : null, (_m = data.status) !== null && _m !== void 0 ? _m : 'active', (_o = data.joinedAt) !== null && _o !== void 0 ? _o : null, (_p = data.leftAt) !== null && _p !== void 0 ? _p : null, (_q = data.notes) !== null && _q !== void 0 ? _q : null));
+            const createdCollaboratorId = (_r = created[0]) === null || _r === void 0 ? void 0 : _r.id;
             await this.replaceCollaboratorScheduleDays(tx, createdCollaboratorId, data.weeklySchedule);
             if (data.autoGenerateContractDraft !== false) {
                 await this.createHiringContractDraft(tx, actor.userId, {
                     collaboratorId: createdCollaboratorId,
-                    collaboratorCode: data.code,
-                    displayName: data.displayName,
-                    collaboratorType: (_m = data.collaboratorType) !== null && _m !== void 0 ? _m : 'other',
-                    supervisorCollaboratorId: (_o = data.supervisorCollaboratorId) !== null && _o !== void 0 ? _o : null,
-                    startDate: (_p = data.joinedAt) !== null && _p !== void 0 ? _p : null,
-                    weeklyCapacityHours: (_q = data.weeklyCapacityHours) !== null && _q !== void 0 ? _q : null,
-                    compensationAmount: (_r = data.compensationAmount) !== null && _r !== void 0 ? _r : null,
-                    description: (_t = (_s = data.contractDescription) !== null && _s !== void 0 ? _s : data.notes) !== null && _t !== void 0 ? _t : null,
+                    collaboratorCode: normalizedCode,
+                    displayName: resolvedDisplayName,
+                    collaboratorType: (_s = data.collaboratorType) !== null && _s !== void 0 ? _s : 'other',
+                    supervisorCollaboratorId: (_t = data.supervisorCollaboratorId) !== null && _t !== void 0 ? _t : null,
+                    startDate: (_u = data.joinedAt) !== null && _u !== void 0 ? _u : null,
+                    weeklyCapacityHours: (_v = data.weeklyCapacityHours) !== null && _v !== void 0 ? _v : null,
+                    compensationAmount: (_w = data.compensationAmount) !== null && _w !== void 0 ? _w : null,
+                    description: (_y = (_x = data.contractDescription) !== null && _x !== void 0 ? _x : data.notes) !== null && _y !== void 0 ? _y : null,
                 });
             }
             return createdCollaboratorId;
@@ -387,24 +514,41 @@ let OperationsService = class OperationsService {
         return this.getCollaboratorByIdForUser(userId, collaboratorId);
     }
     async updateCollaborator(userId, collaboratorId, data) {
+        var _a, _b, _c, _d, _e;
         const actor = await this.getActorContext(userId);
         this.ensureDirector(actor);
         await this.getCollaboratorById(collaboratorId);
         const updates = [];
         const params = [];
+        const resolvedPerson = data.personId !== undefined && data.personId !== null
+            ? await this.getPersonById(Number(data.personId))
+            : null;
+        const resolvedDisplayName = (_d = (_b = (_a = resolvedPerson === null || resolvedPerson === void 0 ? void 0 : resolvedPerson.name) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : (_c = data.displayName) === null || _c === void 0 ? void 0 : _c.trim()) !== null && _d !== void 0 ? _d : undefined;
+        this.pushUpdate(updates, params, 'user_id', data.userId);
+        this.pushUpdate(updates, params, 'person_id', data.personId);
         this.pushUpdate(updates, params, 'supervisor_collaborator_id', data.supervisorCollaboratorId);
-        this.pushUpdate(updates, params, 'code', data.code);
-        this.pushUpdate(updates, params, 'collaborator_type', data.collaboratorType);
-        this.pushUpdate(updates, params, 'display_name', data.displayName);
-        this.pushUpdate(updates, params, 'department', data.department);
+        this.pushUpdate(updates, params, 'code', (_e = data.code) === null || _e === void 0 ? void 0 : _e.trim());
+        this.pushUpdate(updates, params, 'collaborator_type', data.collaboratorType, 'operations_collaborator_collaborator_type_7dd7b0ada2_enum');
+        if (data.personId !== undefined || data.displayName !== undefined) {
+            this.pushUpdate(updates, params, 'display_name', resolvedDisplayName !== null && resolvedDisplayName !== void 0 ? resolvedDisplayName : null);
+        }
         this.pushUpdate(updates, params, 'title', data.title);
         this.pushUpdate(updates, params, 'level_label', data.levelLabel);
         this.pushUpdate(updates, params, 'weekly_capacity_hours', data.weeklyCapacityHours);
-        this.pushUpdate(updates, params, 'status', data.status);
-        this.pushUpdate(updates, params, 'joined_at', data.joinedAt);
-        this.pushUpdate(updates, params, 'left_at', data.leftAt);
+        this.pushUpdate(updates, params, 'status', data.status, 'operations_collaborator_status_ef779877d4_enum');
+        this.pushUpdate(updates, params, 'joined_at', data.joinedAt, 'date');
+        this.pushUpdate(updates, params, 'left_at', data.leftAt, 'date');
         this.pushUpdate(updates, params, 'notes', data.notes);
         await this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c;
+            if (data.department !== undefined || data.departmentId !== undefined) {
+                const resolvedDepartment = await this.resolveDepartmentReference(tx, {
+                    departmentId: (_a = data.departmentId) !== null && _a !== void 0 ? _a : null,
+                    departmentName: data.department,
+                });
+                this.pushUpdate(updates, params, 'department', (_b = resolvedDepartment === null || resolvedDepartment === void 0 ? void 0 : resolvedDepartment.name) !== null && _b !== void 0 ? _b : null);
+                this.pushUpdate(updates, params, 'department_id', (_c = resolvedDepartment === null || resolvedDepartment === void 0 ? void 0 : resolvedDepartment.id) !== null && _c !== void 0 ? _c : null);
+            }
             if (updates.length) {
                 params.push(collaboratorId);
                 await tx.$executeRawUnsafe(`UPDATE operations_collaborator
@@ -418,6 +562,109 @@ let OperationsService = class OperationsService {
         });
         return this.getCollaboratorByIdForUser(userId, collaboratorId);
     }
+    async listDepartments(userId) {
+        const actor = await this.getActorContext(userId);
+        this.ensureCollaborator(actor);
+        return this.queryRows(`SELECT d.id,
+              d.slug,
+              d.code,
+              d.name,
+              d.description,
+              CASE WHEN d.deleted_at IS NULL THEN 'active' ELSE 'inactive' END AS status,
+              COUNT(DISTINCT c.id)::int AS "collaboratorCount",
+              d.created_at AS "createdAt",
+              d.updated_at AS "updatedAt"
+         FROM operations_department d
+         LEFT JOIN operations_collaborator c
+           ON c.deleted_at IS NULL
+          AND (
+            c.department_id = d.id
+            OR (
+              c.department_id IS NULL
+              AND LOWER(COALESCE(c.department, '')) = LOWER(d.name)
+            )
+          )
+        GROUP BY d.id
+        ORDER BY CASE WHEN d.deleted_at IS NULL THEN 0 ELSE 1 END ASC,
+                 d.name ASC`);
+    }
+    async createDepartment(userId, data) {
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        const name = this.normalizeOptionalText(data.name);
+        if (!name) {
+            throw new common_1.BadRequestException('Department name is required.');
+        }
+        return this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c, _d;
+            await this.assertDepartmentNameAvailable(tx, name);
+            const normalizedCode = (_b = (_a = this.normalizeOptionalText(data.code)) === null || _a === void 0 ? void 0 : _a.toUpperCase()) !== null && _b !== void 0 ? _b : null;
+            if (normalizedCode) {
+                await this.assertDepartmentCodeAvailable(tx, normalizedCode);
+            }
+            const created = (await tx.$queryRawUnsafe(`INSERT INTO operations_department (
+          slug,
+          code,
+          name,
+          description,
+          deleted_at,
+          created_at,
+          updated_at
+        ) VALUES (
+          $1, $2, $3, $4,
+          CASE WHEN $5 = 'inactive' THEN NOW() ELSE NULL END,
+          NOW(), NOW()
+        )
+        RETURNING id`, await this.generateUniqueDepartmentSlug(tx, name), normalizedCode, name, this.normalizeOptionalText(data.description), (_c = data.status) !== null && _c !== void 0 ? _c : 'active'));
+            const createdDepartmentId = (_d = created[0]) === null || _d === void 0 ? void 0 : _d.id;
+            if (!createdDepartmentId) {
+                throw new common_1.BadRequestException('Unable to create the department.');
+            }
+            return this.getDepartmentById(tx, createdDepartmentId, true);
+        });
+    }
+    async updateDepartment(userId, departmentId, data) {
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        return this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c, _d, _e, _f;
+            const current = await this.getDepartmentById(tx, departmentId, true);
+            const nextName = data.name !== undefined
+                ? this.normalizeOptionalText(data.name)
+                : current.name;
+            if (!nextName) {
+                throw new common_1.BadRequestException('Department name is required.');
+            }
+            if (String(nextName).toLowerCase() !== String(current.name).toLowerCase()) {
+                await this.assertDepartmentNameAvailable(tx, nextName, departmentId);
+            }
+            const nextCode = data.code !== undefined
+                ? (_b = (_a = this.normalizeOptionalText(data.code)) === null || _a === void 0 ? void 0 : _a.toUpperCase()) !== null && _b !== void 0 ? _b : null
+                : ((_c = current.code) !== null && _c !== void 0 ? _c : null);
+            if (nextCode) {
+                await this.assertDepartmentCodeAvailable(tx, nextCode, departmentId);
+            }
+            const nextDescription = data.description !== undefined
+                ? this.normalizeOptionalText(data.description)
+                : ((_d = current.description) !== null && _d !== void 0 ? _d : null);
+            const nextStatus = (_f = (_e = data.status) !== null && _e !== void 0 ? _e : current.status) !== null && _f !== void 0 ? _f : 'active';
+            const nextSlug = String(nextName).toLowerCase() !== String(current.name).toLowerCase()
+                ? await this.generateUniqueDepartmentSlug(tx, nextName, departmentId)
+                : current.slug;
+            await tx.$executeRawUnsafe(`UPDATE operations_department
+            SET slug = $1,
+                code = $2,
+                name = $3,
+                description = $4,
+                deleted_at = CASE
+                  WHEN $5 = 'inactive' THEN COALESCE(deleted_at, NOW())
+                  ELSE NULL
+                END,
+                updated_at = NOW()
+          WHERE id = $6`, nextSlug, nextCode, nextName, nextDescription, nextStatus, departmentId);
+            return this.getDepartmentById(tx, departmentId, true);
+        });
+    }
     async listProjects(userId) {
         const actor = await this.getActorContext(userId);
         const filter = this.buildIdFilter(actor.visibleProjectIds, 'p.id', actor.isDirector);
@@ -466,7 +713,7 @@ let OperationsService = class OperationsService {
         this.ensureDirector(actor);
         this.requireFields(data, ['code', 'name']);
         const createdProjectId = await this.prisma.$transaction(async (tx) => {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
             const created = await tx.$queryRawUnsafe(`INSERT INTO operations_project (
           contract_id,
           manager_collaborator_id,
@@ -483,8 +730,11 @@ let OperationsService = class OperationsService {
           created_at,
           updated_at
         ) VALUES (
-          $1, $2, $3, $4, $5, $6, COALESCE($7, 'planning'), $8,
-          COALESCE($9, 'project_delivery'), $10, $11, $12, NOW(), NOW()
+          $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()
         )
         RETURNING id`, (_a = data.contractId) !== null && _a !== void 0 ? _a : null, (_b = data.managerCollaboratorId) !== null && _b !== void 0 ? _b : null, data.code, data.name, (_c = data.clientName) !== null && _c !== void 0 ? _c : null, (_d = data.summary) !== null && _d !== void 0 ? _d : null, (_e = data.status) !== null && _e !== void 0 ? _e : 'planning', (_f = data.progressPercent) !== null && _f !== void 0 ? _f : null, (_g = data.deliveryModel) !== null && _g !== void 0 ? _g : 'project_delivery', (_h = data.budgetAmount) !== null && _h !== void 0 ? _h : null, (_j = data.startDate) !== null && _j !== void 0 ? _j : null, (_k = data.endDate) !== null && _k !== void 0 ? _k : null);
             const projectId = (_l = created[0]) === null || _l === void 0 ? void 0 : _l.id;
@@ -494,18 +744,19 @@ let OperationsService = class OperationsService {
             if (!data.contractId && data.autoGenerateContractDraft !== false) {
                 const contractId = await this.createProjectContractDraft(tx, actor.userId, {
                     projectId,
+                    contractTemplateId: (_o = data.contractTemplateId) !== null && _o !== void 0 ? _o : null,
                     projectCode: data.code,
                     projectName: data.name,
-                    clientName: (_o = data.clientName) !== null && _o !== void 0 ? _o : data.name,
-                    managerCollaboratorId: (_p = data.managerCollaboratorId) !== null && _p !== void 0 ? _p : null,
-                    startDate: (_q = data.startDate) !== null && _q !== void 0 ? _q : null,
-                    endDate: (_r = data.endDate) !== null && _r !== void 0 ? _r : null,
-                    budgetAmount: (_s = data.budgetAmount) !== null && _s !== void 0 ? _s : null,
-                    monthlyHourCap: (_t = data.monthlyHourCap) !== null && _t !== void 0 ? _t : null,
-                    billingModel: (_u = data.billingModel) !== null && _u !== void 0 ? _u : 'time_and_material',
-                    contractCode: (_v = data.contractCode) !== null && _v !== void 0 ? _v : null,
-                    contractName: (_w = data.contractName) !== null && _w !== void 0 ? _w : null,
-                    description: (_y = (_x = data.contractDescription) !== null && _x !== void 0 ? _x : data.summary) !== null && _y !== void 0 ? _y : null,
+                    clientName: (_p = data.clientName) !== null && _p !== void 0 ? _p : data.name,
+                    managerCollaboratorId: (_q = data.managerCollaboratorId) !== null && _q !== void 0 ? _q : null,
+                    startDate: (_r = data.startDate) !== null && _r !== void 0 ? _r : null,
+                    endDate: (_s = data.endDate) !== null && _s !== void 0 ? _s : null,
+                    budgetAmount: (_t = data.budgetAmount) !== null && _t !== void 0 ? _t : null,
+                    monthlyHourCap: (_u = data.monthlyHourCap) !== null && _u !== void 0 ? _u : null,
+                    billingModel: (_v = data.billingModel) !== null && _v !== void 0 ? _v : 'time_and_material',
+                    contractCode: (_w = data.contractCode) !== null && _w !== void 0 ? _w : null,
+                    contractName: (_x = data.contractName) !== null && _x !== void 0 ? _x : null,
+                    description: (_z = (_y = data.contractDescription) !== null && _y !== void 0 ? _y : data.summary) !== null && _z !== void 0 ? _z : null,
                 });
                 await tx.$executeRawUnsafe(`UPDATE operations_project
               SET contract_id = $1,
@@ -519,7 +770,7 @@ let OperationsService = class OperationsService {
     async updateProject(userId, projectId, data) {
         const actor = await this.getActorContext(userId);
         this.ensureDirector(actor);
-        await this.getProjectById(userId, projectId);
+        const currentProject = await this.getProjectById(userId, projectId);
         const updates = [];
         const params = [];
         this.pushUpdate(updates, params, 'contract_id', data.contractId);
@@ -528,13 +779,14 @@ let OperationsService = class OperationsService {
         this.pushUpdate(updates, params, 'name', data.name);
         this.pushUpdate(updates, params, 'client_name', data.clientName);
         this.pushUpdate(updates, params, 'summary', data.summary);
-        this.pushUpdate(updates, params, 'status', data.status);
+        this.pushUpdate(updates, params, 'status', data.status, 'operations_project_status_965e8d4b2d_enum');
         this.pushUpdate(updates, params, 'progress_percent', data.progressPercent);
-        this.pushUpdate(updates, params, 'delivery_model', data.deliveryModel);
+        this.pushUpdate(updates, params, 'delivery_model', data.deliveryModel, 'operations_project_delivery_model_75ee11b3b7_enum');
         this.pushUpdate(updates, params, 'budget_amount', data.budgetAmount);
-        this.pushUpdate(updates, params, 'start_date', data.startDate);
-        this.pushUpdate(updates, params, 'end_date', data.endDate);
+        this.pushUpdate(updates, params, 'start_date', data.startDate, 'date');
+        this.pushUpdate(updates, params, 'end_date', data.endDate, 'date');
         await this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6;
             if (updates.length) {
                 params.push(projectId);
                 await tx.$executeRawUnsafe(`UPDATE operations_project
@@ -545,9 +797,162 @@ let OperationsService = class OperationsService {
             if (data.teamAssignments) {
                 await this.replaceProjectAssignments(tx, projectId, data.teamAssignments);
             }
+            const nextContractId = data.contractId !== undefined
+                ? data.contractId
+                : ((_a = currentProject.contractId) !== null && _a !== void 0 ? _a : null);
+            const shouldGenerateDraft = !nextContractId && data.autoGenerateContractDraft === true;
+            if (shouldGenerateDraft) {
+                const contractId = await this.createProjectContractDraft(tx, actor.userId, {
+                    projectId,
+                    contractTemplateId: (_b = data.contractTemplateId) !== null && _b !== void 0 ? _b : null,
+                    projectCode: (_c = data.code) !== null && _c !== void 0 ? _c : currentProject.code,
+                    projectName: (_d = data.name) !== null && _d !== void 0 ? _d : currentProject.name,
+                    clientName: (_f = (_e = data.clientName) !== null && _e !== void 0 ? _e : currentProject.clientName) !== null && _f !== void 0 ? _f : currentProject.name,
+                    managerCollaboratorId: (_h = (_g = data.managerCollaboratorId) !== null && _g !== void 0 ? _g : currentProject.managerCollaboratorId) !== null && _h !== void 0 ? _h : null,
+                    startDate: (_k = (_j = data.startDate) !== null && _j !== void 0 ? _j : currentProject.startDate) !== null && _k !== void 0 ? _k : null,
+                    endDate: (_m = (_l = data.endDate) !== null && _l !== void 0 ? _l : currentProject.endDate) !== null && _m !== void 0 ? _m : null,
+                    budgetAmount: (_p = (_o = data.budgetAmount) !== null && _o !== void 0 ? _o : currentProject.budgetAmount) !== null && _p !== void 0 ? _p : null,
+                    monthlyHourCap: (_s = (_q = data.monthlyHourCap) !== null && _q !== void 0 ? _q : (_r = currentProject.relatedContract) === null || _r === void 0 ? void 0 : _r.monthlyHourCap) !== null && _s !== void 0 ? _s : null,
+                    billingModel: (_v = (_t = data.billingModel) !== null && _t !== void 0 ? _t : (_u = currentProject.relatedContract) === null || _u === void 0 ? void 0 : _u.billingModel) !== null && _v !== void 0 ? _v : 'time_and_material',
+                    contractCode: (_y = (_w = data.contractCode) !== null && _w !== void 0 ? _w : (_x = currentProject.relatedContract) === null || _x === void 0 ? void 0 : _x.code) !== null && _y !== void 0 ? _y : null,
+                    contractName: (_1 = (_z = data.contractName) !== null && _z !== void 0 ? _z : (_0 = currentProject.relatedContract) === null || _0 === void 0 ? void 0 : _0.name) !== null && _1 !== void 0 ? _1 : null,
+                    description: (_6 = (_5 = (_4 = (_2 = data.contractDescription) !== null && _2 !== void 0 ? _2 : (_3 = currentProject.relatedContract) === null || _3 === void 0 ? void 0 : _3.description) !== null && _4 !== void 0 ? _4 : data.summary) !== null && _5 !== void 0 ? _5 : currentProject.summary) !== null && _6 !== void 0 ? _6 : null,
+                });
+                await tx.$executeRawUnsafe(`UPDATE operations_project
+              SET contract_id = $1,
+                  updated_at = NOW()
+            WHERE id = $2`, contractId, projectId);
+            }
         });
         return this.getProjectById(userId, projectId);
     }
+    async listContractTemplates(userId) {
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        return this.queryRows(`SELECT t.id,
+              t.slug,
+              t.code,
+              t.name,
+              t.description,
+              t.contract_category AS "contractCategory",
+              t.contract_type AS "contractType",
+              t.billing_model AS "billingModel",
+              t.signature_status AS "signatureStatus",
+              t.is_active AS "isActive",
+              t.status,
+              t.content_html AS "contentHtml",
+              t.created_at AS "createdAt",
+              t.updated_at AS "updatedAt",
+              COUNT(DISTINCT c.id)::int AS "usageCount"
+         FROM operations_contract_template t
+         LEFT JOIN operations_contract c
+           ON c.contract_template_id = t.id
+          AND c.deleted_at IS NULL
+        WHERE t.deleted_at IS NULL
+        GROUP BY t.id
+        ORDER BY CASE
+                   WHEN t.status = 'active' THEN 0
+                   WHEN t.status = 'draft' THEN 1
+                   WHEN t.status = 'inactive' THEN 2
+                   ELSE 3
+                 END,
+                 t.name ASC`);
+    }
+    async getContractTemplateById(userId, templateId) {
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        return this.getContractTemplateRecord(this.prisma, templateId);
+    }
+    async createContractTemplate(userId, data) {
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        const name = this.normalizeOptionalText(data.name);
+        if (!name) {
+            throw new common_1.BadRequestException('Contract template name is required.');
+        }
+        return this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            await this.assertContractTemplateNameAvailable(tx, name);
+            const nextCode = (_b = (_a = this.normalizeOptionalText(data.code)) === null || _a === void 0 ? void 0 : _a.toUpperCase()) !== null && _b !== void 0 ? _b : null;
+            if (nextCode) {
+                await this.assertContractTemplateCodeAvailable(tx, nextCode);
+            }
+            const nextStatus = (_c = data.status) !== null && _c !== void 0 ? _c : 'active';
+            const isActive = (_d = data.isActive) !== null && _d !== void 0 ? _d : !['inactive', 'archived'].includes(nextStatus);
+            const created = (await tx.$queryRawUnsafe(`INSERT INTO operations_contract_template (
+          slug,
+          code,
+          name,
+          description,
+          contract_category,
+          contract_type,
+          billing_model,
+          signature_status,
+          is_active,
+          status,
+          content_html,
+          created_at,
+          updated_at
+        ) VALUES (
+          $1, $2, $3, $4,
+          $5, $6, $7, $8, $9, $10, $11,
+          NOW(), NOW()
+        )
+        RETURNING id`, await this.generateUniqueContractTemplateSlug(tx, name), nextCode, name, this.normalizeOptionalText(data.description), (_e = data.contractCategory) !== null && _e !== void 0 ? _e : 'client', (_f = data.contractType) !== null && _f !== void 0 ? _f : 'service_agreement', (_g = data.billingModel) !== null && _g !== void 0 ? _g : 'time_and_material', (_h = data.signatureStatus) !== null && _h !== void 0 ? _h : 'not_started', isActive, nextStatus, this.normalizeOptionalText(data.contentHtml)));
+            const templateId = (_j = created[0]) === null || _j === void 0 ? void 0 : _j.id;
+            if (!templateId) {
+                throw new common_1.BadRequestException('Unable to create the contract template.');
+            }
+            return this.getContractTemplateRecord(tx, templateId, true);
+        });
+    }
+    async updateContractTemplate(userId, templateId, data) {
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        return this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+            const current = await this.getContractTemplateRecord(tx, templateId, true);
+            const nextName = data.name !== undefined
+                ? this.normalizeOptionalText(data.name)
+                : current.name;
+            if (!nextName) {
+                throw new common_1.BadRequestException('Contract template name is required.');
+            }
+            if (String(nextName).toLowerCase() !== String(current.name).toLowerCase()) {
+                await this.assertContractTemplateNameAvailable(tx, nextName, templateId);
+            }
+            const nextCode = data.code !== undefined
+                ? (_b = (_a = this.normalizeOptionalText(data.code)) === null || _a === void 0 ? void 0 : _a.toUpperCase()) !== null && _b !== void 0 ? _b : null
+                : ((_c = current.code) !== null && _c !== void 0 ? _c : null);
+            if (nextCode) {
+                await this.assertContractTemplateCodeAvailable(tx, nextCode, templateId);
+            }
+            const nextStatus = (_e = (_d = data.status) !== null && _d !== void 0 ? _d : current.status) !== null && _e !== void 0 ? _e : 'active';
+            const nextIsActive = (_f = data.isActive) !== null && _f !== void 0 ? _f : !['inactive', 'archived'].includes(nextStatus);
+            const nextSlug = String(nextName).toLowerCase() !== String(current.name).toLowerCase()
+                ? await this.generateUniqueContractTemplateSlug(tx, nextName, templateId)
+                : current.slug;
+            await tx.$executeRawUnsafe(`UPDATE operations_contract_template
+            SET slug = $1,
+                code = $2,
+                name = $3,
+                description = $4,
+                contract_category = $5,
+                contract_type = $6,
+                billing_model = $7,
+                signature_status = $8,
+                is_active = $9,
+                status = $10,
+                content_html = $11,
+                updated_at = NOW()
+          WHERE id = $12`, nextSlug, nextCode, nextName, data.description !== undefined
+                ? this.normalizeOptionalText(data.description)
+                : ((_g = current.description) !== null && _g !== void 0 ? _g : null), (_j = (_h = data.contractCategory) !== null && _h !== void 0 ? _h : current.contractCategory) !== null && _j !== void 0 ? _j : 'client', (_l = (_k = data.contractType) !== null && _k !== void 0 ? _k : current.contractType) !== null && _l !== void 0 ? _l : 'service_agreement', (_o = (_m = data.billingModel) !== null && _m !== void 0 ? _m : current.billingModel) !== null && _o !== void 0 ? _o : 'time_and_material', (_q = (_p = data.signatureStatus) !== null && _p !== void 0 ? _p : current.signatureStatus) !== null && _q !== void 0 ? _q : 'not_started', nextIsActive, nextStatus, data.contentHtml !== undefined
+                ? this.normalizeOptionalText(data.contentHtml)
+                : ((_r = current.contentHtml) !== null && _r !== void 0 ? _r : null), templateId);
+            return this.getContractTemplateRecord(tx, templateId, true);
+        });
+    }
     async listContracts(userId) {
         const actor = await this.getActorContext(userId);
         const params = [];
@@ -574,6 +979,10 @@ let OperationsService = class OperationsService {
               c.billing_model AS "billingModel",
               c.account_manager_collaborator_id AS "accountManagerCollaboratorId",
               c.related_collaborator_id AS "relatedCollaboratorId",
+              c.contract_template_id AS "contractTemplateId",
+              template.name AS "contractTemplateName",
+              template.slug AS "contractTemplateSlug",
+              template.code AS "contractTemplateCode",
               c.origin_type AS "originType",
               c.origin_id AS "originId",
               c.start_date AS "startDate",
@@ -583,19 +992,23 @@ let OperationsService = class OperationsService {
               c.budget_amount AS "budgetAmount",
               c.monthly_hour_cap AS "monthlyHourCap",
               c.status,
+              c.creation_mode AS "creationMode",
+              c.wizard_step AS "wizardStep",
               c.description,
               m.display_name AS "accountManagerName",
               linked.display_name AS "relatedCollaboratorName",
-              COALESCE(primary_party.display_name, linked.display_name, c.client_name) AS "mainRelatedPartyName",
-              COALESCE(financials.value_amount, 0) AS "valueAmount",
-              COALESCE(financials.payment_amount, 0) AS "paymentAmount",
-              COALESCE(financials.revenue_amount, 0) AS "revenueAmount",
-              COALESCE(financials.fine_amount, 0) AS "fineAmount",
-              COALESCE(pdf_document.file_name, '') AS "currentPdfFileName",
+              MAX(COALESCE(primary_party.display_name, linked.display_name, c.client_name)) AS "mainRelatedPartyName",
+              MAX(COALESCE(financials.value_amount, 0)) AS "valueAmount",
+              MAX(COALESCE(financials.payment_amount, 0)) AS "paymentAmount",
+              MAX(COALESCE(financials.revenue_amount, 0)) AS "revenueAmount",
+              MAX(COALESCE(financials.fine_amount, 0)) AS "fineAmount",
+              MAX(COALESCE(pdf_document.file_name, '')) AS "currentPdfFileName",
               COUNT(DISTINCT p.id)::int AS "projectCount"
          FROM operations_contract c
          LEFT JOIN operations_collaborator m ON m.id = c.account_manager_collaborator_id
          LEFT JOIN operations_collaborator linked ON linked.id = c.related_collaborator_id
+         LEFT JOIN operations_contract_template template
+           ON template.id = c.contract_template_id
          LEFT JOIN LATERAL (
            SELECT cp.display_name
              FROM operations_contract_party cp
@@ -620,7 +1033,7 @@ let OperationsService = class OperationsService {
             WHERE cd.contract_id = c.id
               AND cd.deleted_at IS NULL
               AND cd.is_current = true
-              AND cd.document_type IN ('uploaded_pdf', 'generated_pdf')
+              AND cd.document_type IN ('source_upload', 'generated_pdf')
             ORDER BY cd.id DESC
             LIMIT 1
          ) pdf_document ON TRUE
@@ -628,8 +1041,8 @@ let OperationsService = class OperationsService {
            ON p.contract_id = c.id
           AND p.deleted_at IS NULL
         WHERE ${accessClause}
-        GROUP BY c.id, m.id, linked.id
-        ORDER BY c.name ASC`, params);
+        GROUP BY c.id, m.id, linked.id, template.id
+        ORDER BY COALESCE(c.name, c.code, CONCAT('draft-', c.id)) ASC`, params);
     }
     async getContractById(userId, contractId) {
         var _a, _b, _c;
@@ -645,6 +1058,10 @@ let OperationsService = class OperationsService {
               c.billing_model AS "billingModel",
               c.account_manager_collaborator_id AS "accountManagerCollaboratorId",
               c.related_collaborator_id AS "relatedCollaboratorId",
+              c.contract_template_id AS "contractTemplateId",
+              template.name AS "contractTemplateName",
+              template.slug AS "contractTemplateSlug",
+              template.code AS "contractTemplateCode",
               c.origin_type AS "originType",
               c.origin_id AS "originId",
               c.start_date AS "startDate",
@@ -654,6 +1071,8 @@ let OperationsService = class OperationsService {
               c.budget_amount AS "budgetAmount",
               c.monthly_hour_cap AS "monthlyHourCap",
               c.status,
+              c.creation_mode AS "creationMode",
+              c.wizard_step AS "wizardStep",
               c.description,
               c.content_html AS "contentHtml",
               m.display_name AS "accountManagerName",
@@ -661,6 +1080,8 @@ let OperationsService = class OperationsService {
          FROM operations_contract c
          LEFT JOIN operations_collaborator m ON m.id = c.account_manager_collaborator_id
          LEFT JOIN operations_collaborator linked ON linked.id = c.related_collaborator_id
+         LEFT JOIN operations_contract_template template
+           ON template.id = c.contract_template_id
         WHERE c.id = $1
           AND c.deleted_at IS NULL`, [contractId]);
         if (!contract) {
@@ -739,10 +1160,13 @@ let OperationsService = class OperationsService {
             ORDER BY id ASC`, [contractId]),
             this.queryRows(`SELECT id,
                   document_type AS "documentType",
+                  file_id AS "fileId",
                   file_name AS "fileName",
                   mime_type AS "mimeType",
                   file_content_base64 AS "fileContentBase64",
                   is_current AS "isCurrent",
+                  extraction_status AS "extractionStatus",
+                  extraction_summary AS "extractionSummary",
                   notes,
                   created_at AS "createdAt"
              FROM operations_contract_document
@@ -781,9 +1205,9 @@ let OperationsService = class OperationsService {
     async createContract(userId, data) {
         const actor = await this.getActorContext(userId);
         this.ensureDirector(actor);
-        this.requireFields(data, ['code', 'name', 'clientName', 'startDate']);
         const createdId = await this.prisma.$transaction(async (tx) => {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
+            const normalizedCode = (_b = (_a = this.normalizeOptionalText(data.code)) === null || _a === void 0 ? void 0 : _a.toUpperCase()) !== null && _b !== void 0 ? _b : (await this.generateContractCode(tx));
             const created = await tx.$queryRawUnsafe(`INSERT INTO operations_contract (
           code,
           name,
@@ -795,6 +1219,7 @@ let OperationsService = class OperationsService {
           billing_model,
           account_manager_collaborator_id,
           related_collaborator_id,
+          contract_template_id,
           origin_type,
           origin_id,
           start_date,
@@ -804,23 +1229,42 @@ let OperationsService = class OperationsService {
           budget_amount,
           monthly_hour_cap,
           status,
+          creation_mode,
+          wizard_step,
           description,
           content_html,
           created_at,
           updated_at
         ) VALUES (
-          $1, $2, COALESCE($3, 'client'), COALESCE($4, 'service_agreement'), $5, COALESCE($6, 'not_started'),
-          COALESCE($7, true), COALESCE($8, 'time_and_material'), $9, $10, COALESCE($11, 'manual'), $12, $13,
-          $14, $15, $16, $17, $18, COALESCE($19, 'draft'), $20, $21, NOW(), NOW()
+          $1, $2,
+          $3::operations_contract_contract_category_70d553ea09_enum,
+          $4::operations_contract_contract_type_48331e2ebf_enum,
+          $5,
+          $6::operations_contract_signature_status_2cb7282a7b_enum,
+          $7,
+          $8::operations_contract_billing_model_409dc7fea2_enum,
+          $9,
+          $10,
+          $11,
+          $12::operations_contract_origin_type_07a7cc2b5d_enum,
+          $13,
+          $14::date,
+          $15::date, $16::date, $17::date, $18, $19,
+          $20::operations_contract_status_a0395962df_enum,
+          $21::operations_contract_creation_mode_98ba669209_enum,
+          $22,
+          $23,
+          $24,
+          NOW(), NOW()
         )
-        RETURNING id`, data.code, data.name, (_a = data.contractCategory) !== null && _a !== void 0 ? _a : 'client', (_b = data.contractType) !== null && _b !== void 0 ? _b : 'service_agreement', data.clientName, (_c = data.signatureStatus) !== null && _c !== void 0 ? _c : 'not_started', (_d = data.isActive) !== null && _d !== void 0 ? _d : true, (_e = data.billingModel) !== null && _e !== void 0 ? _e : 'time_and_material', (_f = data.accountManagerCollaboratorId) !== null && _f !== void 0 ? _f : null, (_g = data.relatedCollaboratorId) !== null && _g !== void 0 ? _g : null, (_h = data.originType) !== null && _h !== void 0 ? _h : 'manual', (_j = data.originId) !== null && _j !== void 0 ? _j : null, data.startDate, (_k = data.endDate) !== null && _k !== void 0 ? _k : null, (_l = data.signedAt) !== null && _l !== void 0 ? _l : null, (_m = data.effectiveDate) !== null && _m !== void 0 ? _m : data.startDate, (_o = data.budgetAmount) !== null && _o !== void 0 ? _o : null, (_p = data.monthlyHourCap) !== null && _p !== void 0 ? _p : null, (_q = data.status) !== null && _q !== void 0 ? _q : 'draft', (_r = data.description) !== null && _r !== void 0 ? _r : null, (_s = data.contentHtml) !== null && _s !== void 0 ? _s : null);
-            const contractId = (_t = created[0]) === null || _t === void 0 ? void 0 : _t.id;
+        RETURNING id`, normalizedCode, this.normalizeOptionalText(data.name), (_c = data.contractCategory) !== null && _c !== void 0 ? _c : 'client', (_d = data.contractType) !== null && _d !== void 0 ? _d : 'service_agreement', this.normalizeOptionalText(data.clientName), (_e = data.signatureStatus) !== null && _e !== void 0 ? _e : 'not_started', (_f = data.isActive) !== null && _f !== void 0 ? _f : true, (_g = data.billingModel) !== null && _g !== void 0 ? _g : 'time_and_material', (_h = data.accountManagerCollaboratorId) !== null && _h !== void 0 ? _h : null, (_j = data.relatedCollaboratorId) !== null && _j !== void 0 ? _j : null, (_k = data.contractTemplateId) !== null && _k !== void 0 ? _k : null, (_l = data.originType) !== null && _l !== void 0 ? _l : 'manual', (_m = data.originId) !== null && _m !== void 0 ? _m : null, this.normalizeOptionalText((_o = data.startDate) !== null && _o !== void 0 ? _o : null), (_p = data.endDate) !== null && _p !== void 0 ? _p : null, (_q = data.signedAt) !== null && _q !== void 0 ? _q : null, (_s = (_r = data.effectiveDate) !== null && _r !== void 0 ? _r : data.startDate) !== null && _s !== void 0 ? _s : null, (_t = data.budgetAmount) !== null && _t !== void 0 ? _t : null, (_u = data.monthlyHourCap) !== null && _u !== void 0 ? _u : null, (_v = data.status) !== null && _v !== void 0 ? _v : 'draft', (_w = data.creationMode) !== null && _w !== void 0 ? _w : 'blank', (_x = data.wizardStep) !== null && _x !== void 0 ? _x : 0, (_y = data.description) !== null && _y !== void 0 ? _y : null, (_z = data.contentHtml) !== null && _z !== void 0 ? _z : null);
+            const contractId = (_0 = created[0]) === null || _0 === void 0 ? void 0 : _0.id;
             await this.replaceContractParties(tx, contractId, data.parties);
             await this.replaceContractSignatures(tx, contractId, data.signatures);
             await this.replaceContractFinancialTerms(tx, contractId, data.financialTerms);
             await this.replaceContractRevisions(tx, contractId, data.revisions);
             if (data.replaceUploadedPdfDocument) {
-                await this.replaceContractPdfDocument(tx, contractId, data.replaceUploadedPdfDocument);
+                await this.replaceContractDocument(tx, contractId, 'source_upload', data.replaceUploadedPdfDocument);
             }
             await this.insertContractHistory(tx, contractId, userId, 'created', data.originType === 'manual'
                 ? 'Manual contract created from registry.'
@@ -829,34 +1273,642 @@ let OperationsService = class OperationsService {
         });
         return this.getContractById(userId, createdId);
     }
+    async createContractDraft(userId, data) {
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        const creationMode = this.normalizeEnumValue(data.creationMode, CONTRACT_CREATION_MODE_VALUES, 'blank');
+        const selectedTemplate = data.templateId && data.templateId > 0
+            ? await this.getContractTemplateById(userId, data.templateId)
+            : null;
+        const duplicateSource = data.duplicateFromId && data.duplicateFromId > 0
+            ? await this.getContractById(userId, data.duplicateFromId)
+            : null;
+        const storedSourceFile = data.sourceFileId && data.sourceFileId > 0
+            ? await this.prisma.file.findUnique({
+                where: { id: data.sourceFileId },
+                include: { file_mimetype: true },
+            })
+            : null;
+        if (data.sourceFileId && !storedSourceFile) {
+            throw new common_1.NotFoundException('Source contract file not found.');
+        }
+        const createdId = await this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16;
+            const generatedCode = await this.generateContractCode(tx);
+            const duplicateNameBase = (_b = (_a = this.normalizeOptionalText(duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.name)) !== null && _a !== void 0 ? _a : this.normalizeOptionalText(duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.code)) !== null && _b !== void 0 ? _b : 'Contract';
+            const created = await tx.$queryRawUnsafe(`INSERT INTO operations_contract (
+          code,
+          name,
+          contract_category,
+          contract_type,
+          client_name,
+          signature_status,
+          is_active,
+          billing_model,
+          account_manager_collaborator_id,
+          related_collaborator_id,
+          contract_template_id,
+          origin_type,
+          origin_id,
+          start_date,
+          end_date,
+          signed_at,
+          effective_date,
+          budget_amount,
+          monthly_hour_cap,
+          status,
+          creation_mode,
+          wizard_step,
+          description,
+          content_html,
+          created_by_user_id,
+          updated_by_user_id,
+          created_at,
+          updated_at
+        ) VALUES (
+          $1,
+          $2,
+          $3::operations_contract_contract_category_70d553ea09_enum,
+          $4::operations_contract_contract_type_48331e2ebf_enum,
+          $5,
+          $6::operations_contract_signature_status_2cb7282a7b_enum,
+          $7,
+          $8::operations_contract_billing_model_409dc7fea2_enum,
+          $9,
+          $10,
+          $11,
+          $12::operations_contract_origin_type_07a7cc2b5d_enum,
+          $13,
+          $14::date,
+          $15::date,
+          $16::date,
+          $17::date,
+          $18,
+          $19,
+          $20::operations_contract_status_a0395962df_enum,
+          $21::operations_contract_creation_mode_98ba669209_enum,
+          $22,
+          $23,
+          $24,
+          $25,
+          $25,
+          NOW(),
+          NOW()
+        )
+        RETURNING id`, generatedCode, creationMode === 'duplicate'
+                ? `${duplicateNameBase} Copy`
+                : this.normalizeOptionalText(selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.name), (_d = (_c = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.contractCategory) !== null && _c !== void 0 ? _c : selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.contractCategory) !== null && _d !== void 0 ? _d : 'client', (_f = (_e = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.contractType) !== null && _e !== void 0 ? _e : selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.contractType) !== null && _f !== void 0 ? _f : 'service_agreement', this.normalizeOptionalText(duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.clientName), (_h = (_g = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.signatureStatus) !== null && _g !== void 0 ? _g : selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.signatureStatus) !== null && _h !== void 0 ? _h : 'not_started', (_j = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.isActive) !== null && _j !== void 0 ? _j : true, (_l = (_k = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.billingModel) !== null && _k !== void 0 ? _k : selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.billingModel) !== null && _l !== void 0 ? _l : 'time_and_material', (_m = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.accountManagerCollaboratorId) !== null && _m !== void 0 ? _m : null, (_o = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.relatedCollaboratorId) !== null && _o !== void 0 ? _o : null, (_q = (_p = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.contractTemplateId) !== null && _p !== void 0 ? _p : selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.id) !== null && _q !== void 0 ? _q : null, (_r = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.originType) !== null && _r !== void 0 ? _r : 'manual', (_s = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.originId) !== null && _s !== void 0 ? _s : null, (_t = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.startDate) !== null && _t !== void 0 ? _t : null, (_u = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.endDate) !== null && _u !== void 0 ? _u : null, (_v = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.signedAt) !== null && _v !== void 0 ? _v : null, (_w = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.effectiveDate) !== null && _w !== void 0 ? _w : null, (_x = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.budgetAmount) !== null && _x !== void 0 ? _x : null, (_y = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.monthlyHourCap) !== null && _y !== void 0 ? _y : null, 'draft', creationMode, creationMode === 'upload' ? 0 : creationMode === 'blank' ? 0 : 1, (_0 = (_z = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.description) !== null && _z !== void 0 ? _z : selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.description) !== null && _0 !== void 0 ? _0 : null, (_2 = (_1 = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.contentHtml) !== null && _1 !== void 0 ? _1 : selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.contentHtml) !== null && _2 !== void 0 ? _2 : null, userId);
+            const contractId = (_3 = created[0]) === null || _3 === void 0 ? void 0 : _3.id;
+            if (duplicateSource) {
+                await this.replaceContractParties(tx, contractId, duplicateSource.parties);
+                await this.replaceContractSignatures(tx, contractId, duplicateSource.signatures);
+                await this.replaceContractFinancialTerms(tx, contractId, duplicateSource.financialTerms);
+                await this.replaceContractRevisions(tx, contractId, duplicateSource.revisions);
+                const currentSourceDocument = (_4 = duplicateSource.documents.find((document) => document.isCurrent && document.documentType === 'source_upload')) !== null && _4 !== void 0 ? _4 : null;
+                if (currentSourceDocument) {
+                    await this.replaceContractDocument(tx, contractId, 'source_upload', {
+                        fileId: (_5 = currentSourceDocument.fileId) !== null && _5 !== void 0 ? _5 : null,
+                        fileName: currentSourceDocument.fileName,
+                        mimeType: currentSourceDocument.mimeType,
+                        fileContentBase64: (_6 = currentSourceDocument.fileContentBase64) !== null && _6 !== void 0 ? _6 : null,
+                        notes: (_7 = currentSourceDocument.notes) !== null && _7 !== void 0 ? _7 : null,
+                        extractionStatus: (_8 = currentSourceDocument.extractionStatus) !== null && _8 !== void 0 ? _8 : 'skipped',
+                        extractionSummary: (_9 = currentSourceDocument.extractionSummary) !== null && _9 !== void 0 ? _9 : null,
+                    });
+                }
+            }
+            if (storedSourceFile) {
+                await this.replaceContractDocument(tx, contractId, 'source_upload', {
+                    fileId: storedSourceFile.id,
+                    fileName: (_10 = this.normalizeOptionalText(data.sourceFileName)) !== null && _10 !== void 0 ? _10 : storedSourceFile.filename,
+                    mimeType: (_13 = (_11 = this.normalizeOptionalText(data.sourceMimeType)) !== null && _11 !== void 0 ? _11 : (_12 = storedSourceFile.file_mimetype) === null || _12 === void 0 ? void 0 : _12.name) !== null && _13 !== void 0 ? _13 : 'application/pdf',
+                    notes: 'Source contract document uploaded during draft creation.',
+                    extractionStatus: 'pending',
+                    extractionSummary: null,
+                });
+            }
+            await this.insertContractHistory(tx, contractId, userId, 'draft_created', `Contract draft created with mode ${creationMode}.`, JSON.stringify({
+                creationMode,
+                templateId: (_14 = selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.id) !== null && _14 !== void 0 ? _14 : null,
+                duplicateFromId: (_15 = duplicateSource === null || duplicateSource === void 0 ? void 0 : duplicateSource.id) !== null && _15 !== void 0 ? _15 : null,
+                sourceFileId: (_16 = storedSourceFile === null || storedSourceFile === void 0 ? void 0 : storedSourceFile.id) !== null && _16 !== void 0 ? _16 : null,
+            }));
+            return contractId;
+        });
+        return this.getContractById(userId, createdId);
+    }
+    async extractContractSource(userId, contractId, data) {
+        var _a, _b;
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        const contract = await this.getContractById(userId, contractId);
+        const sourceDocument = contract.documents.find((document) => document.isCurrent && document.documentType === 'source_upload');
+        if (!sourceDocument) {
+            throw new common_1.BadRequestException('No source document is attached to this contract draft.');
+        }
+        await this.prisma.$executeRawUnsafe(`UPDATE operations_contract_document
+          SET extraction_status = 'processing',
+              updated_at = NOW()
+        WHERE id = $1`, sourceDocument.id);
+        try {
+            const extracted = await this.extractContractDraft(userId, {
+                contractId,
+                provider: (_a = data.provider) !== null && _a !== void 0 ? _a : null,
+                promptMessage: (_b = data.promptMessage) !== null && _b !== void 0 ? _b : null,
+            });
+            await this.prisma.$executeRawUnsafe(`UPDATE operations_contract_document
+            SET extraction_status = 'completed',
+                extraction_summary = $2,
+                updated_at = NOW()
+          WHERE id = $1`, sourceDocument.id, extracted.summary || extracted.description || extracted.name || null);
+            await this.insertContractHistory(this.prisma, contractId, userId, 'source_extracted', 'Source contract document extracted with AI.');
+            return extracted;
+        }
+        catch (error) {
+            await this.prisma.$executeRawUnsafe(`UPDATE operations_contract_document
+            SET extraction_status = 'failed',
+                updated_at = NOW()
+          WHERE id = $1`, sourceDocument.id);
+            throw error;
+        }
+    }
+    async generateContractContent(userId, contractId, data = {}) {
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        const contract = await this.getContractById(userId, contractId);
+        const contentHtml = await this.generateContractContentHtml(contract, data);
+        await this.prisma.$transaction(async (tx) => {
+            var _a;
+            await tx.$executeRawUnsafe(`UPDATE operations_contract
+            SET content_html = $2,
+                wizard_step = CASE
+                  WHEN COALESCE(wizard_step, 0) < 4 THEN 4
+                  ELSE wizard_step
+                END,
+                updated_by_user_id = $3,
+                updated_at = NOW()
+          WHERE id = $1`, contractId, contentHtml, userId);
+            await this.insertContractHistory(tx, contractId, userId, 'content_generated', 'Contract content generated automatically for editing.', JSON.stringify({
+                provider: (_a = data.provider) !== null && _a !== void 0 ? _a : null,
+                overwrite: Boolean(data.overwrite),
+                hasPrompt: Boolean(this.normalizeOptionalText(data.promptMessage)),
+            }));
+        });
+        return this.getContractById(userId, contractId);
+    }
+    async reviewContractLegally(userId, contractId, data = {}) {
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        const contract = await this.getContractById(userId, contractId);
+        const review = await this.buildContractLegalReview(contract, data);
+        await this.insertContractHistory(this.prisma, contractId, userId, 'legal_reviewed', 'Advisory legal checklist updated for this contract.', JSON.stringify(review));
+        return review;
+    }
+    async generateContractPdf(userId, contractId) {
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        const contract = await this.getContractById(userId, contractId);
+        const pdfBuffer = await this.renderContractPdfBuffer(contract);
+        const fileName = this.buildContractPdfFileName(contract);
+        const uploadedFile = await this.fileService.upload('operations/contracts/generated', {
+            fieldname: 'file',
+            originalname: fileName,
+            encoding: '7bit',
+            mimetype: 'application/pdf',
+            size: pdfBuffer.length,
+            destination: '',
+            filename: fileName,
+            path: '',
+            buffer: pdfBuffer,
+        });
+        await this.prisma.$transaction(async (tx) => {
+            await this.replaceContractDocument(tx, contractId, 'generated_pdf', {
+                fileId: uploadedFile.id,
+                fileName,
+                mimeType: 'application/pdf',
+                notes: 'PDF generated from contract rich text content.',
+                extractionStatus: 'skipped',
+                extractionSummary: null,
+            });
+            await this.insertContractHistory(tx, contractId, userId, 'pdf_generated', 'Generated a branded PDF version of the contract.');
+        });
+        return {
+            contractId,
+            fileId: uploadedFile.id,
+            fileName,
+            mimeType: 'application/pdf',
+            documentType: 'generated_pdf',
+            downloadUrl: `/file/open/${uploadedFile.id}`,
+        };
+    }
+    async extractContractDraft(userId, data) {
+        var _a;
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        const uploadFile = await this.resolveContractExtractionFile(userId, data);
+        const aiResult = await this.aiService.chat({
+            provider: data.provider === 'gemini' ? 'gemini' : 'openai',
+            model: data.provider === 'gemini' ? 'gemini-1.5-flash' : 'gpt-4o-mini',
+            message: this.normalizeExtractionString(data.promptMessage) ||
+                'Analyze the attached contract and extract a structured draft for the contract form.',
+            systemPrompt: this.buildContractExtractionSystemPrompt(),
+        }, uploadFile);
+        const parsed = this.parseAiJsonPayload(String((_a = aiResult === null || aiResult === void 0 ? void 0 : aiResult.content) !== null && _a !== void 0 ? _a : ''));
+        const draft = this.normalizeContractExtractDraft(parsed);
+        const warnings = [...draft.warnings];
+        if (uploadFile.mimetype === 'application/msword' ||
+            uploadFile.mimetype ===
+                'application/vnd.openxmlformats-officedocument.wordprocessingml.document') {
+            warnings.push('Word extraction is best-effort. Review names, dates, and values before saving.');
+        }
+        return Object.assign(Object.assign({}, draft), { warnings: Array.from(new Set(warnings.filter(Boolean))) });
+    }
+    async createContractFromProposalIntegration(payload) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
+        const sourceEntityId = String(payload.proposalId || '').trim();
+        if (!sourceEntityId) {
+            throw new common_1.BadRequestException('proposalId is required for CRM proposal integration.');
+        }
+        const proposal = payload.proposal || {
+            code: (_a = payload.code) !== null && _a !== void 0 ? _a : null,
+            title: (_b = payload.title) !== null && _b !== void 0 ? _b : null,
+            contractCategory: (_d = (_c = payload.commercialTerms) === null || _c === void 0 ? void 0 : _c.contractCategory) !== null && _d !== void 0 ? _d : 'client',
+            contractType: (_f = (_e = payload.commercialTerms) === null || _e === void 0 ? void 0 : _e.contractType) !== null && _f !== void 0 ? _f : 'service_agreement',
+            billingModel: (_h = (_g = payload.commercialTerms) === null || _g === void 0 ? void 0 : _g.billingModel) !== null && _h !== void 0 ? _h : 'fixed_price',
+            validFrom: (_k = (_j = payload.commercialTerms) === null || _j === void 0 ? void 0 : _j.validFrom) !== null && _k !== void 0 ? _k : null,
+            validUntil: (_o = (_l = payload.validUntil) !== null && _l !== void 0 ? _l : (_m = payload.commercialTerms) === null || _m === void 0 ? void 0 : _m.validUntil) !== null && _o !== void 0 ? _o : null,
+            totalAmount: (_p = payload.total) !== null && _p !== void 0 ? _p : null,
+            totalAmountCents: payload.total != null ? Math.round(Number(payload.total) * 100) : null,
+            notes: (_r = (_q = payload.commercialTerms) === null || _q === void 0 ? void 0 : _q.notes) !== null && _r !== void 0 ? _r : null,
+        };
+        const person = payload.person || {};
+        const items = Array.isArray(payload.items) ? payload.items : [];
+        const contractCategory = (_s = proposal.contractCategory) !== null && _s !== void 0 ? _s : 'client';
+        const contractType = (_t = proposal.contractType) !== null && _t !== void 0 ? _t : 'service_agreement';
+        const billingModel = (_u = proposal.billingModel) !== null && _u !== void 0 ? _u : 'fixed_price';
+        const clientName = (_x = (_w = (_v = this.normalizeOptionalText(person.tradeName)) !== null && _v !== void 0 ? _v : this.normalizeOptionalText(person.name)) !== null && _w !== void 0 ? _w : this.normalizeOptionalText(proposal.title)) !== null && _x !== void 0 ? _x : `Proposal ${sourceEntityId}`;
+        const contractName = (_y = this.normalizeOptionalText(proposal.title)) !== null && _y !== void 0 ? _y : `Proposal ${sourceEntityId}`;
+        const financialTerms = items
+            .map((item) => {
+            var _a, _b, _c;
+            return ({
+                termType: this.normalizeEnumValue(item.termType, FINANCIAL_TERM_TYPE_VALUES, 'value'),
+                label: (_a = this.normalizeOptionalText(item.name)) !== null && _a !== void 0 ? _a : 'Commercial term',
+                amount: Number((_b = item.amount) !== null && _b !== void 0 ? _b : Number(item.totalAmountCents || 0) / 100),
+                recurrence: this.normalizeEnumValue(item.recurrence, RECURRENCE_VALUES, 'one_time'),
+                dueDay: (_c = item.dueDay) !== null && _c !== void 0 ? _c : null,
+                notes: this.normalizeOptionalText(item.description),
+            });
+        })
+            .filter((term) => Number.isFinite(term.amount) && term.amount > 0);
+        const fallbackAmount = Number((_z = proposal.totalAmount) !== null && _z !== void 0 ? _z : 0);
+        if (financialTerms.length === 0 && Number.isFinite(fallbackAmount) && fallbackAmount > 0) {
+            financialTerms.push({
+                termType: 'revenue',
+                label: contractName,
+                amount: fallbackAmount,
+                recurrence: 'one_time',
+                dueDay: null,
+                notes: this.normalizeOptionalText(proposal.notes),
+            });
+        }
+        const primaryPartyRole = ['employee', 'contractor'].includes(contractCategory)
+            ? 'employee'
+            : ['supplier', 'vendor'].includes(contractCategory)
+                ? 'supplier'
+                : contractCategory === 'partner'
+                    ? 'partner'
+                    : 'client';
+        return this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+            await tx.$queryRawUnsafe(`SELECT pg_advisory_xact_lock(hashtext($1))`, `operations:crm_proposal:${sourceEntityId}`);
+            const existingContracts = await tx.$queryRawUnsafe(`SELECT id, code
+           FROM operations_contract
+          WHERE deleted_at IS NULL
+            AND origin_type = $1::operations_contract_origin_type_07a7cc2b5d_enum
+            AND origin_id::text = $2
+          ORDER BY id DESC
+          LIMIT 1`, 'crm_proposal', sourceEntityId);
+            const existingContract = existingContracts[0];
+            if (existingContract === null || existingContract === void 0 ? void 0 : existingContract.id) {
+                return {
+                    id: existingContract.id,
+                    code: (_a = existingContract.code) !== null && _a !== void 0 ? _a : `CONTRACT-${existingContract.id}`,
+                };
+            }
+            const generatedCode = await this.generateContractCode(tx);
+            const created = await tx.$queryRawUnsafe(`INSERT INTO operations_contract (
+          code,
+          name,
+          contract_category,
+          contract_type,
+          client_name,
+          signature_status,
+          is_active,
+          billing_model,
+          account_manager_collaborator_id,
+          related_collaborator_id,
+          contract_template_id,
+          origin_type,
+          origin_id,
+          start_date,
+          end_date,
+          signed_at,
+          effective_date,
+          budget_amount,
+          monthly_hour_cap,
+          status,
+          creation_mode,
+          wizard_step,
+          description,
+          content_html,
+          created_by_user_id,
+          updated_by_user_id,
+          created_at,
+          updated_at
+        ) VALUES (
+          $1,
+          $2,
+          $3::operations_contract_contract_category_70d553ea09_enum,
+          $4::operations_contract_contract_type_48331e2ebf_enum,
+          $5,
+          $6::operations_contract_signature_status_2cb7282a7b_enum,
+          $7,
+          $8::operations_contract_billing_model_409dc7fea2_enum,
+          $9,
+          $10,
+          $11,
+          $12::operations_contract_origin_type_07a7cc2b5d_enum,
+          $13,
+          $14::date,
+          $15::date,
+          $16::date,
+          $17::date,
+          $18,
+          $19,
+          $20::operations_contract_status_a0395962df_enum,
+          $21::operations_contract_creation_mode_98ba669209_enum,
+          $22,
+          $23,
+          $24,
+          $25,
+          $25,
+          NOW(),
+          NOW()
+        )
+        RETURNING id`, generatedCode, contractName, contractCategory, contractType, clientName, 'not_started', true, billingModel, null, null, null, 'crm_proposal', sourceEntityId, (_b = proposal.validFrom) !== null && _b !== void 0 ? _b : null, (_c = proposal.validUntil) !== null && _c !== void 0 ? _c : null, null, (_d = proposal.validFrom) !== null && _d !== void 0 ? _d : null, fallbackAmount > 0 ? fallbackAmount : null, null, 'draft', 'blank', 1, this.normalizeOptionalText(proposal.notes), this.normalizeOptionalText((_e = payload.revision) === null || _e === void 0 ? void 0 : _e.contentHtml), Number(payload.approvedByUserId) || null);
+            const contractId = (_f = created[0]) === null || _f === void 0 ? void 0 : _f.id;
+            if (!contractId) {
+                throw new common_1.BadRequestException('Could not create contract draft from proposal.');
+            }
+            await this.replaceContractParties(tx, contractId, [
+                {
+                    partyRole: primaryPartyRole,
+                    partyType: person.tradeName ? 'company' : 'individual',
+                    displayName: clientName,
+                    documentNumber: this.normalizeOptionalText(person.document),
+                    email: this.normalizeOptionalText(person.email),
+                    phone: this.normalizeOptionalText(person.phone),
+                    isPrimary: true,
+                },
+            ]);
+            await this.replaceContractFinancialTerms(tx, contractId, financialTerms.map((term) => ({
+                termType: term.termType,
+                label: term.label,
+                amount: term.amount,
+                recurrence: term.recurrence,
+                dueDay: term.dueDay,
+                notes: term.notes,
+            })));
+            await this.replaceContractRevisions(tx, contractId, [
+                {
+                    revisionType: 'revision',
+                    title: (_h = (_g = payload.revision) === null || _g === void 0 ? void 0 : _g.title) !== null && _h !== void 0 ? _h : contractName,
+                    effectiveDate: (_j = proposal.validFrom) !== null && _j !== void 0 ? _j : null,
+                    status: 'draft',
+                    summary: (_l = this.normalizeOptionalText((_k = payload.revision) === null || _k === void 0 ? void 0 : _k.summary)) !== null && _l !== void 0 ? _l : this.normalizeOptionalText(proposal.notes),
+                },
+            ]);
+            await this.insertContractHistory(tx, contractId, Number(payload.approvedByUserId) || null, 'created', `Draft contract generated from CRM proposal ${(_m = proposal.code) !== null && _m !== void 0 ? _m : sourceEntityId}.`, JSON.stringify({
+                correlationId: payload.correlationId || `proposal:${sourceEntityId}`,
+                proposalId: (_o = payload.proposalId) !== null && _o !== void 0 ? _o : (Number(sourceEntityId) > 0 ? Number(sourceEntityId) : null),
+                proposalRevisionId: (_p = payload.proposalRevisionId) !== null && _p !== void 0 ? _p : null,
+                sourceModule: 'contact',
+                sourceEntity: 'proposal',
+                sourceId: sourceEntityId,
+                approvedByUserId: Number(payload.approvedByUserId) || null,
+            }));
+            await this.integrationApi.publishEvent({
+                eventName: 'operations.contract.created',
+                sourceModule: 'operations',
+                aggregateType: 'contract',
+                aggregateId: String(contractId),
+                payload: this.buildContractCreatedEventPayload({
+                    id: contractId,
+                    code: generatedCode,
+                    name: contractName,
+                    clientName,
+                    contractCategory,
+                    contractType,
+                    billingModel,
+                    originType: 'crm_proposal',
+                    originId: sourceEntityId,
+                    startDate: (_q = proposal.validFrom) !== null && _q !== void 0 ? _q : null,
+                    endDate: (_r = proposal.validUntil) !== null && _r !== void 0 ? _r : null,
+                    description: this.normalizeOptionalText(proposal.notes),
+                    financialTerms,
+                }, payload, String(payload.locale || '').trim() || 'en', Number(payload.approvedByUserId) || undefined),
+                metadata: {
+                    producer: 'operations',
+                    correlationId: payload.correlationId || `proposal:${sourceEntityId}`,
+                    sourceModule: 'operations',
+                    sourceEntity: 'contract',
+                    sourceId: String(contractId),
+                    originType: 'crm_proposal',
+                    originId: sourceEntityId,
+                },
+            }, {
+                persistenceClient: tx,
+            });
+            return {
+                id: contractId,
+                code: generatedCode,
+            };
+        });
+    }
+    buildContractCreatedEventPayload(contract, payload, locale = 'en', createdByUserId) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1;
+        return {
+            contractId: contract.id,
+            proposalId: (_a = payload.proposalId) !== null && _a !== void 0 ? _a : null,
+            proposalRevisionId: (_b = payload.proposalRevisionId) !== null && _b !== void 0 ? _b : null,
+            personId: (_e = (_c = payload.personId) !== null && _c !== void 0 ? _c : (_d = payload.person) === null || _d === void 0 ? void 0 : _d.id) !== null && _e !== void 0 ? _e : null,
+            createdByUserId: createdByUserId !== null && createdByUserId !== void 0 ? createdByUserId : null,
+            createdAt: new Date().toISOString(),
+            locale,
+            correlationId: payload.correlationId || `proposal:${(_g = (_f = payload.proposalId) !== null && _f !== void 0 ? _f : contract.originId) !== null && _g !== void 0 ? _g : contract.id}`,
+            sourceModule: 'operations',
+            sourceEntity: 'contract',
+            sourceId: String(contract.id),
+            source_module: 'operations',
+            source_entity: 'contract',
+            source_id: String(contract.id),
+            contract: {
+                id: contract.id,
+                code: (_h = contract.code) !== null && _h !== void 0 ? _h : null,
+                name: (_j = contract.name) !== null && _j !== void 0 ? _j : null,
+                clientName: (_k = contract.clientName) !== null && _k !== void 0 ? _k : null,
+                status: 'draft',
+                contractCategory: (_l = contract.contractCategory) !== null && _l !== void 0 ? _l : 'client',
+                contractType: (_m = contract.contractType) !== null && _m !== void 0 ? _m : 'service_agreement',
+                billingModel: (_o = contract.billingModel) !== null && _o !== void 0 ? _o : 'fixed_price',
+                originType: (_p = contract.originType) !== null && _p !== void 0 ? _p : 'manual',
+                originId: (_q = contract.originId) !== null && _q !== void 0 ? _q : null,
+                startDate: (_r = contract.startDate) !== null && _r !== void 0 ? _r : null,
+                endDate: (_s = contract.endDate) !== null && _s !== void 0 ? _s : null,
+                description: (_t = contract.description) !== null && _t !== void 0 ? _t : null,
+                financialTerms: (_u = contract.financialTerms) !== null && _u !== void 0 ? _u : [],
+            },
+            proposal: (_v = payload.proposal) !== null && _v !== void 0 ? _v : {
+                code: (_w = payload.code) !== null && _w !== void 0 ? _w : null,
+                title: (_x = payload.title) !== null && _x !== void 0 ? _x : null,
+                totalAmount: (_y = payload.total) !== null && _y !== void 0 ? _y : null,
+                notes: (_0 = (_z = payload.commercialTerms) === null || _z === void 0 ? void 0 : _z.notes) !== null && _0 !== void 0 ? _0 : null,
+            },
+            person: (_1 = payload.person) !== null && _1 !== void 0 ? _1 : null,
+        };
+    }
+    async buildContractActivatedEventPayload(contract, locale = 'en', activatedByUserId) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9;
+        let personId = null;
+        let proposalId = null;
+        let personRecord = null;
+        if (contract.originType === 'crm_proposal' && contract.originId) {
+            const parsedProposalId = Number(contract.originId);
+            if (Number.isInteger(parsedProposalId) && parsedProposalId > 0) {
+                proposalId = parsedProposalId;
+                const proposal = await this.prisma.proposal.findUnique({
+                    where: { id: parsedProposalId },
+                    include: {
+                        person: {
+                            select: {
+                                id: true,
+                                name: true,
+                                trade_name: true,
+                                email: true,
+                                phone: true,
+                                document: true,
+                            },
+                        },
+                    },
+                });
+                if (proposal) {
+                    personId = (_c = (_a = proposal.person_id) !== null && _a !== void 0 ? _a : (_b = proposal.person) === null || _b === void 0 ? void 0 : _b.id) !== null && _c !== void 0 ? _c : null;
+                    personRecord = (_d = proposal.person) !== null && _d !== void 0 ? _d : null;
+                }
+            }
+        }
+        const financialTerms = ((_e = contract.financialTerms) !== null && _e !== void 0 ? _e : []).map((term) => {
+            var _a, _b, _c, _d, _e;
+            return ({
+                label: term.label,
+                termType: (_a = term.termType) !== null && _a !== void 0 ? _a : 'value',
+                amount: Number((_b = term.amount) !== null && _b !== void 0 ? _b : 0),
+                recurrence: (_c = term.recurrence) !== null && _c !== void 0 ? _c : 'one_time',
+                dueDay: (_d = term.dueDay) !== null && _d !== void 0 ? _d : null,
+                notes: (_e = term.notes) !== null && _e !== void 0 ? _e : null,
+            });
+        });
+        const totalAmount = financialTerms.reduce((sum, term) => sum + (Number.isFinite(term.amount) ? term.amount : 0), 0) || Number((_f = contract.budgetAmount) !== null && _f !== void 0 ? _f : 0);
+        return {
+            contractId: contract.id,
+            proposalId,
+            personId,
+            activatedByUserId: activatedByUserId !== null && activatedByUserId !== void 0 ? activatedByUserId : null,
+            signedByUserId: activatedByUserId !== null && activatedByUserId !== void 0 ? activatedByUserId : null,
+            activatedAt: new Date().toISOString(),
+            signedAt: (_j = (_h = (_g = contract.signedAt) !== null && _g !== void 0 ? _g : contract.effectiveDate) !== null && _h !== void 0 ? _h : contract.startDate) !== null && _j !== void 0 ? _j : null,
+            locale,
+            correlationId: proposalId ? `proposal:${proposalId}` : `contract:${contract.id}`,
+            sourceModule: 'operations',
+            sourceEntity: 'contract',
+            sourceId: String(contract.id),
+            source_module: 'operations',
+            source_entity: 'contract',
+            source_id: String(contract.id),
+            contract: {
+                code: (_k = contract.code) !== null && _k !== void 0 ? _k : null,
+                name: (_l = contract.name) !== null && _l !== void 0 ? _l : null,
+                clientName: (_m = contract.clientName) !== null && _m !== void 0 ? _m : null,
+                contractCategory: (_o = contract.contractCategory) !== null && _o !== void 0 ? _o : 'client',
+                contractType: (_p = contract.contractType) !== null && _p !== void 0 ? _p : 'service_agreement',
+                billingModel: (_q = contract.billingModel) !== null && _q !== void 0 ? _q : 'fixed_price',
+                originType: (_r = contract.originType) !== null && _r !== void 0 ? _r : 'manual',
+                originId: (_s = contract.originId) !== null && _s !== void 0 ? _s : null,
+                startDate: (_t = contract.startDate) !== null && _t !== void 0 ? _t : null,
+                endDate: (_u = contract.endDate) !== null && _u !== void 0 ? _u : null,
+                signedAt: (_v = contract.signedAt) !== null && _v !== void 0 ? _v : null,
+                effectiveDate: (_w = contract.effectiveDate) !== null && _w !== void 0 ? _w : null,
+                budgetAmount: (_x = contract.budgetAmount) !== null && _x !== void 0 ? _x : null,
+                description: (_y = contract.description) !== null && _y !== void 0 ? _y : null,
+                financialTerms,
+                parties: (_z = contract.parties) !== null && _z !== void 0 ? _z : [],
+            },
+            person: personRecord
+                ? {
+                    id: (_0 = personRecord.id) !== null && _0 !== void 0 ? _0 : null,
+                    name: (_1 = personRecord.name) !== null && _1 !== void 0 ? _1 : null,
+                    tradeName: (_2 = personRecord.trade_name) !== null && _2 !== void 0 ? _2 : null,
+                    email: (_3 = personRecord.email) !== null && _3 !== void 0 ? _3 : null,
+                    phone: (_4 = personRecord.phone) !== null && _4 !== void 0 ? _4 : null,
+                    document: (_5 = personRecord.document) !== null && _5 !== void 0 ? _5 : null,
+                }
+                : null,
+            receivable: {
+                personId,
+                documentNumber: (_6 = contract.code) !== null && _6 !== void 0 ? _6 : `CONTRACT-${contract.id}`,
+                totalAmount,
+                description: (_9 = (_8 = (_7 = contract.description) !== null && _7 !== void 0 ? _7 : contract.name) !== null && _8 !== void 0 ? _8 : contract.code) !== null && _9 !== void 0 ? _9 : null,
+            },
+        };
+    }
     async updateContract(userId, contractId, data) {
+        var _a, _b;
         const actor = await this.getActorContext(userId);
         this.ensureDirector(actor);
-        await this.getContractById(userId, contractId);
+        const current = await this.getContractById(userId, contractId);
+        const nextStatus = this.normalizeEnumValue(data.status, CONTRACT_STATUS_VALUES, (_a = current.status) !== null && _a !== void 0 ? _a : 'draft');
+        const nextSignatureStatus = this.normalizeEnumValue(data.signatureStatus, SIGNATURE_STATUS_VALUES, (_b = current.signatureStatus) !== null && _b !== void 0 ? _b : 'not_started');
+        const shouldPublishSigned = current.signatureStatus !== 'signed' && nextSignatureStatus === 'signed';
+        const shouldPublishActivation = current.status !== 'active' && nextStatus === 'active';
         const updates = [];
         const params = [];
         this.pushUpdate(updates, params, 'code', data.code);
         this.pushUpdate(updates, params, 'name', data.name);
-        this.pushUpdate(updates, params, 'contract_category', data.contractCategory);
-        this.pushUpdate(updates, params, 'contract_type', data.contractType);
+        this.pushUpdate(updates, params, 'contract_category', data.contractCategory, 'operations_contract_contract_category_70d553ea09_enum');
+        this.pushUpdate(updates, params, 'contract_type', data.contractType, 'operations_contract_contract_type_48331e2ebf_enum');
         this.pushUpdate(updates, params, 'client_name', data.clientName);
-        this.pushUpdate(updates, params, 'signature_status', data.signatureStatus);
+        this.pushUpdate(updates, params, 'signature_status', data.signatureStatus, 'operations_contract_signature_status_2cb7282a7b_enum');
         this.pushUpdate(updates, params, 'is_active', data.isActive);
-        this.pushUpdate(updates, params, 'billing_model', data.billingModel);
+        this.pushUpdate(updates, params, 'billing_model', data.billingModel, 'operations_contract_billing_model_409dc7fea2_enum');
         this.pushUpdate(updates, params, 'account_manager_collaborator_id', data.accountManagerCollaboratorId);
         this.pushUpdate(updates, params, 'related_collaborator_id', data.relatedCollaboratorId);
-        this.pushUpdate(updates, params, 'origin_type', data.originType);
+        this.pushUpdate(updates, params, 'contract_template_id', data.contractTemplateId);
+        this.pushUpdate(updates, params, 'origin_type', data.originType, 'operations_contract_origin_type_07a7cc2b5d_enum');
         this.pushUpdate(updates, params, 'origin_id', data.originId);
-        this.pushUpdate(updates, params, 'start_date', data.startDate);
-        this.pushUpdate(updates, params, 'end_date', data.endDate);
-        this.pushUpdate(updates, params, 'signed_at', data.signedAt);
-        this.pushUpdate(updates, params, 'effective_date', data.effectiveDate);
+        this.pushUpdate(updates, params, 'start_date', data.startDate, 'date');
+        this.pushUpdate(updates, params, 'end_date', data.endDate, 'date');
+        this.pushUpdate(updates, params, 'signed_at', data.signedAt, 'date');
+        this.pushUpdate(updates, params, 'effective_date', data.effectiveDate, 'date');
         this.pushUpdate(updates, params, 'budget_amount', data.budgetAmount);
         this.pushUpdate(updates, params, 'monthly_hour_cap', data.monthlyHourCap);
-        this.pushUpdate(updates, params, 'status', data.status);
+        this.pushUpdate(updates, params, 'status', data.status, 'operations_contract_status_a0395962df_enum');
+        this.pushUpdate(updates, params, 'creation_mode', data.creationMode, 'operations_contract_creation_mode_98ba669209_enum');
+        this.pushUpdate(updates, params, 'wizard_step', data.wizardStep);
         this.pushUpdate(updates, params, 'description', data.description);
         this.pushUpdate(updates, params, 'content_html', data.contentHtml);
         await this.prisma.$transaction(async (tx) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
             if (updates.length) {
                 params.push(contractId);
                 await tx.$executeRawUnsafe(`UPDATE operations_contract
@@ -877,12 +1929,110 @@ let OperationsService = class OperationsService {
                 await this.replaceContractRevisions(tx, contractId, data.revisions);
             }
             if (data.replaceUploadedPdfDocument) {
-                await this.replaceContractPdfDocument(tx, contractId, data.replaceUploadedPdfDocument);
+                await this.replaceContractDocument(tx, contractId, 'source_upload', data.replaceUploadedPdfDocument);
             }
             await this.insertContractHistory(tx, contractId, userId, 'updated', 'Contract registry data updated.');
+            if (shouldPublishSigned || shouldPublishActivation) {
+                const contractEventPayload = await this.buildContractActivatedEventPayload({
+                    id: current.id,
+                    code: (_a = data.code) !== null && _a !== void 0 ? _a : current.code,
+                    name: (_b = data.name) !== null && _b !== void 0 ? _b : current.name,
+                    clientName: (_c = data.clientName) !== null && _c !== void 0 ? _c : current.clientName,
+                    contractCategory: (_d = data.contractCategory) !== null && _d !== void 0 ? _d : current.contractCategory,
+                    contractType: (_e = data.contractType) !== null && _e !== void 0 ? _e : current.contractType,
+                    billingModel: (_f = data.billingModel) !== null && _f !== void 0 ? _f : current.billingModel,
+                    originType: (_g = data.originType) !== null && _g !== void 0 ? _g : current.originType,
+                    originId: (_h = data.originId) !== null && _h !== void 0 ? _h : current.originId,
+                    startDate: (_j = data.startDate) !== null && _j !== void 0 ? _j : current.startDate,
+                    endDate: (_k = data.endDate) !== null && _k !== void 0 ? _k : current.endDate,
+                    signedAt: (_l = data.signedAt) !== null && _l !== void 0 ? _l : current.signedAt,
+                    effectiveDate: (_m = data.effectiveDate) !== null && _m !== void 0 ? _m : current.effectiveDate,
+                    budgetAmount: (_o = data.budgetAmount) !== null && _o !== void 0 ? _o : current.budgetAmount,
+                    description: (_p = data.description) !== null && _p !== void 0 ? _p : current.description,
+                    financialTerms: (_q = data.financialTerms) !== null && _q !== void 0 ? _q : current.financialTerms,
+                    parties: (_r = data.parties) !== null && _r !== void 0 ? _r : current.parties,
+                }, 'en', userId);
+                if (shouldPublishSigned) {
+                    await this.integrationApi.publishEvent({
+                        eventName: 'operations.contract.signed',
+                        sourceModule: 'operations',
+                        aggregateType: 'contract',
+                        aggregateId: String(contractId),
+                        payload: Object.assign(Object.assign({}, contractEventPayload), { signedByUserId: userId !== null && userId !== void 0 ? userId : null, signedAt: (_u = (_t = (_s = data.signedAt) !== null && _s !== void 0 ? _s : current.signedAt) !== null && _t !== void 0 ? _t : contractEventPayload.signedAt) !== null && _u !== void 0 ? _u : new Date().toISOString() }),
+                        metadata: {
+                            producer: 'operations',
+                            correlationId: contractEventPayload.correlationId || `contract:${contractId}`,
+                            sourceModule: 'operations',
+                            sourceEntity: 'contract',
+                            sourceId: String(contractId),
+                            originType: (_v = data.originType) !== null && _v !== void 0 ? _v : current.originType,
+                            originId: (_w = data.originId) !== null && _w !== void 0 ? _w : current.originId,
+                            lifecycle: 'signed',
+                        },
+                    }, {
+                        persistenceClient: tx,
+                    });
+                }
+                if (shouldPublishActivation) {
+                    await this.integrationApi.publishEvent({
+                        eventName: 'operations.contract.activated',
+                        sourceModule: 'operations',
+                        aggregateType: 'contract',
+                        aggregateId: String(contractId),
+                        payload: contractEventPayload,
+                        metadata: {
+                            producer: 'operations',
+                            correlationId: contractEventPayload.correlationId || `contract:${contractId}`,
+                            sourceModule: 'operations',
+                            sourceEntity: 'contract',
+                            sourceId: String(contractId),
+                            originType: (_x = data.originType) !== null && _x !== void 0 ? _x : current.originType,
+                            originId: (_y = data.originId) !== null && _y !== void 0 ? _y : current.originId,
+                            lifecycle: 'activated',
+                        },
+                    }, {
+                        persistenceClient: tx,
+                    });
+                }
+            }
         });
         return this.getContractById(userId, contractId);
     }
+    async removeContract(userId, contractId) {
+        const actor = await this.getActorContext(userId);
+        this.ensureDirector(actor);
+        const current = await this.getContractById(userId, contractId);
+        await this.prisma.$transaction(async (tx) => {
+            var _a, _b;
+            await tx.$executeRawUnsafe(`UPDATE operations_project
+            SET contract_id = NULL,
+                updated_at = NOW()
+          WHERE contract_id = $1
+            AND deleted_at IS NULL`, contractId);
+            for (const tableName of [
+                'operations_contract_party',
+                'operations_contract_signature',
+                'operations_contract_financial_term',
+                'operations_contract_document',
+                'operations_contract_revision',
+            ]) {
+                await tx.$executeRawUnsafe(`UPDATE ${tableName}
+              SET deleted_at = NOW(),
+                  updated_at = NOW()
+            WHERE contract_id = $1
+              AND deleted_at IS NULL`, contractId);
+            }
+            await this.insertContractHistory(tx, contractId, userId, 'deleted', `Contract "${(_b = (_a = current.name) !== null && _a !== void 0 ? _a : current.code) !== null && _b !== void 0 ? _b : `#${contractId}`}" removed from registry.`);
+            await tx.$executeRawUnsafe(`UPDATE operations_contract
+            SET deleted_at = NOW(),
+                is_active = false,
+                status = 'archived',
+                updated_at = NOW()
+          WHERE id = $1
+            AND deleted_at IS NULL`, contractId);
+        });
+        return { success: true };
+    }
     async listTimesheets(userId) {
         const actor = await this.getActorContext(userId);
         const filter = this.buildIdFilter(actor.visibleCollaboratorIds, 't.collaborator_id', actor.isDirector);
@@ -958,7 +2108,7 @@ let OperationsService = class OperationsService {
           status,
           created_at,
           updated_at
-        ) VALUES ($1, $2, $3, $4, $5, 'draft', NOW(), NOW())
+        ) VALUES ($1, $2, $3::date, $4::date, $5, 'draft', NOW(), NOW())
         RETURNING id`, collaboratorId, (_a = collaborator.supervisorId) !== null && _a !== void 0 ? _a : null, data.weekStartDate, data.weekEndDate, (_b = data.notes) !== null && _b !== void 0 ? _b : null));
             const timesheetId = (_c = row[0]) === null || _c === void 0 ? void 0 : _c.id;
             await this.replaceTimesheetEntries(tx, timesheetId, (_d = data.entries) !== null && _d !== void 0 ? _d : [], collaboratorId);
@@ -979,8 +2129,8 @@ let OperationsService = class OperationsService {
         await this.prisma.$transaction(async (tx) => {
             const updates = [];
             const params = [];
-            this.pushUpdate(updates, params, 'week_start_date', data.weekStartDate);
-            this.pushUpdate(updates, params, 'week_end_date', data.weekEndDate);
+            this.pushUpdate(updates, params, 'week_start_date', data.weekStartDate, 'date');
+            this.pushUpdate(updates, params, 'week_end_date', data.weekEndDate, 'date');
             this.pushUpdate(updates, params, 'notes', data.notes);
             if (updates.length) {
                 params.push(timesheetId);
@@ -1079,7 +2229,17 @@ let OperationsService = class OperationsService {
           submitted_at,
           created_at,
           updated_at
-        ) VALUES ($1, $2, COALESCE($3, 'vacation'), $4, $5, $6, 'submitted', $7, NOW(), NOW(), NOW())
+        ) VALUES (
+          $1,
+          $2,
+          $3::operations_time_off_request_request_type_fdcf258f8e_enum,
+          $4::date,
+          $5::date,
+          $6,
+          'submitted',
+          $7,
+          NOW(), NOW(), NOW()
+        )
         RETURNING id`, collaboratorId, (_a = collaborator.supervisorId) !== null && _a !== void 0 ? _a : null, (_b = data.requestType) !== null && _b !== void 0 ? _b : 'vacation', data.startDate, data.endDate, (_c = data.totalDays) !== null && _c !== void 0 ? _c : null, (_d = data.reason) !== null && _d !== void 0 ? _d : null));
             const requestId = (_e = row[0]) === null || _e === void 0 ? void 0 : _e.id;
             await this.upsertApproval(tx, {
@@ -1188,7 +2348,14 @@ let OperationsService = class OperationsService {
           created_at,
           updated_at
         ) VALUES (
-          $1, $2, COALESCE($3, 'temporary'), $4, $5, 'submitted', $6, NOW(), NOW(), NOW()
+          $1,
+          $2,
+          $3::operations_schedule_adjustment_request_request__d3f1202fa6_enum,
+          $4::date,
+          $5::date,
+          'submitted',
+          $6,
+          NOW(), NOW(), NOW()
         )
         RETURNING id`, collaboratorId, (_a = collaborator.supervisorId) !== null && _a !== void 0 ? _a : null, (_b = data.requestScope) !== null && _b !== void 0 ? _b : 'temporary', data.effectiveStartDate, (_c = data.effectiveEndDate) !== null && _c !== void 0 ? _c : null, (_d = data.reason) !== null && _d !== void 0 ? _d : null));
             const requestId = (_e = row[0]) === null || _e === void 0 ? void 0 : _e.id;
@@ -1202,7 +2369,11 @@ let OperationsService = class OperationsService {
             break_minutes,
             created_at,
             updated_at
-          ) VALUES ($1, $2, $3, $4, $5, $6, NOW(), NOW())`, requestId, day.weekday, (_f = day.isWorkingDay) !== null && _f !== void 0 ? _f : true, (_g = day.startTime) !== null && _g !== void 0 ? _g : null, (_h = day.endTime) !== null && _h !== void 0 ? _h : null, (_j = day.breakMinutes) !== null && _j !== void 0 ? _j : null);
+          ) VALUES (
+            $1,
+            $2::operations_schedule_adjustment_day_weekday_ba6542bf86_enum,
+            $3, $4::time, $5::time, $6, NOW(), NOW()
+          )`, requestId, day.weekday, (_f = day.isWorkingDay) !== null && _f !== void 0 ? _f : true, (_g = day.startTime) !== null && _g !== void 0 ? _g : null, (_h = day.endTime) !== null && _h !== void 0 ? _h : null, (_j = day.breakMinutes) !== null && _j !== void 0 ? _j : null);
             }
             await this.upsertApproval(tx, {
                 targetType: 'schedule_adjustment_request',
@@ -1371,14 +2542,14 @@ let OperationsService = class OperationsService {
         await this.prisma.$transaction(async (tx) => {
             var _a, _b;
             await tx.$executeRawUnsafe(`UPDATE operations_approval
-            SET status = $1,
+            SET status = $1::operations_approval_status_747aa313d9_enum,
                 decided_at = NOW(),
                 decision_note = $2,
                 updated_at = NOW()
           WHERE id = $3`, nextStatus, (_a = data.note) !== null && _a !== void 0 ? _a : null, approvalId);
             if (approval.targetType === 'timesheet') {
                 await tx.$executeRawUnsafe(`UPDATE operations_timesheet
-              SET status = $1,
+              SET status = $1::operations_timesheet_status_128a8ecd30_enum,
                   reviewed_at = NOW(),
                   approver_collaborator_id = $2,
                   updated_at = NOW()
@@ -1386,7 +2557,7 @@ let OperationsService = class OperationsService {
             }
             if (approval.targetType === 'time_off_request') {
                 await tx.$executeRawUnsafe(`UPDATE operations_time_off_request
-            SET status = $1,
+            SET status = $1::operations_time_off_request_status_c0b28799ee_enum,
                 reviewed_at = NOW(),
                 approver_collaborator_id = $2,
                 submitted_at = COALESCE(submitted_at, NOW()),
@@ -1395,7 +2566,7 @@ let OperationsService = class OperationsService {
             }
             if (approval.targetType === 'schedule_adjustment_request') {
                 await tx.$executeRawUnsafe(`UPDATE operations_schedule_adjustment_request
-            SET status = $1,
+            SET status = $1::operations_schedule_adjustment_request_status_159e10f34e_enum,
                 reviewed_at = NOW(),
                 approver_collaborator_id = $2,
                 submitted_at = COALESCE(submitted_at, NOW()),
@@ -1460,10 +2631,12 @@ let OperationsService = class OperationsService {
     }
     async getCollaboratorByUserId(userId) {
         return this.querySingle(`SELECT c.id,
-              c.display_name AS "displayName",
+              COALESCE(NULLIF(c.display_name, ''), person_record.name) AS "displayName",
               s.id AS "supervisorId",
               s.display_name AS "supervisorName"
          FROM operations_collaborator c
+         LEFT JOIN person person_record
+           ON person_record.id = c.person_id
          LEFT JOIN operations_collaborator s
            ON s.id = c.supervisor_collaborator_id
         WHERE c.user_id = $1
@@ -1471,10 +2644,12 @@ let OperationsService = class OperationsService {
     }
     async getCollaboratorById(collaboratorId) {
         const collaborator = await this.querySingle(`SELECT c.id,
-              c.display_name AS "displayName",
+              COALESCE(NULLIF(c.display_name, ''), person_record.name) AS "displayName",
               s.id AS "supervisorId",
               s.display_name AS "supervisorName"
          FROM operations_collaborator c
+         LEFT JOIN person person_record
+           ON person_record.id = c.person_id
          LEFT JOIN operations_collaborator s
            ON s.id = c.supervisor_collaborator_id
         WHERE c.id = $1
@@ -1484,6 +2659,186 @@ let OperationsService = class OperationsService {
         }
         return collaborator;
     }
+    async getPersonById(personId) {
+        const person = await this.querySingle(`SELECT id, name, type
+         FROM person
+        WHERE id = $1`, [personId]);
+        if (!person) {
+            throw new common_1.NotFoundException('Person not found.');
+        }
+        return person;
+    }
+    async getDepartmentById(client, departmentId, includeInactive = false) {
+        var _a;
+        const departments = (await client.$queryRawUnsafe(`SELECT id,
+              slug,
+              code,
+              name,
+              description,
+              created_at AS "createdAt",
+              updated_at AS "updatedAt",
+              deleted_at AS "deletedAt",
+              CASE WHEN deleted_at IS NULL THEN 'active' ELSE 'inactive' END AS status
+         FROM operations_department
+        WHERE id = $1
+          AND ($2::boolean OR deleted_at IS NULL)`, departmentId, includeInactive));
+        const department = (_a = departments[0]) !== null && _a !== void 0 ? _a : null;
+        if (!department) {
+            throw new common_1.NotFoundException('Department not found.');
+        }
+        return department;
+    }
+    async assertDepartmentNameAvailable(client, name, excludeDepartmentId) {
+        const existing = (await client.$queryRawUnsafe(`SELECT id
+         FROM operations_department
+        WHERE LOWER(name) = LOWER($1)
+          AND ($2::int IS NULL OR id <> $2)
+        LIMIT 1`, name, excludeDepartmentId !== null && excludeDepartmentId !== void 0 ? excludeDepartmentId : null));
+        if (existing[0]) {
+            throw new common_1.BadRequestException('A department with this name already exists.');
+        }
+    }
+    async assertDepartmentCodeAvailable(client, code, excludeDepartmentId) {
+        const existing = (await client.$queryRawUnsafe(`SELECT id
+         FROM operations_department
+        WHERE UPPER(COALESCE(code, '')) = UPPER($1)
+          AND ($2::int IS NULL OR id <> $2)
+        LIMIT 1`, code, excludeDepartmentId !== null && excludeDepartmentId !== void 0 ? excludeDepartmentId : null));
+        if (existing[0]) {
+            throw new common_1.BadRequestException('A department with this code already exists.');
+        }
+    }
+    async resolveDepartmentReference(client, input) {
+        var _a;
+        if (input.departmentName !== undefined) {
+            const normalizedDepartmentName = this.normalizeOptionalText(input.departmentName);
+            if (!normalizedDepartmentName) {
+                return null;
+            }
+            const existingByName = (await client.$queryRawUnsafe(`SELECT id, name
+           FROM operations_department
+          WHERE deleted_at IS NULL
+            AND LOWER(name) = LOWER($1)
+          ORDER BY id ASC
+          LIMIT 1`, normalizedDepartmentName));
+            if (existingByName[0]) {
+                return existingByName[0];
+            }
+            const slug = await this.generateUniqueDepartmentSlug(client, normalizedDepartmentName);
+            const created = (await client.$queryRawUnsafe(`INSERT INTO operations_department (
+          slug,
+          code,
+          name,
+          description,
+          created_at,
+          updated_at
+        ) VALUES ($1, NULL, $2, NULL, NOW(), NOW())
+        RETURNING id, name`, slug, normalizedDepartmentName));
+            return (_a = created[0]) !== null && _a !== void 0 ? _a : null;
+        }
+        if (typeof input.departmentId === 'number' &&
+            Number.isInteger(input.departmentId) &&
+            input.departmentId > 0) {
+            return this.getDepartmentById(client, input.departmentId);
+        }
+        return null;
+    }
+    async generateUniqueDepartmentSlug(client, label, excludeDepartmentId) {
+        const baseSlug = this.slugifyValue(label) || `department-${Date.now().toString(36)}`;
+        for (let attempt = 0; attempt < 25; attempt += 1) {
+            const candidate = attempt === 0 ? baseSlug : `${baseSlug}-${attempt + 1}`;
+            const existing = (await client.$queryRawUnsafe(`SELECT id
+           FROM operations_department
+          WHERE slug = $1
+            AND ($2::int IS NULL OR id <> $2)
+          LIMIT 1`, candidate, excludeDepartmentId !== null && excludeDepartmentId !== void 0 ? excludeDepartmentId : null));
+            if (!existing.length) {
+                return candidate;
+            }
+        }
+        return `${baseSlug}-${Date.now().toString(36)}`;
+    }
+    async getContractTemplateRecord(client, templateId, includeInactive = false) {
+        const template = (await client.$queryRawUnsafe(`SELECT t.id,
+              t.slug,
+              t.code,
+              t.name,
+              t.description,
+              t.contract_category AS "contractCategory",
+              t.contract_type AS "contractType",
+              t.billing_model AS "billingModel",
+              t.signature_status AS "signatureStatus",
+              t.is_active AS "isActive",
+              t.status,
+              t.content_html AS "contentHtml",
+              COUNT(DISTINCT c.id)::int AS "usageCount",
+              t.created_at AS "createdAt",
+              t.updated_at AS "updatedAt"
+         FROM operations_contract_template t
+         LEFT JOIN operations_contract c
+           ON c.contract_template_id = t.id
+          AND c.deleted_at IS NULL
+        WHERE t.id = $1
+          AND ($2::boolean = true OR t.deleted_at IS NULL)
+        GROUP BY t.id
+        LIMIT 1`, templateId, includeInactive));
+        const record = template[0];
+        if (!record) {
+            throw new common_1.NotFoundException('Contract template not found.');
+        }
+        return record;
+    }
+    async assertContractTemplateNameAvailable(client, name, excludeTemplateId) {
+        const existing = (await client.$queryRawUnsafe(`SELECT id
+         FROM operations_contract_template
+        WHERE LOWER(name) = LOWER($1)
+          AND deleted_at IS NULL
+          AND ($2::int IS NULL OR id <> $2)
+        LIMIT 1`, name, excludeTemplateId !== null && excludeTemplateId !== void 0 ? excludeTemplateId : null));
+        if (existing[0]) {
+            throw new common_1.BadRequestException('A contract template with this name already exists.');
+        }
+    }
+    async assertContractTemplateCodeAvailable(client, code, excludeTemplateId) {
+        const existing = (await client.$queryRawUnsafe(`SELECT id
+         FROM operations_contract_template
+        WHERE UPPER(COALESCE(code, '')) = UPPER($1)
+          AND deleted_at IS NULL
+          AND ($2::int IS NULL OR id <> $2)
+        LIMIT 1`, code, excludeTemplateId !== null && excludeTemplateId !== void 0 ? excludeTemplateId : null));
+        if (existing[0]) {
+            throw new common_1.BadRequestException('A contract template with this code already exists.');
+        }
+    }
+    async generateUniqueContractTemplateSlug(client, label, excludeTemplateId) {
+        const baseSlug = this.slugifyValue(label) || `contract-template-${Date.now().toString(36)}`;
+        for (let attempt = 0; attempt < 25; attempt += 1) {
+            const candidate = attempt === 0 ? baseSlug : `${baseSlug}-${attempt + 1}`;
+            const existing = (await client.$queryRawUnsafe(`SELECT id
+           FROM operations_contract_template
+          WHERE slug = $1
+            AND ($2::int IS NULL OR id <> $2)
+          LIMIT 1`, candidate, excludeTemplateId !== null && excludeTemplateId !== void 0 ? excludeTemplateId : null));
+            if (!existing.length) {
+                return candidate;
+            }
+        }
+        return `${baseSlug}-${Date.now().toString(36)}`;
+    }
+    slugifyValue(value) {
+        return (value !== null && value !== void 0 ? value : '')
+            .normalize('NFKD')
+            .replace(/[\u0300-\u036f]/g, '')
+            .toLowerCase()
+            .trim()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '')
+            .slice(0, 80);
+    }
+    normalizeOptionalText(value) {
+        const normalized = String(value !== null && value !== void 0 ? value : '').trim();
+        return normalized || null;
+    }
     async getProjectDetails(projectId, actorCollaboratorId) {
         var _a, _b, _c, _d, _e, _f, _g;
         const project = await this.querySingle(`SELECT p.id,
@@ -1589,10 +2944,14 @@ let OperationsService = class OperationsService {
         var _a, _b, _c, _d, _e, _f;
         const collaborator = await this.querySingle(`SELECT c.id,
               c.user_id AS "userId",
+              c.person_id AS "personId",
+              person_record.name AS "personName",
+              person_record.avatar_id AS "personAvatarId",
               c.code,
               c.collaborator_type AS "collaboratorType",
-              c.display_name AS "displayName",
-              c.department,
+              COALESCE(NULLIF(c.display_name, ''), person_record.name) AS "displayName",
+              c.department_id AS "departmentId",
+              COALESCE(NULLIF(department_record.name, ''), NULLIF(c.department, '')) AS "department",
               c.title,
               c.level_label AS "levelLabel",
               c.weekly_capacity_hours AS "weeklyCapacityHours",
@@ -1606,6 +2965,11 @@ let OperationsService = class OperationsService {
               hiring_contract.status AS "contractStatus",
               COUNT(DISTINCT pa.id)::int AS "activeAssignments"
          FROM operations_collaborator c
+         LEFT JOIN person person_record
+           ON person_record.id = c.person_id
+         LEFT JOIN operations_department department_record
+           ON department_record.id = c.department_id
+          AND department_record.deleted_at IS NULL
          LEFT JOIN operations_collaborator s
            ON s.id = c.supervisor_collaborator_id
          LEFT JOIN operations_project_assignment pa
@@ -1623,7 +2987,7 @@ let OperationsService = class OperationsService {
          ) hiring_contract ON TRUE
         WHERE c.id = $1
           AND c.deleted_at IS NULL
-        GROUP BY c.id, s.id, hiring_contract.id, hiring_contract.status`, [collaboratorId]);
+        GROUP BY c.id, person_record.id, department_record.id, s.id, hiring_contract.id, hiring_contract.status`, [collaboratorId]);
         if (!collaborator) {
             throw new common_1.NotFoundException('Collaborator not found.');
         }
@@ -1770,7 +3134,7 @@ let OperationsService = class OperationsService {
           description,
           created_at,
           updated_at
-        ) VALUES ($1, $2, $3, $4, $5, $6, NOW(), NOW())`, timesheetId, (_a = entry.projectAssignmentId) !== null && _a !== void 0 ? _a : null, (_b = entry.activityLabel) !== null && _b !== void 0 ? _b : null, entry.workDate, entry.hours, (_c = entry.description) !== null && _c !== void 0 ? _c : null);
+        ) VALUES ($1, $2, $3, $4::date, $5, $6, NOW(), NOW())`, timesheetId, (_a = entry.projectAssignmentId) !== null && _a !== void 0 ? _a : null, (_b = entry.activityLabel) !== null && _b !== void 0 ? _b : null, entry.workDate, entry.hours, (_c = entry.description) !== null && _c !== void 0 ? _c : null);
         }
     }
     async refreshTimesheetTotal(client, timesheetId) {
@@ -1788,7 +3152,7 @@ let OperationsService = class OperationsService {
         var _a, _b;
         const existing = (await client.$queryRawUnsafe(`SELECT id
          FROM operations_approval
-        WHERE target_type = $1
+        WHERE target_type = $1::operations_approval_target_type_32d3f04385_enum
           AND target_id = $2
           AND deleted_at IS NULL`, input.targetType, input.targetId));
         let approvalId = (_a = existing[0]) === null || _a === void 0 ? void 0 : _a.id;
@@ -1802,7 +3166,10 @@ let OperationsService = class OperationsService {
           submitted_at,
           created_at,
           updated_at
-        ) VALUES ($1, $2, $3, $4, 'pending', NOW(), NOW(), NOW())
+        ) VALUES (
+          $1::operations_approval_target_type_32d3f04385_enum,
+          $2, $3, $4, 'pending', NOW(), NOW(), NOW()
+        )
         RETURNING id`, input.targetType, input.targetId, input.requesterCollaboratorId, input.approverCollaboratorId));
             approvalId = (_b = created[0]) === null || _b === void 0 ? void 0 : _b.id;
             await this.insertApprovalHistory(client, approvalId, input.requesterCollaboratorId, 'created', null);
@@ -1828,7 +3195,13 @@ let OperationsService = class OperationsService {
         action,
         note,
         created_at
-      ) VALUES ($1, $2, $3, $4, NOW())`, approvalId, actorCollaboratorId, action, note);
+      ) VALUES (
+        $1,
+        $2,
+        $3::operations_approval_history_action_c8478a05d6_enum,
+        $4,
+        NOW()
+      )`, approvalId, actorCollaboratorId, action, note);
     }
     async assertProjectAccess(actor, projectId) {
         if (actor.isDirector)
@@ -1941,7 +3314,7 @@ let OperationsService = class OperationsService {
           break_minutes,
           created_at,
           updated_at
-        ) VALUES ($1, $2, $3, $4, $5, $6, NOW(), NOW())`, collaboratorId, day.weekday, (_a = day.isWorkingDay) !== null && _a !== void 0 ? _a : true, day.isWorkingDay === false ? null : (_b = day.startTime) !== null && _b !== void 0 ? _b : null, day.isWorkingDay === false ? null : (_c = day.endTime) !== null && _c !== void 0 ? _c : null, (_d = day.breakMinutes) !== null && _d !== void 0 ? _d : null);
+        ) VALUES ($1, $2::operations_collaborator_schedule_day_weekday_5d79528f6c_enum, $3, $4::time, $5::time, $6, NOW(), NOW())`, collaboratorId, day.weekday, (_a = day.isWorkingDay) !== null && _a !== void 0 ? _a : true, day.isWorkingDay === false ? null : (_b = day.startTime) !== null && _b !== void 0 ? _b : null, day.isWorkingDay === false ? null : (_c = day.endTime) !== null && _c !== void 0 ? _c : null, (_d = day.breakMinutes) !== null && _d !== void 0 ? _d : null);
         }
     }
     async replaceProjectAssignments(client, projectId, teamAssignments) {
@@ -1965,7 +3338,9 @@ let OperationsService = class OperationsService {
           created_at,
           updated_at
         ) VALUES (
-          $1, $2, $3, $4, $5, $6, $7, $8, COALESCE($9, 'active'), NOW(), NOW()
+          $1, $2, $3, $4, $5, $6, $7::date, $8::date,
+          $9::operations_project_assignment_status_155b459bbf_enum,
+          NOW(), NOW()
         )`, projectId, assignment.collaboratorId, (_a = assignment.roleLabel) !== null && _a !== void 0 ? _a : 'Team Member', (_b = assignment.allocationPercent) !== null && _b !== void 0 ? _b : null, (_c = assignment.weeklyHours) !== null && _c !== void 0 ? _c : null, (_d = assignment.isBillable) !== null && _d !== void 0 ? _d : true, (_e = assignment.startDate) !== null && _e !== void 0 ? _e : null, (_f = assignment.endDate) !== null && _f !== void 0 ? _f : null, (_g = assignment.status) !== null && _g !== void 0 ? _g : 'active');
         }
     }
@@ -2032,14 +3407,59 @@ let OperationsService = class OperationsService {
         created_at,
         updated_at
       ) VALUES (
-        $1, $2, $3, $4, $5, 'not_started', true, $6, $7, $8, 'employee_hiring', $9, $10, NULL,
-        NULL, $10, $11, $12, 'draft', $13, NULL, $14, $14, NOW(), NOW()
+        $1, $2,
+        $3::operations_contract_contract_category_70d553ea09_enum,
+        $4::operations_contract_contract_type_48331e2ebf_enum,
+        $5, 'not_started', true,
+        $6::operations_contract_billing_model_409dc7fea2_enum,
+        $7, $8, 'employee_hiring', $9, $10::date, NULL,
+        NULL, $10::date, $11, $12, 'draft', $13, NULL, $14, $14, NOW(), NOW()
       )`, contractCode, contractName, this.mapContractCategoryForCollaboratorType(input.collaboratorType), this.mapContractTypeForCollaboratorType(input.collaboratorType), input.displayName, this.mapBillingModelForCollaboratorType(input.collaboratorType), input.supervisorCollaboratorId, input.collaboratorId, input.collaboratorId, (_a = input.startDate) !== null && _a !== void 0 ? _a : new Date().toISOString().slice(0, 10), (_b = input.compensationAmount) !== null && _b !== void 0 ? _b : null, input.weeklyCapacityHours
             ? Math.round(Number(input.weeklyCapacityHours) * 4)
             : null, (_c = input.description) !== null && _c !== void 0 ? _c : null, createdByUserId);
     }
     async createProjectContractDraft(client, createdByUserId, input) {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+        const templateRows = input.contractTemplateId
+            ? (await client.$queryRawUnsafe(`SELECT id,
+                  code,
+                  name,
+                  description,
+                  contract_category AS "contractCategory",
+                  contract_type AS "contractType",
+                  billing_model AS "billingModel",
+                  signature_status AS "signatureStatus",
+                  content_html AS "contentHtml"
+             FROM operations_contract_template
+            WHERE id = $1
+              AND deleted_at IS NULL
+            LIMIT 1`, input.contractTemplateId))
+            : [];
+        const selectedTemplate = (_a = templateRows[0]) !== null && _a !== void 0 ? _a : null;
+        const templateContext = {
+            project_code: input.projectCode,
+            project_name: input.projectName,
+            client_name: input.clientName,
+            start_date: (_b = input.startDate) !== null && _b !== void 0 ? _b : '',
+            end_date: (_c = input.endDate) !== null && _c !== void 0 ? _c : '',
+            budget_amount: input.budgetAmount !== null && input.budgetAmount !== undefined
+                ? String(input.budgetAmount)
+                : '',
+            monthly_hour_cap: input.monthlyHourCap !== null && input.monthlyHourCap !== undefined
+                ? String(input.monthlyHourCap)
+                : '',
+        };
+        const applyTemplateVariables = (value) => {
+            const source = value !== null && value !== void 0 ? value : '';
+            return Object.entries(templateContext).reduce((result, [key, replacement]) => result.split(`{{${key}}}`).join(replacement || ''), source);
+        };
+        const templateCodePrefix = this.normalizeOptionalText(selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.code);
+        const generatedContractCode = ((_e = (_d = this.normalizeOptionalText(input.contractCode)) !== null && _d !== void 0 ? _d : (templateCodePrefix
+            ? `${templateCodePrefix}-${input.projectCode}`
+            : null)) !== null && _e !== void 0 ? _e : `PRJ-${input.projectCode}`).slice(0, 40);
+        const generatedContractName = (_g = (_f = this.normalizeOptionalText(input.contractName)) !== null && _f !== void 0 ? _f : this.normalizeOptionalText(applyTemplateVariables(selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.name))) !== null && _g !== void 0 ? _g : `${input.projectName} Service Agreement`;
+        const generatedDescription = this.normalizeOptionalText(applyTemplateVariables((_h = input.description) !== null && _h !== void 0 ? _h : selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.description));
+        const generatedContentHtml = this.normalizeOptionalText(applyTemplateVariables(selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.contentHtml));
         const created = await client.$queryRawUnsafe(`INSERT INTO operations_contract (
         code,
         name,
@@ -2051,6 +3471,7 @@ let OperationsService = class OperationsService {
         billing_model,
         account_manager_collaborator_id,
         related_collaborator_id,
+        contract_template_id,
         origin_type,
         origin_id,
         start_date,
@@ -2067,11 +3488,35 @@ let OperationsService = class OperationsService {
         created_at,
         updated_at
       ) VALUES (
-        $1, $2, 'client', 'service_agreement', $3, 'not_started', true, $4, $5, NULL, 'client_project', $6,
-        $7, $8, NULL, $7, $9, $10, 'draft', $11, NULL, $12, $12, NOW(), NOW()
+        $1,
+        $2,
+        $3::operations_contract_contract_category_70d553ea09_enum,
+        $4::operations_contract_contract_type_48331e2ebf_enum,
+        $5,
+        $6::operations_contract_signature_status_2cb7282a7b_enum,
+        true,
+        $7::operations_contract_billing_model_409dc7fea2_enum,
+        $8,
+        NULL,
+        $9,
+        'client_project',
+        $10,
+        $11::date,
+        $12::date,
+        NULL,
+        $11::date,
+        $13,
+        $14,
+        'draft',
+        $15,
+        $16,
+        $17,
+        $17,
+        NOW(),
+        NOW()
       )
-      RETURNING id`, (_a = input.contractCode) !== null && _a !== void 0 ? _a : `PRJ-${input.projectCode}`, (_b = input.contractName) !== null && _b !== void 0 ? _b : `${input.projectName} Service Agreement`, input.clientName, input.billingModel, input.managerCollaboratorId, input.projectId, (_c = input.startDate) !== null && _c !== void 0 ? _c : new Date().toISOString().slice(0, 10), (_d = input.endDate) !== null && _d !== void 0 ? _d : null, (_e = input.budgetAmount) !== null && _e !== void 0 ? _e : null, (_f = input.monthlyHourCap) !== null && _f !== void 0 ? _f : null, (_g = input.description) !== null && _g !== void 0 ? _g : null, createdByUserId);
-        return (_h = created[0]) === null || _h === void 0 ? void 0 : _h.id;
+      RETURNING id`, generatedContractCode, generatedContractName, (_j = selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.contractCategory) !== null && _j !== void 0 ? _j : 'client', (_k = selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.contractType) !== null && _k !== void 0 ? _k : 'service_agreement', input.clientName, (_l = selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.signatureStatus) !== null && _l !== void 0 ? _l : 'not_started', (_m = selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.billingModel) !== null && _m !== void 0 ? _m : input.billingModel, input.managerCollaboratorId, (_o = selectedTemplate === null || selectedTemplate === void 0 ? void 0 : selectedTemplate.id) !== null && _o !== void 0 ? _o : null, input.projectId, (_p = input.startDate) !== null && _p !== void 0 ? _p : new Date().toISOString().slice(0, 10), (_q = input.endDate) !== null && _q !== void 0 ? _q : null, (_r = input.budgetAmount) !== null && _r !== void 0 ? _r : null, (_s = input.monthlyHourCap) !== null && _s !== void 0 ? _s : null, generatedDescription, generatedContentHtml, createdByUserId);
+        return (_t = created[0]) === null || _t === void 0 ? void 0 : _t.id;
     }
     async replaceContractParties(client, contractId, parties) {
         var _a, _b, _c, _d, _e, _f;
@@ -2093,7 +3538,10 @@ let OperationsService = class OperationsService {
           created_at,
           updated_at
         ) VALUES (
-          $1, COALESCE($2, 'other'), COALESCE($3, 'company'), $4, $5, $6, $7, COALESCE($8, false), NOW(), NOW()
+          $1,
+          $2::operations_contract_party_party_role_b66e8515fc_enum,
+          $3::operations_contract_party_party_type_1383bb371c_enum,
+          $4, $5, $6, $7, $8, NOW(), NOW()
         )`, contractId, (_a = party.partyRole) !== null && _a !== void 0 ? _a : 'other', (_b = party.partyType) !== null && _b !== void 0 ? _b : 'company', party.displayName, (_c = party.documentNumber) !== null && _c !== void 0 ? _c : null, (_d = party.email) !== null && _d !== void 0 ? _d : null, (_e = party.phone) !== null && _e !== void 0 ? _e : null, (_f = party.isPrimary) !== null && _f !== void 0 ? _f : false);
         }
     }
@@ -2115,7 +3563,9 @@ let OperationsService = class OperationsService {
           created_at,
           updated_at
         ) VALUES (
-          $1, $2, $3, $4, COALESCE($5, 'pending'), $6, NOW(), NOW()
+          $1, $2, $3, $4,
+          $5::operations_contract_signature_signer_status_1e6fbe2519_enum,
+          $6::timestamp, NOW(), NOW()
         )`, contractId, signature.signerName, (_a = signature.signerRole) !== null && _a !== void 0 ? _a : null, (_b = signature.signerEmail) !== null && _b !== void 0 ? _b : null, (_c = signature.status) !== null && _c !== void 0 ? _c : 'pending', (_d = signature.signedAt) !== null && _d !== void 0 ? _d : null);
         }
     }
@@ -2138,7 +3588,14 @@ let OperationsService = class OperationsService {
           created_at,
           updated_at
         ) VALUES (
-          $1, COALESCE($2, 'value'), $3, $4, COALESCE($5, 'one_time'), $6, $7, NOW(), NOW()
+          $1,
+          $2::operations_contract_financial_term_term_type_700635c06a_enum,
+          $3,
+          $4,
+          $5::operations_contract_financial_term_recurrence_ba90bbe3bf_enum,
+          $6,
+          $7,
+          NOW(), NOW()
         )`, contractId, (_a = term.termType) !== null && _a !== void 0 ? _a : 'value', term.label, term.amount, (_b = term.recurrence) !== null && _b !== void 0 ? _b : 'one_time', (_c = term.dueDay) !== null && _c !== void 0 ? _c : null, (_d = term.notes) !== null && _d !== void 0 ? _d : null);
         }
     }
@@ -2160,31 +3617,340 @@ let OperationsService = class OperationsService {
           created_at,
           updated_at
         ) VALUES (
-          $1, COALESCE($2, 'revision'), $3, $4, COALESCE($5, 'draft'), $6, NOW(), NOW()
+          $1,
+          $2::operations_contract_revision_revision_type_cf5ba1a538_enum,
+          $3,
+          $4::date,
+          $5::operations_contract_revision_status_f44f35bb66_enum,
+          $6,
+          NOW(), NOW()
         )`, contractId, (_a = revision.revisionType) !== null && _a !== void 0 ? _a : 'revision', revision.title, (_b = revision.effectiveDate) !== null && _b !== void 0 ? _b : null, (_c = revision.status) !== null && _c !== void 0 ? _c : 'draft', (_d = revision.summary) !== null && _d !== void 0 ? _d : null);
         }
     }
-    async replaceContractPdfDocument(client, contractId, document) {
-        var _a;
+    async replaceContractDocument(client, contractId, documentType, document) {
+        var _a, _b, _c, _d, _e;
         await client.$executeRawUnsafe(`UPDATE operations_contract_document
           SET is_current = false,
               updated_at = NOW()
         WHERE contract_id = $1
           AND deleted_at IS NULL
-          AND document_type IN ('uploaded_pdf', 'generated_pdf')`, contractId);
+          AND document_type = $2`, contractId, documentType);
         await client.$executeRawUnsafe(`INSERT INTO operations_contract_document (
         contract_id,
         document_type,
+        file_id,
         file_name,
         mime_type,
         file_content_base64,
         is_current,
+        extraction_status,
+        extraction_summary,
         notes,
         created_at,
         updated_at
       ) VALUES (
-        $1, 'uploaded_pdf', $2, $3, $4, true, $5, NOW(), NOW()
-      )`, contractId, document.fileName, document.mimeType, document.fileContentBase64, (_a = document.notes) !== null && _a !== void 0 ? _a : null);
+        $1, $2, $3, $4, $5, $6, true, $7, $8, $9, NOW(), NOW()
+      )`, contractId, documentType, (_a = document.fileId) !== null && _a !== void 0 ? _a : null, document.fileName, document.mimeType, (_b = document.fileContentBase64) !== null && _b !== void 0 ? _b : null, (_c = document.extractionStatus) !== null && _c !== void 0 ? _c : 'skipped', (_d = document.extractionSummary) !== null && _d !== void 0 ? _d : null, (_e = document.notes) !== null && _e !== void 0 ? _e : null);
+    }
+    async resolveContractExtractionFile(userId, data) {
+        if (data.contractId && data.contractId > 0) {
+            const contract = await this.getContractById(userId, data.contractId);
+            const sourceDocument = contract.documents.find((document) => document.isCurrent && document.documentType === 'source_upload');
+            if (!sourceDocument) {
+                throw new common_1.BadRequestException('No source document is attached to this contract draft.');
+            }
+            if (sourceDocument.fileId) {
+                const { buffer } = await this.fileService.getBuffer(sourceDocument.fileId);
+                return this.buildContractExtractionFile(sourceDocument.fileName, sourceDocument.mimeType, buffer);
+            }
+            const base64 = this.normalizeExtractionString(sourceDocument.fileContentBase64);
+            if (!base64) {
+                throw new common_1.BadRequestException('The current source document does not contain readable file content.');
+            }
+            return this.buildContractExtractionFile(sourceDocument.fileName, sourceDocument.mimeType, Buffer.from(base64, 'base64'));
+        }
+        const fileName = this.normalizeExtractionString(data.fileName);
+        const fileContentBase64 = this.normalizeExtractionString(data.fileContentBase64);
+        const mimeType = this.normalizeContractExtractionMimeType(data.mimeType, fileName);
+        if (!fileName || !fileContentBase64) {
+            throw new common_1.BadRequestException('fileName and fileContentBase64 are required.');
+        }
+        return this.buildContractExtractionFile(fileName, mimeType, Buffer.from(fileContentBase64, 'base64'));
+    }
+    buildContractExtractionFile(fileName, mimeType, buffer) {
+        if (!this.isAllowedContractExtractionMimeType(mimeType)) {
+            throw new common_1.BadRequestException('Only PDF, DOC, and DOCX files are supported for contract extraction.');
+        }
+        if (!buffer.length) {
+            throw new common_1.BadRequestException('Unable to decode the uploaded contract document.');
+        }
+        if (buffer.length > 12 * 1024 * 1024) {
+            throw new common_1.BadRequestException('The uploaded contract document must be smaller than 12 MB.');
+        }
+        return {
+            fieldname: 'file',
+            originalname: fileName,
+            encoding: 'base64',
+            mimetype: mimeType,
+            size: buffer.length,
+            destination: '',
+            filename: fileName,
+            path: '',
+            buffer,
+        };
+    }
+    async renderContractPdfBuffer(contract) {
+        var _a;
+        const html = await this.buildContractPdfHtml(contract);
+        let browser = null;
+        try {
+            const importPlaywright = new Function('moduleName', 'return import(moduleName);');
+            const playwright = await importPlaywright('playwright');
+            browser = await playwright.chromium.launch({ headless: true });
+            const page = await browser.newPage();
+            await page.setContent(html, { waitUntil: 'networkidle' });
+            return Buffer.from(await page.pdf({
+                format: 'A4',
+                printBackground: true,
+                margin: {
+                    top: '72px',
+                    right: '18px',
+                    bottom: '56px',
+                    left: '18px',
+                },
+            }));
+        }
+        catch (error) {
+            throw new common_1.BadRequestException('PDF generation requires Playwright to be installed on the server.');
+        }
+        finally {
+            await ((_a = browser === null || browser === void 0 ? void 0 : browser.close) === null || _a === void 0 ? void 0 : _a.call(browser));
+        }
+    }
+    async buildContractPdfHtml(contract) {
+        var _a, _b, _c, _d, _e;
+        const logoUrl = await this.resolveContractPdfLogoUrl();
+        const contentHtml = (_c = (_a = this.normalizeOptionalText(contract.contentHtml)) !== null && _a !== void 0 ? _a : (_b = this.normalizeOptionalText(contract.description)) === null || _b === void 0 ? void 0 : _b.split(/\n{2,}/).map((paragraph) => `<p>${this.escapeHtml(paragraph)}</p>`).join('')) !== null && _c !== void 0 ? _c : '<p>No contract body was provided yet.</p>';
+        const partiesHtml = ((_d = contract.parties) !== null && _d !== void 0 ? _d : []).length
+            ? contract.parties
+                .map((party) => `
+              <li>
+                <strong>${this.escapeHtml(party.displayName || 'Party')}</strong>
+                <span>${this.escapeHtml([party.partyRole, party.partyType].filter(Boolean).join(' • '))}</span>
+              </li>`)
+                .join('')
+            : '<li><strong>No parties registered yet.</strong><span>Complete this contract later if needed.</span></li>';
+        const financialTermsHtml = ((_e = contract.financialTerms) !== null && _e !== void 0 ? _e : []).length
+            ? contract.financialTerms
+                .map((term) => `
+              <li>
+                <strong>${this.escapeHtml(term.label || 'Term')}</strong>
+                <span>${this.escapeHtml([term.termType, term.amount, term.recurrence]
+                .filter((item) => item !== null && item !== undefined && String(item).trim())
+                .join(' • '))}</span>
+              </li>`)
+                .join('')
+            : '<li><strong>No financial terms registered yet.</strong><span>The draft is intentionally lightweight.</span></li>';
+        return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <style>
+      @page {
+        size: A4;
+        margin: 72px 18px 56px 18px;
+      }
+      body {
+        color: #0f172a;
+        font-family: Arial, sans-serif;
+        font-size: 12px;
+        line-height: 1.5;
+        margin: 0;
+      }
+      header {
+        align-items: center;
+        border-bottom: 2px solid #dbeafe;
+        display: flex;
+        gap: 16px;
+        justify-content: space-between;
+        margin-bottom: 24px;
+        padding-bottom: 16px;
+      }
+      .brand {
+        align-items: center;
+        display: flex;
+        gap: 12px;
+      }
+      .brand img {
+        height: 42px;
+        max-width: 140px;
+        object-fit: contain;
+      }
+      .eyebrow {
+        color: #2563eb;
+        font-size: 10px;
+        font-weight: 700;
+        letter-spacing: 0.12em;
+        text-transform: uppercase;
+      }
+      h1 {
+        font-size: 22px;
+        margin: 4px 0 0;
+      }
+      .meta-grid {
+        display: grid;
+        gap: 12px;
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+        margin: 20px 0;
+      }
+      .meta-card {
+        background: #f8fafc;
+        border: 1px solid #dbeafe;
+        border-radius: 12px;
+        padding: 12px;
+      }
+      .meta-card strong {
+        display: block;
+        font-size: 10px;
+        letter-spacing: 0.08em;
+        margin-bottom: 4px;
+        text-transform: uppercase;
+      }
+      section {
+        margin-top: 20px;
+      }
+      h2 {
+        color: #1d4ed8;
+        font-size: 14px;
+        margin: 0 0 10px;
+      }
+      ul {
+        list-style: none;
+        margin: 0;
+        padding: 0;
+      }
+      li {
+        border: 1px solid #e2e8f0;
+        border-radius: 10px;
+        margin-bottom: 8px;
+        padding: 10px 12px;
+      }
+      li strong {
+        display: block;
+        margin-bottom: 2px;
+      }
+      footer {
+        border-top: 1px solid #dbeafe;
+        color: #475569;
+        font-size: 10px;
+        margin-top: 28px;
+        padding-top: 12px;
+      }
+      .content {
+        border: 1px solid #e2e8f0;
+        border-radius: 14px;
+        padding: 18px;
+      }
+      .content p:first-child {
+        margin-top: 0;
+      }
+    </style>
+  </head>
+  <body>
+    <header>
+      <div class="brand">
+        <img src="${logoUrl}" alt="System logo" />
+        <div>
+          <div class="eyebrow">Contract Document</div>
+          <h1>${this.escapeHtml(contract.name || contract.code || 'Contract draft')}</h1>
+        </div>
+      </div>
+      <div>
+        <div><strong>Code:</strong> ${this.escapeHtml(contract.code || 'Draft')}</div>
+        <div><strong>Status:</strong> ${this.escapeHtml(this.humanizeEnumLabel(contract.status || 'draft'))}</div>
+      </div>
+    </header>
+
+    <div class="meta-grid">
+      <div class="meta-card">
+        <strong>Client</strong>
+        ${this.escapeHtml(contract.clientName || 'Not informed yet')}
+      </div>
+      <div class="meta-card">
+        <strong>Type</strong>
+        ${this.escapeHtml(this.humanizeEnumLabel(contract.contractType || 'service_agreement'))}
+      </div>
+      <div class="meta-card">
+        <strong>Period</strong>
+        ${this.escapeHtml([contract.startDate || 'Open start', contract.endDate || 'Open end'].join(' - '))}
+      </div>
+      <div class="meta-card">
+        <strong>Billing</strong>
+        ${this.escapeHtml(this.humanizeEnumLabel(contract.billingModel || 'time_and_material'))}
+      </div>
+    </div>
+
+    <section>
+      <h2>Related Parties</h2>
+      <ul>${partiesHtml}</ul>
+    </section>
+
+    <section>
+      <h2>Financial Terms</h2>
+      <ul>${financialTermsHtml}</ul>
+    </section>
+
+    <section>
+      <h2>Contract Body</h2>
+      <div class="content">${contentHtml}</div>
+    </section>
+
+    <footer>
+      Generated on ${this.escapeHtml(new Date().toISOString())} for ${this.escapeHtml(contract.code || 'draft')}.
+    </footer>
+  </body>
+</html>`;
+    }
+    async resolveContractPdfLogoUrl() {
+        var _a;
+        const settings = await this.settingService.getSettingValues([
+            'image-url',
+            'icon-url',
+        ]);
+        const configuredUrl = (_a = this.normalizeOptionalText(settings['image-url'])) !== null && _a !== void 0 ? _a : this.normalizeOptionalText(settings['icon-url']);
+        if (configuredUrl && /^https?:\/\//i.test(configuredUrl)) {
+            return configuredUrl;
+        }
+        const inlineSvg = encodeURIComponent(`<svg xmlns="http://www.w3.org/2000/svg" width="240" height="72" viewBox="0 0 240 72">
+        <rect width="240" height="72" rx="18" fill="#0f172a"/>
+        <circle cx="38" cy="36" r="18" fill="#3b82f6"/>
+        <text x="72" y="43" fill="#ffffff" font-size="26" font-family="Arial, sans-serif" font-weight="700">HedHog</text>
+      </svg>`);
+        return `data:image/svg+xml;charset=UTF-8,${inlineSvg}`;
+    }
+    buildContractPdfFileName(contract) {
+        var _a, _b;
+        const base = (_b = (_a = this.normalizeOptionalText(contract.code)) !== null && _a !== void 0 ? _a : this.normalizeOptionalText(contract.name)) !== null && _b !== void 0 ? _b : `contract-${contract.id}`;
+        return `${base
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '')
+            .slice(0, 80) || `contract-${contract.id}`}.pdf`;
+    }
+    humanizeEnumLabel(value) {
+        return String(value !== null && value !== void 0 ? value : '')
+            .split('_')
+            .filter(Boolean)
+            .map((part) => { var _a; return ((_a = part[0]) === null || _a === void 0 ? void 0 : _a.toUpperCase()) + part.slice(1); })
+            .join(' ');
+    }
+    escapeHtml(value) {
+        return String(value !== null && value !== void 0 ? value : '')
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&#39;');
     }
     async insertContractHistory(client, contractId, actorUserId, action, note, metadataJson) {
         await client.$executeRawUnsafe(`INSERT INTO operations_contract_history (
@@ -2198,6 +3964,555 @@ let OperationsService = class OperationsService {
         $1, $2, $3, $4, $5, NOW()
       )`, contractId, actorUserId, action, note, metadataJson !== null && metadataJson !== void 0 ? metadataJson : null);
     }
+    async generateCollaboratorCode(client) {
+        for (let attempt = 0; attempt < 5; attempt += 1) {
+            const candidate = `COL-${Date.now().toString(36).toUpperCase()}${Math.random()
+                .toString(36)
+                .slice(2, 6)
+                .toUpperCase()}`;
+            const existing = (await client.$queryRawUnsafe(`SELECT code
+           FROM operations_collaborator
+          WHERE code = $1
+          LIMIT 1`, candidate));
+            if (!existing.length) {
+                return candidate;
+            }
+        }
+        throw new common_1.BadRequestException('Unable to generate collaborator code.');
+    }
+    async generateContractCode(client) {
+        for (let attempt = 0; attempt < 5; attempt += 1) {
+            const candidate = `CTR-${Date.now().toString(36).toUpperCase()}${Math.random()
+                .toString(36)
+                .slice(2, 6)
+                .toUpperCase()}`.slice(0, 40);
+            const existing = (await client.$queryRawUnsafe(`SELECT code
+           FROM operations_contract
+          WHERE code = $1
+          LIMIT 1`, candidate));
+            if (!existing.length) {
+                return candidate;
+            }
+        }
+        throw new common_1.BadRequestException('Unable to generate contract code.');
+    }
+    async generateContractContentHtml(contract, data = {}) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
+        const currentContent = this.normalizeOptionalText(contract.contentHtml);
+        const primaryParty = (_d = (_b = ((_a = contract.parties) !== null && _a !== void 0 ? _a : []).find((party) => party.isPrimary)) !== null && _b !== void 0 ? _b : ((_c = contract.parties) !== null && _c !== void 0 ? _c : [])[0]) !== null && _d !== void 0 ? _d : null;
+        const templateContext = {
+            contract_code: (_e = this.normalizeOptionalText(contract.code)) !== null && _e !== void 0 ? _e : '',
+            contract_name: (_f = this.normalizeOptionalText(contract.name)) !== null && _f !== void 0 ? _f : '',
+            client_name: (_h = (_g = this.normalizeOptionalText(contract.clientName)) !== null && _g !== void 0 ? _g : this.normalizeOptionalText(primaryParty === null || primaryParty === void 0 ? void 0 : primaryParty.displayName)) !== null && _h !== void 0 ? _h : '',
+            contract_category: (_j = this.normalizeOptionalText(contract.contractCategory)) !== null && _j !== void 0 ? _j : '',
+            contract_type: (_k = this.normalizeOptionalText(contract.contractType)) !== null && _k !== void 0 ? _k : '',
+            start_date: (_l = this.normalizeOptionalText(contract.startDate)) !== null && _l !== void 0 ? _l : '',
+            end_date: (_m = this.normalizeOptionalText(contract.endDate)) !== null && _m !== void 0 ? _m : '',
+            effective_date: (_o = this.normalizeOptionalText(contract.effectiveDate)) !== null && _o !== void 0 ? _o : '',
+            signed_at: (_p = this.normalizeOptionalText(contract.signedAt)) !== null && _p !== void 0 ? _p : '',
+            budget_amount: contract.budgetAmount !== null && contract.budgetAmount !== undefined
+                ? String(contract.budgetAmount)
+                : '',
+            monthly_hour_cap: contract.monthlyHourCap !== null &&
+                contract.monthlyHourCap !== undefined
+                ? String(contract.monthlyHourCap)
+                : '',
+            primary_party_name: (_q = this.normalizeOptionalText(primaryParty === null || primaryParty === void 0 ? void 0 : primaryParty.displayName)) !== null && _q !== void 0 ? _q : '',
+            primary_party_document: (_r = this.normalizeOptionalText(primaryParty === null || primaryParty === void 0 ? void 0 : primaryParty.documentNumber)) !== null && _r !== void 0 ? _r : '',
+            primary_party_email: (_s = this.normalizeOptionalText(primaryParty === null || primaryParty === void 0 ? void 0 : primaryParty.email)) !== null && _s !== void 0 ? _s : '',
+            primary_party_phone: (_t = this.normalizeOptionalText(primaryParty === null || primaryParty === void 0 ? void 0 : primaryParty.phone)) !== null && _t !== void 0 ? _t : '',
+            description: (_u = this.normalizeOptionalText(contract.description)) !== null && _u !== void 0 ? _u : '',
+        };
+        const applyTemplateVariables = (value) => {
+            const source = value !== null && value !== void 0 ? value : '';
+            return Object.entries(templateContext).reduce((result, [key, replacement]) => result.split(`{{${key}}}`).join(replacement || ''), source);
+        };
+        const currentHtmlWithVariables = this.normalizeOptionalText(applyTemplateVariables(currentContent));
+        if (currentHtmlWithVariables && data.overwrite !== true) {
+            return currentHtmlWithVariables;
+        }
+        const baseHtml = currentHtmlWithVariables !== null && currentHtmlWithVariables !== void 0 ? currentHtmlWithVariables : this.buildFallbackContractContent(contract);
+        const promptMessage = (_v = this.normalizeOptionalText(data.promptMessage)) !== null && _v !== void 0 ? _v : 'Generate an initial contract body using the registered metadata and keep the language concise, professional, and ready for legal review.';
+        try {
+            const aiResult = await this.aiService.chat({
+                provider: data.provider === 'gemini' ? 'gemini' : 'openai',
+                model: data.provider === 'gemini' ? 'gemini-1.5-flash' : 'gpt-4o-mini',
+                message: promptMessage,
+                systemPrompt: [
+                    'You draft professional business contract content for an operations back-office system.',
+                    'Return ONLY clean HTML suitable for a rich text editor preview.',
+                    'Do not include Markdown fences, commentary, or legal disclaimers inside the HTML.',
+                    'Keep the output concise, well-structured, and ready for legal revision.',
+                    'If a specific detail is missing, preserve placeholders like {{client_name}}, {{start_date}}, {{end_date}}, {{budget_amount}}, and {{monthly_hour_cap}} instead of inventing facts.',
+                    `Contract context:\n${JSON.stringify(templateContext, null, 2)}`,
+                    baseHtml
+                        ? `Current base HTML:\n${baseHtml}`
+                        : 'There is no current HTML yet.',
+                ].join('\n\n'),
+            });
+            return ((_x = this.normalizeOptionalText(String((_w = aiResult === null || aiResult === void 0 ? void 0 : aiResult.content) !== null && _w !== void 0 ? _w : ''))) !== null && _x !== void 0 ? _x : baseHtml);
+        }
+        catch (_y) {
+            return baseHtml;
+        }
+    }
+    buildFallbackContractContent(contract) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const title = this.escapeHtml((_b = (_a = this.normalizeOptionalText(contract.name)) !== null && _a !== void 0 ? _a : this.normalizeOptionalText(contract.code)) !== null && _b !== void 0 ? _b : 'Contract Draft');
+        const description = this.escapeHtml((_c = this.normalizeOptionalText(contract.description)) !== null && _c !== void 0 ? _c : 'This draft summarizes the main commercial and operational conditions agreed between the parties.');
+        const validityItems = [
+            contract.startDate ? `Start date: ${contract.startDate}` : null,
+            contract.endDate ? `End date: ${contract.endDate}` : null,
+            contract.effectiveDate ? `Effective date: ${contract.effectiveDate}` : null,
+            contract.signedAt ? `Signed at: ${contract.signedAt}` : null,
+        ]
+            .filter(Boolean)
+            .map((item) => `<li>${this.escapeHtml(String(item))}</li>`)
+            .join('');
+        const partiesHtml = ((_d = contract.parties) !== null && _d !== void 0 ? _d : []).length
+            ? ((_e = contract.parties) !== null && _e !== void 0 ? _e : [])
+                .map((party) => `
+              <li>
+                <strong>${this.escapeHtml(party.displayName || 'Party')}</strong>
+                <span>${this.escapeHtml([party.partyRole, party.partyType, party.documentNumber]
+                .filter(Boolean)
+                .join(' • '))}</span>
+              </li>`)
+                .join('')
+            : '<li><strong>Main party</strong><span>{{client_name}}</span></li>';
+        const financialTermsHtml = ((_f = contract.financialTerms) !== null && _f !== void 0 ? _f : []).length
+            ? ((_g = contract.financialTerms) !== null && _g !== void 0 ? _g : [])
+                .map((term) => `
+              <li>
+                <strong>${this.escapeHtml(term.label || 'Financial term')}</strong>
+                <span>${this.escapeHtml([term.termType, term.amount, term.recurrence]
+                .filter((item) => item !== null &&
+                item !== undefined &&
+                String(item).trim())
+                .join(' • '))}</span>
+              </li>`)
+                .join('')
+            : '<li><strong>Commercial conditions</strong><span>Define prices, billing cadence, and penalties before signature.</span></li>';
+        return `
+      <h1>${title}</h1>
+      <p>${description}</p>
+      <h2>1. Parties</h2>
+      <ul>${partiesHtml}</ul>
+      <h2>2. Scope and object</h2>
+      <p>The parties agree to execute the services and obligations described in this contract, according to the agreed operational, technical, and commercial conditions.</p>
+      <h2>3. Validity</h2>
+      ${validityItems ? `<ul>${validityItems}</ul>` : '<p>Define start date, term, renewal, and termination conditions.</p>'}
+      <h2>4. Financial terms</h2>
+      <ul>${financialTermsHtml}</ul>
+      <h2>5. General obligations</h2>
+      <p>Review confidentiality, data protection, service levels, termination, and liability clauses before formal approval.</p>
+    `;
+    }
+    async buildContractLegalReview(contract, data = {}) {
+        var _a, _b, _c;
+        const heuristicReview = this.buildHeuristicContractLegalReview(contract);
+        const promptMessage = (_a = this.normalizeOptionalText(data.promptMessage)) !== null && _a !== void 0 ? _a : 'Review this contract draft and return an advisory legal checklist with practical warnings and missing items.';
+        try {
+            const aiResult = await this.aiService.chat({
+                provider: data.provider === 'gemini' ? 'gemini' : 'openai',
+                model: data.provider === 'gemini' ? 'gemini-1.5-flash' : 'gpt-4o-mini',
+                message: promptMessage,
+                systemPrompt: [
+                    'You are an advisory legal-review assistant for business contracts.',
+                    'Return ONLY valid JSON. Do not include Markdown fences or commentary.',
+                    'This review is non-blocking and should help a human reviewer spot likely gaps.',
+                    'Expected JSON shape:',
+                    JSON.stringify({
+                        summary: '',
+                        missingFields: [],
+                        warnings: [],
+                        checklist: [],
+                        status: 'attention_required',
+                    }, null, 2),
+                    `Contract metadata:\n${JSON.stringify({
+                        code: contract.code,
+                        name: contract.name,
+                        clientName: contract.clientName,
+                        contractCategory: contract.contractCategory,
+                        contractType: contract.contractType,
+                        startDate: contract.startDate,
+                        endDate: contract.endDate,
+                        effectiveDate: contract.effectiveDate,
+                        signatureStatus: contract.signatureStatus,
+                        parties: contract.parties,
+                        financialTerms: contract.financialTerms,
+                    }, null, 2)}`,
+                    `Contract HTML:\n${(_b = this.normalizeOptionalText(contract.contentHtml)) !== null && _b !== void 0 ? _b : ''}`,
+                ].join('\n\n'),
+            });
+            const parsed = this.parseAiJsonPayload(String((_c = aiResult === null || aiResult === void 0 ? void 0 : aiResult.content) !== null && _c !== void 0 ? _c : ''));
+            const missingFields = Array.from(new Set([
+                ...heuristicReview.missingFields,
+                ...this.normalizeStringList(parsed.missingFields),
+            ]));
+            const warnings = Array.from(new Set([
+                ...heuristicReview.warnings,
+                ...this.normalizeStringList(parsed.warnings),
+            ]));
+            const checklist = Array.from(new Set([
+                ...this.normalizeStringList(parsed.checklist),
+                ...heuristicReview.checklist,
+            ]));
+            const parsedStatus = this.normalizeExtractionString(parsed.status);
+            const status = parsedStatus === 'ready_for_revision' ||
+                parsedStatus === 'attention_required'
+                ? parsedStatus
+                : missingFields.length || warnings.length
+                    ? 'attention_required'
+                    : 'ready_for_revision';
+            return {
+                summary: this.normalizeExtractionString(parsed.summary) ||
+                    heuristicReview.summary,
+                missingFields,
+                warnings,
+                checklist,
+                status,
+                reviewedAt: new Date().toISOString(),
+            };
+        }
+        catch (_d) {
+            return heuristicReview;
+        }
+    }
+    buildHeuristicContractLegalReview(contract) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const contentText = ((_a = this.normalizeOptionalText(contract.contentHtml)) !== null && _a !== void 0 ? _a : '')
+            .replace(/<[^>]+>/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim()
+            .toLowerCase();
+        const primaryParty = (_e = (_c = ((_b = contract.parties) !== null && _b !== void 0 ? _b : []).find((party) => party.isPrimary)) !== null && _c !== void 0 ? _c : ((_d = contract.parties) !== null && _d !== void 0 ? _d : [])[0]) !== null && _e !== void 0 ? _e : null;
+        const missingFields = [];
+        const warnings = [];
+        const checklist = [];
+        if (!this.normalizeOptionalText(contract.name)) {
+            missingFields.push('Contract title');
+            checklist.push('Attention: define a clear contract title.');
+        }
+        else {
+            checklist.push('OK: contract title is registered.');
+        }
+        if (!this.normalizeOptionalText(contract.clientName)) {
+            missingFields.push('Client or primary party name');
+            checklist.push('Attention: confirm the client or main party identification.');
+        }
+        else {
+            checklist.push('OK: the main party is identified.');
+        }
+        if (!contract.startDate && !contract.effectiveDate) {
+            missingFields.push('Start or effective date');
+            checklist.push('Attention: define the term start or effective date.');
+        }
+        else {
+            checklist.push('OK: validity dates were provided.');
+        }
+        if (!((_f = contract.parties) !== null && _f !== void 0 ? _f : []).length) {
+            missingFields.push('Related parties');
+            warnings.push('No related parties are registered in the contract draft.');
+        }
+        if (!this.normalizeOptionalText(primaryParty === null || primaryParty === void 0 ? void 0 : primaryParty.documentNumber)) {
+            warnings.push('Consider confirming the primary party document number.');
+        }
+        if (!((_g = contract.financialTerms) !== null && _g !== void 0 ? _g : []).length && contract.budgetAmount == null) {
+            warnings.push('Commercial conditions are still generic; define prices, recurrence, and penalties.');
+            checklist.push('Attention: validate billing, adjustments, and penalties.');
+        }
+        else {
+            checklist.push('OK: there is at least one financial reference to review.');
+        }
+        if (!contentText) {
+            missingFields.push('Contract body content');
+            warnings.push('The contract body is still empty and needs a first draft.');
+        }
+        else {
+            if (contentText.length < 600) {
+                warnings.push('The contract body is still brief; validate scope, obligations, and exceptions in detail.');
+            }
+            if (!/(rescis|terminat|cancel)/.test(contentText)) {
+                warnings.push('Add a termination / rescission clause with notice and penalty rules.');
+            }
+            if (!/(confiden|sigil|data protect|privacy)/.test(contentText)) {
+                warnings.push('Review confidentiality and data protection clauses when applicable.');
+            }
+            if (!/(foro|jurisd|governing law|applicable law)/.test(contentText)) {
+                warnings.push('Review the governing law / forum clause before signature.');
+            }
+        }
+        const summary = missingFields.length || warnings.length
+            ? `Advisory legal review found ${missingFields.length} missing item(s) and ${warnings.length} point(s) for attention before final approval.`
+            : 'Advisory legal review found the draft structurally consistent for human legal revision.';
+        return {
+            summary,
+            missingFields: Array.from(new Set(missingFields)),
+            warnings: Array.from(new Set(warnings)),
+            checklist: Array.from(new Set(checklist)),
+            status: missingFields.length || warnings.length
+                ? 'attention_required'
+                : 'ready_for_revision',
+            reviewedAt: new Date().toISOString(),
+        };
+    }
+    buildContractExtractionSystemPrompt() {
+        return [
+            'You extract structured draft data from uploaded business contracts.',
+            'Return ONLY valid JSON. Do not include Markdown fences, prose, or comments.',
+            'Use empty strings or empty arrays when the document is unclear; never invent legal facts.',
+            'Dates must use YYYY-MM-DD whenever the document provides enough confidence.',
+            'For contentHtml, return clean HTML suitable for a rich text editor preview.',
+            'Expected JSON shape:',
+            JSON.stringify({
+                code: '',
+                name: '',
+                clientName: '',
+                contractCategory: 'client',
+                contractType: 'service_agreement',
+                signatureStatus: 'not_started',
+                billingModel: 'time_and_material',
+                originType: 'manual',
+                originId: '',
+                startDate: '',
+                endDate: '',
+                signedAt: '',
+                effectiveDate: '',
+                budgetAmount: '',
+                monthlyHourCap: '',
+                status: 'draft',
+                description: '',
+                contentHtml: '',
+                parties: [
+                    {
+                        displayName: '',
+                        partyRole: 'client',
+                        partyType: 'company',
+                        documentNumber: '',
+                        email: '',
+                        phone: '',
+                        isPrimary: true,
+                    },
+                ],
+                signatures: [
+                    {
+                        signerName: '',
+                        signerRole: '',
+                        signerEmail: '',
+                        status: 'pending',
+                        signedAt: '',
+                    },
+                ],
+                financialTerms: [
+                    {
+                        label: '',
+                        termType: 'value',
+                        amount: '',
+                        recurrence: 'one_time',
+                        dueDay: '',
+                        notes: '',
+                    },
+                ],
+                revisions: [
+                    {
+                        title: '',
+                        revisionType: 'revision',
+                        effectiveDate: '',
+                        status: 'draft',
+                        summary: '',
+                    },
+                ],
+                summary: '',
+                missingFields: [],
+                warnings: [],
+            }, null, 2),
+        ].join('\n\n');
+    }
+    parseAiJsonPayload(content) {
+        var _a;
+        const trimmed = String(content !== null && content !== void 0 ? content : '').trim();
+        if (!trimmed) {
+            throw new common_1.BadRequestException('AI returned an empty contract draft response.');
+        }
+        const fencedMatch = trimmed.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
+        const candidate = ((_a = fencedMatch === null || fencedMatch === void 0 ? void 0 : fencedMatch[1]) === null || _a === void 0 ? void 0 : _a.trim()) || trimmed;
+        try {
+            return JSON.parse(candidate);
+        }
+        catch (_b) {
+            const firstBraceIndex = candidate.indexOf('{');
+            const lastBraceIndex = candidate.lastIndexOf('}');
+            if (firstBraceIndex >= 0 && lastBraceIndex > firstBraceIndex) {
+                try {
+                    return JSON.parse(candidate.slice(firstBraceIndex, lastBraceIndex + 1));
+                }
+                catch (_c) {
+                    throw new common_1.BadRequestException('AI returned an invalid contract draft payload.');
+                }
+            }
+            throw new common_1.BadRequestException('AI returned an invalid contract draft payload.');
+        }
+    }
+    normalizeContractExtractDraft(raw) {
+        const warnings = this.normalizeStringList(raw.warnings);
+        const missingFields = this.normalizeStringList(raw.missingFields);
+        const draft = {
+            code: this.normalizeExtractionString(raw.code),
+            name: this.normalizeExtractionString(raw.name),
+            clientName: this.normalizeExtractionString(raw.clientName),
+            contractCategory: this.normalizeEnumValue(raw.contractCategory, CONTRACT_CATEGORY_VALUES, 'client'),
+            contractType: this.normalizeEnumValue(raw.contractType, CONTRACT_TYPE_VALUES, 'service_agreement'),
+            signatureStatus: this.normalizeEnumValue(raw.signatureStatus, SIGNATURE_STATUS_VALUES, 'not_started'),
+            isActive: raw.isActive === false ? false : true,
+            billingModel: this.normalizeEnumValue(raw.billingModel, BILLING_MODEL_VALUES, 'time_and_material'),
+            originType: this.normalizeEnumValue(raw.originType, ORIGIN_TYPE_VALUES, 'manual'),
+            originId: this.normalizeExtractionString(raw.originId),
+            startDate: this.normalizeExtractionDate(raw.startDate),
+            endDate: this.normalizeExtractionDate(raw.endDate),
+            signedAt: this.normalizeExtractionDate(raw.signedAt),
+            effectiveDate: this.normalizeExtractionDate(raw.effectiveDate),
+            budgetAmount: this.normalizeExtractionNumber(raw.budgetAmount),
+            monthlyHourCap: this.normalizeExtractionNumber(raw.monthlyHourCap),
+            status: this.normalizeEnumValue(raw.status, CONTRACT_STATUS_VALUES, 'draft'),
+            description: this.normalizeExtractionString(raw.description),
+            contentHtml: this.normalizeExtractionString(raw.contentHtml),
+            summary: this.normalizeExtractionString(raw.summary),
+            parties: this.normalizeObjectList(raw.parties)
+                .map((party) => ({
+                displayName: this.normalizeExtractionString(party.displayName),
+                partyRole: this.normalizeEnumValue(party.partyRole, PARTY_ROLE_VALUES, 'client'),
+                partyType: this.normalizeEnumValue(party.partyType, PARTY_TYPE_VALUES, 'company'),
+                documentNumber: this.normalizeExtractionString(party.documentNumber),
+                email: this.normalizeExtractionString(party.email),
+                phone: this.normalizeExtractionString(party.phone),
+                isPrimary: this.normalizeExtractionBoolean(party.isPrimary),
+            }))
+                .filter((party) => party.displayName),
+            signatures: this.normalizeObjectList(raw.signatures)
+                .map((signature) => ({
+                signerName: this.normalizeExtractionString(signature.signerName),
+                signerRole: this.normalizeExtractionString(signature.signerRole),
+                signerEmail: this.normalizeExtractionString(signature.signerEmail),
+                status: this.normalizeEnumValue(signature.status, SIGNATURE_ITEM_STATUS_VALUES, 'pending'),
+                signedAt: this.normalizeExtractionDate(signature.signedAt),
+            }))
+                .filter((signature) => signature.signerName),
+            financialTerms: this.normalizeObjectList(raw.financialTerms)
+                .map((term) => ({
+                label: this.normalizeExtractionString(term.label),
+                termType: this.normalizeEnumValue(term.termType, FINANCIAL_TERM_TYPE_VALUES, 'value'),
+                amount: this.normalizeExtractionNumber(term.amount),
+                recurrence: this.normalizeEnumValue(term.recurrence, RECURRENCE_VALUES, 'one_time'),
+                dueDay: this.normalizeExtractionNumber(term.dueDay),
+                notes: this.normalizeExtractionString(term.notes),
+            }))
+                .filter((term) => term.label),
+            revisions: this.normalizeObjectList(raw.revisions)
+                .map((revision) => ({
+                title: this.normalizeExtractionString(revision.title),
+                revisionType: this.normalizeEnumValue(revision.revisionType, REVISION_TYPE_VALUES, 'revision'),
+                effectiveDate: this.normalizeExtractionDate(revision.effectiveDate),
+                status: this.normalizeEnumValue(revision.status, REVISION_STATUS_VALUES, 'draft'),
+                summary: this.normalizeExtractionString(revision.summary),
+            }))
+                .filter((revision) => revision.title),
+        };
+        if (!draft.name)
+            missingFields.push('Contract title');
+        if (!draft.clientName)
+            missingFields.push('Client name');
+        if (!draft.startDate)
+            missingFields.push('Start date');
+        if (!draft.contentHtml && !draft.summary && !draft.description) {
+            warnings.push('The contract body was not extracted with enough confidence. Use the editor to complete it.');
+        }
+        if (!draft.parties.length) {
+            warnings.push('No related parties were identified with confidence.');
+        }
+        return Object.assign(Object.assign({}, draft), { summary: draft.summary || draft.description || draft.name, missingFields: Array.from(new Set(missingFields.filter(Boolean))), warnings: Array.from(new Set(warnings.filter(Boolean))) });
+    }
+    normalizeExtractionString(value) {
+        return typeof value === 'string'
+            ? value.trim()
+            : value === null || value === undefined
+                ? ''
+                : String(value).trim();
+    }
+    normalizeExtractionBoolean(value) {
+        if (typeof value === 'boolean') {
+            return value;
+        }
+        const normalized = this.normalizeExtractionString(value).toLowerCase();
+        return normalized === 'true' || normalized === '1' || normalized === 'yes';
+    }
+    normalizeExtractionNumber(value) {
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            return value;
+        }
+        const normalized = this.normalizeExtractionString(value);
+        if (!normalized) {
+            return '';
+        }
+        const direct = Number(normalized);
+        if (Number.isFinite(direct)) {
+            return direct;
+        }
+        const ptBr = normalized
+            .split('.')
+            .join('')
+            .replace(',', '.');
+        const parsed = Number(ptBr);
+        return Number.isFinite(parsed) ? parsed : normalized;
+    }
+    normalizeExtractionDate(value) {
+        var _a;
+        const normalized = this.normalizeExtractionString(value);
+        if (!normalized) {
+            return '';
+        }
+        const match = normalized.match(/\d{4}-\d{2}-\d{2}/);
+        return (_a = match === null || match === void 0 ? void 0 : match[0]) !== null && _a !== void 0 ? _a : '';
+    }
+    normalizeStringList(value) {
+        return Array.isArray(value)
+            ? value
+                .map((item) => this.normalizeExtractionString(item))
+                .filter(Boolean)
+            : [];
+    }
+    normalizeObjectList(value) {
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        return value.filter((item) => Boolean(item) && typeof item === 'object');
+    }
+    normalizeEnumValue(value, allowed, fallback) {
+        const normalized = this.normalizeExtractionString(value);
+        return allowed.includes(normalized) ? normalized : fallback;
+    }
+    normalizeContractExtractionMimeType(mimeType, fileName) {
+        const current = this.normalizeExtractionString(mimeType).toLowerCase();
+        if (current && current !== 'application/octet-stream') {
+            return current;
+        }
+        const name = this.normalizeExtractionString(fileName).toLowerCase();
+        if (name.endsWith('.pdf'))
+            return 'application/pdf';
+        if (name.endsWith('.doc'))
+            return 'application/msword';
+        if (name.endsWith('.docx')) {
+            return 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
+        }
+        return current || 'application/octet-stream';
+    }
+    isAllowedContractExtractionMimeType(mimeType) {
+        return [
+            'application/pdf',
+            'application/msword',
+            'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        ].includes(mimeType);
+    }
     requireFields(input, required) {
         for (const field of required) {
             const value = input[field];
@@ -2223,15 +4538,18 @@ let OperationsService = class OperationsService {
             ...new Set(values.filter((value) => typeof value === 'number')),
         ];
     }
-    pushUpdate(updates, params, column, value) {
+    pushUpdate(updates, params, column, value, castType) {
         if (value === undefined)
             return;
         params.push(value);
-        updates.push(`${column} = $${params.length}`);
+        const placeholder = castType
+            ? `$${params.length}::${castType}`
+            : `$${params.length}`;
+        updates.push(`${column} = ${placeholder}`);
     }
-    param(params, value) {
+    param(params, value, castType) {
         params.push(value);
-        return `$${params.length}`;
+        return castType ? `$${params.length}::${castType}` : `$${params.length}`;
     }
     groupBy(items, key) {
         return items.reduce((accumulator, item) => {
@@ -2257,7 +4575,12 @@ let OperationsService = class OperationsService {
 exports.OperationsService = OperationsService;
 exports.OperationsService = OperationsService = __decorate([
     (0, common_1.Injectable)(),
+    __param(3, (0, common_1.Inject)((0, common_1.forwardRef)(() => core_1.FileService))),
+    __param(4, (0, common_1.Inject)((0, common_1.forwardRef)(() => core_1.SettingService))),
     __metadata("design:paramtypes", [api_prisma_1.PrismaService,
-        core_1.IntegrationDeveloperApiService])
+        core_1.AiService,
+        core_1.IntegrationDeveloperApiService,
+        core_1.FileService,
+        core_1.SettingService])
 ], OperationsService);
 //# sourceMappingURL=operations.service.js.map