@hed-hog/operations 0.0.295 → 0.0.296

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

@@ -0,0 +1,32 @@
+type RequestFn = (input: {
+  url: string;
+  method: string;
+  data?: unknown;
+}) => Promise<{ data: any }>;
+
+export async function fetchOperations<T>(
+  request: RequestFn,
+  url: string
+) {
+  const response = await request({
+    url,
+    method: 'GET',
+  });
+
+  return response.data as T;
+}
+
+export async function mutateOperations<T>(
+  request: RequestFn,
+  url: string,
+  method: 'POST' | 'PATCH',
+  data?: unknown
+) {
+  const response = await request({
+    url,
+    method,
+    data,
+  });
+
+  return response.data as T;
+}

package/hedhog/frontend/app/_lib/hooks/use-operations-access.ts.ejs

@@ -0,0 +1,44 @@
+'use client';
+
+import { useApp, useQuery } from '@hed-hog/next-app-provider';
+
+type Role = {
+  slug?: string;
+};
+
+export function useOperationsAccess() {
+  const { request, accessToken } = useApp();
+
+  const { data, isLoading } = useQuery<{ roles: Role[] }>({
+    queryKey: ['operations-roles', accessToken],
+    enabled: !!accessToken,
+    queryFn: async () => {
+      const response = await request<{ roles: Role[] }>({
+        url: '/auth/roles',
+      });
+
+      return response.data;
+    },
+  });
+
+  const roleSlugs = (data?.roles ?? [])
+    .map((role) => role.slug || '')
+    .filter(Boolean);
+
+  return {
+    isLoading,
+    roleSlugs,
+    isDirector:
+      roleSlugs.includes('admin') ||
+      roleSlugs.includes('admin-operations-director'),
+    isSupervisor:
+      roleSlugs.includes('admin') ||
+      roleSlugs.includes('admin-operations-director') ||
+      roleSlugs.includes('admin-operations-supervisor'),
+    isCollaborator:
+      roleSlugs.includes('admin') ||
+      roleSlugs.includes('admin-operations-director') ||
+      roleSlugs.includes('admin-operations-supervisor') ||
+      roleSlugs.includes('admin-operations-collaborator'),
+  };
+}

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

@@ -0,0 +1,360 @@
+export type OperationsDashboard = {
+  actor: {
+    roleScope: 'self' | 'team' | 'full';
+    collaboratorId: number | null;
+    collaboratorName: string | null;
+    teamSize: number;
+  };
+  cards: {
+    projectsTotal: number;
+    activeProjects: number;
+    visibleTimesheets: number;
+    pendingTimesheets: number;
+    timeOffRequests: number;
+    scheduleAdjustmentRequests: number;
+    pendingApprovals: number;
+  };
+  recentTimesheets: Array<{
+    id: number;
+    collaboratorName: string;
+    weekStartDate: string;
+    weekEndDate: string;
+    totalHours: number | null;
+    status: string;
+  }>;
+};
+
+export type OperationsCollaborator = {
+  id: number;
+  userId?: number;
+  code: string;
+  collaboratorType?: string;
+  displayName: string;
+  department?: string | null;
+  title?: string | null;
+  levelLabel?: string | null;
+  weeklyCapacityHours?: number | null;
+  status: string;
+  joinedAt?: string | null;
+  leftAt?: string | null;
+  notes?: string | null;
+  supervisorId?: number | null;
+  supervisorName?: string | null;
+  contractId?: number | null;
+  contractStatus?: string | null;
+  activeAssignments?: number;
+  pendingApprovals?: number;
+  pendingTimeOffRequests?: number;
+  pendingScheduleAdjustmentRequests?: number;
+};
+
+export type OperationsProject = {
+  id: number;
+  contractId?: number | null;
+  managerCollaboratorId?: number | null;
+  code: string;
+  name: string;
+  clientName?: string | null;
+  summary?: string | null;
+  status: string;
+  progressPercent?: number | null;
+  deliveryModel?: string | null;
+  budgetAmount?: number | null;
+  startDate?: string | null;
+  endDate?: string | null;
+  contractName?: string | null;
+  contractStatus?: string | null;
+  contractCategory?: string | null;
+  managerName?: string | null;
+  myAssignmentId?: number | null;
+  myRoleLabel?: string | null;
+  teamSize?: number;
+};
+
+export type OperationsContract = {
+  id: number;
+  code: string;
+  name: string;
+  contractCategory?: string;
+  contractType?: string;
+  clientName: string;
+  signatureStatus?: string;
+  isActive?: boolean;
+  billingModel: string;
+  accountManagerCollaboratorId?: number | null;
+  accountManagerName?: string | null;
+  relatedCollaboratorId?: number | null;
+  relatedCollaboratorName?: string | null;
+  mainRelatedPartyName?: string | null;
+  originType?: string | null;
+  originId?: number | null;
+  startDate: string;
+  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;
+  description?: string | null;
+  contentHtml?: string | null;
+  projectCount?: number;
+  currentPdfFileName?: string | null;
+  scheduleSummary?: OperationsWeeklyScheduleDay[];
+};
+
+export type OperationsWeeklyScheduleDay = {
+  weekday: string;
+  isWorkingDay: boolean;
+  startTime?: string | null;
+  endTime?: string | null;
+  breakMinutes?: number | null;
+};
+
+export type OperationsTimesheetEntry = {
+  id: number;
+  projectAssignmentId?: number | null;
+  projectId?: number | null;
+  projectName?: string | null;
+  roleLabel?: string | null;
+  activityLabel?: string | null;
+  workDate: string;
+  hours: number;
+  description?: string | null;
+};
+
+export type OperationsTimesheet = {
+  id: number;
+  collaboratorId: number;
+  collaboratorName: string;
+  approverCollaboratorId?: number | null;
+  approverName?: string | null;
+  weekStartDate: string;
+  weekEndDate: string;
+  totalHours?: number | null;
+  status: string;
+  submittedAt?: string | null;
+  reviewedAt?: string | null;
+  notes?: string | null;
+  decisionNote?: string | null;
+  entries?: OperationsTimesheetEntry[];
+};
+
+export type OperationsTimeOffRequest = {
+  id: number;
+  collaboratorId: number;
+  collaboratorName?: string;
+  approverCollaboratorId?: number | null;
+  approverName?: string | null;
+  requestType: string;
+  startDate: string;
+  endDate: string;
+  totalDays?: number | null;
+  status: string;
+  reason?: string | null;
+  submittedAt?: string | null;
+  reviewedAt?: string | null;
+  approverNote?: string | null;
+};
+
+export type OperationsScheduleAdjustmentDay = {
+  requestId: number;
+  weekday: string;
+  isWorkingDay: boolean;
+  startTime?: string | null;
+  endTime?: string | null;
+  breakMinutes?: number | null;
+};
+
+export type OperationsScheduleAdjustmentRequest = {
+  id: number;
+  collaboratorId: number;
+  collaboratorName?: string;
+  approverCollaboratorId?: number | null;
+  approverName?: string | null;
+  requestScope: string;
+  effectiveStartDate: string;
+  effectiveEndDate?: string | null;
+  status: string;
+  reason?: string | null;
+  submittedAt?: string | null;
+  reviewedAt?: string | null;
+  approverNote?: string | null;
+  currentSchedule?: OperationsWeeklyScheduleDay[];
+  days?: OperationsScheduleAdjustmentDay[];
+};
+
+export type OperationsApproval = {
+  id: number;
+  targetType: string;
+  targetId: number;
+  requesterCollaboratorId: number;
+  requesterName: string;
+  approverCollaboratorId?: number | null;
+  approverName?: string | null;
+  status: string;
+  submittedAt?: string | null;
+  decidedAt?: string | null;
+  decisionNote?: string | null;
+  timesheetWeekStartDate?: string | null;
+  timesheetWeekEndDate?: string | null;
+  timesheetTotalHours?: number | null;
+  timesheetProjectNames?: string | null;
+  timeOffType?: string | null;
+  timeOffStartDate?: string | null;
+  timeOffEndDate?: string | null;
+  timeOffReason?: string | null;
+  scheduleRequestScope?: string | null;
+  scheduleStartDate?: string | null;
+  scheduleEndDate?: string | null;
+  scheduleReason?: string | null;
+};
+
+export type OperationsTeamOverview = {
+  teamMembers: OperationsCollaborator[];
+  projectCount: number;
+  pendingApprovals: number;
+  pendingItems: {
+    timesheets: number;
+    timeOffRequests: number;
+    scheduleAdjustmentRequests: number;
+  };
+  teamProjects: Array<{
+    id: number;
+    code: string;
+    name: string;
+    clientName?: string | null;
+    status: string;
+    teamSize: number;
+    pendingTimesheets: number;
+  }>;
+  pendingApprovalQueue: OperationsApproval[];
+  pendingTimeOffRequests: OperationsTimeOffRequest[];
+  pendingScheduleAdjustmentRequests: OperationsScheduleAdjustmentRequest[];
+};
+
+export type OperationsCollaboratorDetails = OperationsCollaborator & {
+  assignedProjects: Array<{
+    id: number;
+    code: string;
+    name: string;
+    status: string;
+    roleLabel?: string | null;
+    allocationPercent?: number | null;
+    weeklyHours?: number | null;
+    startDate?: string | null;
+    endDate?: string | null;
+  }>;
+  relatedContracts: OperationsContract[];
+  weeklySchedule: OperationsWeeklyScheduleDay[];
+  timesheetSummary: {
+    totalTimesheets: number;
+    pendingTimesheets: number;
+    totalHours: number;
+  };
+  timeOffSummary: {
+    totalRequests: number;
+    pendingRequests: number;
+    approvedRequests: number;
+  };
+  scheduleAdjustmentRequests: Array<{
+    id: number;
+    requestScope: string;
+    effectiveStartDate: string;
+    effectiveEndDate?: string | null;
+    status: string;
+    reason?: string | null;
+  }>;
+};
+
+export type OperationsProjectDetails = OperationsProject & {
+  assignments: Array<{
+    id: number;
+    collaboratorId: number;
+    collaboratorName: string;
+    roleLabel?: string | null;
+    allocationPercent?: number | null;
+    weeklyHours?: number | null;
+    isBillable?: boolean;
+    startDate?: string | null;
+    endDate?: string | null;
+    status: string;
+  }>;
+  relatedContract?: OperationsContract | null;
+  timesheetSummary: {
+    totalTimesheets: number;
+    pendingTimesheets: number;
+    totalHours: number;
+  };
+  operationalIndicators: {
+    activeAssignments: number;
+    billableAssignments: number;
+    averageAllocation: number;
+    totalWeeklyHours: number;
+  };
+};
+
+export type OperationsContractDetails = OperationsContract & {
+  projects: Array<{
+    id: number;
+    code: string;
+    name: string;
+    status: string;
+  }>;
+  parties: Array<{
+    id: number;
+    partyRole: string;
+    partyType: string;
+    displayName: string;
+    documentNumber?: string | null;
+    email?: string | null;
+    phone?: string | null;
+    isPrimary?: boolean;
+  }>;
+  signatures: Array<{
+    id: number;
+    signerName: string;
+    signerRole?: string | null;
+    signerEmail?: string | null;
+    status: string;
+    signedAt?: string | null;
+  }>;
+  financialTerms: Array<{
+    id: number;
+    termType: string;
+    label: string;
+    amount: number;
+    recurrence: string;
+    dueDay?: number | null;
+    notes?: string | null;
+  }>;
+  documents: Array<{
+    id: number;
+    documentType: string;
+    fileName: string;
+    mimeType: string;
+    fileContentBase64?: string | null;
+    isCurrent: boolean;
+    notes?: string | null;
+    createdAt: string;
+  }>;
+  revisions: Array<{
+    id: number;
+    revisionType: string;
+    title: string;
+    effectiveDate?: string | null;
+    status: string;
+    summary?: string | null;
+  }>;
+  history: Array<{
+    id: number;
+    actorUserId?: number | null;
+    action: string;
+    note?: string | null;
+    metadataJson?: string | null;
+    createdAt: string;
+  }>;
+};

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

@@ -1,25 +1,129 @@
-export const operationsCurrency = new Intl.NumberFormat('en-US', {
-  style: 'currency',
-  currency: 'USD',
-  maximumFractionDigits: 0,
-});
-
-export function formatCurrency(value: number) {
-  return operationsCurrency.format(value);
-}
-
-export function formatDate(value: string) {
-  return new Date(`${value}T00:00:00`).toLocaleDateString('en-US', {
-    month: 'short',
-    day: 'numeric',
-    year: 'numeric',
-  });
-}
-
-export function formatPercent(value: number) {
-  return `${value}%`;
-}
-
-export function formatHours(value: number) {
-  return `${value.toFixed(1)}h`;
-}
+export const operationsCurrency = new Intl.NumberFormat('en-US', {
+  style: 'currency',
+  currency: 'USD',
+  maximumFractionDigits: 0,
+});
+
+export function formatCurrency(value: number) {
+  return operationsCurrency.format(value);
+}
+
+export function formatDate(value?: string | null) {
+  if (!value) {
+    return '-';
+  }
+
+  return new Date(`${value}T00:00:00`).toLocaleDateString('en-US', {
+    month: 'short',
+    day: 'numeric',
+    year: 'numeric',
+  });
+}
+
+export function formatDateTime(value?: string | null) {
+  if (!value) {
+    return '-';
+  }
+
+  return new Date(value).toLocaleString('en-US', {
+    month: 'short',
+    day: 'numeric',
+    year: 'numeric',
+    hour: '2-digit',
+    minute: '2-digit',
+  });
+}
+
+export function formatPercent(value?: number | null) {
+  if (value === null || value === undefined || Number.isNaN(value)) {
+    return '-';
+  }
+
+  return `${value}%`;
+}
+
+export function formatHours(value?: number | null) {
+  if (value === null || value === undefined || Number.isNaN(value)) {
+    return '-';
+  }
+
+  return `${Number(value).toFixed(1)}h`;
+}
+
+export function formatEnumLabel(value?: string | null) {
+  if (!value) {
+    return '-';
+  }
+
+  return value
+    .replace(/[_-]+/g, ' ')
+    .replace(/\b\w/g, (match) => match.toUpperCase());
+}
+
+export function formatDateRange(
+  startDate?: string | null,
+  endDate?: string | null
+) {
+  if (!startDate && !endDate) {
+    return '-';
+  }
+
+  if (!endDate || startDate === endDate) {
+    return formatDate(startDate);
+  }
+
+  return `${formatDate(startDate)} to ${formatDate(endDate)}`;
+}
+
+export function getStatusBadgeClass(value?: string | null) {
+  switch (value) {
+    case 'active':
+    case 'approved':
+    case 'completed':
+      return 'bg-emerald-100 text-emerald-800';
+    case 'submitted':
+    case 'pending':
+    case 'renewal':
+    case 'planning':
+      return 'bg-amber-100 text-amber-900';
+    case 'rejected':
+    case 'cancelled':
+    case 'archived':
+    case 'closed':
+      return 'bg-rose-100 text-rose-800';
+    case 'draft':
+    case 'paused':
+    case 'inactive':
+    case 'on_leave':
+      return 'bg-slate-100 text-slate-800';
+    case 'at_risk':
+      return 'bg-orange-100 text-orange-900';
+    default:
+      return 'bg-sky-100 text-sky-800';
+  }
+}
+
+export function summarizeScheduleDays(
+  days: Array<{
+    weekday: string;
+    isWorkingDay: boolean;
+    startTime?: string | null;
+    endTime?: string | null;
+  }>
+) {
+  if (!days.length) {
+    return '-';
+  }
+
+  return days
+    .filter((day) => day.isWorkingDay)
+    .map((day) => {
+      const label = formatEnumLabel(day.weekday);
+      if (day.startTime && day.endTime) {
+        return `${label}: ${day.startTime}-${day.endTime}`;
+      }
+
+      return label;
+    })
+    .join(', ');
+}

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

@@ -0,0 +1,14 @@
+export function parseNumberInput(value: string) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return null;
+  }
+
+  const parsed = Number(trimmed);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+
+export function trimToNull(value?: string | null) {
+  const trimmed = value?.trim() ?? '';
+  return trimmed ? trimmed : null;
+}