@hed-hog/operations 0.0.303 → 0.0.305

package/hedhog/frontend/app/_components/timesheet-task-create-sheet.tsx.ejs

@@ -0,0 +1,213 @@
+'use client';
+
+import {
+  Form,
+  FormControl,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from '@/components/ui/form';
+import { FormActions } from '@/components/ui/form-actions';
+import { Input } from '@/components/ui/input';
+import {
+  Sheet,
+  SheetContent,
+  SheetDescription,
+  SheetHeader,
+  SheetTitle,
+} from '@/components/ui/sheet';
+import { Textarea } from '@/components/ui/textarea';
+import { useApp } from '@hed-hog/next-app-provider';
+import { zodResolver } from '@hookform/resolvers/zod';
+import { Layers3 } from 'lucide-react';
+import { useTranslations } from 'next-intl';
+import { useEffect, useMemo } from 'react';
+import { useForm } from 'react-hook-form';
+import { z } from 'zod';
+
+import { getOperationsErrorMessage, mutateOperations } from '../_lib/api';
+import type {
+  OperationsProjectOption,
+  OperationsTaskOption,
+} from '../_lib/types';
+import { trimToNull } from '../_lib/utils/forms';
+
+type TimesheetTaskCreateSheetProps = {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  project: OperationsProjectOption | null;
+  onCreated: (task: OperationsTaskOption) => void;
+};
+
+type TaskFormValues = {
+  name: string;
+  description: string;
+};
+
+export function TimesheetTaskCreateSheet({
+  open,
+  onOpenChange,
+  project,
+  onCreated,
+}: TimesheetTaskCreateSheetProps) {
+  const t = useTranslations('operations.TimesheetsPage');
+  const commonT = useTranslations('operations.Common');
+  const { request, showToastHandler } = useApp();
+
+  const taskSchema = useMemo(
+    () =>
+      z.object({
+        name: z
+          .string()
+          .trim()
+          .min(2, t('sheet.task.validation.nameMinLength')),
+        description: z
+          .string()
+          .trim()
+          .max(500, t('sheet.task.validation.descriptionMaxLength'))
+          .optional()
+          .or(z.literal('')),
+      }),
+    [t]
+  );
+
+  const form = useForm<TaskFormValues>({
+    resolver: zodResolver(taskSchema),
+    defaultValues: {
+      name: '',
+      description: '',
+    },
+  });
+
+  useEffect(() => {
+    if (!open) {
+      form.reset({
+        name: '',
+        description: '',
+      });
+    }
+  }, [form, open]);
+
+  const handleSubmit = async (values: TaskFormValues) => {
+    if (!project?.id) {
+      showToastHandler?.('error', t('messages.selectProjectFirst'));
+      return;
+    }
+
+    try {
+      const createdTask = await mutateOperations<OperationsTaskOption>(
+        request,
+        '/operations/tasks',
+        'POST',
+        {
+          projectId: project.id,
+          name: values.name.trim(),
+          description: trimToNull(values.description),
+        }
+      );
+
+      onCreated(createdTask);
+      form.reset({
+        name: '',
+        description: '',
+      });
+      onOpenChange(false);
+      showToastHandler?.('success', t('messages.taskCreateSuccess'));
+    } catch (error) {
+      showToastHandler?.(
+        'error',
+        getOperationsErrorMessage(error, t('messages.taskCreateError'))
+      );
+    }
+  };
+
+  const handleOpenChange = (nextOpen: boolean) => {
+    if (form.formState.isSubmitting && !nextOpen) {
+      return;
+    }
+
+    onOpenChange(nextOpen);
+  };
+
+  return (
+    <Sheet open={open} onOpenChange={handleOpenChange}>
+      <SheetContent className="flex h-full w-full flex-col gap-0 overflow-hidden p-0 sm:max-w-lg">
+        <SheetHeader className="border-b px-4 py-4 text-left">
+          <div className="flex items-start gap-3">
+            <div className="flex h-10 w-10 shrink-0 items-center justify-center rounded-xl bg-violet-500/10 text-violet-600">
+              <Layers3 className="size-5" />
+            </div>
+
+            <div className="space-y-1">
+              <SheetTitle>{t('sheet.task.title')}</SheetTitle>
+              <SheetDescription>{t('sheet.task.description')}</SheetDescription>
+            </div>
+          </div>
+        </SheetHeader>
+
+        <Form {...form}>
+          <form
+            onSubmit={form.handleSubmit(handleSubmit)}
+            className="flex min-h-0 flex-1 flex-col"
+          >
+            <div className="flex-1 space-y-4 overflow-y-auto px-4 py-4">
+              <div className="rounded-lg border bg-muted/30 p-3">
+                <div className="text-xs font-medium uppercase tracking-wide text-muted-foreground">
+                  {t('sheet.task.projectLabel')}
+                </div>
+                <div className="mt-1 text-sm font-medium text-foreground">
+                  {project?.label ?? commonT('labels.notAssigned')}
+                </div>
+              </div>
+
+              <FormField
+                control={form.control}
+                name="name"
+                render={({ field }) => (
+                  <FormItem>
+                    <FormLabel>{t('sheet.task.name')}</FormLabel>
+                    <FormControl>
+                      <Input
+                        {...field}
+                        placeholder={t('sheet.task.placeholders.name')}
+                      />
+                    </FormControl>
+                    <FormMessage />
+                  </FormItem>
+                )}
+              />
+
+              <FormField
+                control={form.control}
+                name="description"
+                render={({ field }) => (
+                  <FormItem>
+                    <FormLabel>{t('sheet.task.descriptionLabel')}</FormLabel>
+                    <FormControl>
+                      <Textarea
+                        {...field}
+                        rows={4}
+                        placeholder={t('sheet.task.placeholders.description')}
+                      />
+                    </FormControl>
+                    <FormMessage />
+                  </FormItem>
+                )}
+              />
+            </div>
+
+            <FormActions
+              sheet
+              onCancel={() => onOpenChange(false)}
+              cancelLabel={commonT('actions.cancel')}
+              submitType="submit"
+              submitLabel={t('sheet.task.submit')}
+              submitDisabled={form.formState.isSubmitting || !project}
+            />
+          </form>
+        </Form>
+      </SheetContent>
+    </Sheet>
+  );
+}

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

@@ -4,6 +4,35 @@ type RequestFn = (input: {
   data?: unknown;
 }) => Promise<{ data: unknown }>;
 
+export function getOperationsErrorMessage(error: unknown, fallback: string) {
+  if (error && typeof error === 'object') {
+    const requestError = error as {
+      message?: string;
+      response?: {
+        data?: {
+          message?: string | string[];
+        };
+      };
+    };
+
+    const message =
+      requestError.response?.data?.message ?? requestError.message;
+
+    if (Array.isArray(message)) {
+      const combined = message.filter(Boolean).join(' ');
+      if (combined.trim()) {
+        return combined;
+      }
+    }
+
+    if (typeof message === 'string' && message.trim()) {
+      return message;
+    }
+  }
+
+  return fallback;
+}
+
 export async function fetchOperations<T>(request: RequestFn, url: string) {
   const response = await request({
     url,
@@ -16,7 +45,7 @@ export async function fetchOperations<T>(request: RequestFn, url: string) {
 export async function mutateOperations<T>(
   request: RequestFn,
   url: string,
-  method: 'POST' | 'PATCH',
+  method: 'POST' | 'PATCH' | 'DELETE',
   data?: unknown
 ) {
   const response = await request({

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

@@ -1,3 +1,13 @@
+export type PaginatedResponse<T> = {
+  total: number;
+  lastPage: number;
+  page: number;
+  pageSize: number;
+  prev?: number | null;
+  next?: number | null;
+  data: T[];
+};
+
 export type OperationsDashboard = {
   actor: {
     roleScope: 'self' | 'team' | 'full';
@@ -31,13 +41,18 @@ export type OperationsCollaborator = {
   personName?: string | null;
   personAvatarId?: number | null;
   code: string;
-  collaboratorType?: string;
+  collaboratorTypeId?: number | null;
+  collaboratorTypeSlug?: string | null;
+  collaboratorType?: string | null;
+  collaboratorTypeName?: string | null;
   displayName: string;
   departmentId?: number | null;
   department?: string | null;
+  jobTitleId?: number | null;
   title?: string | null;
   levelLabel?: string | null;
   weeklyCapacityHours?: number | null;
+  compensationAmount?: number | null;
   status: string;
   joinedAt?: string | null;
   leftAt?: string | null;
@@ -64,10 +79,76 @@ export type OperationsDepartment = {
   updatedAt?: string | null;
 };
 
+export type OperationsJobTitle = {
+  id: number;
+  slug: string;
+  code?: string | null;
+  name: string;
+  description?: string | null;
+  status: 'active' | 'inactive';
+  collaboratorCount?: number;
+  createdAt?: string | null;
+  updatedAt?: string | null;
+};
+
+export type OperationsCollaboratorType = {
+  id: number;
+  slug: string;
+  name: string;
+  description?: string | null;
+  category?: string | null;
+  isActive?: boolean;
+  sortOrder?: number | null;
+  status: 'active' | 'inactive';
+  collaboratorCount?: number;
+  createdAt?: string | null;
+  updatedAt?: string | null;
+};
+
+export type OperationsProjectRole = {
+  id: number;
+  slug: string;
+  code?: string | null;
+  name: string;
+  description?: string | null;
+  isActive?: boolean;
+  sortOrder?: number;
+  createdAt?: string | null;
+  updatedAt?: string | null;
+};
+
+export type OperationsProjectOption = {
+  id: number;
+  label: string;
+  name: string;
+  code?: string | null;
+  clientName?: string | null;
+  projectAssignmentId?: number | null;
+  roleLabel?: string | null;
+  status: string;
+  startDate?: string | null;
+  endDate?: string | null;
+};
+
+export type OperationsTaskOption = {
+  id: number;
+  label: string;
+  name: string;
+  description?: string | null;
+  status: string;
+  projectId: number;
+  projectAssignmentId: number;
+  projectName: string;
+  projectCode?: string | null;
+  createdAt?: string | null;
+};
+
 export type OperationsProject = {
   id: number;
   contractId?: number | null;
   managerCollaboratorId?: number | null;
+  clientPersonId?: number | null;
+  clientAvatarId?: number | null;
   code: string;
   name: string;
   clientName?: string | null;
@@ -87,16 +168,16 @@ export type OperationsProject = {
   teamSize?: number;
 };
 
-export type OperationsContract = {
-  id: number;
-  code: string;
-  name?: string | null;
-  contractCategory?: string;
-  contractType?: string;
-  clientName?: string | null;
-  signatureStatus?: string;
-  isActive?: boolean;
-  billingModel: string;
+export type OperationsContract = {
+  id: number;
+  code: string;
+  name?: string | null;
+  contractCategory?: string;
+  contractType?: string;
+  clientName?: string | null;
+  signatureStatus?: string;
+  isActive?: boolean;
+  billingModel: string;
   accountManagerCollaboratorId?: number | null;
   accountManagerName?: string | null;
   relatedCollaboratorId?: number | null;
@@ -104,26 +185,26 @@ export type OperationsContract = {
   contractTemplateId?: number | null;
   contractTemplateName?: string | null;
   contractTemplateSlug?: string | null;
-  contractTemplateCode?: string | null;
-  mainRelatedPartyName?: string | null;
-  originType?: string | null;
-  originId?: number | null;
-  startDate?: string | null;
-  endDate?: string | null;
-  signedAt?: string | null;
-  effectiveDate?: string | null;
+  contractTemplateCode?: string | null;
+  mainRelatedPartyName?: string | null;
+  originType?: string | null;
+  originId?: number | null;
+  startDate?: string | null;
+  endDate?: string | null;
+  signedAt?: string | null;
+  effectiveDate?: string | null;
   budgetAmount?: number | null;
   monthlyHourCap?: number | null;
   valueAmount?: number | null;
   paymentAmount?: number | null;
   revenueAmount?: number | null;
-  fineAmount?: number | null;
-  status: string;
-  creationMode?: 'blank' | 'template' | 'upload' | 'duplicate' | null;
-  wizardStep?: number | null;
-  description?: string | null;
-  contentHtml?: string | null;
-  projectCount?: number;
+  fineAmount?: number | null;
+  status: string;
+  creationMode?: 'blank' | 'template' | 'upload' | 'duplicate' | null;
+  wizardStep?: number | null;
+  description?: string | null;
+  contentHtml?: string | null;
+  projectCount?: number;
   currentPdfFileName?: string | null;
   scheduleSummary?: OperationsWeeklyScheduleDay[];
 };
@@ -154,14 +235,35 @@ export type OperationsWeeklyScheduleDay = {
   breakMinutes?: number | null;
 };
 
+export type OperationsCollaboratorEquityParticipation = {
+  participationType: string;
+  percentage?: number | null;
+  votingPower?: number | null;
+  startDate?: string | null;
+  endDate?: string | null;
+  notes?: string | null;
+};
+
 export type OperationsTimesheetEntry = {
   id: number;
+  timesheetId?: number | null;
+  collaboratorId?: number | null;
+  collaboratorName?: string | null;
   projectAssignmentId?: number | null;
   projectId?: number | null;
+  projectCode?: string | null;
   projectName?: string | null;
   roleLabel?: string | null;
+  taskId?: number | null;
+  taskName?: string | null;
   activityLabel?: string | null;
+  label?: string | null;
+  status?: string | null;
+  weekStartDate?: string | null;
+  weekEndDate?: string | null;
+  createdAt?: string | null;
   workDate: string;
+  durationMinutes?: number | null;
   hours: number;
   description?: string | null;
 };
@@ -282,6 +384,7 @@ export type OperationsCollaboratorDetails = OperationsCollaborator & {
     code: string;
     name: string;
     status: string;
+    projectRoleId?: number | null;
     roleLabel?: string | null;
     allocationPercent?: number | null;
     weeklyHours?: number | null;
@@ -290,6 +393,7 @@ export type OperationsCollaboratorDetails = OperationsCollaborator & {
   }>;
   relatedContracts: OperationsContract[];
   weeklySchedule: OperationsWeeklyScheduleDay[];
+  equityParticipation?: OperationsCollaboratorEquityParticipation | null;
   timesheetSummary: {
     totalTimesheets: number;
     pendingTimesheets: number;
@@ -314,7 +418,11 @@ export type OperationsProjectDetails = OperationsProject & {
   assignments: Array<{
     id: number;
     collaboratorId: number;
+    userId?: number | null;
+    personAvatarId?: number | null;
+    userPhotoId?: number | null;
     collaboratorName: string;
+    projectRoleId?: number | null;
     roleLabel?: string | null;
     allocationPercent?: number | null;
     weeklyHours?: number | null;
@@ -371,19 +479,19 @@ export type OperationsContractDetails = OperationsContract & {
     dueDay?: number | null;
     notes?: string | null;
   }>;
-  documents: Array<{
-    id: number;
-    documentType: string;
-    fileId?: number | null;
-    fileName: string;
-    mimeType: string;
-    fileContentBase64?: string | null;
-    isCurrent: boolean;
-    extractionStatus?: string | null;
-    extractionSummary?: string | null;
-    notes?: string | null;
-    createdAt: string;
-  }>;
+  documents: Array<{
+    id: number;
+    documentType: string;
+    fileId?: number | null;
+    fileName: string;
+    mimeType: string;
+    fileContentBase64?: string | null;
+    isCurrent: boolean;
+    extractionStatus?: string | null;
+    extractionSummary?: string | null;
+    notes?: string | null;
+    createdAt: string;
+  }>;
   revisions: Array<{
     id: number;
     revisionType: string;

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

@@ -20,7 +20,7 @@ function resolveLocale(currentLocaleCode: string) {
 export function formatDate(
   value?: string | null,
   getSettingValue?: ((key: string) => unknown) | null,
-  currentLocaleCode = 'en-US'
+  currentLocaleCode = 'pt-BR'
 ) {
   if (!value) {
     return '-';
@@ -47,8 +47,8 @@ export function formatDate(
   }
 
   return parsedDate.toLocaleDateString(resolveLocale(currentLocaleCode), {
-    month: 'short',
-    day: 'numeric',
+    day: '2-digit',
+    month: '2-digit',
     year: 'numeric',
   });
 }
@@ -56,7 +56,7 @@ export function formatDate(
 export function formatDateTime(
   value?: string | null,
   getSettingValue?: ((key: string) => unknown) | null,
-  currentLocaleCode = 'en-US'
+  currentLocaleCode = 'pt-BR'
 ) {
   if (!value) {
     return '-';
@@ -81,8 +81,8 @@ export function formatDateTime(
   }
 
   return parsedDate.toLocaleString(resolveLocale(currentLocaleCode), {
-    month: 'short',
-    day: 'numeric',
+    day: '2-digit',
+    month: '2-digit',
     year: 'numeric',
     hour: '2-digit',
     minute: '2-digit',
@@ -135,11 +135,41 @@ export function formatEnumLabel(value?: string | null) {
     .replace(/\b\w/g, (match) => match.toUpperCase());
 }
 
+const weekdayLabels: Record<
+  string,
+  {
+    'pt-BR': string;
+    'en-US': string;
+  }
+> = {
+  monday: { 'pt-BR': 'Segunda-feira', 'en-US': 'Monday' },
+  tuesday: { 'pt-BR': 'Terça-feira', 'en-US': 'Tuesday' },
+  wednesday: { 'pt-BR': 'Quarta-feira', 'en-US': 'Wednesday' },
+  thursday: { 'pt-BR': 'Quinta-feira', 'en-US': 'Thursday' },
+  friday: { 'pt-BR': 'Sexta-feira', 'en-US': 'Friday' },
+  saturday: { 'pt-BR': 'Sábado', 'en-US': 'Saturday' },
+  sunday: { 'pt-BR': 'Domingo', 'en-US': 'Sunday' },
+};
+
+export function formatWeekdayLabel(
+  value?: string | null,
+  currentLocaleCode = 'en-US'
+) {
+  if (!value) {
+    return '-';
+  }
+
+  const locale = resolveLocale(currentLocaleCode) as 'pt-BR' | 'en-US';
+  const normalizedValue = String(value).trim().toLowerCase();
+
+  return weekdayLabels[normalizedValue]?.[locale] ?? formatEnumLabel(value);
+}
+
 export function formatDateRange(
   startDate?: string | null,
   endDate?: string | null,
   getSettingValue?: ((key: string) => unknown) | null,
-  currentLocaleCode = 'en-US'
+  currentLocaleCode = 'pt-BR'
 ) {
   if (!startDate && !endDate) {
     return '-';
@@ -186,7 +216,8 @@ export function summarizeScheduleDays(
     isWorkingDay: boolean;
     startTime?: string | null;
     endTime?: string | null;
-  }>
+  }>,
+  currentLocaleCode = 'en-US'
 ) {
   if (!days.length) {
     return '-';
@@ -195,7 +226,7 @@ export function summarizeScheduleDays(
   return days
     .filter((day) => day.isWorkingDay)
     .map((day) => {
-      const label = formatEnumLabel(day.weekday);
+      const label = formatWeekdayLabel(day.weekday, currentLocaleCode);
       if (day.startTime && day.endTime) {
         return `${label}: ${formatTimeValue(day.startTime)}-${formatTimeValue(day.endTime)}`;
       }

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

@@ -4,10 +4,57 @@ export function parseNumberInput(value: string) {
     return null;
   }
 
-  const parsed = Number(trimmed);
+  const normalized = /[.,]/.test(trimmed)
+    ? trimmed.replace(/\./g, '').replace(',', '.')
+    : trimmed;
+
+  const parsed = Number(normalized);
   return Number.isFinite(parsed) ? parsed : null;
 }
 
+export function normalizePercentInput(value: string) {
+  const trimmed = value.trim();
+
+  if (!trimmed) {
+    return '';
+  }
+
+  const withNormalizedSeparator = trimmed.replace(/,/g, '.');
+  const digitsAndSeparatorsOnly = withNormalizedSeparator.replace(
+    /[^0-9.]/g,
+    ''
+  );
+
+  if (!digitsAndSeparatorsOnly) {
+    return '';
+  }
+
+  const separatorIndex = digitsAndSeparatorsOnly.indexOf('.');
+  const normalized =
+    separatorIndex === -1
+      ? digitsAndSeparatorsOnly
+      : `${digitsAndSeparatorsOnly.slice(0, separatorIndex + 1)}${digitsAndSeparatorsOnly
+          .slice(separatorIndex + 1)
+          .replace(/\./g, '')}`;
+
+  const prefixedValue = normalized.startsWith('.') ? `0${normalized}` : normalized;
+  const parsed = Number(prefixedValue);
+
+  if (!Number.isFinite(parsed)) {
+    return '';
+  }
+
+  if (parsed <= 0) {
+    return prefixedValue === '0.' ? prefixedValue : '0';
+  }
+
+  if (parsed >= 100) {
+    return '100';
+  }
+
+  return prefixedValue;
+}
+
 export function trimToNull(value?: string | null) {
   const trimmed = value?.trim() ?? '';
   return trimmed ? trimmed : null;