@hed-hog/operations 0.0.321 → 0.0.322

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.321",
+  "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-prisma": "0.0.6",
-    "@hed-hog/api-pagination": "0.0.7",
     "@hed-hog/api-locale": "0.0.14",
-    "@hed-hog/core": "0.0.321",
+    "@hed-hog/api-prisma": "0.0.6",
     "@hed-hog/api-types": "0.0.1",
-    "@hed-hog/contact": "0.0.321"
+    "@hed-hog/api-pagination": "0.0.7",
+    "@hed-hog/core": "0.0.322",
+    "@hed-hog/contact": "0.0.322"
   },
   "exports": {
     ".": {

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/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.service.ts

@@ -2570,6 +2570,7 @@ export class OperationsService {
               p.code,
               p.name,
               p.client_name AS "clientName",
+              cp.avatar_id AS "clientAvatarId",
               p.summary,
               p.status,
               p.progress_percent AS "progressPercent",
@@ -2580,17 +2581,20 @@ export class OperationsService {
               c.name AS "contractName",
               c.status AS "contractStatus",
               m.display_name AS "managerName",
+              mp.avatar_id AS "managerAvatarId",
               ${ownAssignmentSelect}
               COUNT(DISTINCT pa.id)::int AS "teamSize"
          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 person mp ON mp.id = m.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, mp.id`;
 
     if (!pagination) {
       return this.queryRows(`${baseQuery} ORDER BY p.name ASC`, params);
@@ -2924,29 +2928,39 @@ export class OperationsService {
     this.requireFields(data as Record<string, unknown>, ['name']);
 
     let assignmentId: number | null = null;
-    let projectId: number | null = null;
+    let projectId: number | null = data.projectId ?? null;
 
     if (data.projectId || data.projectAssignmentId) {
-      const assignment = await this.resolveProjectAssignmentForActor(
-        this.prisma,
-        actor,
-        {
-          projectId: data.projectId ?? null,
-          projectAssignmentId: data.projectAssignmentId ?? null,
+      if (actor.isCollaborator && !actor.isDirector && !actor.isSupervisor) {
+        const assignment = await this.resolveProjectAssignmentForActor(
+          this.prisma,
+          actor,
+          {
+            projectId: data.projectId ?? null,
+            projectAssignmentId: data.projectAssignmentId ?? null,
+          }
+        );
+        await this.assertProjectAccess(actor, assignment.projectId);
+        assignmentId = assignment.id;
+        projectId = assignment.projectId;
+      } else {
+        if (data.projectId) {
+          await this.assertProjectAccess(actor, data.projectId);
+          projectId = data.projectId;
         }
-      );
-      await this.assertProjectAccess(actor, assignment.projectId);
-      assignmentId = assignment.id;
-      projectId = assignment.projectId;
-    } else if (data.projectId) {
-      projectId = data.projectId;
-      await this.assertProjectAccess(actor, projectId);
-    } else {
-      throw new BadRequestException('Either projectId or projectAssignmentId is required.');
-    }
-
-    if (!projectId) {
-      projectId = data.projectId ?? null;
+        if (data.projectAssignmentId) {
+          const assignment = await this.resolveProjectAssignmentForActor(
+            this.prisma,
+            actor,
+            {
+              projectId: data.projectId ?? null,
+              projectAssignmentId: data.projectAssignmentId,
+            }
+          );
+          assignmentId = assignment.id;
+          projectId = assignment.projectId;
+        }
+      }
     }
 
     const name = this.normalizeOptionalText(data.name);
@@ -2989,7 +3003,7 @@ export class OperationsService {
       [
         projectId,
         assignmentId,
-        data.assigneeCollaboratorId ?? actor.collaboratorId ?? null,
+        data.assigneeCollaboratorId ?? null,
         name,
         this.normalizeOptionalText(data.description),
         data.priority ?? 'medium',
@@ -3140,6 +3154,114 @@ export class OperationsService {
     return { success: true };
   }
 
+  async listTaskFiles(userId: number, taskId: number) {
+    const actor = await this.getActorContext(userId);
+    if (!actor.isCollaborator && !actor.isDirector && !actor.isSupervisor) {
+      throw new ForbiddenException(
+        'Operations collaborator access is required.'
+      );
+    }
+
+    const current = await this.getTaskRecordForActor(
+      this.prisma,
+      actor,
+      taskId
+    );
+    await this.assertProjectAccess(actor, current.projectId);
+
+    const rows = (await (this.prisma as any).$queryRawUnsafe(
+      `SELECT tf.id, tf.file_id, f.filename, f.size, m.name AS mimetype, tf.created_at
+         FROM operations_task_file tf
+         JOIN file f ON f.id = tf.file_id
+         JOIN file_mimetype m ON m.id = f.mimetype_id
+        WHERE tf.operations_task_id = $1
+        ORDER BY tf.created_at ASC`,
+      taskId
+    )) as Array<{
+      id: number;
+      file_id: number;
+      filename: string;
+      size: number;
+      mimetype: string;
+      created_at: Date;
+    }>;
+
+    return rows;
+  }
+
+  async addTaskFile(
+    userId: number,
+    taskId: number,
+    file: MulterFile
+  ) {
+    const actor = await this.getActorContext(userId);
+    if (!actor.isCollaborator && !actor.isDirector && !actor.isSupervisor) {
+      throw new ForbiddenException(
+        'Operations collaborator access is required.'
+      );
+    }
+
+    const current = await this.getTaskRecordForActor(
+      this.prisma,
+      actor,
+      taskId
+    );
+    await this.assertProjectAccess(actor, current.projectId);
+
+    const uploaded = await this.fileService.upload(
+      `operations/tasks/${taskId}`,
+      file
+    );
+
+    await (this.prisma as any).$executeRawUnsafe(
+      `INSERT INTO operations_task_file (operations_task_id, file_id, created_at, updated_at)
+       VALUES ($1, $2, NOW(), NOW())`,
+      taskId,
+      uploaded.id
+    );
+
+    return uploaded;
+  }
+
+  async removeTaskFile(userId: number, taskId: number, fileRelationId: number) {
+    const actor = await this.getActorContext(userId);
+    if (!actor.isCollaborator && !actor.isDirector && !actor.isSupervisor) {
+      throw new ForbiddenException(
+        'Operations collaborator access is required.'
+      );
+    }
+
+    const current = await this.getTaskRecordForActor(
+      this.prisma,
+      actor,
+      taskId
+    );
+    await this.assertProjectAccess(actor, current.projectId);
+
+    const rows = (await (this.prisma as any).$queryRawUnsafe(
+      `SELECT file_id FROM operations_task_file WHERE id = $1 AND operations_task_id = $2`,
+      fileRelationId,
+      taskId
+    )) as Array<{ file_id: number }>;
+
+    if (!rows.length) {
+      throw new NotFoundException('Task file attachment not found.');
+    }
+
+    const fileId = rows[0].file_id;
+
+    await (this.prisma as any).$executeRawUnsafe(
+      `DELETE FROM operations_task_file WHERE id = $1`,
+      fileRelationId
+    );
+
+    if (fileId) {
+      await this.fileService.delete('en', { ids: [fileId] });
+    }
+
+    return { success: true };
+  }
+
   async listTimesheetEntries(
     userId: number,
     paginationParams: {