@hed-hog/operations 0.0.330 → 0.0.331

package/hedhog/table/operations_task_activity.yaml

@@ -0,0 +1,51 @@
+columns:
+  - type: pk
+  - name: task_id
+    type: fk
+    references:
+      table: operations_task
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: actor_collaborator_id
+    type: fk
+    isNullable: true
+    references:
+      table: operations_collaborator
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: action
+    type: enum
+    values:
+      [
+        status_changed,
+        task_created,
+        task_deleted,
+        task_restored,
+        assignee_changed,
+        priority_changed,
+        due_date_changed,
+        name_changed,
+        description_changed,
+        comment_added,
+        comment_updated,
+        comment_removed,
+        file_added,
+        file_removed,
+      ]
+    default: status_changed
+  - name: from_status
+    type: enum
+    values: [todo, doing, review, done]
+    isNullable: true
+  - name: to_status
+    type: enum
+    values: [todo, doing, review, done]
+    isNullable: true
+  - type: created_at
+
+indices:
+  - columns: [task_id]
+  - columns: [actor_collaborator_id]
+  - columns: [created_at]

package/package.json

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

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

@@ -1,14 +1,18 @@
 import { Role, User } from '@hed-hog/api';
 import {
-  Body,
-  Controller,
-  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 { ListMyProjectsDto } from '../dto/list-my-projects.dto';
 import { ListOperationsProjectOptionsDto } from '../dto/list-project-options.dto';
 import { ListProjectsDto } from '../dto/list-projects.dto';
@@ -64,4 +68,33 @@ export class OperationsProjectsController {
   updateProject(@User() user, @Param('id', ParseIntPipe) id: number, @Body() data) {
     return this.operationsService.updateProject(Number(user?.id || 0), id, data);
   }
+
+  @Delete('projects/:id')
+  deleteProject(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.deleteProject(Number(user?.id || 0), id);
+  }
+
+  @Get('projects/:id/files')
+  listProjectFiles(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.listProjectFiles(Number(user?.id || 0), id);
+  }
+
+  @Post('projects/:id/files')
+  @UseInterceptors(FileInterceptor('file'))
+  addProjectFile(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @UploadedFile() file: MulterFile,
+  ) {
+    return this.operationsService.addProjectFile(Number(user?.id || 0), id, file);
+  }
+
+  @Delete('projects/:id/files/:fileRelationId')
+  removeProjectFile(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Param('fileRelationId', ParseIntPipe) fileRelationId: number,
+  ) {
+    return this.operationsService.removeProjectFile(Number(user?.id || 0), id, fileRelationId);
+  }
 }

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

@@ -1,166 +1,156 @@
-import { Role, User } from '@hed-hog/api';
-import {
-    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';
-import { UpdateOperationsTaskDto } from '../dto/update-task.dto';
-import { OperationsService } from '../operations.service';
-
-@Role()
-@Controller('operations')
-export class OperationsTasksController {
-  constructor(private readonly operationsService: OperationsService) {}
-
-  @Get('tasks')
-  listTasks(
-    @User() user,
-    @Query() paginationParams: ListOperationsTasksDto,
-  ) {
-    return this.operationsService.listTasks(
-      Number(user?.id || 0),
-      paginationParams,
-    );
-  }
-
-  @Get('my-tasks')
-  listMyTasks(
-    @User() user,
-    @Query() paginationParams: ListMyTasksDto,
-  ) {
-    return this.operationsService.listMyTasks(
-      Number(user?.id || 0),
-      paginationParams,
-    );
-  }
-
-  @Get('projects/:id/tasks')
-  listProjectBoardTasks(
-    @User() user,
-    @Param('id', ParseIntPipe) id: number,
-  ) {
-    return this.operationsService.listProjectBoardTasks(
-      Number(user?.id || 0),
-      id,
-    );
-  }
-
-  @Post('tasks')
-  createTask(@User() user, @Body() data: CreateOperationsTaskDto) {
-    return this.operationsService.createTask(Number(user?.id || 0), data);
-  }
-
-  @Patch('tasks/:id')
-  updateTask(
-    @User() user,
-    @Param('id', ParseIntPipe) id: number,
-    @Body() data: UpdateOperationsTaskDto,
-  ) {
-    return this.operationsService.updateTask(Number(user?.id || 0), id, data);
-  }
-
-  @Delete('tasks/:id')
-  removeTask(
-    @User() user,
-    @Param('id', ParseIntPipe) id: number,
-    @Query('permanent') permanent?: string,
-  ) {
-    return this.operationsService.removeTask(
-      Number(user?.id || 0),
-      id,
-      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
-    );
-  }
-
-  @Get('tasks/:id/comments')
-  listTaskComments(
-    @User() user,
-    @Param('id', ParseIntPipe) id: number,
-  ) {
-    return this.operationsService.listTaskComments(Number(user?.id || 0), id);
-  }
-
-  @Post('tasks/:id/comments')
-  addTaskComment(
-    @User() user,
-    @Param('id', ParseIntPipe) id: number,
-    @Body('content') content: string,
-  ) {
-    return this.operationsService.addTaskComment(
-      Number(user?.id || 0),
-      id,
-      content
-    );
-  }
-
-  @Patch('tasks/:taskId/comments/:commentId')
-  updateTaskComment(
-    @User() user,
-    @Param('taskId', ParseIntPipe) taskId: number,
-    @Param('commentId', ParseIntPipe) commentId: number,
-    @Body('content') content: string,
-  ) {
-    return this.operationsService.updateTaskComment(
-      Number(user?.id || 0),
-      taskId,
-      commentId,
-      content
-    );
-  }
-
-  @Delete('tasks/:taskId/comments/:commentId')
-  removeTaskComment(
-    @User() user,
-    @Param('taskId', ParseIntPipe) taskId: number,
-    @Param('commentId', ParseIntPipe) commentId: number,
-  ) {
-    return this.operationsService.removeTaskComment(
-      Number(user?.id || 0),
-      taskId,
-      commentId
-    );
-  }
-}
+import { Role, User } from "@hed-hog/api";
+import {
+  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";
+import { UpdateOperationsTaskDto } from "../dto/update-task.dto";
+import { OperationsService } from "../operations.service";
+
+@Role()
+@Controller("operations")
+export class OperationsTasksController {
+  constructor(private readonly operationsService: OperationsService) {}
+
+  @Get("tasks")
+  listTasks(@User() user, @Query() paginationParams: ListOperationsTasksDto) {
+    return this.operationsService.listTasks(
+      Number(user?.id || 0),
+      paginationParams,
+    );
+  }
+
+  @Get("my-tasks")
+  listMyTasks(@User() user, @Query() paginationParams: ListMyTasksDto) {
+    return this.operationsService.listMyTasks(
+      Number(user?.id || 0),
+      paginationParams,
+    );
+  }
+
+  @Get("projects/:id/tasks")
+  listProjectBoardTasks(@User() user, @Param("id", ParseIntPipe) id: number) {
+    return this.operationsService.listProjectBoardTasks(
+      Number(user?.id || 0),
+      id,
+    );
+  }
+
+  @Post("tasks")
+  createTask(@User() user, @Body() data: CreateOperationsTaskDto) {
+    return this.operationsService.createTask(Number(user?.id || 0), data);
+  }
+
+  @Patch("tasks/:id")
+  updateTask(
+    @User() user,
+    @Param("id", ParseIntPipe) id: number,
+    @Body() data: UpdateOperationsTaskDto,
+  ) {
+    return this.operationsService.updateTask(Number(user?.id || 0), id, data);
+  }
+
+  @Delete("tasks/:id")
+  removeTask(
+    @User() user,
+    @Param("id", ParseIntPipe) id: number,
+    @Query("permanent") permanent?: string,
+  ) {
+    return this.operationsService.removeTask(
+      Number(user?.id || 0),
+      id,
+      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,
+    );
+  }
+
+  @Get("tasks/:id/comments")
+  listTaskComments(@User() user, @Param("id", ParseIntPipe) id: number) {
+    return this.operationsService.listTaskComments(Number(user?.id || 0), id);
+  }
+
+  @Get("tasks/:id/activities")
+  listTaskActivities(@User() user, @Param("id", ParseIntPipe) id: number) {
+    return this.operationsService.listTaskActivities(Number(user?.id || 0), id);
+  }
+
+  @Post("tasks/:id/comments")
+  addTaskComment(
+    @User() user,
+    @Param("id", ParseIntPipe) id: number,
+    @Body("content") content: string,
+  ) {
+    return this.operationsService.addTaskComment(
+      Number(user?.id || 0),
+      id,
+      content,
+    );
+  }
+
+  @Patch("tasks/:taskId/comments/:commentId")
+  updateTaskComment(
+    @User() user,
+    @Param("taskId", ParseIntPipe) taskId: number,
+    @Param("commentId", ParseIntPipe) commentId: number,
+    @Body("content") content: string,
+  ) {
+    return this.operationsService.updateTaskComment(
+      Number(user?.id || 0),
+      taskId,
+      commentId,
+      content,
+    );
+  }
+
+  @Delete("tasks/:taskId/comments/:commentId")
+  removeTaskComment(
+    @User() user,
+    @Param("taskId", ParseIntPipe) taskId: number,
+    @Param("commentId", ParseIntPipe) commentId: number,
+  ) {
+    return this.operationsService.removeTaskComment(
+      Number(user?.id || 0),
+      taskId,
+      commentId,
+    );
+  }
+}

package/src/dashboard/README.md

@@ -0,0 +1,214 @@
+# Dashboard Widgets - Operations Module
+
+## Arquitetura
+
+O dashboard do módulo operations segue um padrão de composição modular com 3 camadas de widgets baseados em roles:
+
+### Roles e Widgets
+
+| Role | Widgets | Descrição |
+|------|---------|-----------|
+| `operations-collaborator` | 8 widgets | Visão pessoal: horas, timesheet, alocações, solicitações, prazos, ações rápidas |
+| `admin-operations-supervisor` | 8 widgets | Visão de time: headcount, aprovações, horas, capacidade, utilização, alertas, projetos, fila |
+| `admin-operations-director` | 7 widgets | Visão de portfólio: projetos, custos, esforço, risco, status, distribuição, prazos |
+
+### Estrutura de Pastas
+
+```
+src/dashboard/
+├── hooks/
+│   └── useDashboardData.ts          # Hook para buscar dados do backend
+├── types/
+│   └── widgets.types.ts             # Tipos TypeScript para dados de widgets
+├── components/
+│   └── DashboardLayout.tsx          # Layout principal que renderiza widgets
+└── widgets/
+    ├── MyHoursPeriodKpi.tsx         # Exemplo: Collaborator widget
+    ├── TeamHeadcountKpi.tsx         # Exemplo: Supervisor widget
+    ├── PortfolioProjectsKpi.tsx     # Exemplo: Director widget
+    └── [outros widgets...]          # A implementar
+```
+
+## Como Adicionar um Novo Widget
+
+### 1. Defina o tipo de dados em `types/widgets.types.ts`
+
+Adicione a interface de dados para seu widget:
+
+```typescript
+export interface MyNewWidgetData {
+  title: string;
+  value: number;
+  // ... outros campos
+}
+```
+
+### 2. Crie o componente widget
+
+Crie um arquivo em `widgets/MyNewWidget.tsx`:
+
+```typescript
+'use client';
+
+import React from 'react';
+
+interface MyNewWidgetProps {
+  slug: string;
+  title: string;
+  roleSlug: string;
+  width?: number;
+  height?: number;
+  data?: MyNewWidgetData;
+  style?: React.CSSProperties;
+}
+
+const MyNewWidget: React.FC<MyNewWidgetProps> = ({
+  title,
+  data,
+  style,
+}) => {
+  return (
+    <div className="bg-white rounded-lg shadow-sm p-4" style={style}>
+      <h3 className="text-sm font-medium">{title}</h3>
+      {/* Renderizar dados aqui */}
+    </div>
+  );
+};
+
+export default MyNewWidget;
+```
+
+### 3. Registre o widget em `DashboardLayout.tsx`
+
+Adicione ao `WIDGET_REGISTRY`:
+
+```typescript
+'my-new-widget': React.lazy(() => import('./widgets/MyNewWidget')),
+```
+
+### 4. Configure permissões no YAML
+
+Atualize `libraries/operations/hedhog/data/dashboard_component.yaml`:
+
+```yaml
+- slug: my-new-widget
+  library_slug: operations
+  width: 3
+  height: 1
+  name:
+    en: My New Widget
+    pt: Meu Novo Widget
+```
+
+Atualize `libraries/operations/hedhog/data/dashboard_component_role.yaml`:
+
+```yaml
+- component_id:
+    where:
+      slug: my-new-widget
+  role_id:
+    where:
+      slug: operations-collaborator  # ou a role apropriada
+```
+
+## Backend Integration
+
+### Endpoint: GET /operations/dashboard
+
+O backend retorna dados estruturados conforme a role do usuário:
+
+```typescript
+{
+  actor: {
+    roleScope: 'full' | 'team' | 'self',
+    collaboratorId: number,
+    collaboratorName: string,
+    teamSize: number,
+  },
+  cards: {
+    // ... dados agregados
+  },
+  recentTimesheets: [],
+  // ... dados específicos por role
+}
+```
+
+### Segurança
+
+⚠️ **IMPORTANTE:** O backend sanitiza automaticamente dados sensíveis por role:
+
+- **Directors**: Veem TODOS os dados (salários, custos, etc.)
+- **Supervisors**: Veem dados monetários da equipe apenas
+- **Collaborators**: Veem APENAS seus próprios dados, não de colegas
+
+Nenhuma sanitização adicional é necessária no frontend - confia no backend!
+
+## Padrões de Componente
+
+### KPI Card (Métrica simples)
+
+```typescript
+{
+  "métrica_principal": número grande em destaque,
+  "contexto": "de total",
+  "breakdown": [array de sub-métricas],
+  "status_indicator": visual de saúde (verde/amarelo/vermelho)
+}
+```
+
+### Chart/Graph (Visualização complexa)
+
+```typescript
+{
+  "título": string,
+  "dados": array de pontos com x,y,label,
+  "legenda": tipos de dados mostrados
+}
+```
+
+### Lista (Array de items)
+
+```typescript
+{
+  "cabeçalhos": ["coluna1", "coluna2", ...],
+  "linhas": [{ coluna1: valor, coluna2: valor }, ...],
+  "paginação": opcional
+}
+```
+
+## Testes
+
+Para testar um widget com dados mock:
+
+```typescript
+const mockData = {
+  plannedHours: 40,
+  approvedHours: 32,
+  pendingHours: 4,
+};
+
+<MyHoursPeriodKpi 
+  slug="my-hours-period-kpi"
+  title="Horas no Período"
+  roleSlug="operations-collaborator"
+  data={mockData}
+/>
+```
+
+## Loading States
+
+Cada widget implementa um fallback de loading usando `React.Suspense`:
+
+```typescript
+<React.Suspense fallback={<SkeletonLoader />}>
+  <MyWidget data={data} />
+</React.Suspense>
+```
+
+## Próximas Etapas
+
+- [ ] Implementar hook `useDashboardData` com react-query
+- [ ] Criar 20 widgets restantes (20/23 ainda faltam)
+- [ ] Integrar com Recharts/Chart.js para gráficos
+- [ ] Adicionar testes unitários para cada widget
+- [ ] Documentar parâmetros de cada widget