@hed-hog/operations 0.0.322 → 0.0.325

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

@@ -0,0 +1,860 @@
+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;
+  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;
+  }>;
+}