@hed-hog/operations 0.0.338 → 0.0.347

package/hedhog/frontend/messages/en.json

@@ -306,7 +306,11 @@
       "projects": "Projects",
       "tasks": "Tasks",
       "timesheets": "Timesheets",
-      "salary": "Compensation"
+      "salary": "Compensation",
+      "paymentHistory": "Payment History",
+      "paymentHistoryEmpty": "No payment records found for this collaborator.",
+      "invoices": "Invoices",
+      "invoicesEmpty": "No invoices have been submitted by this collaborator yet."
     },
     "sections": {
       "basicInfo": "Basic info",
@@ -341,6 +345,7 @@
       "collaboratorType": "Relationship type",
       "collaboratorTypeDescription": "Select the nature of the relationship with the company. Role and equity participation stay separate.",
       "weeklyCapacityHours": "Weekly workload",
+      "hourlyRate": "Hourly rate",
       "compensationAmount": "Compensation amount",
       "contract": "Contract",
       "contractPlaceholder": "Search or select a contract…",
@@ -417,7 +422,49 @@
       "createSuccess": "Collaborator created successfully.",
       "createError": "Unable to create the collaborator.",
       "updateSuccess": "Collaborator updated successfully.",
-      "updateError": "Unable to update the collaborator."
+      "updateError": "Unable to update the collaborator.",
+      "saveSuccess": "Saved successfully.",
+      "saveError": "Unable to save. Please try again.",
+      "deleteSuccess": "Deleted successfully.",
+      "deleteError": "Unable to delete. Please try again."
+    },
+    "paymentHistory": {
+      "add": "Add payment",
+      "editTitle": "Edit payment",
+      "deleteConfirm": "Are you sure you want to delete this payment?",
+      "amount": "Amount",
+      "paymentDate": "Payment date",
+      "referenceMonth": "Reference month",
+      "paymentMethod": "Payment method",
+      "notes": "Notes",
+      "methodBankTransfer": "Bank transfer",
+      "methodPix": "Pix",
+      "methodCheck": "Check",
+      "methodOther": "Other"
+    },
+    "invoices": {
+      "add": "Add invoice",
+      "editTitle": "Edit invoice",
+      "deleteConfirm": "Are you sure you want to delete this invoice?",
+      "invoiceNumber": "Invoice number",
+      "amount": "Amount",
+      "issueDate": "Issue date",
+      "dueDate": "Due date",
+      "status": "Status",
+      "description": "Description",
+      "statusPending": "Pending",
+      "statusPaid": "Paid",
+      "statusCancelled": "Cancelled",
+      "statusOverdue": "Overdue"
+    },
+    "projectAllocation": {
+      "total": "Total allocation",
+      "idle": "Idle capacity",
+      "overloaded": "Overloaded",
+      "distributeEqually": "Distribute equally",
+      "autoRebalance": "Auto-rebalance",
+      "autoRebalanceDescription": "Automatically adjust other projects when editing allocation",
+      "distributing": "Distributing..."
     },
     "chart": {
       "salaryHistory": "Salary history",
@@ -645,6 +692,47 @@
       "done": "Done"
     }
   },
+  "TasksGanttPage": {
+    "title": "Tasks Gantt",
+    "description": "Track tasks from every active project on a single timeline.",
+    "breadcrumb": "Tasks Gantt",
+    "searchPlaceholder": "Search task, project, or assignee...",
+    "viewDescription": "Tasks from active projects grouped by project.",
+    "loading": "Building Gantt view...",
+    "emptyDescription": "No tasks were found for active projects with the current filters.",
+    "loadErrorDescription": "We couldn't load the schedule right now. Refresh to try again.",
+    "noAccessDescription": "The consolidated Gantt view is available only to supervisors and directors.",
+    "actions": {
+      "openProject": "Open project"
+    },
+    "filters": {
+      "allProjects": "All projects",
+      "allStatuses": "All statuses",
+      "clearDateRange": "Clear date range"
+    },
+    "cards": {
+      "activeProjects": "Active projects",
+      "activeProjectsDescription": "Active projects with tasks on the schedule.",
+      "tasks": "Scheduled tasks",
+      "tasksDescription": "Items shown with the current filters.",
+      "doing": "In progress",
+      "doingDescription": "Tasks currently being executed.",
+      "overdue": "Overdue",
+      "overdueDescription": "Open tasks with an expired due date."
+    },
+    "labels": {
+      "projectTask": "Project and task",
+      "range": "{from} through {to}",
+      "tasksCount": "{count} task(s)"
+    },
+    "legend": {
+      "todo": "To do",
+      "doing": "In progress",
+      "review": "In review",
+      "done": "Done",
+      "overdue": "Overdue"
+    }
+  },
   "ProjectFormPage": {
     "newTitle": "New Project",
     "editTitle": "Edit Project",
@@ -950,6 +1038,12 @@
       "usedHours": "Used hours",
       "availability": "Availability",
       "overloadWarning": "{value}% above recommended capacity.",
+      "addCollaborator": "Add collaborator",
+      "addTitle": "Add collaborator",
+      "editTitle": "Edit allocation",
+      "formDescription": "Configure the collaborator's allocation data for this project.",
+      "removeTitle": "Remove collaborator",
+      "removeDescription": "Are you sure you want to remove this collaborator from the project?",
       "status": {
         "available": "Available",
         "high": "High load",

package/hedhog/frontend/messages/pt.json

@@ -304,7 +304,11 @@
       "projects": "Projetos",
       "tasks": "Tarefas",
       "timesheets": "Apontamentos",
-      "salary": "Remuneração"
+      "salary": "Remuneração",
+      "paymentHistory": "Histórico de Pagamentos",
+      "paymentHistoryEmpty": "Nenhum registro de pagamento encontrado para este colaborador.",
+      "invoices": "Notas Fiscais",
+      "invoicesEmpty": "Nenhuma nota fiscal enviada por este colaborador ainda."
     },
     "sections": {
       "basicInfo": "Informações básicas",
@@ -339,6 +343,7 @@
       "collaboratorType": "Tipo de colaborador",
       "collaboratorTypeDescription": "Selecione a natureza da relação com a empresa. Função e participação societária permanecem separadas.",
       "weeklyCapacityHours": "Carga horária semanal",
+      "hourlyRate": "Valor hora",
       "compensationAmount": "Valor da remuneração",
       "contract": "Contrato",
       "contractPlaceholder": "Pesquisar ou selecionar contrato…",
@@ -415,7 +420,49 @@
       "createSuccess": "Colaborador criado com sucesso.",
       "createError": "Não foi possível criar o colaborador.",
       "updateSuccess": "Colaborador atualizado com sucesso.",
-      "updateError": "Não foi possível atualizar o colaborador."
+      "updateError": "Não foi possível atualizar o colaborador.",
+      "saveSuccess": "Salvo com sucesso.",
+      "saveError": "Não foi possível salvar. Tente novamente.",
+      "deleteSuccess": "Excluído com sucesso.",
+      "deleteError": "Não foi possível excluir. Tente novamente."
+    },
+    "paymentHistory": {
+      "add": "Adicionar pagamento",
+      "editTitle": "Editar pagamento",
+      "deleteConfirm": "Tem certeza que deseja excluir este pagamento?",
+      "amount": "Valor",
+      "paymentDate": "Data do pagamento",
+      "referenceMonth": "Mês de referência",
+      "paymentMethod": "Forma de pagamento",
+      "notes": "Observações",
+      "methodBankTransfer": "Transferência bancária",
+      "methodPix": "Pix",
+      "methodCheck": "Cheque",
+      "methodOther": "Outro"
+    },
+    "invoices": {
+      "add": "Adicionar NF",
+      "editTitle": "Editar NF",
+      "deleteConfirm": "Tem certeza que deseja excluir esta nota fiscal?",
+      "invoiceNumber": "Número da NF",
+      "amount": "Valor",
+      "issueDate": "Data de emissão",
+      "dueDate": "Vencimento",
+      "status": "Status",
+      "description": "Descrição",
+      "statusPending": "Pendente",
+      "statusPaid": "Pago",
+      "statusCancelled": "Cancelado",
+      "statusOverdue": "Vencido"
+    },
+    "projectAllocation": {
+      "total": "Alocação total",
+      "idle": "Ociosidade",
+      "overloaded": "Sobrecarga",
+      "distributeEqually": "Distribuir igualmente",
+      "autoRebalance": "Auto-rebalancear",
+      "autoRebalanceDescription": "Ajustar automaticamente os outros projetos ao editar a alocação",
+      "distributing": "Distribuindo..."
     },
     "chart": {
       "salaryHistory": "Histórico de salário",
@@ -643,6 +690,47 @@
       "done": "Concluída"
     }
   },
+  "TasksGanttPage": {
+    "title": "Gantt de Tarefas",
+    "description": "Acompanhe tarefas de todos os projetos em execução em uma linha do tempo única.",
+    "breadcrumb": "Gantt de Tarefas",
+    "searchPlaceholder": "Buscar tarefa, projeto ou responsável...",
+    "viewDescription": "Tarefas dos projetos ativos agrupadas por projeto.",
+    "loading": "Montando visão de Gantt...",
+    "emptyDescription": "Nenhuma tarefa encontrada para os projetos em execução com os filtros atuais.",
+    "loadErrorDescription": "Não foi possível carregar o cronograma agora. Atualize para tentar novamente.",
+    "noAccessDescription": "A visão consolidada de Gantt está disponível apenas para supervisores e diretores.",
+    "actions": {
+      "openProject": "Abrir projeto"
+    },
+    "filters": {
+      "allProjects": "Todos os projetos",
+      "allStatuses": "Todos os status",
+      "clearDateRange": "Limpar período"
+    },
+    "cards": {
+      "activeProjects": "Projetos em execução",
+      "activeProjectsDescription": "Projetos ativos com tarefas no cronograma.",
+      "tasks": "Tarefas no cronograma",
+      "tasksDescription": "Itens exibidos conforme os filtros atuais.",
+      "doing": "Em andamento",
+      "doingDescription": "Tarefas sendo executadas agora.",
+      "overdue": "Atrasadas",
+      "overdueDescription": "Tarefas com prazo vencido e ainda abertas."
+    },
+    "labels": {
+      "projectTask": "Projeto e tarefa",
+      "range": "{from} até {to}",
+      "tasksCount": "{count} tarefa(s)"
+    },
+    "legend": {
+      "todo": "A fazer",
+      "doing": "Em andamento",
+      "review": "Em revisão",
+      "done": "Concluída",
+      "overdue": "Atrasada"
+    }
+  },
   "ProjectFormPage": {
     "newTitle": "Novo Projeto",
     "editTitle": "Editar Projeto",
@@ -948,6 +1036,12 @@
       "usedHours": "Horas utilizadas",
       "availability": "Disponibilidade",
       "overloadWarning": "{value}% acima da capacidade recomendada.",
+      "addCollaborator": "Adicionar colaborador",
+      "addTitle": "Adicionar colaborador",
+      "editTitle": "Editar alocação",
+      "formDescription": "Configure os dados de alocação do colaborador neste projeto.",
+      "removeTitle": "Remover colaborador",
+      "removeDescription": "Tem certeza que deseja remover este colaborador do projeto?",
       "status": {
         "available": "Disponível",
         "high": "Alta carga",

package/hedhog/table/operations_collaborator_invoice.yaml

@@ -0,0 +1,35 @@
+columns:
+  - type: pk
+  - name: collaborator_id
+    type: fk
+    references:
+      table: operations_collaborator
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: invoice_number
+    type: varchar
+    length: 50
+    isNullable: true
+  - name: amount
+    type: decimal
+    precision: 14
+    scale: 2
+  - name: issue_date
+    type: date
+  - name: due_date
+    type: date
+    isNullable: true
+  - name: status
+    type: enum
+    values: [pending, paid, cancelled, overdue]
+    default: pending
+  - name: description
+    type: text
+    isNullable: true
+  - type: created_at
+
+indices:
+  - columns: [collaborator_id]
+  - columns: [issue_date]
+  - columns: [status]

package/hedhog/table/operations_collaborator_payment.yaml

@@ -0,0 +1,32 @@
+columns:
+  - type: pk
+  - name: collaborator_id
+    type: fk
+    references:
+      table: operations_collaborator
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: amount
+    type: decimal
+    precision: 14
+    scale: 2
+  - name: payment_date
+    type: date
+  - name: reference_month
+    type: varchar
+    length: 7
+    isNullable: true
+  - name: payment_method
+    type: enum
+    values: [bank_transfer, pix, check, other]
+    default: pix
+  - name: notes
+    type: text
+    isNullable: true
+  - type: created_at
+
+indices:
+  - columns: [collaborator_id]
+  - columns: [payment_date]
+  - columns: [reference_month]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/operations",
-  "version": "0.0.338",
+  "version": "0.0.347",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -11,12 +11,12 @@
     "@nestjs/mapped-types": "*",
     "lucide-react": "^0.562.0",
     "@hed-hog/api-types": "0.0.1",
-    "@hed-hog/api": "0.0.8",
     "@hed-hog/api-locale": "0.0.14",
-    "@hed-hog/core": "0.0.338",
+    "@hed-hog/api": "0.0.8",
+    "@hed-hog/core": "0.0.347",
+    "@hed-hog/contact": "0.0.347",
     "@hed-hog/api-pagination": "0.0.7",
-    "@hed-hog/api-prisma": "0.0.6",
-    "@hed-hog/contact": "0.0.338"
+    "@hed-hog/api-prisma": "0.0.6"
   },
   "exports": {
     ".": {

package/src/controllers/operations-collaborators.controller.ts

@@ -2,6 +2,7 @@ import { Role, User } from '@hed-hog/api';
 import {
     Body,
     Controller,
+    Delete,
     Get,
     Param,
     ParseIntPipe,
@@ -9,9 +10,13 @@ import {
     Post,
     Query,
 } from '@nestjs/common';
+import { CreateCollaboratorInvoiceDto } from '../dto/create-collaborator-invoice.dto';
+import { CreateCollaboratorPaymentDto } from '../dto/create-collaborator-payment.dto';
 import { CreateCollaboratorProjectAssignmentDto } from '../dto/create-collaborator-project-assignment.dto';
 import { CreateCollaboratorDto } from '../dto/create-collaborator.dto';
 import { ListCollaboratorsDto } from '../dto/list-collaborators.dto';
+import { UpdateCollaboratorInvoiceDto } from '../dto/update-collaborator-invoice.dto';
+import { UpdateCollaboratorPaymentDto } from '../dto/update-collaborator-payment.dto';
 import { UpdateCollaboratorProjectAssignmentDto } from '../dto/update-collaborator-project-assignment.dto';
 import { UpdateCollaboratorDto } from '../dto/update-collaborator.dto';
 import { OperationsService } from '../operations.service';
@@ -58,6 +63,110 @@ export class OperationsCollaboratorsController {
     );
   }
 
+  @Get('collaborators/:id/payment-history')
+  getCollaboratorPaymentHistory(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+  ) {
+    return this.operationsService.getCollaboratorPaymentHistory(
+      Number(user?.id || 0),
+      id,
+    );
+  }
+
+  @Get('collaborators/:id/invoices')
+  getCollaboratorInvoices(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+  ) {
+    return this.operationsService.getCollaboratorInvoices(
+      Number(user?.id || 0),
+      id,
+    );
+  }
+
+  @Post('collaborators/:id/payment-history')
+  createCollaboratorPayment(
+    @User() user,
+    @Param('id', ParseIntPipe) collaboratorId: number,
+    @Body() data: CreateCollaboratorPaymentDto,
+  ) {
+    return this.operationsService.createCollaboratorPayment(
+      Number(user?.id || 0),
+      collaboratorId,
+      data,
+    );
+  }
+
+  @Patch('collaborators/:id/payment-history/:paymentId')
+  updateCollaboratorPayment(
+    @User() user,
+    @Param('id', ParseIntPipe) collaboratorId: number,
+    @Param('paymentId', ParseIntPipe) paymentId: number,
+    @Body() data: UpdateCollaboratorPaymentDto,
+  ) {
+    return this.operationsService.updateCollaboratorPayment(
+      Number(user?.id || 0),
+      collaboratorId,
+      paymentId,
+      data,
+    );
+  }
+
+  @Delete('collaborators/:id/payment-history/:paymentId')
+  deleteCollaboratorPayment(
+    @User() user,
+    @Param('id', ParseIntPipe) collaboratorId: number,
+    @Param('paymentId', ParseIntPipe) paymentId: number,
+  ) {
+    return this.operationsService.deleteCollaboratorPayment(
+      Number(user?.id || 0),
+      collaboratorId,
+      paymentId,
+    );
+  }
+
+  @Post('collaborators/:id/invoices')
+  createCollaboratorInvoice(
+    @User() user,
+    @Param('id', ParseIntPipe) collaboratorId: number,
+    @Body() data: CreateCollaboratorInvoiceDto,
+  ) {
+    return this.operationsService.createCollaboratorInvoice(
+      Number(user?.id || 0),
+      collaboratorId,
+      data,
+    );
+  }
+
+  @Patch('collaborators/:id/invoices/:invoiceId')
+  updateCollaboratorInvoice(
+    @User() user,
+    @Param('id', ParseIntPipe) collaboratorId: number,
+    @Param('invoiceId', ParseIntPipe) invoiceId: number,
+    @Body() data: UpdateCollaboratorInvoiceDto,
+  ) {
+    return this.operationsService.updateCollaboratorInvoice(
+      Number(user?.id || 0),
+      collaboratorId,
+      invoiceId,
+      data,
+    );
+  }
+
+  @Delete('collaborators/:id/invoices/:invoiceId')
+  deleteCollaboratorInvoice(
+    @User() user,
+    @Param('id', ParseIntPipe) collaboratorId: number,
+    @Param('invoiceId', ParseIntPipe) invoiceId: number,
+  ) {
+    return this.operationsService.deleteCollaboratorInvoice(
+      Number(user?.id || 0),
+      collaboratorId,
+      invoiceId,
+    );
+  }
+
   @Get('collaborators/:id')
   getCollaborator(@User() user, @Param('id', ParseIntPipe) id: number) {
     return this.operationsService.getCollaboratorByIdForUser(

package/src/dto/create-collaborator-invoice.dto.ts

@@ -0,0 +1,39 @@
+import { Transform } from 'class-transformer';
+import { IsIn, IsNumber, IsOptional, IsString, MaxLength, Min } from 'class-validator';
+
+export const INVOICE_STATUS_VALUES = [
+  'pending',
+  'paid',
+  'cancelled',
+  'overdue',
+] as const;
+export type InvoiceStatus = (typeof INVOICE_STATUS_VALUES)[number];
+
+export class CreateCollaboratorInvoiceDto {
+  @IsOptional()
+  @IsString()
+  @MaxLength(50)
+  invoiceNumber?: string | null;
+
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value),
+  )
+  @IsNumber()
+  @Min(0)
+  amount!: number;
+
+  @IsString()
+  issueDate!: string;
+
+  @IsOptional()
+  @IsString()
+  dueDate?: string | null;
+
+  @IsOptional()
+  @IsIn(INVOICE_STATUS_VALUES)
+  status?: InvoiceStatus;
+
+  @IsOptional()
+  @IsString()
+  description?: string | null;
+}

package/src/dto/create-collaborator-payment.dto.ts

@@ -0,0 +1,35 @@
+import { Transform } from 'class-transformer';
+import { IsIn, IsNumber, IsOptional, IsString, MaxLength, Min } from 'class-validator';
+
+export const PAYMENT_METHOD_VALUES = [
+  'bank_transfer',
+  'pix',
+  'check',
+  'other',
+] as const;
+export type PaymentMethod = (typeof PAYMENT_METHOD_VALUES)[number];
+
+export class CreateCollaboratorPaymentDto {
+  @Transform(({ value }) =>
+    value === '' || value === undefined || value === null ? undefined : Number(value),
+  )
+  @IsNumber()
+  @Min(0)
+  amount!: number;
+
+  @IsString()
+  paymentDate!: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(7)
+  referenceMonth?: string | null;
+
+  @IsOptional()
+  @IsIn(PAYMENT_METHOD_VALUES)
+  paymentMethod?: PaymentMethod;
+
+  @IsOptional()
+  @IsString()
+  notes?: string | null;
+}

package/src/dto/list-collaborator-invoice.dto.ts

@@ -0,0 +1,3 @@
+import { PaginationDTO } from '@hed-hog/api-pagination';
+
+export class ListCollaboratorInvoiceDto extends PaginationDTO {}

package/src/dto/list-collaborator-payment.dto.ts

@@ -0,0 +1,3 @@
+import { PaginationDTO } from '@hed-hog/api-pagination';
+
+export class ListCollaboratorPaymentDto extends PaginationDTO {}

package/src/dto/update-collaborator-invoice.dto.ts

@@ -0,0 +1,6 @@
+import { PartialType } from '@nestjs/mapped-types';
+import { CreateCollaboratorInvoiceDto } from './create-collaborator-invoice.dto';
+
+export class UpdateCollaboratorInvoiceDto extends PartialType(
+  CreateCollaboratorInvoiceDto,
+) {}

package/src/dto/update-collaborator-payment.dto.ts

@@ -0,0 +1,6 @@
+import { PartialType } from '@nestjs/mapped-types';
+import { CreateCollaboratorPaymentDto } from './create-collaborator-payment.dto';
+
+export class UpdateCollaboratorPaymentDto extends PartialType(
+  CreateCollaboratorPaymentDto,
+) {}