@hed-hog/operations 0.0.300 → 0.0.301

package/hedhog/table/operations_collaborator.yaml

@@ -2,6 +2,15 @@ columns:
   - type: pk
   - name: user_id
     type: int
+    isNullable: true
+  - name: person_id
+    type: fk
+    isNullable: true
+    references:
+      table: person
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
   - name: supervisor_collaborator_id
     type: fk
     isNullable: true
@@ -24,6 +33,14 @@ columns:
     type: varchar
     length: 120
     isNullable: true
+  - name: department_id
+    type: fk
+    isNullable: true
+    references:
+      table: operations_department
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
   - name: title
     type: varchar
     length: 120
@@ -59,9 +76,12 @@ columns:
 indices:
   - columns: [user_id]
     isUnique: true
+  - columns: [person_id]
+    isUnique: true
   - columns: [code]
     isUnique: true
   - columns: [collaborator_type]
   - columns: [supervisor_collaborator_id]
+  - columns: [department_id]
   - columns: [status]
   - columns: [deleted_at]

package/hedhog/table/operations_contract.yaml

@@ -6,6 +6,7 @@ columns:
   - name: name
     type: varchar
     length: 180
+    isNullable: true
   - name: contract_category
     type: enum
     values: [employee, contractor, client, supplier, vendor, partner, internal, other]
@@ -17,6 +18,7 @@ columns:
   - name: client_name
     type: varchar
     length: 180
+    isNullable: true
   - name: signature_status
     type: enum
     values: [not_started, pending, partially_signed, signed, expired]
@@ -44,15 +46,24 @@ columns:
       column: id
       onDelete: SET NULL
       onUpdate: CASCADE
+  - name: contract_template_id
+    type: fk
+    isNullable: true
+    references:
+      table: operations_contract_template
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
   - name: origin_type
     type: enum
-    values: [manual, employee_hiring, client_project]
+    values: [manual, employee_hiring, client_project, crm_proposal]
     default: manual
   - name: origin_id
     type: int
     isNullable: true
   - name: start_date
     type: date
+    isNullable: true
   - name: end_date
     type: date
     isNullable: true
@@ -74,6 +85,13 @@ columns:
     type: enum
     values: [draft, under_review, active, renewal, expired, closed, archived]
     default: draft
+  - name: creation_mode
+    type: enum
+    values: [blank, template, upload, duplicate]
+    default: blank
+  - name: wizard_step
+    type: int
+    default: 0
   - name: description
     type: text
     isNullable: true
@@ -97,6 +115,7 @@ indices:
     isUnique: true
   - columns: [account_manager_collaborator_id]
   - columns: [related_collaborator_id]
+  - columns: [contract_template_id]
   - columns: [contract_category]
   - columns: [contract_type]
   - columns: [origin_type]
@@ -104,6 +123,8 @@ indices:
   - columns: [signature_status]
   - columns: [is_active]
   - columns: [status]
+  - columns: [creation_mode]
+  - columns: [wizard_step]
   - columns: [start_date]
   - columns: [end_date]
   - columns: [deleted_at]

package/hedhog/table/operations_contract_document.yaml

@@ -7,25 +7,40 @@ columns:
       column: id
       onDelete: CASCADE
       onUpdate: CASCADE
-  - name: document_type
-    type: enum
-    values: [uploaded_pdf, generated_pdf, attachment, other]
-    default: attachment
-  - name: file_name
-    type: varchar
-    length: 200
+  - name: document_type
+    type: enum
+    values: [source_upload, generated_pdf, attachment, other]
+    default: attachment
+  - name: file_id
+    type: fk
+    isNullable: true
+    references:
+      table: file
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: file_name
+    type: varchar
+    length: 200
   - name: mime_type
     type: varchar
     length: 120
   - name: file_content_base64
     type: text
     isNullable: true
-  - name: is_current
-    type: boolean
-    default: true
-  - name: notes
-    type: text
-    isNullable: true
+  - name: is_current
+    type: boolean
+    default: true
+  - name: extraction_status
+    type: enum
+    values: [pending, processing, completed, failed, skipped]
+    default: skipped
+  - name: extraction_summary
+    type: text
+    isNullable: true
+  - name: notes
+    type: text
+    isNullable: true
   - name: deleted_at
     type: datetime
     isNullable: true
@@ -34,6 +49,8 @@ columns:
 
 indices:
   - columns: [contract_id]
-  - columns: [document_type]
-  - columns: [is_current]
-  - columns: [deleted_at]
+  - columns: [document_type]
+  - columns: [file_id]
+  - columns: [is_current]
+  - columns: [extraction_status]
+  - columns: [deleted_at]

package/hedhog/table/operations_contract_template.yaml

@@ -0,0 +1,58 @@
+columns:
+  - type: pk
+  - type: slug
+  - name: code
+    type: varchar
+    length: 40
+    isNullable: true
+  - name: name
+    type: varchar
+    length: 180
+  - name: description
+    type: text
+    isNullable: true
+  - name: contract_category
+    type: enum
+    values: [employee, contractor, client, supplier, vendor, partner, internal, other]
+    default: client
+  - name: contract_type
+    type: enum
+    values: [clt, pj, freelancer_agreement, service_agreement, fixed_term, recurring_service, nda, amendment, addendum, other]
+    default: service_agreement
+  - name: billing_model
+    type: enum
+    values: [time_and_material, monthly_retainer, fixed_price]
+    default: time_and_material
+  - name: signature_status
+    type: enum
+    values: [not_started, pending, partially_signed, signed, expired]
+    default: not_started
+  - name: is_active
+    type: boolean
+    default: true
+  - name: status
+    type: enum
+    values: [draft, active, inactive, archived]
+    default: active
+  - name: content_html
+    type: text
+    isNullable: true
+  - name: deleted_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [slug]
+    isUnique: true
+  - columns: [code]
+    isUnique: true
+  - columns: [name]
+  - columns: [contract_category]
+  - columns: [contract_type]
+  - columns: [billing_model]
+  - columns: [signature_status]
+  - columns: [is_active]
+  - columns: [status]
+  - columns: [deleted_at]

package/hedhog/table/operations_department.yaml

@@ -0,0 +1,24 @@
+columns:
+  - type: pk
+  - type: slug
+  - name: code
+    type: varchar
+    length: 32
+    isNullable: true
+  - name: name
+    type: varchar
+    length: 120
+  - name: description
+    type: text
+    isNullable: true
+  - name: deleted_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [code]
+    isUnique: true
+  - columns: [name]
+  - columns: [deleted_at]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/operations",
-  "version": "0.0.300",
+  "version": "0.0.301",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -10,11 +10,12 @@
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
     "@hed-hog/api": "0.0.6",
-    "@hed-hog/api-pagination": "0.0.7",
     "@hed-hog/api-types": "0.0.1",
-    "@hed-hog/api-locale": "0.0.14",
     "@hed-hog/api-prisma": "0.0.6",
-    "@hed-hog/core": "0.0.300"
+    "@hed-hog/api-locale": "0.0.14",
+    "@hed-hog/api-pagination": "0.0.7",
+    "@hed-hog/core": "0.0.301",
+    "@hed-hog/contact": "0.0.301"
   },
   "exports": {
     ".": {
@@ -30,6 +31,7 @@
   ],
   "scripts": {
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\"",
+    "test": "jest --config jest.config.ts --runInBand",
     "prebuild": "pnpm --dir ../.. exec ts-node ./scripts/build-dependencies.ts libraries/operations",
     "build": "tsc --project tsconfig.production.json",
     "patch": "pnpm exec ts-node ../../scripts/patch.ts libraries/operations",

package/src/operations.controller.ts

@@ -2,6 +2,7 @@ import { Role, User } from '@hed-hog/api';
 import {
     Body,
     Controller,
+    Delete,
     Get,
     Param,
     ParseIntPipe,
@@ -61,6 +62,25 @@ export class OperationsController {
     );
   }
 
+  @Get('departments')
+  listDepartments(@User() user) {
+    return this.operationsService.listDepartments(Number(user?.id || 0));
+  }
+
+  @Post('departments')
+  createDepartment(@User() user, @Body() data) {
+    return this.operationsService.createDepartment(Number(user?.id || 0), data);
+  }
+
+  @Patch('departments/:id')
+  updateDepartment(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.updateDepartment(Number(user?.id || 0), id, data);
+  }
+
   @Get('projects')
   listProjects(@User() user) {
     return this.operationsService.listProjects(Number(user?.id || 0));
@@ -81,6 +101,40 @@ export class OperationsController {
     return this.operationsService.updateProject(Number(user?.id || 0), id, data);
   }
 
+  @Get('contract-templates')
+  listContractTemplates(@User() user) {
+    return this.operationsService.listContractTemplates(Number(user?.id || 0));
+  }
+
+  @Get('contract-templates/:id')
+  getContractTemplate(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.getContractTemplateById(
+      Number(user?.id || 0),
+      id
+    );
+  }
+
+  @Post('contract-templates')
+  createContractTemplate(@User() user, @Body() data) {
+    return this.operationsService.createContractTemplate(
+      Number(user?.id || 0),
+      data
+    );
+  }
+
+  @Patch('contract-templates/:id')
+  updateContractTemplate(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.updateContractTemplate(
+      Number(user?.id || 0),
+      id,
+      data
+    );
+  }
+
   @Get('contracts')
   listContracts(@User() user) {
     return this.operationsService.listContracts(Number(user?.id || 0));
@@ -91,11 +145,63 @@ export class OperationsController {
     return this.operationsService.getContractById(Number(user?.id || 0), id);
   }
 
+  @Post('contracts/drafts')
+  createContractDraft(@User() user, @Body() data) {
+    return this.operationsService.createContractDraft(Number(user?.id || 0), data);
+  }
+
   @Post('contracts')
   createContract(@User() user, @Body() data) {
     return this.operationsService.createContract(Number(user?.id || 0), data);
   }
 
+  @Post('contracts/extract-draft')
+  extractContractDraft(@User() user, @Body() data) {
+    return this.operationsService.extractContractDraft(
+      Number(user?.id || 0),
+      data
+    );
+  }
+
+  @Post('contracts/:id/extract-source')
+  extractContractSource(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.extractContractSource(
+      Number(user?.id || 0),
+      id,
+      data
+    );
+  }
+
+  @Post('contracts/:id/generate-content')
+  generateContractContent(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.generateContractContent(
+      Number(user?.id || 0),
+      id,
+      data
+    );
+  }
+
+  @Post('contracts/:id/legal-review')
+  reviewContractLegally(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.reviewContractLegally(
+      Number(user?.id || 0),
+      id,
+      data
+    );
+  }
+
   @Patch('contracts/:id')
   updateContract(
     @User() user,
@@ -105,6 +211,22 @@ export class OperationsController {
     return this.operationsService.updateContract(Number(user?.id || 0), id, data);
   }
 
+  @Delete('contracts/:id')
+  removeContract(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.removeContract(Number(user?.id || 0), id);
+  }
+
+  @Post('contracts/:id/generate-pdf')
+  generateContractPdf(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number
+  ) {
+    return this.operationsService.generateContractPdf(
+      Number(user?.id || 0),
+      id
+    );
+  }
+
   @Get('timesheets')
   listTimesheets(@User() user) {
     return this.operationsService.listTimesheets(Number(user?.id || 0));

package/src/operations.module.ts

@@ -1,10 +1,11 @@
 import { LocaleModule } from '@hed-hog/api-locale';
 import { PaginationModule } from '@hed-hog/api-pagination';
 import { PrismaModule } from '@hed-hog/api-prisma';
-import { IntegrationModule } from '@hed-hog/core';
+import { AiModule, FileModule, IntegrationModule, SettingModule } from '@hed-hog/core';
 import { forwardRef, Module } from '@nestjs/common';
 import { ConfigModule } from '@nestjs/config';
 import { OperationsController } from './operations.controller';
+import { OperationsProposalSubscriber } from './operations.proposal.subscriber';
 import { OperationsService } from './operations.service';
 
 @Module({
@@ -13,10 +14,13 @@ import { OperationsService } from './operations.service';
     forwardRef(() => PaginationModule),
     forwardRef(() => PrismaModule),
     forwardRef(() => LocaleModule),
+    forwardRef(() => AiModule),
+    forwardRef(() => FileModule),
     forwardRef(() => IntegrationModule),
+    forwardRef(() => SettingModule),
   ],
   controllers: [OperationsController],
-  providers: [OperationsService],
+  providers: [OperationsService, OperationsProposalSubscriber],
   exports: [OperationsService],
 })
 export class OperationsModule {}

package/src/operations.proposal.subscriber.spec.ts

@@ -0,0 +1,121 @@
+/// <reference types="jest" />
+
+import { OperationsProposalSubscriber } from './operations.proposal.subscriber';
+
+describe('OperationsProposalSubscriber', () => {
+  let integrationApi: {
+    subscribeMany: jest.Mock;
+    findLinksBySource: jest.Mock;
+    createLink: jest.Mock;
+  };
+  let operationsService: {
+    createContractFromProposalIntegration: jest.Mock;
+  };
+  let subscriber: OperationsProposalSubscriber;
+
+  beforeEach(() => {
+    integrationApi = {
+      subscribeMany: jest.fn(),
+      findLinksBySource: jest.fn(),
+      createLink: jest.fn().mockResolvedValue(undefined),
+    };
+
+    operationsService = {
+      createContractFromProposalIntegration: jest
+        .fn()
+        .mockResolvedValue({ id: 88, code: 'CTR-088' }),
+    };
+
+    subscriber = new OperationsProposalSubscriber(
+      integrationApi as any,
+      operationsService as any,
+    );
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('registers handlers for the proposal approval and conversion flow', () => {
+    subscriber.onModuleInit();
+
+    const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+
+    expect(subscriptions).toHaveLength(2);
+    expect(subscriptions.map((entry: { eventName: string }) => entry.eventName)).toEqual(
+      expect.arrayContaining([
+        'contact.proposal.convert_requested',
+        'contact.proposal.approved',
+      ]),
+    );
+  });
+
+  it('skips duplicate contract generation when the integration link already exists', async () => {
+    subscriber.onModuleInit();
+
+    const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+    const convertRequested = subscriptions.find(
+      (entry: { eventName: string }) => entry.eventName === 'contact.proposal.convert_requested',
+    );
+
+    integrationApi.findLinksBySource.mockResolvedValue([
+      {
+        targetModule: 'operations',
+        targetEntityType: 'contract',
+        targetEntityId: '88',
+      },
+    ]);
+
+    await convertRequested.handler({
+      eventName: 'contact.proposal.convert_requested',
+      sourceModule: 'contact',
+      aggregateType: 'proposal',
+      aggregateId: '1001',
+      payload: {
+        proposalId: 1001,
+      },
+    });
+
+    expect(operationsService.createContractFromProposalIntegration).not.toHaveBeenCalled();
+    expect(integrationApi.createLink).not.toHaveBeenCalled();
+  });
+
+  it('creates the integration link after generating a contract draft', async () => {
+    subscriber.onModuleInit();
+
+    const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+    const approved = subscriptions.find(
+      (entry: { eventName: string }) => entry.eventName === 'contact.proposal.approved',
+    );
+
+    integrationApi.findLinksBySource.mockResolvedValue([]);
+
+    await approved.handler({
+      eventName: 'contact.proposal.approved',
+      sourceModule: 'contact',
+      aggregateType: 'proposal',
+      aggregateId: '1002',
+      payload: {
+        proposalId: 1002,
+      },
+    });
+
+    expect(operationsService.createContractFromProposalIntegration).toHaveBeenCalledWith({
+      proposalId: 1002,
+    });
+    expect(integrationApi.createLink).toHaveBeenCalledWith(
+      expect.objectContaining({
+        sourceModule: 'contact',
+        sourceEntityType: 'proposal',
+        sourceEntityId: '1002',
+        targetModule: 'operations',
+        targetEntityType: 'contract',
+        targetEntityId: '88',
+        metadata: expect.objectContaining({
+          eventName: 'contact.proposal.approved',
+          contractCode: 'CTR-088',
+        }),
+      }),
+    );
+  });
+});

package/src/operations.proposal.subscriber.ts

@@ -0,0 +1,86 @@
+import {
+    IntegrationDeveloperApiService,
+    LinkType,
+} from '@hed-hog/core';
+import { Injectable, Logger, OnModuleInit } from '@nestjs/common';
+import { OperationsService } from './operations.service';
+
+@Injectable()
+export class OperationsProposalSubscriber implements OnModuleInit {
+  private readonly logger = new Logger(OperationsProposalSubscriber.name);
+
+  constructor(
+    private readonly integrationApi: IntegrationDeveloperApiService,
+    private readonly operationsService: OperationsService,
+  ) {}
+
+  onModuleInit(): void {
+    const handler = async (event) => {
+      const payload = (event.payload || {}) as {
+        proposalId?: number;
+      };
+      const sourceEntityType =
+        String(event.aggregateType || '').trim() || 'proposal';
+      const sourceEntityId =
+        String(payload.proposalId || event.aggregateId || '').trim() ||
+        event.aggregateId;
+
+      if (!sourceEntityId) {
+        throw new Error(`Missing proposal aggregate id for ${event.eventName}.`);
+      }
+
+      const existingLinks = await this.integrationApi.findLinksBySource({
+        module: event.sourceModule,
+        entityType: sourceEntityType,
+        entityId: sourceEntityId,
+      });
+
+      const alreadyLinked = existingLinks.some(
+        (link) =>
+          link.targetModule === 'operations' &&
+          link.targetEntityType === 'contract',
+      );
+
+      if (alreadyLinked) {
+        this.logger.debug(
+          `Skipping duplicate contract generation for ${sourceEntityType}:${sourceEntityId} from ${event.eventName}`,
+        );
+        return;
+      }
+
+      const createdContract =
+        await this.operationsService.createContractFromProposalIntegration(
+          event.payload || {},
+        );
+
+      await this.integrationApi.createLink({
+        sourceModule: event.sourceModule,
+        sourceEntityType,
+        sourceEntityId,
+        targetModule: 'operations',
+        targetEntityType: 'contract',
+        targetEntityId: String(createdContract.id),
+        linkType: LinkType.REFERENCE,
+        metadata: {
+          eventName: event.eventName,
+          contractCode: createdContract.code,
+        },
+      });
+    };
+
+    this.integrationApi.subscribeMany([
+      {
+        eventName: 'contact.proposal.convert_requested',
+        consumerName: 'operations.contract-from-proposal',
+        priority: 10,
+        handler,
+      },
+      {
+        eventName: 'contact.proposal.approved',
+        consumerName: 'operations.contract-from-proposal-legacy',
+        priority: 5,
+        handler,
+      },
+    ]);
+  }
+}