@hed-hog/contact 0.0.300 → 0.0.302

package/hedhog/table/proposal.yaml

@@ -0,0 +1,112 @@
+columns:
+  - type: pk
+  - name: person_id
+    type: fk
+    references:
+      table: person
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: code
+    type: varchar
+    length: 40
+  - name: title
+    type: varchar
+    length: 180
+  - name: status
+    type: enum
+    values: [draft, pending_approval, approved, rejected, cancelled, expired, contract_generated]
+    default: draft
+  - 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: fixed_price
+  - name: currency_code
+    type: varchar
+    length: 8
+    default: BRL
+  - name: valid_from
+    type: datetime
+    isNullable: true
+  - name: valid_until
+    type: datetime
+    isNullable: true
+  - name: subtotal_amount_cents
+    type: int
+    default: 0
+  - name: discount_amount_cents
+    type: int
+    default: 0
+  - name: tax_amount_cents
+    type: int
+    default: 0
+  - name: total_amount_cents
+    type: int
+    default: 0
+  - name: notes
+    type: text
+    isNullable: true
+  - name: owner_user_id
+    type: fk
+    isNullable: true
+    references:
+      table: user
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: created_by_user_id
+    type: fk
+    isNullable: true
+    references:
+      table: user
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: updated_by_user_id
+    type: fk
+    isNullable: true
+    references:
+      table: user
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: approved_by_user_id
+    type: fk
+    isNullable: true
+    references:
+      table: user
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: approved_at
+    type: datetime
+    isNullable: true
+  - name: contract_generated_at
+    type: datetime
+    isNullable: true
+  - name: current_revision_number
+    type: int
+    default: 0
+  - name: deleted_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [code]
+    isUnique: true
+  - columns: [person_id]
+  - columns: [person_id, status]
+  - columns: [status]
+  - columns: [valid_until]
+  - columns: [approved_at]
+  - columns: [deleted_at]

package/hedhog/table/proposal_approval.yaml

@@ -0,0 +1,63 @@
+columns:
+  - type: pk
+  - name: proposal_id
+    type: fk
+    references:
+      table: proposal
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: proposal_revision_id
+    type: fk
+    references:
+      table: proposal_revision
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: requester_user_id
+    type: fk
+    isNullable: true
+    references:
+      table: user
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: approver_user_id
+    type: fk
+    isNullable: true
+    references:
+      table: user
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: step_order
+    type: int
+    default: 1
+  - name: status
+    type: enum
+    values: [pending, approved, rejected, cancelled]
+    default: pending
+  - name: submitted_at
+    type: datetime
+  - name: decided_at
+    type: datetime
+    isNullable: true
+  - name: decision_note
+    type: text
+    isNullable: true
+  - name: deleted_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [proposal_id]
+  - columns: [proposal_revision_id, step_order]
+    isUnique: true
+  - columns: [requester_user_id]
+  - columns: [approver_user_id]
+  - columns: [status]
+  - columns: [submitted_at]
+  - columns: [decided_at]
+  - columns: [deleted_at]

package/hedhog/table/proposal_document.yaml

@@ -0,0 +1,77 @@
+columns:
+  - type: pk
+  - name: proposal_id
+    type: fk
+    references:
+      table: proposal
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: proposal_revision_id
+    type: fk
+    isNullable: true
+    references:
+      table: proposal_revision
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: document_type
+    type: enum
+    values: [source_upload, generated_pdf, approval_attachment, signed_copy, 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: source_kind
+    type: enum
+    values: [manual, generated, imported, ai_assisted]
+    default: manual
+  - 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: uploaded_by_user_id
+    type: fk
+    isNullable: true
+    references:
+      table: user
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: deleted_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [proposal_id]
+  - columns: [proposal_revision_id]
+  - columns: [document_type]
+  - columns: [file_id]
+  - columns: [is_current]
+  - columns: [extraction_status]
+  - columns: [deleted_at]

package/hedhog/table/proposal_item.yaml

@@ -0,0 +1,64 @@
+columns:
+  - type: pk
+  - name: proposal_revision_id
+    type: fk
+    references:
+      table: proposal_revision
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - type: order
+  - name: item_type
+    type: enum
+    values: [service, product, fee, discount, note, other]
+    default: service
+  - name: term_type
+    type: enum
+    values: [value, payment, revenue, fine, other]
+    default: value
+  - name: name
+    type: varchar
+    length: 180
+  - name: description
+    type: text
+    isNullable: true
+  - name: quantity
+    type: decimal
+    precision: 12
+    scale: 2
+    default: 1
+  - name: unit_amount_cents
+    type: int
+    default: 0
+  - name: total_amount_cents
+    type: int
+    default: 0
+  - name: recurrence
+    type: enum
+    values: [one_time, monthly, quarterly, yearly, other]
+    default: one_time
+  - name: due_day
+    type: int
+    isNullable: true
+  - name: start_date
+    type: date
+    isNullable: true
+  - name: end_date
+    type: date
+    isNullable: true
+  - name: metadata_json
+    type: json
+    isNullable: true
+  - name: deleted_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [proposal_revision_id]
+  - columns: [proposal_revision_id, order]
+  - columns: [item_type]
+  - columns: [term_type]
+  - columns: [recurrence]
+  - columns: [deleted_at]

package/hedhog/table/proposal_revision.yaml

@@ -0,0 +1,78 @@
+columns:
+  - type: pk
+  - name: proposal_id
+    type: fk
+    references:
+      table: proposal
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: revision_number
+    type: int
+  - name: status
+    type: enum
+    values: [draft, pending_approval, approved, rejected, cancelled, superseded]
+    default: draft
+  - name: generation_mode
+    type: enum
+    values: [manual, ai_assisted, duplicated, imported]
+    default: manual
+  - name: title
+    type: varchar
+    length: 180
+  - name: summary
+    type: text
+    isNullable: true
+  - name: content_html
+    type: text
+    isNullable: true
+  - name: snapshot_json
+    type: json
+    isNullable: true
+  - name: valid_until
+    type: datetime
+    isNullable: true
+  - name: subtotal_amount_cents
+    type: int
+    default: 0
+  - name: discount_amount_cents
+    type: int
+    default: 0
+  - name: tax_amount_cents
+    type: int
+    default: 0
+  - name: total_amount_cents
+    type: int
+    default: 0
+  - name: submitted_at
+    type: datetime
+    isNullable: true
+  - name: approved_at
+    type: datetime
+    isNullable: true
+  - name: is_current
+    type: boolean
+    default: true
+  - name: created_by_user_id
+    type: fk
+    isNullable: true
+    references:
+      table: user
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: deleted_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [proposal_id, revision_number]
+    isUnique: true
+  - columns: [proposal_id]
+  - columns: [proposal_id, is_current]
+  - columns: [status]
+  - columns: [submitted_at]
+  - columns: [approved_at]
+  - columns: [deleted_at]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/contact",
-  "version": "0.0.300",
+  "version": "0.0.302",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -9,12 +9,12 @@
     "@nestjs/core": "^11",
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
-    "@hed-hog/core": "0.0.300",
+    "@hed-hog/api-prisma": "0.0.6",
     "@hed-hog/api-locale": "0.0.14",
     "@hed-hog/api-mail": "0.0.9",
-    "@hed-hog/api-prisma": "0.0.6",
+    "@hed-hog/core": "0.0.302",
+    "@hed-hog/address": "0.0.302",
     "@hed-hog/api": "0.0.6",
-    "@hed-hog/address": "0.0.300",
     "@hed-hog/api-pagination": "0.0.7"
   },
   "exports": {
@@ -31,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/contact",
     "build": "tsc --project tsconfig.production.json",
     "patch": "npx ts-node ../../scripts/patch.ts libraries/contact",

package/src/contact.module.ts

@@ -11,6 +11,7 @@ import { ContactService } from './contact.service';
 import { PersonDocumentTypeModule } from './document-type/document-type.module';
 import { PersonRelationTypeModule } from './person-relation-type/person-relation-type.module';
 import { PersonModule } from './person/person.module';
+import { ProposalModule } from './proposal/proposal.module';
 
 @Module({
   imports: [
@@ -33,6 +34,7 @@ import { PersonModule } from './person/person.module';
     forwardRef(() => PrismaModule),
     forwardRef(() => PaginationModule),
     forwardRef(() => PersonModule),
+    forwardRef(() => ProposalModule),
     forwardRef(() => PersonContactTypeModule),
     forwardRef(() => PersonDocumentTypeModule),
     forwardRef(() => PersonRelationTypeModule),

package/src/index.ts

@@ -1,5 +1,8 @@
 export * from './contact.module';
 export * from './contact.service';
+export * from './proposal/proposal-event.types';
+export * from './proposal/proposal.module';
+export * from './proposal/proposal.service';
 
 export * from './address-type.enum';
 export * from './contact-type/contact-type.enum';

package/src/person/person.service.spec.ts

@@ -0,0 +1,143 @@
+/// <reference types="jest" />
+import { PersonInteractionTypeDTO } from './dto/create-interaction.dto';
+import { PersonService } from './person.service';
+
+describe('PersonService CRM interaction/follow-up regression coverage', () => {
+  let prisma: any;
+  let tx: any;
+  let service: PersonService;
+
+  beforeEach(() => {
+    tx = {
+      crm_activity: {
+        findFirst: jest.fn().mockResolvedValue(null),
+        create: jest.fn().mockResolvedValue({ id: 1 }),
+        update: jest.fn().mockResolvedValue({ id: 1 }),
+      },
+    };
+
+    prisma = {
+      $transaction: jest.fn().mockImplementation(async (callback: any) =>
+        callback(tx)
+      ),
+    };
+
+    service = new PersonService(
+      prisma as any,
+      {} as any,
+      {} as any,
+      {
+        getSettingValues: jest.fn().mockResolvedValue({}),
+      } as any
+    );
+
+    jest
+      .spyOn(service as any, 'ensurePersonAccessible')
+      .mockResolvedValue({ id: 42, type: 'individual', status: 'active' });
+    jest.spyOn(service as any, 'getPersonOwnerUserId').mockResolvedValue(7);
+    jest.spyOn(service as any, 'loadInteractionsFromTx').mockResolvedValue([]);
+    jest.spyOn(service as any, 'upsertMetadataValue').mockResolvedValue(undefined);
+  });
+
+  it('persists a completed crm activity when registering an interaction', async () => {
+    await service.createInteraction(
+      42,
+      {
+        type: PersonInteractionTypeDTO.CALL,
+        notes: 'Ligação inicial',
+      },
+      'en',
+      { id: 9, name: 'Root User' }
+    );
+
+    expect(tx.crm_activity.create).toHaveBeenCalledWith(
+      expect.objectContaining({
+        data: expect.objectContaining({
+          person_id: 42,
+          owner_user_id: 7,
+          created_by_user_id: 9,
+          completed_by_user_id: 9,
+          type: PersonInteractionTypeDTO.CALL,
+          subject: 'Call',
+          notes: 'Ligação inicial',
+          priority: 'medium',
+          source_kind: 'interaction',
+          due_at: expect.any(Date),
+          completed_at: expect.any(Date),
+          created_at: expect.any(Date),
+          updated_at: expect.any(Date),
+        }),
+      })
+    );
+  });
+
+  it('creates an open follow-up activity when none exists', async () => {
+    tx.crm_activity.findFirst.mockResolvedValue(null);
+
+    await service.scheduleFollowup(
+      42,
+      {
+        next_action_at: '2026-04-09T13:48:31.715Z',
+        notes: 'Retornar por telefone',
+      },
+      'en',
+      { id: 9, name: 'Root User' }
+    );
+
+    expect(tx.crm_activity.findFirst).toHaveBeenCalledWith({
+      where: {
+        person_id: 42,
+        source_kind: 'followup',
+        completed_at: null,
+      },
+      orderBy: {
+        id: 'desc',
+      },
+    });
+
+    expect(tx.crm_activity.create).toHaveBeenCalledWith(
+      expect.objectContaining({
+        data: expect.objectContaining({
+          person_id: 42,
+          owner_user_id: 7,
+          created_by_user_id: 9,
+          type: 'task',
+          subject: 'Follow-up',
+          notes: 'Retornar por telefone',
+          priority: 'medium',
+          source_kind: 'followup',
+          due_at: new Date('2026-04-09T13:48:31.715Z'),
+        }),
+      })
+    );
+  });
+
+  it('updates the existing open follow-up activity when rescheduling', async () => {
+    tx.crm_activity.findFirst.mockResolvedValue({ id: 88 });
+
+    await service.scheduleFollowup(
+      42,
+      {
+        next_action_at: '2026-04-10T15:00:00.000Z',
+        notes: 'Reagendar reunião',
+      },
+      'en',
+      { id: 11, name: 'Owner User' }
+    );
+
+    expect(tx.crm_activity.update).toHaveBeenCalledWith({
+      where: {
+        id: 88,
+      },
+      data: expect.objectContaining({
+        owner_user_id: 7,
+        type: 'task',
+        subject: 'Follow-up',
+        notes: 'Reagendar reunião',
+        due_at: new Date('2026-04-10T15:00:00.000Z'),
+        priority: 'medium',
+        updated_at: expect.any(Date),
+      }),
+    });
+  });
+});