refactor: faxina arquitetural — código morto, identificadores em inglês e estrutura padronizada

Refatoração estrutural sem mudanças funcionais. Saldo líquido: −428 linhas.

Removido:
- 14 funções/constantes mortas verificadas via grep no repo todo: validateCategoriaOwnership,
  getInstallmentAnticipationsAction, getAnticipationDetailsAction, formatDecimalForDb,
  currencyFormatterNoCents, optionalDecimalSchema, formatMonthLabel,
  getGoalProgressStatusColorClass, MONTH_PERIOD_PARAM, calculateRemainingInstallments,
  e 5 funções fetch* não usadas em inbox/queries.ts.
- 1 tipo morto (ImportRow) + 2 órfãos consequentes (InstallmentAnticipationWithRelations,
  GoalProgressStatus convertido em interno).
- ~30 export keywords desnecessários (símbolos usados apenas no próprio arquivo).
- Re-exports mortos em barrels: EstablishmentLogoPicker, CategoryReportSkeleton,
  WidgetSkeleton, toNameKey.
- Arquivo features/reports/types.ts (barrel inteiro era órfão).

Padronizado (PT-BR→EN em identificadores expostos):
- 4 constantes globais (LANCAMENTOS_* → TRANSACTIONS_*).
- 12 tipos/interfaces (Lancamento*/Pagador*/Estabelecimento* → equivalentes EN).
- 13 funções/components exportados (fetchPagador*, EstabelecimentoInput, PagadorInfoCard, etc.).
- 5 props cross-file (preLancamentosCount → inboxPendingCount, pagadorAvatarUrl → payerAvatarUrl, etc.).
- Mantidas em PT-BR conforme exceção do CLAUDE.md: variáveis locais (pagador, categoria,
  lancamento), accessor key pagadorName (persistida em preferências), strings de UI.

Reorganizado:
- transactions/: 14 helpers soltos na raiz movidos para lib/; barrel actions.ts reduzido
  de 76 linhas de wrappers para 14 linhas de re-exports puros; anticipation-actions.ts
  movido para actions/anticipation.ts.
- dashboard/: 8 helpers soltos consolidados em dashboard/lib/.
- reports/: 5 query files na raiz consolidados em reports/lib/.
- payers/: detail-actions.ts (21KB) e detail-queries.ts movidos para payers/lib/.
- shared/components/: 9 dos 16 componentes soltos agrupados em brand/, widgets/, feedback/.
- shared/lib/fetch-json.ts movido para shared/utils/fetch-json.ts.

Validação: pnpm exec tsc --noEmit (0 erros), biome check (0 issues), knip (sem unused).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

src/app/(dashboard)/accounts/[accountId]/statement/page.tsx

@@ -7,8 +7,8 @@ import { AdjustBalanceDialog } from "@/features/accounts/components/adjust-balan
 import type { Account } from "@/features/accounts/components/types";
 import {
 	fetchAccountData,
-	fetchAccountLancamentosPage,
 	fetchAccountSummary,
+	fetchAccountTransactionsPage,
 } from "@/features/accounts/statement-queries";
 import { fetchUserPreferences } from "@/features/settings/queries";
 import { TransactionsPage as LancamentosSection } from "@/features/transactions/components/page/transactions-page";
@@ -22,7 +22,7 @@ import {
 	mapTransactionsData,
 	type ResolvedSearchParams,
 	resolveTransactionPagination,
-} from "@/features/transactions/page-helpers";
+} from "@/features/transactions/lib/page-helpers";
 import {
 	fetchRecentEstablishments,
 	fetchTransactionFilterSources,
@@ -89,7 +89,7 @@ export default async function Page({ params, searchParams }: PageProps) {
 		accountId: account.id,
 	});
 
-	const transactionsPage = await fetchAccountLancamentosPage(
+	const transactionsPage = await fetchAccountTransactionsPage(
 		filters,
 		pagination,
 	);

src/app/(dashboard)/calendar/page.tsx

@@ -4,7 +4,7 @@ import { fetchCalendarData } from "@/features/calendar/queries";
 import {
 	getSingleParam,
 	type ResolvedSearchParams,
-} from "@/features/transactions/page-helpers";
+} from "@/features/transactions/lib/page-helpers";
 import MonthNavigation from "@/shared/components/month-picker/month-navigation";
 import { getUserId } from "@/shared/lib/auth/server";
 import type { CalendarPeriod } from "@/shared/lib/types/calendar";

src/app/(dashboard)/cards/[cardId]/invoice/page.tsx

@@ -21,7 +21,7 @@ import {
 	getSingleParam,
 	mapTransactionsData,
 	type ResolvedSearchParams,
-} from "@/features/transactions/page-helpers";
+} from "@/features/transactions/lib/page-helpers";
 import {
 	fetchRecentEstablishments,
 	fetchTransactionFilterSources,

src/app/(dashboard)/categories/[categoryId]/page.tsx

@@ -7,7 +7,7 @@ import { TransactionsPage } from "@/features/transactions/components/page/transa
 import {
 	buildOptionSets,
 	buildSluggedFilters,
-} from "@/features/transactions/page-helpers";
+} from "@/features/transactions/lib/page-helpers";
 import {
 	fetchRecentEstablishments,
 	fetchTransactionFilterSources,

src/app/(dashboard)/dashboard/page.tsx

@@ -2,9 +2,9 @@ import { connection } from "next/server";
 import { DashboardGridEditable } from "@/features/dashboard/components/dashboard-grid-editable";
 import { DashboardMetricsCards } from "@/features/dashboard/components/dashboard-metrics-cards";
 import { DashboardWelcome } from "@/features/dashboard/components/dashboard-welcome";
-import { extractDashboardLogoNames } from "@/features/dashboard/extract-logo-names";
+import { extractDashboardLogoNames } from "@/features/dashboard/lib/extract-logo-names";
 import { fetchDashboardPageData } from "@/features/dashboard/page-data-queries";
-import { getSingleParam } from "@/features/transactions/page-helpers";
+import { getSingleParam } from "@/features/transactions/lib/page-helpers";
 import { LogoPrefetchProvider } from "@/shared/components/entity-avatar";
 import MonthNavigation from "@/shared/components/month-picker/month-navigation";
 import { getUser } from "@/shared/lib/auth/server";

src/app/(dashboard)/layout.tsx

@@ -1,5 +1,5 @@
 import { connection } from "next/server";
-import { fetchDashboardNavbarData } from "@/features/dashboard/navbar-queries";
+import { fetchDashboardNavbarData } from "@/features/dashboard/lib/navbar-queries";
 import { AppNavbar } from "@/shared/components/navigation/navbar/app-navbar";
 import { LogoDevProvider } from "@/shared/components/providers/logo-dev-provider";
 import { PrivacyProvider } from "@/shared/components/providers/privacy-provider";
@@ -21,8 +21,8 @@ export default async function DashboardLayout({
 			<PrivacyProvider>
 				<AppNavbar
 					user={{ ...session.user, image: session.user.image ?? null }}
-					pagadorAvatarUrl={navbarData.pagadorAvatarUrl}
-					preLancamentosCount={navbarData.preLancamentosCount}
+					payerAvatarUrl={navbarData.payerAvatarUrl}
+					inboxPendingCount={navbarData.inboxPendingCount}
 					notificationsSnapshot={navbarData.notificationsSnapshot}
 				/>
 				<div className="relative flex flex-1 flex-col pt-16">

src/app/(dashboard)/payers/[payerId]/loading.tsx

@@ -4,7 +4,7 @@ import { Skeleton } from "@/shared/components/ui/skeleton";
  * Loading state para a página de detalhes do pagador.
  * Layout: navegação mensal + tabs com card compartilhado do pagador.
  */
-export default function PagadorDetailsLoading() {
+export default function PayerDetailsLoading() {
 	return (
 		<main className="flex flex-col gap-6">
 			<div className="h-[60px] animate-pulse rounded-md bg-foreground/10" />

src/app/(dashboard)/payers/[payerId]/page.tsx

@@ -8,7 +8,7 @@ import { connection } from "next/server";
 import { PayerCardUsageCard } from "@/features/payers/components/details/payer-card-usage-card";
 import { PayerHeaderCard } from "@/features/payers/components/details/payer-header-card";
 import { PayerHistoryCard } from "@/features/payers/components/details/payer-history-card";
-import { PagadorInfoCard } from "@/features/payers/components/details/payer-info-card";
+import { PayerInfoCard } from "@/features/payers/components/details/payer-info-card";
 import { PayerLeaveShareCard } from "@/features/payers/components/details/payer-leave-share-card";
 import { PayerMonthlySummaryCard } from "@/features/payers/components/details/payer-monthly-summary-card";
 import {
@@ -16,12 +16,12 @@ import {
 	PayerPaymentStatusCard,
 } from "@/features/payers/components/details/payer-payment-method-cards";
 import { PayerSharingCard } from "@/features/payers/components/details/payer-sharing-card";
+import { buildReadOnlyOptionSets } from "@/features/payers/lib/build-readonly-option-sets";
 import {
 	fetchCurrentUserShare,
-	fetchPagadorLancamentos,
 	fetchPayerShares,
-} from "@/features/payers/detail-queries";
-import { buildReadOnlyOptionSets } from "@/features/payers/lib/build-readonly-option-sets";
+	fetchPayerTransactions,
+} from "@/features/payers/lib/detail-queries";
 import { fetchUserPreferences } from "@/features/settings/queries";
 import { TransactionsPage as LancamentosSection } from "@/features/transactions/components/page/transactions-page";
 import {
@@ -36,13 +36,12 @@ import {
 	type SluggedFilters,
 	type SlugMaps,
 	type TransactionSearchFilters,
-} from "@/features/transactions/page-helpers";
+} from "@/features/transactions/lib/page-helpers";
 import {
 	fetchRecentEstablishments,
 	fetchTransactionFilterSources,
 } from "@/features/transactions/queries";
 import { LogoPrefetchProvider } from "@/shared/components/entity-avatar";
-import { ExpandableWidgetCard } from "@/shared/components/expandable-widget-card";
 import MonthNavigation from "@/shared/components/month-picker/month-navigation";
 import {
 	Tabs,
@@ -50,16 +49,17 @@ import {
 	TabsList,
 	TabsTrigger,
 } from "@/shared/components/ui/tabs";
+import { ExpandableWidgetCard } from "@/shared/components/widgets/expandable-widget-card";
 import { getUserId } from "@/shared/lib/auth/server";
 import { prefetchLogoMappings } from "@/shared/lib/logo/prefetch-server";
 import { getPayerAccess } from "@/shared/lib/payers/access";
 import {
-	fetchPagadorBoletoItems,
-	fetchPagadorBoletoStats,
-	fetchPagadorCardUsage,
-	fetchPagadorPaymentStatus,
+	fetchPayerBoletoItems,
+	fetchPayerBoletoStats,
+	fetchPayerCardUsage,
 	fetchPayerHistory,
 	fetchPayerMonthlyBreakdown,
+	fetchPayerPaymentStatus,
 	type PayerCardUsageItem,
 } from "@/shared/lib/payers/details";
 import { parsePeriodParam } from "@/shared/utils/period";
@@ -182,7 +182,7 @@ export default async function Page({ params, searchParams }: PageProps) {
 		estabelecimentos,
 		userPreferences,
 	] = await Promise.all([
-		fetchPagadorLancamentos(filters),
+		fetchPayerTransactions(filters),
 		fetchPayerMonthlyBreakdown({
 			userId: dataOwnerId,
 			payerId: pagador.id,
@@ -193,22 +193,22 @@ export default async function Page({ params, searchParams }: PageProps) {
 			payerId: pagador.id,
 			period: selectedPeriod,
 		}),
-		fetchPagadorCardUsage({
+		fetchPayerCardUsage({
 			userId: dataOwnerId,
 			payerId: pagador.id,
 			period: selectedPeriod,
 		}),
-		fetchPagadorBoletoStats({
+		fetchPayerBoletoStats({
 			userId: dataOwnerId,
 			payerId: pagador.id,
 			period: selectedPeriod,
 		}),
-		fetchPagadorBoletoItems({
+		fetchPayerBoletoItems({
 			userId: dataOwnerId,
 			payerId: pagador.id,
 			period: selectedPeriod,
 		}),
-		fetchPagadorPaymentStatus({
+		fetchPayerPaymentStatus({
 			userId: dataOwnerId,
 			payerId: pagador.id,
 			period: selectedPeriod,
@@ -333,7 +333,7 @@ export default async function Page({ params, searchParams }: PageProps) {
 					/>
 
 					<TabsContent value="profile" className="space-y-4">
-						<PagadorInfoCard payer={payerData} />
+						<PayerInfoCard payer={payerData} />
 						{canEdit && payerData.shareCode ? (
 							<PayerSharingCard
 								payerId={pagador.id}

src/app/(dashboard)/payers/loading.tsx

@@ -4,7 +4,7 @@ import { Skeleton } from "@/shared/components/ui/skeleton";
  * Loading state para a página de pessoas
  * Layout: Header + Input de compartilhamento + Grid de cards
  */
-export default function PagadoresLoading() {
+export default function PayersLoading() {
 	return (
 		<main className="flex flex-col items-start gap-6">
 			<div className="w-full space-y-6">

src/app/(dashboard)/reports/card-usage/page.tsx

@@ -1,11 +1,11 @@
 import { RiBankCard2Line } from "@remixicon/react";
 import { connection } from "next/server";
-import { fetchCartoesReportData } from "@/features/reports/cards-report-queries";
 import { CardCategoryBreakdown } from "@/features/reports/components/cards/card-category-breakdown";
 import { CardInvoiceStatus } from "@/features/reports/components/cards/card-invoice-status";
 import { CardTopExpenses } from "@/features/reports/components/cards/card-top-expenses";
 import { CardUsageChart } from "@/features/reports/components/cards/card-usage-chart";
 import { CardsOverview } from "@/features/reports/components/cards/cards-overview";
+import { fetchCartoesReportData } from "@/features/reports/lib/cards-report-queries";
 import MonthNavigation from "@/shared/components/month-picker/month-navigation";
 import { Card } from "@/shared/components/ui/card";
 import { getUser } from "@/shared/lib/auth/server";

src/app/(dashboard)/reports/category-trends/page.tsx

@@ -1,15 +1,15 @@
 import { redirect } from "next/navigation";
 import { connection } from "next/server";
 import type { Category } from "@/db/schema";
-import { fetchCategoryChartData } from "@/features/reports/category-chart-queries";
-import { fetchCategoryReport } from "@/features/reports/category-report-queries";
-import { fetchUserCategories } from "@/features/reports/category-trends-queries";
 import { CategoryReportPage } from "@/features/reports/components/category-report-page";
 import type {
 	CategoryOption,
 	FilterState,
 } from "@/features/reports/components/types";
-import { validateDateRange } from "@/features/reports/utils";
+import { fetchCategoryChartData } from "@/features/reports/lib/category-chart-queries";
+import { fetchCategoryReport } from "@/features/reports/lib/category-report-queries";
+import { fetchUserCategories } from "@/features/reports/lib/category-trends-queries";
+import { validateDateRange } from "@/features/reports/lib/utils";
 import { getUserId } from "@/shared/lib/auth/server";
 import type { CategoryReportFilters } from "@/shared/lib/types/reports";
 import { addMonthsToPeriod, getCurrentPeriod } from "@/shared/utils/period";

src/app/(dashboard)/reports/establishments/page.tsx

@@ -34,7 +34,7 @@ const validatePeriodFilter = (value: string | null): PeriodFilter => {
 	return "6";
 };
 
-export default async function TopEstabelecimentosPage({
+export default async function TopEstablishmentsPage({
 	searchParams,
 }: PageProps) {
 	await connection();

src/app/(dashboard)/transactions/import/page.tsx

@@ -3,7 +3,7 @@ import { ImportPage } from "@/features/transactions/components/import/import-pag
 import {
 	buildOptionSets,
 	buildSluggedFilters,
-} from "@/features/transactions/page-helpers";
+} from "@/features/transactions/lib/page-helpers";
 import { fetchTransactionFilterSources } from "@/features/transactions/queries";
 import { getUserId } from "@/shared/lib/auth/server";
 

src/app/(dashboard)/transactions/loading.tsx

@@ -8,7 +8,7 @@ import { Skeleton } from "@/shared/components/ui/skeleton";
  * Loading state para a página de lançamentos
  * Mantém o mesmo layout da página final
  */
-export default function LancamentosLoading() {
+export default function TransactionsLoading() {
 	return (
 		<main className="flex flex-col gap-6">
 			{/* Month Picker placeholder */}

src/app/(dashboard)/transactions/page.tsx

@@ -11,7 +11,7 @@ import {
 	mapTransactionsData,
 	type ResolvedSearchParams,
 	resolveTransactionPagination,
-} from "@/features/transactions/page-helpers";
+} from "@/features/transactions/lib/page-helpers";
 import {
 	fetchRecentEstablishments,
 	fetchTransactionFilterSources,