@hed-hog/operations 0.0.327 → 0.0.329

package/hedhog/frontend/src/app/(app)/(libraries)/operations/_lib/types.ts

@@ -1,861 +0,0 @@
-export type PaginatedResponse<T> = {
-  total: number;
-  lastPage: number;
-  page: number;
-  pageSize: number;
-  prev?: number | null;
-  next?: number | null;
-  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';
-    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 OperationsReportScenario = 'base' | 'growth' | 'conservative';
-
-export type OperationsReportPlanningCard = {
-  title: string;
-  value: string;
-  description: string;
-};
-
-export type OperationsProjectsReport = {
-  filters: {
-    from: string;
-    to: string;
-    status: string;
-    client: string;
-    scenario: OperationsReportScenario;
-    clients: string[];
-  };
-  summary: {
-    contractedRevenue: number;
-    recognizedRevenue: number;
-    realizedCost: number;
-    forecastCost: number;
-    profit: number;
-    margin: number;
-    plannedHours: number;
-    actualHours: number;
-    billableHours: number;
-    reworkHours: number;
-    backlogValue: number;
-    avgDeadline: number;
-    avgAllocation: number;
-    atRisk: number;
-    burnRate: number;
-  };
-  forecast: Array<{
-    month: string;
-    revenue: number;
-    cost: number;
-    profit: number;
-    backlog: number;
-    planned: number;
-    actual: number;
-  }>;
-  costComposition: Array<{ name: string; value: number }>;
-  hoursByProject: Array<{
-    project: string;
-    Faturável: number;
-    Interno: number;
-    Retrabalho: number;
-    Livre: number;
-  }>;
-  health: Array<{
-    project: string;
-    margem: number;
-    prazo: number;
-    alocacao: number;
-    saude: number;
-  }>;
-  ranking: Array<{ name: string; Lucro: number; Custo: number }>;
-  progress: Array<{ month: string; Planejado: number; Realizado: number }>;
-  planningCards: OperationsReportPlanningCard[];
-  rows: Array<{
-    id: number;
-    name: string;
-    client: string;
-    manager: string;
-    squad: string;
-    status: 'on_track' | 'attention' | 'late' | 'paused';
-    contractType: 'fixed_price' | 'time_materials' | 'retainer';
-    priority: string;
-    startDate: string | null;
-    endDate: string | null;
-    contractedRevenue: number;
-    recognizedRevenue: number;
-    realizedCost: number;
-    forecastCost: number;
-    teamCost: number;
-    infraCost: number;
-    licenseCost: number;
-    thirdPartyCost: number;
-    reworkCost: number;
-    plannedHours: number;
-    actualHours: number;
-    billableHours: number;
-    reworkHours: number;
-    internalHours: number;
-    allocatedCapacity: number;
-    physicalProgress: number;
-    financialProgress: number;
-    backlogValue: number;
-    futureDeliveries: number;
-    risk: 'baixo' | 'médio' | 'alto';
-    recommendation: string;
-  }>;
-};
-
-export type OperationsCollaboratorsReport = {
-  filters: {
-    from: string;
-    to: string;
-    department: string;
-    contractType: string;
-    scenario: OperationsReportScenario;
-    departments: string[];
-    contractTypes: string[];
-  };
-  summary: {
-    cost: number;
-    salary: number;
-    benefits: number;
-    taxes: number;
-    tools: number;
-    billableValue: number;
-    profit: number;
-    margin: number;
-    availableHours: number;
-    allocatedHours: number;
-    billableHours: number;
-    internalHours: number;
-    overtimeHours: number;
-    freeHours: number;
-    allocation: number;
-    utilization: number;
-    overloadCount: number;
-    hourlyCost: number;
-  };
-  forecast: Array<{
-    month: string;
-    revenue: number;
-    cost: number;
-    profit: number;
-    margin: number;
-    capacity: number;
-  }>;
-  costComposition: Array<{ name: string; value: number }>;
-  capacityByDepartment: Array<{
-    department: string;
-    Faturável: number;
-    Interno: number;
-    Livre: number;
-    Sobrecarga: number;
-  }>;
-  health: Array<{
-    department: string;
-    margem: number;
-    alocacao: number;
-    utilizacao: number;
-    saude: number;
-  }>;
-  ranking: Array<{ name: string; Custo: number; Lucro: number }>;
-  planningCards: OperationsReportPlanningCard[];
-  rows: Array<{
-    id: number;
-    name: string;
-    role: string;
-    seniority: string;
-    department: string;
-    contractType: string;
-    startDate: string | null;
-    endDate: string | null;
-    salaryCost: number;
-    benefitsCost: number;
-    taxesCost: number;
-    toolsCost: number;
-    billableValue: number;
-    availableHours: number;
-    allocatedHours: number;
-    billableHours: number;
-    internalHours: number;
-    overtimeHours: number;
-    projects: number;
-    risk: 'baixo' | 'médio' | 'alto';
-    recommendation: string;
-  }>;
-};
-
-export type OperationsCollaborator = {
-  id: number;
-  userId?: number | null;
-  personId?: number | null;
-  personName?: string | null;
-  personAvatarId?: number | null;
-  code: 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;
-  hourlyRate?: 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 OperationsCollaboratorStats = {
-  total: number;
-  active: number;
-  onLeave: number;
-  withContracts: number;
-  totalSalary: number;
-  totalCosts: number;
-  avgSalaryPlusCosts: number;
-  avgSalaryPlusCostsPerCollaborator: number;
-};
-
-export type OperationsContractStats = {
-  total: number;
-  active: number;
-  inactive: number;
-  withFile: number;
-};
-
-export type OperationsDepartment = {
-  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 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;
-  priority?: string | null;
-  projectId: number;
-  projectAssignmentId: number | null;
-  projectName: string;
-  projectCode?: string | null;
-  dueDate?: string | null;
-  estimateHours?: number | null;
-  tags?: string | null;
-  assigneeName?: string | null;
-  assigneeUserPhotoId?: number | null;
-  assigneePersonAvatarId?: number | null;
-  createdAt?: string | null;
-  deletedAt?: string | null;
-  commentCount?: number | 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;
-  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;
-  managerAvatarId?: number | null;
-  myAssignmentId?: number | null;
-  myRoleLabel?: string | null;
-  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;
-  accountManagerCollaboratorId?: number | null;
-  accountManagerName?: string | null;
-  relatedCollaboratorId?: number | null;
-  relatedCollaboratorName?: 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;
-  currentPdfFileName?: string | null;
-  scheduleSummary?: OperationsWeeklyScheduleDay[];
-};
-
-export type OperationsWeeklyScheduleDay = {
-  weekday: string;
-  isWorkingDay: boolean;
-  startTime?: string | null;
-  endTime?: string | null;
-  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;
-};
-
-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;
-  // enriched detail (returned by GET /operations/approvals/:id)
-  entries?: OperationsTimesheetEntry[];
-  days?: OperationsScheduleAdjustmentDay[];
-  currentSchedule?: OperationsWeeklyScheduleDay[];
-};
-
-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;
-    projectRoleId?: number | null;
-    roleLabel?: string | null;
-    allocationPercent?: number | null;
-    weeklyHours?: number | null;
-    startDate?: string | null;
-    endDate?: string | null;
-  }>;
-  relatedContracts: OperationsContract[];
-  weeklySchedule: OperationsWeeklyScheduleDay[];
-  equityParticipation?: OperationsCollaboratorEquityParticipation | null;
-  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 OperationsMyProjectSummary = {
-  id: number;
-  code: string;
-  name: string;
-  status: string;
-  summary: string | null;
-  startDate: string | null;
-  endDate: string | null;
-  myAssignmentId: number | null;
-  myRoleLabel: string | null;
-  assignments: Array<{
-    id: number;
-    collaboratorId: number;
-    collaboratorName: string;
-    roleLabel: string | null;
-    status: string;
-    avatarId: number | null;
-    userPhotoId: number | null;
-  }>;
-  tasks: Array<{
-    id: number;
-    name: string;
-    description: string | null;
-    priority: string;
-    status: string;
-    dueDate: string | null;
-    estimateHours: number | null;
-    position: number;
-    tags: string | null;
-    assigneeCollaboratorId: number | null;
-    assigneeName: string | null;
-    assigneeUserPhotoId: number | null;
-    assigneePersonAvatarId: number | null;
-    projectAssignmentId: number | null;
-    createdAt: string;
-  }>;
-};
-
-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;
-    startDate?: string | null;
-    endDate?: string | null;
-    status: string;
-  }>;
-  relatedContract?: OperationsContract | null;
-  timesheetSummary: {
-    totalTimesheets: number;
-    pendingTimesheets: number;
-    totalHours: number;
-  };
-  operationalIndicators: {
-    activeAssignments: number;
-    completedAssignments: 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;
-    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;
-    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;
-  }>;
-};
-
-// ─── Project Cost ─────────────────────────────────────────────────────────────
-
-export interface ProjectCostCategory {
-  id: number;
-  slug: string;
-  name: string;
-  description?: string;
-  icon?: string;
-  color?: string;
-  is_active: boolean;
-  sort_order: number;
-}
-
-export interface ProjectCostType {
-  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;
-  }>;
-}