@hed-hog/finance 0.0.278 → 0.0.285

package/hedhog/frontend/app/reports/_lib/report-aggregations.ts.ejs

@@ -0,0 +1,275 @@
+import {
+  customerRevenueMock,
+  financialResultsMock,
+  operationalExpensesMock,
+  type GroupBy,
+} from './report-mocks';
+
+const dateFormatter = new Intl.DateTimeFormat('pt-BR');
+
+function toDate(value: string) {
+  return new Date(`${value}T00:00:00`);
+}
+
+function isWithinRange(date: string, from: string, to: string) {
+  return date >= from && date <= to;
+}
+
+function startOfWeek(date: Date) {
+  const current = new Date(date);
+  const day = current.getDay();
+  const diff = day === 0 ? -6 : 1 - day;
+  current.setDate(current.getDate() + diff);
+  current.setHours(0, 0, 0, 0);
+
+  return current;
+}
+
+function getIsoWeek(date: Date) {
+  const current = new Date(
+    Date.UTC(date.getFullYear(), date.getMonth(), date.getDate())
+  );
+  const dayNum = current.getUTCDay() || 7;
+  current.setUTCDate(current.getUTCDate() + 4 - dayNum);
+  const yearStart = new Date(Date.UTC(current.getUTCFullYear(), 0, 1));
+
+  return Math.ceil(
+    ((current.getTime() - yearStart.getTime()) / 86400000 + 1) / 7
+  );
+}
+
+function getBucketKey(date: string, groupBy: GroupBy) {
+  const d = toDate(date);
+
+  if (groupBy === 'day') {
+    return date;
+  }
+
+  if (groupBy === 'week') {
+    const weekStart = startOfWeek(d);
+    const isoWeek = getIsoWeek(weekStart);
+    return `${weekStart.getFullYear()}-W${String(isoWeek).padStart(2, '0')}`;
+  }
+
+  if (groupBy === 'month') {
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}`;
+  }
+
+  return String(d.getFullYear());
+}
+
+export function formatBucketLabel(bucket: string, groupBy: GroupBy) {
+  if (groupBy === 'day') {
+    return dateFormatter.format(toDate(bucket));
+  }
+
+  if (groupBy === 'week') {
+    const [year, week] = bucket.split('-W');
+    return `Sem ${Number(week)}/${year}`;
+  }
+
+  if (groupBy === 'month') {
+    const [year, month] = bucket.split('-');
+    return `${month}/${year}`;
+  }
+
+  return bucket;
+}
+
+function sortBuckets(a: string, b: string, groupBy: GroupBy) {
+  if (groupBy === 'year' || groupBy === 'month' || groupBy === 'day') {
+    return a.localeCompare(b);
+  }
+
+  const [aYear, aWeek] = a.split('-W');
+  const [bYear, bWeek] = b.split('-W');
+  const yearDiff = Number(aYear) - Number(bYear);
+
+  if (yearDiff !== 0) {
+    return yearDiff;
+  }
+
+  return Number(aWeek) - Number(bWeek);
+}
+
+export function aggregateOverview(params: {
+  from: string;
+  to: string;
+  groupBy: GroupBy;
+}) {
+  const { from, to, groupBy } = params;
+  const grouped = new Map<
+    string,
+    {
+      period: string;
+      label: string;
+      faturamento: number;
+      despesasEmprestimos: number;
+      diferenca: number;
+      aporteInvestidor: number;
+      emprestimoBanco: number;
+      despesas: number;
+    }
+  >();
+
+  for (const item of financialResultsMock) {
+    if (!isWithinRange(item.date, from, to)) {
+      continue;
+    }
+
+    const bucket = getBucketKey(item.date, groupBy);
+    const current = grouped.get(bucket) || {
+      period: bucket,
+      label: formatBucketLabel(bucket, groupBy),
+      faturamento: 0,
+      despesasEmprestimos: 0,
+      diferenca: 0,
+      aporteInvestidor: 0,
+      emprestimoBanco: 0,
+      despesas: 0,
+    };
+
+    current.faturamento += item.faturamento;
+    current.aporteInvestidor += item.aporteInvestidor;
+    current.emprestimoBanco += item.emprestimoBanco;
+    current.despesas += item.despesas;
+    current.despesasEmprestimos += item.despesas + item.emprestimoBanco;
+    current.diferenca = current.faturamento - current.despesasEmprestimos;
+
+    grouped.set(bucket, current);
+  }
+
+  return Array.from(grouped.values()).sort((a, b) =>
+    sortBuckets(a.period, b.period, groupBy)
+  );
+}
+
+export function aggregateTopCustomers(params: {
+  from: string;
+  to: string;
+  groupBy: GroupBy;
+  topN?: number;
+}) {
+  const { from, to, groupBy, topN = 20 } = params;
+
+  const byCustomer = new Map<string, number>();
+  const byBucket = new Map<string, number>();
+
+  for (const item of customerRevenueMock) {
+    if (!isWithinRange(item.date, from, to)) {
+      continue;
+    }
+
+    const current = byCustomer.get(item.customer) || 0;
+    byCustomer.set(item.customer, current + item.value);
+
+    const bucket = getBucketKey(item.date, groupBy);
+    const currentBucket = byBucket.get(bucket) || 0;
+    byBucket.set(bucket, currentBucket + item.value);
+  }
+
+  const sorted = Array.from(byCustomer.entries())
+    .map(([customer, value]) => ({ customer, value }))
+    .sort((a, b) => b.value - a.value);
+
+  const topCustomers = sorted.slice(0, topN);
+  const total = sorted.reduce((acc, row) => acc + row.value, 0);
+  const top5 = topCustomers
+    .slice(0, 5)
+    .reduce((acc, row) => acc + row.value, 0);
+
+  const pieData = topCustomers.slice(0, 9);
+  const othersValue = sorted.slice(9).reduce((acc, row) => acc + row.value, 0);
+
+  if (othersValue > 0) {
+    pieData.push({ customer: 'Outros', value: othersValue });
+  }
+
+  const groupedPeriods = Array.from(byBucket.entries())
+    .map(([period, value]) => ({
+      period,
+      label: formatBucketLabel(period, groupBy),
+      value,
+    }))
+    .sort((a, b) => sortBuckets(a.period, b.period, groupBy));
+
+  return {
+    total,
+    top5,
+    top5Percent: total > 0 ? (top5 / total) * 100 : 0,
+    topCustomers,
+    pieData,
+    groupedPeriods,
+  };
+}
+
+export function aggregateOperationalExpenses(params: {
+  from: string;
+  to: string;
+  groupBy: GroupBy;
+  topN?: number;
+}) {
+  const { from, to, groupBy, topN = 20 } = params;
+
+  const byCategory = new Map<
+    string,
+    { category: string; costCenter: string; value: number }
+  >();
+  const byCostCenter = new Map<string, number>();
+  const byBucket = new Map<string, number>();
+
+  for (const item of operationalExpensesMock) {
+    if (!isWithinRange(item.date, from, to)) {
+      continue;
+    }
+
+    const currentCategory = byCategory.get(item.category) || {
+      category: item.category,
+      costCenter: item.costCenter,
+      value: 0,
+    };
+
+    currentCategory.value += item.value;
+    byCategory.set(item.category, currentCategory);
+
+    const currentCenter = byCostCenter.get(item.costCenter) || 0;
+    byCostCenter.set(item.costCenter, currentCenter + item.value);
+
+    const bucket = getBucketKey(item.date, groupBy);
+    const currentBucket = byBucket.get(bucket) || 0;
+    byBucket.set(bucket, currentBucket + item.value);
+  }
+
+  const sorted = Array.from(byCategory.values()).sort(
+    (a, b) => b.value - a.value
+  );
+  const topExpenses = sorted.slice(0, topN);
+  const total = sorted.reduce((acc, item) => acc + item.value, 0);
+
+  const pieData = Array.from(byCostCenter.entries()).map(([name, value]) => ({
+    name,
+    value,
+  }));
+
+  const groupedPeriods = Array.from(byBucket.entries())
+    .map(([period, value]) => ({
+      period,
+      label: formatBucketLabel(period, groupBy),
+      value,
+    }))
+    .sort((a, b) => sortBuckets(a.period, b.period, groupBy));
+
+  return {
+    total,
+    topExpenses,
+    pieData,
+    groupedPeriods,
+  };
+}
+
+export function getDefaultDateRange() {
+  return {
+    from: '2021-01-01',
+    to: '2026-12-31',
+  };
+}

package/hedhog/frontend/app/reports/_lib/report-mocks.ts.ejs

@@ -0,0 +1,186 @@
+export type GroupBy = 'day' | 'week' | 'month' | 'year';
+
+export interface FinancialResultEntry {
+  date: string;
+  faturamento: number;
+  emprestimoBanco: number;
+  aporteInvestidor: number;
+  despesas: number;
+}
+
+export interface CustomerRevenueEntry {
+  date: string;
+  customer: string;
+  value: number;
+}
+
+export interface OperationalExpenseEntry {
+  date: string;
+  category: string;
+  costCenter: string;
+  value: number;
+}
+
+const customerNames = [
+  'VALE',
+  'CALIAN',
+  'ALURA',
+  'FIAP',
+  'UDEMY',
+  'HIREWORK',
+  'PAULO DE TARSO',
+  'BRCLICK',
+  'DISTRITO',
+  'COINBIT CLUB',
+  'IT GLOBAL',
+  'INFINITY LEGACY',
+  'XFX',
+  'CLASS',
+  'IMPACTA',
+  'AFX',
+  'SOLARIUM',
+  'ADVANCED RESOURCES',
+  'BMX SCHOOL',
+  'CODE NATION',
+  'NEXT LEVEL',
+  'MEGA TECH',
+  'EDU PRO',
+  'CONECTA BR',
+  'SABER MAIS',
+];
+
+const topCustomerMultipliers: Record<string, number> = {
+  VALE: 4.5,
+  CALIAN: 2.4,
+  ALURA: 1.65,
+  FIAP: 1.45,
+};
+
+const expenseCategories = [
+  { category: 'Folha de Pagamento', costCenter: 'Pessoas', weight: 4.6 },
+  { category: 'Marketing', costCenter: 'Comercial', weight: 3.4 },
+  { category: 'Tecnologia SaaS', costCenter: 'TI', weight: 3.1 },
+  { category: 'Infraestrutura Cloud', costCenter: 'TI', weight: 2.8 },
+  {
+    category: 'Jurídico e Compliance',
+    costCenter: 'Administrativo',
+    weight: 2.1,
+  },
+  {
+    category: 'Facilities e Escritório',
+    costCenter: 'Administrativo',
+    weight: 1.9,
+  },
+  { category: 'Treinamentos', costCenter: 'Pessoas', weight: 1.7 },
+  { category: 'Viagens e Eventos', costCenter: 'Comercial', weight: 1.5 },
+  { category: 'Suporte ao Cliente', costCenter: 'Operações', weight: 2.0 },
+  {
+    category: 'Ferramentas Financeiras',
+    costCenter: 'Financeiro',
+    weight: 1.3,
+  },
+  { category: 'Consultorias', costCenter: 'Operações', weight: 1.2 },
+  { category: 'Seguros', costCenter: 'Financeiro', weight: 0.9 },
+];
+
+function clamp(value: number, min: number, max: number) {
+  return Math.max(min, Math.min(max, value));
+}
+
+function monthSeed(year: number, monthIndex: number) {
+  return year * 17 + monthIndex * 31;
+}
+
+function buildMonthlyDates() {
+  const dates: string[] = [];
+
+  for (let year = 2021; year <= 2026; year += 1) {
+    for (let month = 1; month <= 12; month += 1) {
+      dates.push(`${year}-${String(month).padStart(2, '0')}-01`);
+    }
+  }
+
+  return dates;
+}
+
+const monthlyDates = buildMonthlyDates();
+
+export const financialResultsMock: FinancialResultEntry[] = monthlyDates.map(
+  (date, index) => {
+    const d = new Date(`${date}T00:00:00`);
+    const year = d.getFullYear();
+    const month = d.getMonth();
+    const growthFactor = 1 + (year - 2021) * 0.08;
+    const seasonality = Math.sin((month / 12) * Math.PI * 2) * 0.18;
+    const trend = 1 + index * 0.006;
+    const seed = monthSeed(year, month);
+
+    const faturamento = Math.round(
+      (260000 + seasonality * 70000 + (seed % 13) * 3500) * trend * growthFactor
+    );
+
+    const despesas = Math.round(
+      (190000 +
+        Math.cos((month / 12) * Math.PI * 2) * 45000 +
+        (seed % 7) * 4200) *
+        (0.93 + (year - 2021) * 0.035)
+    );
+
+    const emprestimoBanco =
+      month % 6 === 1 ? Math.round(22000 + (seed % 9) * 1800) : 0;
+
+    const aporteInvestidor =
+      year === 2023 && (month === 2 || month === 8)
+        ? 175000
+        : year === 2024 && month === 1
+          ? 50000
+          : year === 2025 && month === 4
+            ? 52000
+            : 0;
+
+    return {
+      date,
+      faturamento: clamp(faturamento, 120000, 530000),
+      emprestimoBanco,
+      aporteInvestidor,
+      despesas: clamp(despesas, 130000, 430000),
+    };
+  }
+);
+
+export const customerRevenueMock: CustomerRevenueEntry[] = monthlyDates.flatMap(
+  (date, monthIndex) => {
+    const dateObj = new Date(`${date}T00:00:00`);
+    const seasonal =
+      1 + Math.sin((dateObj.getMonth() / 12) * Math.PI * 2) * 0.08;
+
+    return customerNames.map((customer, index) => {
+      const base = Math.max(1800, 46000 - index * 1850);
+      const priorityBoost = topCustomerMultipliers[customer] || 1;
+      const variation = 1 + ((monthIndex + index * 3) % 9) * 0.023;
+
+      return {
+        date,
+        customer,
+        value: Math.round(base * priorityBoost * seasonal * variation),
+      };
+    });
+  }
+);
+
+export const operationalExpensesMock: OperationalExpenseEntry[] =
+  monthlyDates.flatMap((date, monthIndex) =>
+    expenseCategories.map((entry, categoryIndex) => {
+      const monthPulse = 1 + ((monthIndex + categoryIndex) % 7) * 0.04;
+      const quarterEffects = [1.04, 0.97, 1.1, 0.99] as const;
+      const quarterEffect =
+        quarterEffects[Math.floor((monthIndex % 12) / 3)] ?? 1;
+
+      return {
+        date,
+        category: entry.category,
+        costCenter: entry.costCenter,
+        value: Math.round(14000 * entry.weight * monthPulse * quarterEffect),
+      };
+    })
+  );

package/hedhog/frontend/app/reports/_lib/use-finance-reports.ts.ejs

@@ -0,0 +1,233 @@
+'use client';
+
+import { useApp, useQuery } from '@hed-hog/next-app-provider';
+
+export type GroupBy = 'day' | 'week' | 'month' | 'year';
+
+type QueryValue = string | number | undefined | null;
+
+export type OverviewResultsRow = {
+  period: string;
+  faturamento: number;
+  despesasEmprestimos: number;
+  diferenca: number;
+  aporteInvestidor: number;
+  emprestimoBanco: number;
+  despesas: number;
+};
+
+export type OverviewResultsReportData = {
+  rows: OverviewResultsRow[];
+  totals: {
+    faturamento: number;
+    despesasEmprestimos: number;
+    diferenca: number;
+    aporteInvestidor: number;
+    emprestimoBanco: number;
+    despesas: number;
+    margem: number;
+  };
+};
+
+export type TopCustomerItem = {
+  customer: string;
+  value: number;
+};
+
+export type TopCustomersReportData = {
+  total: number;
+  top5Percent: number;
+  topCustomers: TopCustomerItem[];
+  pieData: TopCustomerItem[];
+  groupedPeriods: Array<{ period: string; value: number }>;
+  leader: TopCustomerItem | null;
+};
+
+export type TopExpenseItem = {
+  category: string;
+  costCenter: string;
+  label: string;
+  value: number;
+};
+
+export type TopOperationalExpensesReportData = {
+  total: number;
+  average: number;
+  topExpenses: TopExpenseItem[];
+  pieData: Array<{ name: string; value: number }>;
+  groupedPeriods: Array<{ period: string; value: number }>;
+  highest: TopExpenseItem | null;
+};
+
+const EMPTY_OVERVIEW_RESULTS: OverviewResultsReportData = {
+  rows: [],
+  totals: {
+    faturamento: 0,
+    despesasEmprestimos: 0,
+    diferenca: 0,
+    aporteInvestidor: 0,
+    emprestimoBanco: 0,
+    despesas: 0,
+    margem: 0,
+  },
+};
+
+const EMPTY_TOP_CUSTOMERS: TopCustomersReportData = {
+  total: 0,
+  top5Percent: 0,
+  topCustomers: [],
+  pieData: [],
+  groupedPeriods: [],
+  leader: null,
+};
+
+const EMPTY_TOP_EXPENSES: TopOperationalExpensesReportData = {
+  total: 0,
+  average: 0,
+  topExpenses: [],
+  pieData: [],
+  groupedPeriods: [],
+  highest: null,
+};
+
+function buildQuery(params: Record<string, QueryValue>) {
+  const query = new URLSearchParams();
+
+  Object.entries(params).forEach(([key, value]) => {
+    if (value === undefined || value === null || value === '') {
+      return;
+    }
+
+    query.set(key, String(value));
+  });
+
+  return query.toString();
+}
+
+function toDate(value: string) {
+  return new Date(`${value}T00:00:00`);
+}
+
+function startOfWeek(date: Date) {
+  const current = new Date(date);
+  const day = current.getDay();
+  const diff = day === 0 ? -6 : 1 - day;
+
+  current.setDate(current.getDate() + diff);
+  current.setHours(0, 0, 0, 0);
+
+  return current;
+}
+
+export function getDefaultDateRange() {
+  return {
+    from: '2021-01-01',
+    to: '2026-12-31',
+  };
+}
+
+export function formatReportBucketLabel(
+  bucket: string,
+  groupBy: GroupBy,
+  locale: string
+) {
+  const dateFormatter = new Intl.DateTimeFormat(locale);
+
+  if (groupBy === 'day') {
+    return dateFormatter.format(toDate(bucket));
+  }
+
+  if (groupBy === 'week') {
+    const [year, week] = bucket.split('-W');
+
+    return `W${Number(week)}/${year}`;
+  }
+
+  if (groupBy === 'month') {
+    const [year, month] = bucket.split('-');
+    const monthDate = new Date(Number(year), Number(month) - 1, 1);
+
+    return new Intl.DateTimeFormat(locale, {
+      month: 'short',
+      year: 'numeric',
+    }).format(monthDate);
+  }
+
+  return bucket;
+}
+
+function useFinanceReportQuery<T>(
+  queryKey: string,
+  path: string,
+  params: Record<string, QueryValue>,
+  initialData: T
+) {
+  const { request } = useApp();
+  const querySuffix = buildQuery(params);
+  const url = querySuffix ? `${path}?${querySuffix}` : path;
+
+  return useQuery<T>({
+    queryKey: [queryKey, querySuffix || 'default'],
+    staleTime: 0,
+    refetchOnMount: 'always',
+    queryFn: async () => {
+      try {
+        const response = await request({
+          url,
+          method: 'GET',
+        });
+
+        return {
+          ...initialData,
+          ...(response?.data || {}),
+        } as T;
+      } catch {
+        return initialData;
+      }
+    },
+    initialData,
+  });
+}
+
+export function useOverviewResultsReport(filters: {
+  from: string;
+  to: string;
+  groupBy: GroupBy;
+}) {
+  return useFinanceReportQuery<OverviewResultsReportData>(
+    'finance-overview-results-report',
+    '/finance/reports/overview-results',
+    filters,
+    EMPTY_OVERVIEW_RESULTS
+  );
+}
+
+export function useTopCustomersReport(filters: {
+  from: string;
+  to: string;
+  groupBy: GroupBy;
+  search?: string;
+  topN?: number;
+}) {
+  return useFinanceReportQuery<TopCustomersReportData>(
+    'finance-top-customers-report',
+    '/finance/reports/top-customers',
+    filters,
+    EMPTY_TOP_CUSTOMERS
+  );
+}
+
+export function useTopOperationalExpensesReport(filters: {
+  from: string;
+  to: string;
+  groupBy: GroupBy;
+  search?: string;
+  topN?: number;
+}) {
+  return useFinanceReportQuery<TopOperationalExpensesReportData>(
+    'finance-top-operational-expenses-report',
+    '/finance/reports/top-operational-expenses',
+    filters,
+    EMPTY_TOP_EXPENSES
+  );
+}