@hed-hog/operations 0.0.329 → 0.0.330

package/hedhog/frontend/messages/en.json

@@ -22,7 +22,9 @@
       "manageDepartments": "Manage departments",
       "manageCollaboratorTypes": "Manage relationship types",
       "manageTemplates": "Manage templates",
-      "useTemplate": "Use template"
+      "useTemplate": "Use template",
+      "showValues": "Show values",
+      "hideValues": "Hide values"
     },
     "filters": {
       "allStatuses": "All statuses",
@@ -110,11 +112,11 @@
       "noTemplatesFound": "No templates found.",
       "loading": "Loading..."
     },
-    "states": {
-      "loading": "Loading...",
-      "emptyTitle": "No records found",
-      "emptyDescription": "Adjust the current filters or create a new record.",
-      "noAccessTitle": "Access required"
+    "states": {
+      "loading": "Loading...",
+      "emptyTitle": "No records found",
+      "emptyDescription": "Adjust the current filters or create a new record.",
+      "noAccessTitle": "Access required"
     }
   },
   "DashboardPage": {
@@ -619,6 +621,9 @@
       "done": "Done",
       "doneDescription": "Completed tasks."
     },
+    "labels": {
+      "progress": "Progress"
+    },
     "status": {
       "todo": "To do",
       "doing": "In progress",
@@ -967,7 +972,22 @@
       "deleteTitle": "Delete task",
       "deleteDescription": "Are you sure you want to permanently delete this task? This action cannot be undone."
     },
-    "emptyArchivedDescription": "There are no archived tasks in this project."
+    "emptyArchivedDescription": "There are no archived tasks in this project.",
+    "commentsSection": {
+      "title": "Comments",
+      "noComments": "No comments yet.",
+      "defaultUser": "Unknown user",
+      "ariaEditComment": "Edit comment",
+      "ariaDeleteComment": "Delete comment",
+      "saveButton": "Save",
+      "cancelButton": "Cancel",
+      "submitButton": "Add comment",
+      "errors": {
+        "addComment": "Unable to add the comment.",
+        "editComment": "Unable to update the comment.",
+        "deleteComment": "Unable to delete the comment."
+      }
+    }
   },
   "ContractsPage": {
     "title": "Contracts",
@@ -1989,15 +2009,15 @@
     "category": "Category",
     "billable": "Billable",
     "reimbursable": "Reimbursable",
-    "all": "All",
-    "yes": "Yes",
-    "no": "No",
-    "planned": "Planned",
-    "realized": "Realized",
-    "statuses": {
-      "planned": "Planned",
-      "approved": "Approved",
-      "realized": "Realized",
+    "all": "All",
+    "yes": "Yes",
+    "no": "No",
+    "planned": "Planned",
+    "realized": "Realized",
+    "statuses": {
+      "planned": "Planned",
+      "approved": "Approved",
+      "realized": "Realized",
       "cancelled": "Cancelled"
     },
     "colDate": "Date",
@@ -2125,5 +2145,192 @@
       "statusBreakdown": "Planned × Approved × Realized",
       "noData": "Not enough data"
     }
+  },
+  "TaskFileAttachments": {
+    "uploadError": "Upload error",
+    "error": "Error",
+    "empty": "No attached files",
+    "dropzone": {
+      "ariaLabel": "Click or drop files to attach",
+      "dragging": "Drop files here",
+      "idle": "Click or drag files to attach"
+    },
+    "actions": {
+      "openInNewTab": "Open in a new tab",
+      "removeFile": "Remove file"
+    }
+  },
+  "ReportsCollaboratorsPage": {
+    "title": "Collaborators Report",
+    "description": "Executive dashboard with costs, profit, current capacity, and planning for the next 12 months.",
+    "breadcrumb": "Reports / Collaborators",
+    "actions": {
+      "clear": "Clear"
+    },
+    "filters": {
+      "start": "Start",
+      "end": "End",
+      "department": "Department",
+      "contract": "Contract",
+      "scenario": "Scenario",
+      "all": "All"
+    },
+    "scenario": {
+      "base": "Base",
+      "growth": "Growth",
+      "conservative": "Conservative"
+    },
+    "allocationStatus": {
+      "overload": "Overloaded",
+      "idle": "Idle",
+      "healthy": "Healthy"
+    },
+    "cards": {
+      "headcount": {
+        "title": "Headcount",
+        "description": "Collaborators in scope"
+      },
+      "cost": {
+        "title": "Total cost",
+        "perAllocatedHour": "per allocated hour",
+        "perCapacityHour": "per capacity hour"
+      },
+      "revenue": {
+        "title": "Generated value",
+        "description": "{hours} billable"
+      },
+      "margin": {
+        "title": "Margin"
+      },
+      "utilization": {
+        "title": "Utilization",
+        "description": "Committed billable hours over total capacity"
+      },
+      "freeCapacity": {
+        "title": "Free capacity",
+        "description": "{percent} available"
+      },
+      "overtime": {
+        "title": "Overtime",
+        "description": "{count} people overloaded"
+      },
+      "scenario": {
+        "title": "12-month scenario",
+        "description": "Projection calculated by the backend"
+      }
+    },
+    "table": {
+      "title": "Collaborator breakdown",
+      "description": "Fixed cost in period, generated value, profit, committed capacity, and executive recommendation.",
+      "hoursBillableOf": "{billable} bill. of {allocated}",
+      "headers": {
+        "collaborator": "Collaborator",
+        "cost": "Cost",
+        "generatedValue": "Generated value",
+        "profit": "Profit",
+        "hours": "Hours",
+        "allocation": "Allocation",
+        "risk": "Risk",
+        "recommendation": "Recommendation"
+      }
+    }
+  },
+  "ReportsProjectsPage": {
+    "title": "Projects Report",
+    "description": "Executive dashboard with revenue, cost, profit, deadlines, risk, and planning for the next 12 months.",
+    "breadcrumb": "Reports / Projects",
+    "filters": {
+      "start": "Start",
+      "end": "End",
+      "status": "Status",
+      "client": "Client",
+      "scenario": "Scenario",
+      "all": "All"
+    },
+    "scenario": {
+      "base": "Base",
+      "growth": "Growth",
+      "conservative": "Conservative"
+    },
+    "status": {
+      "on_track": "On track",
+      "attention": "Attention",
+      "late": "Late",
+      "paused": "Paused"
+    },
+    "contractType": {
+      "fixed_price": "Fixed price",
+      "time_materials": "Time / materials",
+      "retainer": "Retainer"
+    },
+    "risk": {
+      "baixo": "low",
+      "médio": "medium",
+      "alto": "high"
+    },
+    "actions": {
+      "clear": "Clear",
+      "viewDetails": "View details"
+    },
+    "cards": {
+      "projects": {
+        "title": "Projects",
+        "tooltip": "Total number of active projects in the filtered period, including those under operational risk.",
+        "description": "{count} under operational risk"
+      },
+      "budget": {
+        "title": "Budget",
+        "tooltip": "Sum of budget_amount across all projects in the filtered period.",
+        "description": "{count} projects in the period"
+      },
+      "allocatedCost": {
+        "title": "Allocated cost",
+        "tooltip": "Cost calculated from allocations: planned weekly hours × collaborator monthly cost × months in period ÷ weekly capacity.",
+        "description": "vs {value} consumed"
+      },
+      "plannedProfit": {
+        "title": "Planned profit",
+        "tooltip": "Difference between total project budget and allocated collaborator cost in the period.",
+        "description": "{value} margin"
+      },
+      "hours": {
+        "title": "Consumed hours",
+        "tooltip": "Total logged and approved timesheet hours within the selected period.",
+        "description": "{value} billable"
+      },
+      "consumedHoursCost": {
+        "title": "Consumed hours cost",
+        "tooltip": "Actual cost of delivered hours: timesheet hours × collaborator hourly rate (monthly cost ÷ weekly capacity).",
+        "description": "{value} of delivered hours"
+      },
+      "idlenessRate": {
+        "title": "Idleness rate",
+        "tooltip": "Percentage of idle time: gap between planned weekly allocation and hours actually submitted in timesheets, relative to total capacity.",
+        "description": "{value} idle cost"
+      },
+      "idlenessCost": {
+        "title": "Idleness cost",
+        "tooltip": "Amount spent on idle time: allocated cost minus cost of hours effectively consumed in approved timesheets.",
+        "description": "{value} idleness"
+      }
+    },
+    "table": {
+      "title": "Project breakdown",
+      "description": "Budget, allocated cost, planned profit, consumed hours, idleness, and risk by project.",
+      "billableHours": "{value} billable",
+      "columns": {
+        "project": "Project",
+        "status": "Status",
+        "budget": "Budget",
+        "allocatedCost": "Allocated cost",
+        "plannedProfit": "Planned profit",
+        "hours": "Consumed hours",
+        "consumedHoursCost": "Consumed hours cost",
+        "idlenessRate": "Idleness rate",
+        "idlenessCost": "Idleness cost",
+        "risk": "Risk",
+        "recommendation": "Recommendation"
+      }
+    }
   }
 }

package/hedhog/frontend/messages/pt.json

@@ -22,7 +22,9 @@
       "manageDepartments": "Gerenciar departamentos",
       "manageCollaboratorTypes": "Gerenciar tipos de colaborador",
       "manageTemplates": "Gerenciar templates",
-      "useTemplate": "Usar template"
+      "useTemplate": "Usar template",
+      "showValues": "Exibir valores",
+      "hideValues": "Ocultar valores"
     },
     "filters": {
       "allStatuses": "Todos os status",
@@ -108,11 +110,11 @@
       "noTemplatesFound": "Nenhum template encontrado.",
       "loading": "Carregando..."
     },
-    "states": {
-      "loading": "Carregando...",
-      "emptyTitle": "Nenhum registro encontrado",
-      "emptyDescription": "Ajuste os filtros atuais ou crie um novo registro.",
-      "noAccessTitle": "Acesso necessário"
+    "states": {
+      "loading": "Carregando...",
+      "emptyTitle": "Nenhum registro encontrado",
+      "emptyDescription": "Ajuste os filtros atuais ou crie um novo registro.",
+      "noAccessTitle": "Acesso necessário"
     }
   },
   "DashboardPage": {
@@ -617,6 +619,9 @@
       "done": "Concluídas",
       "doneDescription": "Tarefas finalizadas."
     },
+    "labels": {
+      "progress": "Progresso"
+    },
     "status": {
       "todo": "A fazer",
       "doing": "Em andamento",
@@ -965,7 +970,22 @@
       "deleteTitle": "Excluir tarefa",
       "deleteDescription": "Tem certeza que deseja excluir esta tarefa de forma permanente? Esta ação não pode ser desfeita."
     },
-    "emptyArchivedDescription": "Nenhuma tarefa arquivada neste projeto."
+    "emptyArchivedDescription": "Nenhuma tarefa arquivada neste projeto.",
+    "commentsSection": {
+      "title": "Comentários",
+      "noComments": "Nenhum comentário ainda.",
+      "defaultUser": "Usuário desconhecido",
+      "ariaEditComment": "Editar comentário",
+      "ariaDeleteComment": "Excluir comentário",
+      "saveButton": "Salvar",
+      "cancelButton": "Cancelar",
+      "submitButton": "Adicionar comentário",
+      "errors": {
+        "addComment": "Não foi possível adicionar o comentário.",
+        "editComment": "Não foi possível atualizar o comentário.",
+        "deleteComment": "Não foi possível excluir o comentário."
+      }
+    }
   },
   "ContractsPage": {
     "title": "Contratos",
@@ -1996,15 +2016,15 @@
     "category": "Categoria",
     "billable": "Faturável",
     "reimbursable": "Reembolsável",
-    "all": "Todos",
-    "yes": "Sim",
-    "no": "Não",
-    "planned": "Planejado",
-    "realized": "Realizado",
-    "statuses": {
-      "planned": "Planejado",
-      "approved": "Aprovado",
-      "realized": "Realizado",
+    "all": "Todos",
+    "yes": "Sim",
+    "no": "Não",
+    "planned": "Planejado",
+    "realized": "Realizado",
+    "statuses": {
+      "planned": "Planejado",
+      "approved": "Aprovado",
+      "realized": "Realizado",
       "cancelled": "Cancelado"
     },
     "colDate": "Data",
@@ -2132,5 +2152,192 @@
       "statusBreakdown": "Planejado × Aprovado × Realizado",
       "noData": "Sem dados suficientes"
     }
+  },
+  "TaskFileAttachments": {
+    "uploadError": "Erro no upload",
+    "error": "Erro",
+    "empty": "Nenhum arquivo anexado",
+    "dropzone": {
+      "ariaLabel": "Clique ou solte arquivos para anexar",
+      "dragging": "Solte os arquivos aqui",
+      "idle": "Clique ou arraste arquivos para anexar"
+    },
+    "actions": {
+      "openInNewTab": "Abrir em nova aba",
+      "removeFile": "Remover arquivo"
+    }
+  },
+  "ReportsCollaboratorsPage": {
+    "title": "Relatório de Colaboradores",
+    "description": "Dashboard executivo com custo, lucro, capacidade atual e planejamento dos próximos 12 meses.",
+    "breadcrumb": "Relatórios / Colaboradores",
+    "actions": {
+      "clear": "Limpar"
+    },
+    "filters": {
+      "start": "Início",
+      "end": "Fim",
+      "department": "Departamento",
+      "contract": "Vínculo",
+      "scenario": "Cenário",
+      "all": "Todos"
+    },
+    "scenario": {
+      "base": "Base",
+      "growth": "Crescimento",
+      "conservative": "Conservador"
+    },
+    "allocationStatus": {
+      "overload": "Sobrecarga",
+      "idle": "Ocioso",
+      "healthy": "Saudável"
+    },
+    "cards": {
+      "headcount": {
+        "title": "Headcount",
+        "description": "Colaboradores no recorte"
+      },
+      "cost": {
+        "title": "Custo total",
+        "perAllocatedHour": "por hora alocada",
+        "perCapacityHour": "por hora de capacidade"
+      },
+      "revenue": {
+        "title": "Valor gerado",
+        "description": "{hours} faturáveis"
+      },
+      "margin": {
+        "title": "Margem"
+      },
+      "utilization": {
+        "title": "Utilização",
+        "description": "Horas faturáveis comprometidas sobre capacidade"
+      },
+      "freeCapacity": {
+        "title": "Capacidade livre",
+        "description": "{percent} disponível"
+      },
+      "overtime": {
+        "title": "Horas extras",
+        "description": "{count} pessoas em sobrecarga"
+      },
+      "scenario": {
+        "title": "Cenário 12 meses",
+        "description": "Projeção calculada no backend"
+      }
+    },
+    "table": {
+      "title": "Detalhamento por colaborador",
+      "description": "Custo fixo do período, valor apontado, lucro, capacidade comprometida e recomendação executiva.",
+      "hoursBillableOf": "{billable} fat. de {allocated}",
+      "headers": {
+        "collaborator": "Colaborador",
+        "cost": "Custo",
+        "generatedValue": "Valor gerado",
+        "profit": "Lucro",
+        "hours": "Horas",
+        "allocation": "Alocação",
+        "risk": "Risco",
+        "recommendation": "Recomendação"
+      }
+    }
+  },
+  "ReportsProjectsPage": {
+    "title": "Relatório de Projetos",
+    "description": "Dashboard executivo com receita, custo, lucro, prazo, risco e planejamento dos próximos 12 meses.",
+    "breadcrumb": "Relatórios / Projetos",
+    "filters": {
+      "start": "Início",
+      "end": "Fim",
+      "status": "Status",
+      "client": "Cliente",
+      "scenario": "Cenário",
+      "all": "Todos"
+    },
+    "scenario": {
+      "base": "Base",
+      "growth": "Crescimento",
+      "conservative": "Conservador"
+    },
+    "status": {
+      "on_track": "No prazo",
+      "attention": "Atenção",
+      "late": "Atrasado",
+      "paused": "Pausado"
+    },
+    "contractType": {
+      "fixed_price": "Preço fechado",
+      "time_materials": "Hora / Material",
+      "retainer": "Recorrente"
+    },
+    "risk": {
+      "baixo": "baixo",
+      "médio": "médio",
+      "alto": "alto"
+    },
+    "actions": {
+      "clear": "Limpar",
+      "viewDetails": "Ver detalhes"
+    },
+    "cards": {
+      "projects": {
+        "title": "Projetos",
+        "tooltip": "Número total de projetos ativos no período filtrado, incluindo os que estão em risco operacional.",
+        "description": "{count} em risco operacional"
+      },
+      "budget": {
+        "title": "Orçamento",
+        "tooltip": "Soma dos campos de orçamento (budget_amount) de todos os projetos no período filtrado.",
+        "description": "{count} projetos no período"
+      },
+      "allocatedCost": {
+        "title": "Custo alocado",
+        "tooltip": "Custo calculado a partir das alocações: horas semanais planejadas × custo mensal do colaborador × meses do período ÷ capacidade semanal.",
+        "description": "vs {value} consumido"
+      },
+      "plannedProfit": {
+        "title": "Lucro planejado",
+        "tooltip": "Diferença entre o orçamento total dos projetos e o custo alocado dos colaboradores no período.",
+        "description": "{value} de margem"
+      },
+      "hours": {
+        "title": "Horas consumidas",
+        "tooltip": "Total de horas lançadas e aprovadas nos timesheets dentro do período selecionado.",
+        "description": "{value} faturáveis"
+      },
+      "consumedHoursCost": {
+        "title": "Custo das horas consumidas",
+        "tooltip": "Custo real das horas entregues: horas do timesheet × taxa horária do colaborador (custo mensal ÷ capacidade semanal).",
+        "description": "{value} de horas entregues"
+      },
+      "idlenessRate": {
+        "title": "Taxa de ociosidade",
+        "tooltip": "Percentual de tempo ocioso: diferença entre a carga horária semanal planejada (alocada) e as horas efetivamente submetidas via timesheet, em relação à capacidade total.",
+        "description": "{value} de custo ocioso"
+      },
+      "idlenessCost": {
+        "title": "Custo de ociosidade",
+        "tooltip": "Quanto foi gasto com tempo ocioso: custo alocado menos o custo das horas efetivamente consumidas nos timesheets aprovados.",
+        "description": "{value} de ociosidade"
+      }
+    },
+    "table": {
+      "title": "Detalhamento por projeto",
+      "description": "Orçamento, custo alocado, lucro planejado, horas consumidas, ociosidade e risco por projeto.",
+      "billableHours": "{value} faturáveis",
+      "columns": {
+        "project": "Projeto",
+        "status": "Status",
+        "budget": "Orçamento",
+        "allocatedCost": "Custo alocado",
+        "plannedProfit": "Lucro planejado",
+        "hours": "Horas consumidas",
+        "consumedHoursCost": "Custo das horas consumidas",
+        "idlenessRate": "Taxa de ociosidade",
+        "idlenessCost": "Custo de ociosidade",
+        "risk": "Risco",
+        "recommendation": "Recomendação"
+      }
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/operations",
-  "version": "0.0.329",
+  "version": "0.0.330",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -9,13 +9,13 @@
     "@nestjs/core": "^11",
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
+    "@hed-hog/api-locale": "0.0.14",
     "@hed-hog/api": "0.0.8",
     "@hed-hog/api-prisma": "0.0.6",
     "@hed-hog/api-pagination": "0.0.7",
-    "@hed-hog/api-locale": "0.0.14",
-    "@hed-hog/core": "0.0.329",
+    "@hed-hog/contact": "0.0.330",
     "@hed-hog/api-types": "0.0.1",
-    "@hed-hog/contact": "0.0.329"
+    "@hed-hog/core": "0.0.330"
   },
   "exports": {
     ".": {

package/src/operations.service.spec.ts

@@ -200,7 +200,7 @@ describe('OperationsService quick-entry timesheets', () => {
 
     jest.spyOn(service as any, 'getActorContext').mockResolvedValue({
       userId: 15,
-      roleSlugs: ['admin-operations-collaborator'],
+      roleSlugs: ['operations-collaborator'],
       collaboratorId: 7,
       collaboratorName: 'Taylor Tester',
       isDirector: false,

package/src/operations.service.ts

@@ -20,7 +20,7 @@ import {
 } from '@nestjs/common';
 import { OperationsAccessService } from './services/shared/operations-access.service';
 
-const COLLABORATOR_ROLE = 'admin-operations-collaborator';
+const COLLABORATOR_ROLE = 'operations-collaborator';
 const SUPERVISOR_ROLE = 'admin-operations-supervisor';
 const DIRECTOR_ROLE = 'admin-operations-director';
 const CONTRACT_CATEGORY_VALUES = [
@@ -2774,7 +2774,13 @@ export class OperationsService {
               p.code,
               p.name,
               p.client_name AS "clientName",
-              cp.avatar_id AS "clientAvatarId",
+              COALESCE(
+                cp.avatar_id,
+                (SELECT p2.avatar_id FROM person p2
+                 WHERE p.client_person_id IS NULL
+                   AND LOWER(TRIM(p2.name)) = LOWER(TRIM(p.client_name))
+                 LIMIT 1)
+              ) AS "clientAvatarId",
               p.summary,
               p.status,
               p.progress_percent AS "progressPercent",
@@ -3254,7 +3260,7 @@ export class OperationsService {
     return task;
   }
 
-  async updateTask(userId: number, taskId: number, data: TaskPayload) {
+  async updateTask(userId: number, taskId: number, data: TaskPayload) {
     const actor = await this.getActorContext(userId);
     if (!actor.isCollaborator && !actor.isDirector && !actor.isSupervisor) {
       throw new ForbiddenException(
@@ -7741,7 +7747,13 @@ export class OperationsService {
               p.contract_id AS "contractId",
               p.manager_collaborator_id AS "managerCollaboratorId",
               p.client_person_id AS "clientPersonId",
-              client_person.avatar_id AS "clientAvatarId",
+              COALESCE(
+                client_person.avatar_id,
+                (SELECT p2.avatar_id FROM person p2
+                 WHERE p.client_person_id IS NULL
+                   AND LOWER(TRIM(p2.name)) = LOWER(TRIM(p.client_name))
+                 LIMIT 1)
+              ) AS "clientAvatarId",
               p.code,
               p.name,
               p.client_name AS "clientName",
@@ -11385,6 +11397,13 @@ export class OperationsService {
               p.code,
               p.name,
               p.client_name AS "clientName",
+              COALESCE(
+                cp.avatar_id,
+                (SELECT p2.avatar_id FROM person p2
+                 WHERE p.client_person_id IS NULL
+                   AND LOWER(TRIM(p2.name)) = LOWER(TRIM(p.client_name))
+                 LIMIT 1)
+              ) AS "clientAvatarId",
               p.summary,
               p.status,
               p.progress_percent AS "progressPercent",
@@ -11397,12 +11416,13 @@ export class OperationsService {
          FROM operations_project p
          LEFT JOIN operations_contract c ON c.id = p.contract_id
          LEFT JOIN operations_collaborator m ON m.id = p.manager_collaborator_id
+         LEFT JOIN person cp ON cp.id = p.client_person_id
          LEFT JOIN operations_project_assignment pa
            ON pa.project_id = p.id
           AND pa.deleted_at IS NULL
           AND pa.status IN ('planned', 'active')
         WHERE ${whereClause}
-        GROUP BY p.id, c.id, m.id`;
+        GROUP BY p.id, c.id, m.id, cp.id`;
 
     if (!pagination) {
       return this.queryRows(`${baseQuery} ORDER BY p.name ASC`, params);