refactor(dashboard): reorganizar módulos em subdiretórios e nova arquitetura de widgets

Arquivos de queries, helpers e controllers dispersos na raiz de dashboard/
foram movidos para subdiretórios temáticos (bills/, invoices/, notes/,
notifications/, overview/, payments/, goals-progress/, categories/).
~25 widgets monolíticos obsoletos removidos em favor de nova arquitetura
baseada em widget-registry com components/widgets/. Novos componentes:
category-breakdown-chart/list, goals-progress-item, percentage-change-indicator.
Imports atualizados em fetch-dashboard-data e transaction-filters limpos.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

src/features/dashboard/expenses/installment-expenses-helpers.ts

@@ -0,0 +1,116 @@
+import type { InstallmentExpense } from "@/features/dashboard/expenses/installment-expenses-queries";
+import {
+	calculateLastInstallmentDate,
+	formatLastInstallmentDate,
+} from "@/shared/lib/installments/utils";
+
+export type InstallmentExpenseDisplay = {
+	compactLabel: string | null;
+	isLast: boolean;
+	remainingInstallments: number;
+	remainingAmount: number;
+	endDate: string | null;
+	progress: number;
+};
+
+export const buildInstallmentCompactLabel = (
+	currentInstallment: number | null,
+	installmentCount: number | null,
+) => {
+	if (currentInstallment && installmentCount) {
+		return `${currentInstallment} de ${installmentCount}`;
+	}
+
+	return null;
+};
+
+export const isInstallmentLast = (
+	currentInstallment: number | null,
+	installmentCount: number | null,
+) => {
+	if (!currentInstallment || !installmentCount) {
+		return false;
+	}
+
+	return currentInstallment === installmentCount && installmentCount > 1;
+};
+
+export const calculateInstallmentRemainingCount = (
+	currentInstallment: number | null,
+	installmentCount: number | null,
+) => {
+	if (!currentInstallment || !installmentCount) {
+		return 0;
+	}
+
+	return Math.max(0, installmentCount - currentInstallment);
+};
+
+export const calculateInstallmentRemainingAmount = (
+	amount: number,
+	currentInstallment: number | null,
+	installmentCount: number | null,
+) =>
+	amount *
+	calculateInstallmentRemainingCount(currentInstallment, installmentCount);
+
+export const formatInstallmentEndDate = (
+	period: string,
+	currentInstallment: number | null,
+	installmentCount: number | null,
+) => {
+	if (!currentInstallment || !installmentCount) {
+		return null;
+	}
+
+	const lastDate = calculateLastInstallmentDate(
+		period,
+		currentInstallment,
+		installmentCount,
+	);
+
+	return formatLastInstallmentDate(lastDate);
+};
+
+export const buildInstallmentProgress = (
+	currentInstallment: number | null,
+	installmentCount: number | null,
+) => {
+	if (!currentInstallment || !installmentCount || installmentCount <= 0) {
+		return 0;
+	}
+
+	return Math.min(
+		100,
+		Math.max(0, (currentInstallment / installmentCount) * 100),
+	);
+};
+
+export const buildInstallmentExpenseDisplay = (
+	expense: InstallmentExpense,
+): InstallmentExpenseDisplay => {
+	const { amount, currentInstallment, installmentCount, period } = expense;
+
+	return {
+		compactLabel: buildInstallmentCompactLabel(
+			currentInstallment,
+			installmentCount,
+		),
+		isLast: isInstallmentLast(currentInstallment, installmentCount),
+		remainingInstallments: calculateInstallmentRemainingCount(
+			currentInstallment,
+			installmentCount,
+		),
+		remainingAmount: calculateInstallmentRemainingAmount(
+			amount,
+			currentInstallment,
+			installmentCount,
+		),
+		endDate: formatInstallmentEndDate(
+			period,
+			currentInstallment,
+			installmentCount,
+		),
+		progress: buildInstallmentProgress(currentInstallment, installmentCount),
+	};
+};