@hed-hog/operations 0.0.322 → 0.0.326

package/hedhog/frontend/app/_lib/api.ts.ejs

@@ -124,6 +124,15 @@ export function createCostType(
   );
 }
 
+// ─── Collaborators ────────────────────────────────────────────────────────────
+
+export function fetchCollaborators(request: RequestFn) {
+  return fetchOperations<import('./types').OperationsCollaborator[]>(
+    request,
+    '/operations/collaborators'
+  );
+}
+
 // ─── Collaborator Costs ───────────────────────────────────────────────────────
 
 export type CollaboratorCost = {
@@ -218,3 +227,250 @@ export function deleteCollaboratorCost(
     'DELETE'
   );
 }
+
+// ─── Currencies ───────────────────────────────────────────────────────────────
+
+export type Currency = Record<string, unknown> & {
+  id: number;
+  code: string;
+  name: string;
+  symbol: string;
+  status: 'active' | 'inactive';
+};
+
+export function listCurrencies(
+  request: RequestFn,
+  params?: Record<string, string>
+) {
+  const qs = params ? new URLSearchParams(params).toString() : '';
+  return fetchOperations<Currency[]>(
+    request,
+    qs ? `/finance/currencies?${qs}` : '/finance/currencies'
+  );
+}
+
+// ─── Project Cost Categories ──────────────────────────────────────────────────
+
+export function listProjectCostCategories(
+  request: RequestFn,
+  params?: Record<string, string>
+) {
+  const qs = params ? new URLSearchParams(params).toString() : '';
+  return fetchOperations(
+    request,
+    qs
+      ? `/operations/project-cost-categories?${qs}`
+      : '/operations/project-cost-categories'
+  );
+}
+
+export function createProjectCostCategory(request: RequestFn, data: unknown) {
+  return mutateOperations(
+    request,
+    '/operations/project-cost-categories',
+    'POST',
+    data
+  );
+}
+
+export function updateProjectCostCategory(
+  request: RequestFn,
+  id: number,
+  data: unknown
+) {
+  return mutateOperations(
+    request,
+    `/operations/project-cost-categories/${id}`,
+    'PATCH',
+    data
+  );
+}
+
+export function deleteProjectCostCategory(request: RequestFn, id: number) {
+  return mutateOperations(
+    request,
+    `/operations/project-cost-categories/${id}`,
+    'DELETE'
+  );
+}
+
+// ─── Project Cost Types ───────────────────────────────────────────────────────
+
+export function listProjectCostTypes(
+  request: RequestFn,
+  params?: Record<string, string>
+) {
+  const qs = params ? new URLSearchParams(params).toString() : '';
+  return fetchOperations(
+    request,
+    qs
+      ? `/operations/project-cost-types?${qs}`
+      : '/operations/project-cost-types'
+  );
+}
+
+export function createProjectCostType(request: RequestFn, data: unknown) {
+  return mutateOperations(
+    request,
+    '/operations/project-cost-types',
+    'POST',
+    data
+  );
+}
+
+export function updateProjectCostType(
+  request: RequestFn,
+  id: number,
+  data: unknown
+) {
+  return mutateOperations(
+    request,
+    `/operations/project-cost-types/${id}`,
+    'PATCH',
+    data
+  );
+}
+
+export function deleteProjectCostType(request: RequestFn, id: number) {
+  return mutateOperations(
+    request,
+    `/operations/project-cost-types/${id}`,
+    'DELETE'
+  );
+}
+
+// ─── Project Costs ────────────────────────────────────────────────────────────
+
+export function listProjectCosts(
+  request: RequestFn,
+  projectId: number,
+  params?: Record<string, string>
+) {
+  const qs = params ? new URLSearchParams(params).toString() : '';
+  return fetchOperations(
+    request,
+    qs
+      ? `/operations/projects/${projectId}/costs?${qs}`
+      : `/operations/projects/${projectId}/costs`
+  );
+}
+
+export function getProjectCostsSummary(request: RequestFn, projectId: number) {
+  return fetchOperations(
+    request,
+    `/operations/projects/${projectId}/costs/summary`
+  );
+}
+
+export function getFullProjectCostSummary(
+  request: RequestFn,
+  projectId: number
+) {
+  return fetchOperations(
+    request,
+    `/operations/projects/${projectId}/cost-summary`
+  );
+}
+
+export function createProjectCost(
+  request: RequestFn,
+  projectId: number,
+  data: unknown
+) {
+  return mutateOperations(
+    request,
+    `/operations/projects/${projectId}/costs`,
+    'POST',
+    data
+  );
+}
+
+export function updateProjectCost(
+  request: RequestFn,
+  projectId: number,
+  costId: number,
+  data: unknown
+) {
+  return mutateOperations(
+    request,
+    `/operations/projects/${projectId}/costs/${costId}`,
+    'PATCH',
+    data
+  );
+}
+
+export function deleteProjectCost(
+  request: RequestFn,
+  projectId: number,
+  costId: number
+) {
+  return mutateOperations(
+    request,
+    `/operations/projects/${projectId}/costs/${costId}`,
+    'DELETE'
+  );
+}
+
+export function getProjectCostReport(
+  request: RequestFn,
+  projectId: number,
+  filters?: Record<string, unknown>
+) {
+  const params = filters
+    ? '?' +
+      new URLSearchParams(
+        Object.entries(filters)
+          .filter(([, v]) => v !== undefined && v !== null)
+          .map(([k, v]) => [k, String(v)])
+      ).toString()
+    : '';
+  return fetchOperations(
+    request,
+    `/operations/projects/${projectId}/costs/report${params}`
+  );
+}
+
+// ─── Task Comments ────────────────────────────────────────────────────────────
+
+export function fetchTaskComments(request: RequestFn, taskId: number) {
+  return fetchOperations(request, `/operations/tasks/${taskId}/comments`);
+}
+
+export function createTaskComment(
+  request: RequestFn,
+  taskId: number,
+  content: string
+) {
+  return mutateOperations(
+    request,
+    `/operations/tasks/${taskId}/comments`,
+    'POST',
+    { content }
+  );
+}
+
+export function updateTaskComment(
+  request: RequestFn,
+  taskId: number,
+  commentId: number,
+  content: string
+) {
+  return mutateOperations(
+    request,
+    `/operations/tasks/${taskId}/comments/${commentId}`,
+    'PATCH',
+    { content }
+  );
+}
+
+export function deleteTaskComment(
+  request: RequestFn,
+  taskId: number,
+  commentId: number
+) {
+  return mutateOperations(
+    request,
+    `/operations/tasks/${taskId}/comments/${commentId}`,
+    'DELETE'
+  );
+}

package/hedhog/frontend/app/_lib/hooks/use-mention-items.ts.ejs

@@ -0,0 +1,28 @@
+'use client';
+
+import type { MentionItem } from '@/components/rich-text-editor';
+import { useQuery } from '@hed-hog/next-app-provider';
+import type { AxiosRequestConfig, AxiosResponse } from 'axios';
+import { fetchCollaborators } from '../api';
+import type { OperationsCollaborator } from '../types';
+
+type RequestFn = <T extends object>(
+  config?: AxiosRequestConfig
+) => Promise<AxiosResponse<T>>;
+
+export function useMentionItems(request: RequestFn): MentionItem[] {
+  const { data: collaborators = [] } = useQuery<OperationsCollaborator[]>({
+    queryKey: ['operations-collaborators-mention'],
+    queryFn: () => fetchCollaborators(request),
+    staleTime: 5 * 60 * 1000,
+  });
+
+  return collaborators.map<MentionItem>((c) => ({
+    id: c.id,
+    label: c.displayName,
+    avatarSrc:
+      typeof c.personAvatarId === 'number' && c.personAvatarId > 0
+        ? `${process.env.NEXT_PUBLIC_API_BASE_URL}/person/avatar/${c.personAvatarId}`
+        : null,
+  }));
+}

package/hedhog/frontend/app/_lib/types.ts.ejs

@@ -8,6 +8,18 @@ export type PaginatedResponse<T> = {
   data: T[];
 };
 
+export type OperationsTaskComment = {
+  id: number;
+  taskId: number;
+  content: string;
+  actorCollaboratorId: number | null;
+  actorName: string | null;
+  actorUserPhotoId: number | null;
+  actorPersonAvatarId: number | null;
+  createdAt: string;
+  updatedAt: string | null;
+};
+
 export type OperationsDashboard = {
   actor: {
     roleScope: 'self' | 'team' | 'full';
@@ -56,6 +68,9 @@ export type OperationsProjectsReport = {
     recognizedRevenue: number;
     realizedCost: number;
     forecastCost: number;
+    allocatedCost: number;
+    consumedHoursCost: number;
+    plannedProfit: number;
     profit: number;
     margin: number;
     plannedHours: number;
@@ -65,6 +80,8 @@ export type OperationsProjectsReport = {
     backlogValue: number;
     avgDeadline: number;
     avgAllocation: number;
+    idlenessRate: number;
+    idlenessCost: number;
     atRisk: number;
     burnRate: number;
   };
@@ -125,6 +142,10 @@ export type OperationsProjectsReport = {
     financialProgress: number;
     backlogValue: number;
     futureDeliveries: number;
+    allocatedCost: number;
+    consumedHoursCost: number;
+    idlenessRate: number;
+    idlenessCost: number;
     risk: 'baixo' | 'médio' | 'alto';
     recommendation: string;
   }>;
@@ -216,6 +237,7 @@ export type OperationsCollaborator = {
   personId?: number | null;
   personName?: string | null;
   personAvatarId?: number | null;
+  userPhotoId?: number | null;
   code: string;
   collaboratorTypeId?: number | null;
   collaboratorTypeSlug?: string | null;
@@ -229,6 +251,7 @@ export type OperationsCollaborator = {
   levelLabel?: string | null;
   weeklyCapacityHours?: number | null;
   compensationAmount?: number | null;
+  hourlyRate?: number | null;
   status: string;
   joinedAt?: string | null;
   leftAt?: string | null;
@@ -341,6 +364,8 @@ export type OperationsTaskOption = {
   assigneeName?: string | null;
   assigneeUserPhotoId?: number | null;
   assigneePersonAvatarId?: number | null;
+  commentCount?: number | null;
+  fileCount?: number | null;
   createdAt?: string | null;
   deletedAt?: string | null;
 };
@@ -453,6 +478,7 @@ export type OperationsTimesheet = {
   id: number;
   collaboratorId: number;
   collaboratorName: string;
+  approvalId?: number | null;
   approverCollaboratorId?: number | null;
   approverName?: string | null;
   weekStartDate: string;
@@ -731,3 +757,167 @@ export type OperationsContractDetails = OperationsContract & {
     createdAt: string;
   }>;
 };
+
+// ─── Project Cost ─────────────────────────────────────────────────────────────
+
+export interface ProjectCostCategory extends Record<string, unknown> {
+  id: number;
+  slug: string;
+  name: string;
+  description?: string;
+  icon?: string;
+  color?: string;
+  is_active: boolean;
+  sort_order: number;
+}
+
+export interface ProjectCostType extends Record<string, unknown> {
+  id: number;
+  category_id?: number;
+  slug: string;
+  code: string;
+  name: string;
+  description?: string;
+  default_unit?: string;
+  default_calculation_type:
+    | 'fixed'
+    | 'unit'
+    | 'hourly'
+    | 'monthly'
+    | 'percentage';
+  is_recurring_allowed: boolean;
+  is_active: boolean;
+  sort_order: number;
+  category?: ProjectCostCategory;
+}
+
+export interface ProjectCost {
+  id: number;
+  project_id: number;
+  cost_type_id?: number;
+  category_id?: number;
+  description?: string;
+  amount: number;
+  currency: string;
+  quantity: number;
+  unit_amount?: number;
+  cost_date?: string;
+  period_start?: string;
+  period_end?: string;
+  calculation_type: 'fixed' | 'unit' | 'hourly' | 'monthly' | 'percentage';
+  recurrence_type: 'none' | 'daily' | 'weekly' | 'monthly' | 'yearly';
+  is_billable: boolean;
+  is_reimbursable: boolean;
+  notes?: string;
+  status: 'planned' | 'approved' | 'realized' | 'cancelled';
+  cost_type?: ProjectCostType;
+  category?: ProjectCostCategory;
+  created_at: string;
+}
+
+export interface ProjectCostSummary {
+  categories: Array<{
+    category: ProjectCostCategory | null;
+    total_amount: number;
+    count: number;
+    items: ProjectCost[];
+  }>;
+  grand_total: number;
+}
+
+export interface FullCostSummary {
+  project_id: number;
+  budget_amount: number;
+  team_cost_total: number;
+  extra_cost_total: number;
+  total_project_cost: number;
+  remaining_budget: number;
+  budget_usage_percent: number;
+  planned_total: number;
+  approved_total: number;
+  realized_total: number;
+  cancelled_total: number;
+  billable_total: number;
+  non_billable_total: number;
+  reimbursable_total: number;
+  cost_by_category: Array<{
+    category_id: number;
+    category_slug: string;
+    category_name: string;
+    category_color: string;
+    category_icon: string;
+    total: number;
+    count: number;
+  }>;
+  cost_by_type: Array<{
+    cost_type_id: number;
+    cost_type_slug: string;
+    cost_type_name: string;
+    cost_type_code: string;
+    total: number;
+    count: number;
+  }>;
+  cost_by_month: Array<{
+    month: string;
+    total: number;
+    count: number;
+  }>;
+  top_cost_types: Array<{
+    cost_type_id: number;
+    cost_type_slug: string;
+    cost_type_name: string;
+    cost_type_code: string;
+    total: number;
+    percentage: number;
+  }>;
+}
+
+export interface ProjectCostReportItem {
+  id: number;
+  description?: string;
+  category_name?: string;
+  category_color?: string;
+  cost_type_name?: string;
+  status: 'planned' | 'approved' | 'realized' | 'cancelled';
+  cost_date?: string;
+  amount: number;
+  quantity: number;
+  total: number;
+  currency: string;
+  is_billable: boolean;
+  is_reimbursable: boolean;
+}
+
+export interface ProjectCostReport {
+  totals: {
+    grand_total: number;
+    total_count: number;
+    planned_total: number;
+    approved_total: number;
+    realized_total: number;
+    cancelled_total: number;
+    billable_total: number;
+    non_billable_total: number;
+    reimbursable_total: number;
+  };
+  cost_by_month: Array<{
+    month: string;
+    total: number;
+    count: number;
+    planned_subtotal?: number;
+    realized_subtotal?: number;
+  }>;
+  cost_by_category: Array<{
+    category_id?: number | null;
+    category_slug?: string | null;
+    category_name: string;
+    category_color?: string | null;
+    category_icon?: string | null;
+    total: number;
+    count: number;
+    planned_subtotal?: number;
+    realized_subtotal?: number;
+  }>;
+  top_5_costs: ProjectCostReportItem[];
+  detailed_list: ProjectCostReportItem[];
+}

package/hedhog/frontend/app/_lib/utils/format.ts.ejs

@@ -102,12 +102,18 @@ export function formatDateTime(
   });
 }
 
-export function formatPercent(value?: number | null) {
-  if (value === null || value === undefined || Number.isNaN(value)) {
+export function formatPercent(value?: number | string | null) {
+  if (value === null || value === undefined) {
+    return '-';
+  }
+
+  const num = Number(value);
+
+  if (Number.isNaN(num)) {
     return '-';
   }
 
-  return `${value}%`;
+  return `${parseFloat(num.toFixed(2))}%`;
 }
 
 export function formatHours(value?: number | null) {

package/hedhog/frontend/app/collaborators/page.tsx.ejs

@@ -74,10 +74,17 @@ const COLLABORATOR_VIEW_STORAGE_KEY = 'operations-collaborators-view-mode';
 
 type CollaboratorViewMode = 'table' | 'cards';
 
-function getPersonAvatarUrl(avatarId?: number | null) {
-  return typeof avatarId === 'number' && avatarId > 0
-    ? `${process.env.NEXT_PUBLIC_API_BASE_URL}/person/avatar/${avatarId}`
-    : '/placeholder.png';
+function getPersonAvatarUrl(
+  avatarId?: number | null,
+  userPhotoId?: number | null
+) {
+  if (typeof avatarId === 'number' && avatarId > 0) {
+    return `${process.env.NEXT_PUBLIC_API_BASE_URL}/person/avatar/${avatarId}`;
+  }
+  if (typeof userPhotoId === 'number' && userPhotoId > 0) {
+    return `${process.env.NEXT_PUBLIC_API_BASE_URL}/user/avatar/${userPhotoId}`;
+  }
+  return '/placeholder.png';
 }
 
 function getInitials(value?: string | null) {
@@ -552,7 +559,10 @@ export default function OperationsCollaboratorsPage() {
                     <div className="flex min-w-0 items-center gap-3">
                       <Avatar className="h-12 w-12 border border-border/60 bg-muted">
                         <AvatarImage
-                          src={getPersonAvatarUrl(collaborator.personAvatarId)}
+                          src={getPersonAvatarUrl(
+                            collaborator.personAvatarId,
+                            collaborator.userPhotoId
+                          )}
                           alt={collaborator.displayName}
                         />
                         <AvatarFallback className="bg-muted text-sm font-semibold text-foreground">
@@ -734,7 +744,8 @@ export default function OperationsCollaboratorsPage() {
                         <Avatar className="h-9 w-9 border border-border/60 bg-muted">
                           <AvatarImage
                             src={getPersonAvatarUrl(
-                              collaborator.personAvatarId
+                              collaborator.personAvatarId,
+                              collaborator.userPhotoId
                             )}
                             alt={collaborator.displayName}
                           />
@@ -911,7 +922,7 @@ export default function OperationsCollaboratorsPage() {
           }
         }}
       >
-        <SheetContent className="w-full overflow-y-auto sm:max-w-6xl">
+        <SheetContent className="w-full overflow-y-auto sm:max-w-6xl gap-0">
           <SheetHeader>
             <SheetTitle>
               {editingCollaboratorId