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/features/transactions/lib/attachment-copy.ts

@@ -0,0 +1,107 @@
+import { randomUUID } from "node:crypto";
+import { CopyObjectCommand } from "@aws-sdk/client-s3";
+import { eq } from "drizzle-orm";
+import { attachments, transactionAttachments, transactions } from "@/db/schema";
+import { db } from "@/shared/lib/db";
+import { getPayerAccess } from "@/shared/lib/payers/access";
+import { deleteS3Object } from "@/shared/lib/storage/presign";
+import { S3_BUCKET, s3 } from "@/shared/lib/storage/s3-client";
+
+const SAFE_EXTENSION = /^[a-z0-9]{1,10}$/i;
+
+function sanitizeExtension(fileKey: string): string {
+	const ext = fileKey.split(".").pop() ?? "";
+	return SAFE_EXTENSION.test(ext) ? ext.toLowerCase() : "bin";
+}
+
+export async function copyAttachmentsForImport({
+	sourceTransactionId,
+	targetTransactionIds,
+	targetUserId,
+}: {
+	sourceTransactionId: string;
+	targetTransactionIds: string[];
+	targetUserId: string;
+}): Promise<void> {
+	if (targetTransactionIds.length === 0) return;
+
+	const [source] = await db
+		.select({
+			id: transactions.id,
+			userId: transactions.userId,
+			payerId: transactions.payerId,
+		})
+		.from(transactions)
+		.where(eq(transactions.id, sourceTransactionId));
+
+	if (!source) return;
+
+	if (source.userId !== targetUserId) {
+		if (!source.payerId) return;
+		const access = await getPayerAccess(targetUserId, source.payerId);
+		if (!access) return;
+	}
+
+	const sourceAttachments = await db
+		.select({
+			fileKey: attachments.fileKey,
+			fileName: attachments.fileName,
+			fileSize: attachments.fileSize,
+			mimeType: attachments.mimeType,
+		})
+		.from(transactionAttachments)
+		.innerJoin(
+			attachments,
+			eq(transactionAttachments.attachmentId, attachments.id),
+		)
+		.where(eq(transactionAttachments.transactionId, sourceTransactionId));
+
+	if (sourceAttachments.length === 0) return;
+
+	for (const src of sourceAttachments) {
+		const newFileKey = `${targetUserId}/${randomUUID()}.${sanitizeExtension(src.fileKey)}`;
+
+		try {
+			await s3.send(
+				new CopyObjectCommand({
+					Bucket: S3_BUCKET,
+					CopySource: `${S3_BUCKET}/${src.fileKey}`,
+					Key: newFileKey,
+					ContentType: src.mimeType,
+					MetadataDirective: "COPY",
+				}),
+			);
+		} catch (error) {
+			console.error("Falha ao copiar anexo no S3:", error);
+			continue;
+		}
+
+		try {
+			const [newAttachment] = await db
+				.insert(attachments)
+				.values({
+					userId: targetUserId,
+					fileKey: newFileKey,
+					fileName: src.fileName,
+					fileSize: src.fileSize,
+					mimeType: src.mimeType,
+				})
+				.returning({ id: attachments.id });
+
+			if (!newAttachment) {
+				await deleteS3Object(newFileKey);
+				continue;
+			}
+
+			await db.insert(transactionAttachments).values(
+				targetTransactionIds.map((tid) => ({
+					transactionId: tid,
+					attachmentId: newAttachment.id,
+				})),
+			);
+		} catch (error) {
+			console.error("Falha ao registrar anexo copiado:", error);
+			await deleteS3Object(newFileKey).catch(() => {});
+		}
+	}
+}