@hed-hog/operations 0.0.319 → 0.0.322

package/hedhog/frontend/messages/en.json

@@ -723,7 +723,69 @@
       "loggedHours": "Logged hours",
       "loggedHoursDescription": "Total hours linked to this project.",
       "allocation": "Average allocation",
-      "allocationDescription": "Average assignment allocation across linked collaborators."
+      "allocationDescription": "Average assignment allocation across linked collaborators.",
+      "lateTasks": "Late tasks",
+      "lateTasksDescription": "Open tasks with overdue deadlines.",
+      "weeklyVelocity": "Weekly velocity",
+      "weeklyVelocityDescription": "Recent or planned hours for the week.",
+      "projectHealth": "Project health",
+      "pendingTasks": "Pending tasks",
+      "pendingTasksDescription": "{overdue} overdue task(s) right now.",
+      "activeCollaborators": "Active collaborators",
+      "activeCollaboratorsDescription": "People with active allocation on this project."
+    },
+    "kpi": {
+      "indicator": "Indicator",
+      "subtitles": {
+        "health": "Visual blend of progress, pendencies, and allocation."
+      },
+      "trends": {
+        "hours": "{count} timesheet(s)",
+        "health": {
+          "good": "Positive",
+          "warning": "Warning",
+          "danger": "Critical"
+        },
+        "velocity": {
+          "active": "Moving",
+          "empty": "No recent pace"
+        },
+        "allocation": {
+          "good": "Balanced",
+          "warning": "High",
+          "critical": "Overloaded"
+        },
+        "tasks": {
+          "good": "No pendencies",
+          "warning": "Active backlog",
+          "critical": "{count} late"
+        },
+        "collaborators": {
+          "active": "Active team",
+          "empty": "No team"
+        }
+      }
+    },
+    "quickActions": {
+      "timesheet": "Timesheet",
+      "reports": "Reports",
+      "more": "More actions"
+    },
+    "executive": {
+      "team": "Team",
+      "activeTasks": "Active tasks",
+      "completedTasks": "Completed",
+      "fallbackDescription": "Track delivery, staffing, contract, and operational signals for this project.",
+      "membersCount": "{count} member(s)"
+    },
+    "breadcrumbTrail": {
+      "operations": "Operations",
+      "projects": "Projects"
+    },
+    "health": {
+      "good": "Healthy",
+      "warning": "Attention",
+      "danger": "Critical"
     },
     "sections": {
       "overview": "Overview",
@@ -752,14 +814,92 @@
       "deliveryHealthDescription": "Visual overview of team allocation and operational pace.",
       "quickRadar": "Quick radar",
       "quickRadarDescription": "Short-term decision signals.",
+      "timeline": "Operational timeline",
+      "timelineDescription": "Recent activity grouped by day, ready for filters and incremental loading.",
       "taskBoard": "Task board",
       "taskBoardDescription": "Kanban-style board with drag between columns and task side panel.",
       "archivedTasks": "Archived tasks",
       "archivedTasksDescription": "Review archived project tasks, open details, restore them, or delete them permanently."
     },
     "charts": {
+      "projectProgress": "Progress",
+      "burnup": "Burnup / progress",
+      "burnupDescription": "Accumulated logged hours against the planned operating pace.",
       "allocationByCollaborator": "Allocation by collaborator",
-      "weeklyVelocity": "Weekly velocity"
+      "allocationDescription": "Capacity distribution across project collaborators.",
+      "weeklyVelocity": "Weekly velocity",
+      "weeklyVelocityDescription": "Recent pace of hours logged by the team.",
+      "taskDistribution": "Task distribution",
+      "taskDistributionDescription": "Task volume by board stage.",
+      "operationalHealth": "Operational health",
+      "operationalHealthDescription": "Visual score calculated from progress, pendencies, and allocation.",
+      "healthScore": "Operational score",
+      "start": "Start",
+      "current": "Current",
+      "emptyTitle": "Not enough data",
+      "emptyBurnup": "The burnup will appear once there is progress or logged hours.",
+      "emptyVelocity": "No weekly velocity has been returned for this project yet.",
+      "emptyAllocation": "Allocation will appear when collaborators are assigned.",
+      "emptyTasks": "Tasks will appear once the board has items."
+    },
+    "kanban": {
+      "items": "items",
+      "progress": "Progress",
+      "searchPlaceholder": "Search task, tag, assignee...",
+      "filters": "Filters",
+      "allPriorities": "All priorities",
+      "groupStatus": "Group by status",
+      "noEstimate": "No est.",
+      "emptyColumn": "No tasks in this column.",
+      "noFilteredTasks": "No tasks match the filters."
+    },
+    "timeline": {
+      "projectStarted": "Project started",
+      "projectStartedDescription": "{project} entered execution.",
+      "taskCreated": "Task created",
+      "taskCompleted": "Task completed",
+      "commentAdded": "Comment recorded",
+      "timesheetLogged": "Timesheet logged",
+      "timesheetLoggedDescription": "{count} timesheet(s), totaling {hours}.",
+      "approvalPending": "Approval pending",
+      "approvalPendingDescription": "{count} item(s) waiting for review.",
+      "completedTasks": "Completed tasks",
+      "completedTasksDescription": "{count} task(s) completed",
+      "pendingTimesheets": "Pending timesheets",
+      "pendingTimesheetsDescription": "{count} timesheet(s) waiting for review",
+      "targetDate": "Target date",
+      "targetDateDescription": "Operational project deadline.",
+      "loadMore": "Load more events",
+      "emptyTitle": "No activity to show",
+      "empty": "There is not enough operational activity yet to build a timeline.",
+      "filters": {
+        "all": "All events",
+        "task": "Tasks",
+        "status": "Status",
+        "timesheet": "Timesheets",
+        "approval": "Approvals",
+        "comment": "Comments"
+      },
+      "types": {
+        "task": "Task",
+        "timesheet": "Timesheet",
+        "approval": "Approval",
+        "comment": "Comment",
+        "status": "Status"
+      }
+    },
+    "teamPanel": {
+      "available": "Available",
+      "highAllocation": "High allocation",
+      "overload": "Overload",
+      "usedHours": "Used hours",
+      "availability": "Availability",
+      "overloadWarning": "{value}% above recommended capacity.",
+      "status": {
+        "available": "Available",
+        "high": "High load",
+        "overload": "Overload"
+      }
     },
     "quickRadar": {
       "activeAssignments": "Active assignments",
@@ -779,6 +919,7 @@
       "estimateLabel": "Estimate (h)",
       "tagsLabel": "Tags",
       "tagsPlaceholder": "planning, client, design (comma-separated)",
+      "attachmentsLabel": "Attachments",
       "saving": "Saving..."
     },
     "dialogs": {

package/hedhog/frontend/messages/pt.json

@@ -721,7 +721,69 @@
       "loggedHours": "Horas lançadas",
       "loggedHoursDescription": "Total de horas vinculadas a este projeto.",
       "allocation": "Alocação média",
-      "allocationDescription": "Média de alocação das atribuições do projeto."
+      "allocationDescription": "Média de alocação das atribuições do projeto.",
+      "lateTasks": "Tasks atrasadas",
+      "lateTasksDescription": "Tarefas abertas com prazo vencido.",
+      "weeklyVelocity": "Velocidade semanal",
+      "weeklyVelocityDescription": "Horas recentes ou planejadas na semana.",
+      "projectHealth": "Saúde do projeto",
+      "pendingTasks": "Tasks pendentes",
+      "pendingTasksDescription": "{overdue} tarefa(s) atrasada(s) no momento.",
+      "activeCollaborators": "Colaboradores ativos",
+      "activeCollaboratorsDescription": "Pessoas com alocação ativa neste projeto."
+    },
+    "kpi": {
+      "indicator": "Indicador",
+      "subtitles": {
+        "health": "Composição visual de progresso, pendências e alocação."
+      },
+      "trends": {
+        "hours": "{count} timesheet(s)",
+        "health": {
+          "good": "Positivo",
+          "warning": "Warning",
+          "danger": "Crítico"
+        },
+        "velocity": {
+          "active": "Em movimento",
+          "empty": "Sem ritmo recente"
+        },
+        "allocation": {
+          "good": "Equilibrada",
+          "warning": "Alta",
+          "critical": "Sobrecarga"
+        },
+        "tasks": {
+          "good": "Sem pendências",
+          "warning": "Backlog ativo",
+          "critical": "{count} atrasada(s)"
+        },
+        "collaborators": {
+          "active": "Equipe ativa",
+          "empty": "Sem equipe"
+        }
+      }
+    },
+    "quickActions": {
+      "timesheet": "Timesheet",
+      "reports": "Relatórios",
+      "more": "Mais ações"
+    },
+    "executive": {
+      "team": "Equipe",
+      "activeTasks": "Tasks ativas",
+      "completedTasks": "Concluídas",
+      "fallbackDescription": "Acompanhe entrega, equipe, contrato e sinais operacionais deste projeto.",
+      "membersCount": "{count} membro(s)"
+    },
+    "breadcrumbTrail": {
+      "operations": "Operations",
+      "projects": "Projetos"
+    },
+    "health": {
+      "good": "Saudável",
+      "warning": "Atenção",
+      "danger": "Crítico"
     },
     "sections": {
       "overview": "Visão geral",
@@ -750,14 +812,92 @@
       "deliveryHealthDescription": "Leitura visual de alocação e ritmo operacional da equipe.",
       "quickRadar": "Radar rápido",
       "quickRadarDescription": "Sinais para tomada de decisão no curto prazo.",
+      "timeline": "Timeline operacional",
+      "timelineDescription": "Atividade recente agrupada por dia, preparada para filtros e carregamento incremental.",
       "taskBoard": "Quadro de tarefas",
       "taskBoardDescription": "Board estilo Kanban com arraste entre colunas e detalhe lateral da tarefa.",
       "archivedTasks": "Tarefas arquivadas",
       "archivedTasksDescription": "Consulte tarefas arquivadas do projeto, veja detalhes, desarquive ou exclua definitivamente."
     },
     "charts": {
+      "projectProgress": "Progresso",
+      "burnup": "Burnup / progresso",
+      "burnupDescription": "Evolução acumulada de horas lançadas contra o ritmo planejado.",
       "allocationByCollaborator": "Alocação por colaborador",
-      "weeklyVelocity": "Velocidade semanal"
+      "allocationDescription": "Distribuição de capacidade entre os colaboradores do projeto.",
+      "weeklyVelocity": "Velocidade semanal",
+      "weeklyVelocityDescription": "Ritmo recente de horas registradas pela equipe.",
+      "taskDistribution": "Distribuição de tasks",
+      "taskDistributionDescription": "Volume de tarefas por etapa do quadro.",
+      "operationalHealth": "Saúde operacional",
+      "operationalHealthDescription": "Score visual calculado a partir de progresso, pendências e alocação.",
+      "healthScore": "Score operacional",
+      "start": "Início",
+      "current": "Atual",
+      "emptyTitle": "Sem dados suficientes",
+      "emptyBurnup": "O burnup aparecerá quando houver progresso ou horas registradas.",
+      "emptyVelocity": "Ainda não há velocidade semanal retornada para este projeto.",
+      "emptyAllocation": "A alocação aparecerá quando colaboradores forem vinculados.",
+      "emptyTasks": "As tarefas aparecerão quando o quadro tiver itens."
+    },
+    "kanban": {
+      "items": "itens",
+      "progress": "Progresso",
+      "searchPlaceholder": "Buscar task, tag, responsável...",
+      "filters": "Filtros",
+      "allPriorities": "Todas prioridades",
+      "groupStatus": "Agrupar por status",
+      "noEstimate": "Sem estim.",
+      "emptyColumn": "Nenhuma task nesta coluna.",
+      "noFilteredTasks": "Nenhuma task corresponde aos filtros."
+    },
+    "timeline": {
+      "projectStarted": "Projeto iniciado",
+      "projectStartedDescription": "{project} entrou em execução.",
+      "taskCreated": "Task criada",
+      "taskCompleted": "Task concluída",
+      "commentAdded": "Comentário registrado",
+      "timesheetLogged": "Timesheet lançado",
+      "timesheetLoggedDescription": "{count} timesheet(s), totalizando {hours}.",
+      "approvalPending": "Aprovação pendente",
+      "approvalPendingDescription": "{count} item(ns) aguardando revisão.",
+      "completedTasks": "Tarefas concluídas",
+      "completedTasksDescription": "{count} tarefa(s) já concluída(s)",
+      "pendingTimesheets": "Timesheets pendentes",
+      "pendingTimesheetsDescription": "{count} timesheet(s) aguardando revisão",
+      "targetDate": "Data alvo",
+      "targetDateDescription": "Deadline operacional do projeto.",
+      "loadMore": "Carregar mais eventos",
+      "emptyTitle": "Sem atividade para exibir",
+      "empty": "Ainda não há eventos operacionais suficientes para montar uma timeline.",
+      "filters": {
+        "all": "Todos eventos",
+        "task": "Tasks",
+        "status": "Status",
+        "timesheet": "Timesheets",
+        "approval": "Aprovações",
+        "comment": "Comentários"
+      },
+      "types": {
+        "task": "Task",
+        "timesheet": "Timesheet",
+        "approval": "Aprovação",
+        "comment": "Comentário",
+        "status": "Status"
+      }
+    },
+    "teamPanel": {
+      "available": "Disponíveis",
+      "highAllocation": "Alocação alta",
+      "overload": "Sobrecarga",
+      "usedHours": "Horas utilizadas",
+      "availability": "Disponibilidade",
+      "overloadWarning": "{value}% acima da capacidade recomendada.",
+      "status": {
+        "available": "Disponível",
+        "high": "Alta carga",
+        "overload": "Sobrecarga"
+      }
     },
     "quickRadar": {
       "activeAssignments": "Atribuições ativas",
@@ -777,6 +917,7 @@
       "estimateLabel": "Estimativa (h)",
       "tagsLabel": "Etiquetas",
       "tagsPlaceholder": "planejamento, cliente, design (separadas por vírgula)",
+      "attachmentsLabel": "Anexos",
       "saving": "Salvando..."
     },
     "dialogs": {

package/hedhog/table/operations_task_file.yaml

@@ -0,0 +1,23 @@
+columns:
+  - type: pk
+  - name: operations_task_id
+    type: fk
+    references:
+      table: operations_task
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: file_id
+    type: fk
+    isNullable: true
+    references:
+      table: file
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [operations_task_id]
+  - columns: [file_id]

package/package.json

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

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

@@ -1,32 +1,32 @@
-import { Role, User } from '@hed-hog/api';
-import { Controller, Get, Query } from '@nestjs/common';
-import {
-  ListCollaboratorsReportDto,
-  ListProjectsReportDto,
-} from '../dto/list-reports.dto';
-import { OperationsService } from '../operations.service';
-
-@Role()
-@Controller('operations')
-export class OperationsReportsController {
-  constructor(private readonly operationsService: OperationsService) {}
-
-  @Get('reports/projects')
-  getProjectsReport(@User() user, @Query() filters: ListProjectsReportDto) {
-    return this.operationsService.getProjectsReport(
-      Number(user?.id || 0),
-      filters,
-    );
-  }
-
-  @Get('reports/collaborators')
-  getCollaboratorsReport(
-    @User() user,
-    @Query() filters: ListCollaboratorsReportDto,
-  ) {
-    return this.operationsService.getCollaboratorsReport(
-      Number(user?.id || 0),
-      filters,
-    );
-  }
-}
+import { Role, User } from '@hed-hog/api';
+import { Controller, Get, Query } from '@nestjs/common';
+import {
+  ListCollaboratorsReportDto,
+  ListProjectsReportDto,
+} from '../dto/list-reports.dto';
+import { OperationsService } from '../operations.service';
+
+@Role()
+@Controller('operations')
+export class OperationsReportsController {
+  constructor(private readonly operationsService: OperationsService) {}
+
+  @Get('reports/projects')
+  getProjectsReport(@User() user, @Query() filters: ListProjectsReportDto) {
+    return this.operationsService.getProjectsReport(
+      Number(user?.id || 0),
+      filters,
+    );
+  }
+
+  @Get('reports/collaborators')
+  getCollaboratorsReport(
+    @User() user,
+    @Query() filters: ListCollaboratorsReportDto,
+  ) {
+    return this.operationsService.getCollaboratorsReport(
+      Number(user?.id || 0),
+      filters,
+    );
+  }
+}

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

@@ -1,15 +1,18 @@
 import { Role, User } from '@hed-hog/api';
 import {
-  Body,
-  Controller,
-  Delete,
-  Get,
-  Param,
-  ParseIntPipe,
-  Patch,
-  Post,
-  Query,
+    Body,
+    Controller,
+    Delete,
+    Get,
+    Param,
+    ParseIntPipe,
+    Patch,
+    Post,
+    Query,
+    UploadedFile,
+    UseInterceptors,
 } from '@nestjs/common';
+import { FileInterceptor } from '@nestjs/platform-express';
 import { CreateOperationsTaskDto } from '../dto/create-task.dto';
 import { ListMyTasksDto } from '../dto/list-my-tasks.dto';
 import { ListOperationsTasksDto } from '../dto/list-tasks.dto';
@@ -80,4 +83,35 @@ export class OperationsTasksController {
       permanent === 'true'
     );
   }
+
+  @Get('tasks/:id/files')
+  listTaskFiles(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+  ) {
+    return this.operationsService.listTaskFiles(Number(user?.id || 0), id);
+  }
+
+  @Post('tasks/:id/files')
+  @UseInterceptors(FileInterceptor('file'))
+  addTaskFile(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @UploadedFile() file: MulterFile,
+  ) {
+    return this.operationsService.addTaskFile(Number(user?.id || 0), id, file);
+  }
+
+  @Delete('tasks/:id/files/:fileRelationId')
+  removeTaskFile(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Param('fileRelationId', ParseIntPipe) fileRelationId: number,
+  ) {
+    return this.operationsService.removeTaskFile(
+      Number(user?.id || 0),
+      id,
+      fileRelationId
+    );
+  }
 }

package/src/dto/create-task.dto.ts

@@ -36,7 +36,6 @@ export class CreateOperationsTaskDto {
 
   @IsOptional()
   @IsString({ message: 'description must be a string' })
-  @MaxLength(2000, { message: 'description must have at most 2000 characters' })
   description?: string;
 
   @IsOptional()

package/src/dto/list-reports.dto.ts

@@ -1,51 +1,51 @@
-import { IsIn, IsOptional, IsString } from 'class-validator';
-
-export const OPERATIONS_REPORT_SCENARIOS = [
-  'base',
-  'growth',
-  'conservative',
-] as const;
-
-export class ListProjectsReportDto {
-  @IsOptional()
-  @IsString()
-  from?: string;
-
-  @IsOptional()
-  @IsString()
-  to?: string;
-
-  @IsOptional()
-  @IsString()
-  status?: string;
-
-  @IsOptional()
-  @IsString()
-  client?: string;
-
-  @IsOptional()
-  @IsIn(OPERATIONS_REPORT_SCENARIOS)
-  scenario?: string;
-}
-
-export class ListCollaboratorsReportDto {
-  @IsOptional()
-  @IsString()
-  from?: string;
-
-  @IsOptional()
-  @IsString()
-  to?: string;
-
-  @IsOptional()
-  @IsString()
-  department?: string;
-
-  @IsOptional()
-  @IsString()
-  contractType?: string;
-
-  @IsOptional()
-  @IsIn(OPERATIONS_REPORT_SCENARIOS)
-  scenario?: string;
-}
+import { IsIn, IsOptional, IsString } from 'class-validator';
+
+export const OPERATIONS_REPORT_SCENARIOS = [
+  'base',
+  'growth',
+  'conservative',
+] as const;
+
+export class ListProjectsReportDto {
+  @IsOptional()
+  @IsString()
+  from?: string;
+
+  @IsOptional()
+  @IsString()
+  to?: string;
+
+  @IsOptional()
+  @IsString()
+  status?: string;
+
+  @IsOptional()
+  @IsString()
+  client?: string;
+
+  @IsOptional()
+  @IsIn(OPERATIONS_REPORT_SCENARIOS)
+  scenario?: string;
+}
+
+export class ListCollaboratorsReportDto {
+  @IsOptional()
+  @IsString()
+  from?: string;
+
+  @IsOptional()
+  @IsString()
+  to?: string;
+
+  @IsOptional()
+  @IsString()
+  department?: string;
+
+  @IsOptional()
+  @IsString()
+  contractType?: string;
+
+  @IsOptional()
+  @IsIn(OPERATIONS_REPORT_SCENARIOS)
+  scenario?: string;
+}

package/src/dto/update-task.dto.ts

@@ -38,7 +38,6 @@ export class UpdateOperationsTaskDto {
 
   @IsOptional()
   @IsString({ message: 'description must be a string' })
-  @MaxLength(2000, { message: 'description must have at most 2000 characters' })
   description?: string;
 
   @IsOptional()

package/src/operations.module.ts

@@ -9,9 +9,9 @@ import { OperationsCollaboratorCostsController } from './controllers/operations-
 import { OperationsCollaboratorsController } from './controllers/operations-collaborators.controller';
 import { OperationsContractsController } from './controllers/operations-contracts.controller';
 import { OperationsOrgStructureController } from './controllers/operations-org-structure.controller';
-import { OperationsProjectsController } from './controllers/operations-projects.controller';
-import { OperationsReportsController } from './controllers/operations-reports.controller';
-import { OperationsTasksController } from './controllers/operations-tasks.controller';
+import { OperationsProjectsController } from './controllers/operations-projects.controller';
+import { OperationsReportsController } from './controllers/operations-reports.controller';
+import { OperationsTasksController } from './controllers/operations-tasks.controller';
 import { OperationsTimesheetsController } from './controllers/operations-timesheets.controller';
 import { OperationsController } from './operations.controller';
 import { OperationsProposalSubscriber } from './operations.proposal.subscriber';
@@ -34,8 +34,8 @@ import { OperationsAccessService } from './services/shared/operations-access.ser
     OperationsCollaboratorsController,
     OperationsCollaboratorCostsController,
     OperationsOrgStructureController,
-    OperationsProjectsController,
-    OperationsReportsController,
+    OperationsProjectsController,
+    OperationsReportsController,
     OperationsTasksController,
     OperationsContractsController,
     OperationsTimesheetsController,