@hed-hog/operations 0.0.322 → 0.0.325

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

@@ -0,0 +1,836 @@
+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;
+    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;
+    }>;
+};
+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;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map