refactor: traduz dominio de payers no app

2026-05-09 11:01:45 +00:00 · 2026-03-14 12:51:08 +00:00
parent 67ad4b9d02
commit 43b0f0c47e
31 changed files with 691 additions and 720 deletions
--- a/src/features/payers/actions.ts
+++ b/src/features/payers/actions.ts
@@ -4,7 +4,7 @@ import { randomBytes } from "node:crypto";
 import { and, eq } from "drizzle-orm";
 import { revalidatePath } from "next/cache";
 import { z } from "zod";
-import { compartilhamentosPagador, pagadores, user } from "@/db/schema";
+import { payerShares, payers, user } from "@/db/schema";
 import {
 	handleActionError,
 	revalidateForEntity,
@@ -12,21 +12,25 @@ import {
 import { getUser } from "@/shared/lib/auth/server";
 import { db } from "@/shared/lib/db";
 import {
-	DEFAULT_PAGADOR_AVATAR,
-	PAGADOR_ROLE_ADMIN,
-	PAGADOR_ROLE_TERCEIRO,
-	PAGADOR_STATUS_OPTIONS,
+	DEFAULT_PAYER_AVATAR,
+	PAYER_ROLE_ADMIN,
+	PAYER_ROLE_THIRD_PARTY,
+	PAYER_STATUS_OPTIONS,
 } from "@/shared/lib/payers/constants";
 import { normalizeAvatarPath } from "@/shared/lib/payers/utils";
 import { noteSchema, uuidSchema } from "@/shared/lib/schemas/common";
 import type { ActionResult } from "@/shared/lib/types/actions";
 import { normalizeOptionalString } from "@/shared/utils/string";

-const statusEnum = z.enum(PAGADOR_STATUS_OPTIONS as [string, ...string[]], {
-	errorMap: () => ({
-		message: "Selecione um status válido.",
-	}),
-});
+const statusEnum = z
+	.enum([...PAYER_STATUS_OPTIONS] as [string, ...string[]])
+	.refine(
+		(v) =>
+			PAYER_STATUS_OPTIONS.includes(v as (typeof PAYER_STATUS_OPTIONS)[number]),
+		{
+			message: "Selecione um status válido.",
+		},
+	);

 const baseSchema = z.object({
 	name: z
@@ -48,11 +52,11 @@ const baseSchema = z.object({
 const createSchema = baseSchema;

 const updateSchema = baseSchema.extend({
-	id: uuidSchema("Pagador"),
+	id: uuidSchema("Payer"),
 });

 const deleteSchema = z.object({
-	id: uuidSchema("Pagador"),
+	id: uuidSchema("Payer"),
 });

 const shareDeleteSchema = z.object({
@@ -67,7 +71,7 @@ const shareCodeJoinSchema = z.object({
 });

 const shareCodeRegenerateSchema = z.object({
-	pagadorId: uuidSchema("Pagador"),
+	payerId: uuidSchema("Payer"),
 });

 type CreateInput = z.infer<typeof createSchema>;
@@ -77,7 +81,7 @@ type ShareDeleteInput = z.infer<typeof shareDeleteSchema>;
 type ShareCodeJoinInput = z.infer<typeof shareCodeJoinSchema>;
 type ShareCodeRegenerateInput = z.infer<typeof shareCodeRegenerateSchema>;

-const revalidate = () => revalidateForEntity("pagadores");
+const revalidate = () => revalidateForEntity("payers");

 const generateShareCode = () => {
 	// base64url já retorna apenas [a-zA-Z0-9_-]
@@ -85,56 +89,53 @@ const generateShareCode = () => {
 	return randomBytes(18).toString("base64url").slice(0, 24);
 };

-export async function createPagadorAction(
+export async function createPayerAction(
 	input: CreateInput,
 ): Promise<ActionResult> {
 	try {
 		const user = await getUser();
 		const data = createSchema.parse(input);

-		await db.insert(pagadores).values({
+		await db.insert(payers).values({
 			name: data.name,
 			email: data.email,
 			status: data.status,
 			note: data.note,
-			avatarUrl: normalizeAvatarPath(data.avatarUrl) ?? DEFAULT_PAGADOR_AVATAR,
+			avatarUrl: normalizeAvatarPath(data.avatarUrl) ?? DEFAULT_PAYER_AVATAR,
 			isAutoSend: data.isAutoSend ?? false,
-			role: PAGADOR_ROLE_TERCEIRO,
+			role: PAYER_ROLE_THIRD_PARTY,
 			shareCode: generateShareCode(),
 			userId: user.id,
 		});

 		revalidate();

-		return { success: true, message: "Pagador criado com sucesso." };
+		return { success: true, message: "Payer criado com sucesso." };
 	} catch (error) {
 		return handleActionError(error);
 	}
 }

-export async function updatePagadorAction(
+export async function updatePayerAction(
 	input: UpdateInput,
 ): Promise<ActionResult> {
 	try {
 		const currentUser = await getUser();
 		const data = updateSchema.parse(input);

-		const existing = await db.query.pagadores.findFirst({
-			where: and(
-				eq(pagadores.id, data.id),
-				eq(pagadores.userId, currentUser.id),
-			),
+		const existing = await db.query.payers.findFirst({
+			where: and(eq(payers.id, data.id), eq(payers.userId, currentUser.id)),
 		});

 		if (!existing) {
 			return {
 				success: false,
-				error: "Pagador não encontrado.",
+				error: "Payer não encontrado.",
 			};
 		}

 		await db
-			.update(pagadores)
+			.update(payers)
 			.set({
 				name: data.name,
 				email: data.email,
@@ -143,14 +144,12 @@ export async function updatePagadorAction(
 				avatarUrl:
 					normalizeAvatarPath(data.avatarUrl) ?? existing.avatarUrl ?? null,
 				isAutoSend: data.isAutoSend ?? false,
-				role: existing.role ?? PAGADOR_ROLE_TERCEIRO,
+				role: existing.role ?? PAYER_ROLE_THIRD_PARTY,
 			})
-			.where(
-				and(eq(pagadores.id, data.id), eq(pagadores.userId, currentUser.id)),
-			);
+			.where(and(eq(payers.id, data.id), eq(payers.userId, currentUser.id)));

 		// Se o pagador é admin, sincronizar nome com o usuário
-		if (existing.role === PAGADOR_ROLE_ADMIN) {
+		if (existing.role === PAYER_ROLE_ADMIN) {
 			await db
 				.update(user)
 				.set({ name: data.name })
@@ -161,31 +160,31 @@ export async function updatePagadorAction(

 		revalidate();

-		return { success: true, message: "Pagador atualizado com sucesso." };
+		return { success: true, message: "Payer atualizado com sucesso." };
 	} catch (error) {
 		return handleActionError(error);
 	}
 }

-export async function deletePagadorAction(
+export async function deletePayerAction(
 	input: DeleteInput,
 ): Promise<ActionResult> {
 	try {
 		const user = await getUser();
 		const data = deleteSchema.parse(input);

-		const existing = await db.query.pagadores.findFirst({
-			where: and(eq(pagadores.id, data.id), eq(pagadores.userId, user.id)),
+		const existing = await db.query.payers.findFirst({
+			where: and(eq(payers.id, data.id), eq(payers.userId, user.id)),
 		});

 		if (!existing) {
 			return {
 				success: false,
-				error: "Pagador não encontrado.",
+				error: "Payer não encontrado.",
 			};
 		}

-		if (existing.role === PAGADOR_ROLE_ADMIN) {
+		if (existing.role === PAYER_ROLE_ADMIN) {
 			return {
 				success: false,
 				error: "Pagadores administradores não podem ser removidos.",
@@ -193,26 +192,26 @@ export async function deletePagadorAction(
 		}

 		await db
-			.delete(pagadores)
-			.where(and(eq(pagadores.id, data.id), eq(pagadores.userId, user.id)));
+			.delete(payers)
+			.where(and(eq(payers.id, data.id), eq(payers.userId, user.id)));

 		revalidate();

-		return { success: true, message: "Pagador removido com sucesso." };
+		return { success: true, message: "Payer removido com sucesso." };
 	} catch (error) {
 		return handleActionError(error);
 	}
 }

-export async function joinPagadorByShareCodeAction(
+export async function joinPayerByShareCodeAction(
 	input: ShareCodeJoinInput,
 ): Promise<ActionResult> {
 	try {
 		const user = await getUser();
 		const data = shareCodeJoinSchema.parse(input);

-		const pagadorRow = await db.query.pagadores.findFirst({
-			where: eq(pagadores.shareCode, data.code),
+		const pagadorRow = await db.query.payers.findFirst({
+			where: eq(payers.shareCode, data.code),
 		});

 		if (!pagadorRow) {
@@ -226,10 +225,10 @@ export async function joinPagadorByShareCodeAction(
 			};
 		}

-		const existingShare = await db.query.compartilhamentosPagador.findFirst({
+		const existingShare = await db.query.payerShares.findFirst({
 			where: and(
-				eq(compartilhamentosPagador.pagadorId, pagadorRow.id),
-				eq(compartilhamentosPagador.sharedWithUserId, user.id),
+				eq(payerShares.payerId, pagadorRow.id),
+				eq(payerShares.sharedWithUserId, user.id),
 			),
 		});

@@ -240,8 +239,8 @@ export async function joinPagadorByShareCodeAction(
 			};
 		}

-		await db.insert(compartilhamentosPagador).values({
-			pagadorId: pagadorRow.id,
+		await db.insert(payerShares).values({
+			payerId: pagadorRow.id,
 			sharedWithUserId: user.id,
 			permission: "read",
 			createdByUserId: pagadorRow.userId,
@@ -249,28 +248,28 @@ export async function joinPagadorByShareCodeAction(

 		revalidate();

-		return { success: true, message: "Pagador adicionado à sua lista." };
+		return { success: true, message: "Payer adicionado à sua lista." };
 	} catch (error) {
 		return handleActionError(error);
 	}
 }

-export async function deletePagadorShareAction(
+export async function deletePayerShareAction(
 	input: ShareDeleteInput,
 ): Promise<ActionResult> {
 	try {
 		const user = await getUser();
 		const data = shareDeleteSchema.parse(input);

-		const existing = await db.query.compartilhamentosPagador.findFirst({
+		const existing = await db.query.payerShares.findFirst({
 			columns: {
 				id: true,
-				pagadorId: true,
+				payerId: true,
 				sharedWithUserId: true,
 			},
-			where: eq(compartilhamentosPagador.id, data.shareId),
+			where: eq(payerShares.id, data.shareId),
 			with: {
-				pagador: {
+				payer: {
 					columns: {
 						userId: true,
 					},
@@ -279,10 +278,10 @@ export async function deletePagadorShareAction(
 		});

 		// Permitir que o owner OU o próprio usuário compartilhado remova o share
+		const payerOwner = existing?.payer as { userId: string } | null | undefined;
 		if (
 			!existing ||
-			(existing.pagador.userId !== user.id &&
-				existing.sharedWithUserId !== user.id)
+			(payerOwner?.userId !== user.id && existing.sharedWithUserId !== user.id)
 		) {
 			return {
 				success: false,
@@ -290,12 +289,10 @@ export async function deletePagadorShareAction(
 			};
 		}

-		await db
-			.delete(compartilhamentosPagador)
-			.where(eq(compartilhamentosPagador.id, data.shareId));
+		await db.delete(payerShares).where(eq(payerShares.id, data.shareId));

 		revalidate();
-		revalidatePath(`/payers/${existing.pagadorId}`);
+		revalidatePath(`/payers/${existing.payerId}`);

 		return { success: true, message: "Compartilhamento removido." };
 	} catch (error) {
@@ -303,23 +300,20 @@ export async function deletePagadorShareAction(
 	}
 }

-export async function regeneratePagadorShareCodeAction(
+export async function regeneratePayerShareCodeAction(
 	input: ShareCodeRegenerateInput,
 ): Promise<{ success: true; message: string; code: string } | ActionResult> {
 	try {
 		const user = await getUser();
 		const data = shareCodeRegenerateSchema.parse(input);

-		const existing = await db.query.pagadores.findFirst({
+		const existing = await db.query.payers.findFirst({
 			columns: { id: true, userId: true },
-			where: and(
-				eq(pagadores.id, data.pagadorId),
-				eq(pagadores.userId, user.id),
-			),
+			where: and(eq(payers.id, data.payerId), eq(payers.userId, user.id)),
 		});

 		if (!existing) {
-			return { success: false, error: "Pagador não encontrado." };
+			return { success: false, error: "Payer não encontrado." };
 		}

 		let attempts = 0;
@@ -327,17 +321,12 @@ export async function regeneratePagadorShareCodeAction(
 			const newCode = generateShareCode();
 			try {
 				await db
-					.update(pagadores)
+					.update(payers)
 					.set({ shareCode: newCode })
-					.where(
-						and(
-							eq(pagadores.id, data.pagadorId),
-							eq(pagadores.userId, user.id),
-						),
-					);
+					.where(and(eq(payers.id, data.payerId), eq(payers.userId, user.id)));

 				revalidate();
-				revalidatePath(`/payers/${data.pagadorId}`);
+				revalidatePath(`/payers/${data.payerId}`);
 				return {
 					success: true,
 					message: "Código atualizado com sucesso.",
@@ -347,8 +336,8 @@ export async function regeneratePagadorShareCodeAction(
 				if (
 					error instanceof Error &&
 					"constraint" in error &&
-					// @ts-expect-error constraint is present in postgres errors
-					error.constraint === "pagadores_share_code_key"
+					(error as { constraint?: string }).constraint ===
+						"pagadores_share_code_key"
 				) {
 					attempts += 1;
 					continue;
--- a/src/features/payers/components/details/payer-card-usage-card.tsx
+++ b/src/features/payers/components/details/payer-card-usage-card.tsx
@@ -4,7 +4,7 @@ import MoneyValues from "@/shared/components/money-values";
 import { CardContent } from "@/shared/components/ui/card";
 import { WidgetEmptyState } from "@/shared/components/widget-empty-state";
 import { resolveLogoSrc } from "@/shared/lib/logo";
-import type { PagadorCardUsageItem } from "@/shared/lib/payers/details";
+import type { PayerCardUsageItem } from "@/shared/lib/payers/details";

 const buildInitials = (value: string) => {
 	const parts = value.trim().split(/\s+/).filter(Boolean);
@@ -19,10 +19,10 @@ const buildInitials = (value: string) => {
 };

 type PagadorCardUsageCardProps = {
-	items: PagadorCardUsageItem[];
+	items: PayerCardUsageItem[];
 };

-export function PagadorCardUsageCard({ items }: PagadorCardUsageCardProps) {
+export function PayerCardUsageCard({ items }: PagadorCardUsageCardProps) {
 	if (items.length === 0) {
 		return (
 			<CardContent className="px-0">
--- a/src/features/payers/components/details/payer-header-card.tsx
+++ b/src/features/payers/components/details/payer-header-card.tsx
@@ -13,7 +13,7 @@ import Link from "next/link";
 import { useRouter } from "next/navigation";
 import { useState, useTransition } from "react";
 import { toast } from "sonner";
-import { sendPagadorSummaryAction } from "@/features/payers/detail-actions";
+import { sendPayerSummaryAction } from "@/features/payers/detail-actions";
 import { Badge } from "@/shared/components/ui/badge";
 import { Button } from "@/shared/components/ui/button";
 import {
@@ -30,41 +30,41 @@ import {
 	DialogHeader,
 	DialogTitle,
 } from "@/shared/components/ui/dialog";
-import { PAGADOR_ROLE_ADMIN } from "@/shared/lib/payers/constants";
+import { PAYER_ROLE_ADMIN } from "@/shared/lib/payers/constants";
 import { getAvatarSrc } from "@/shared/lib/payers/utils";
 import { formatCurrency } from "@/shared/utils/currency";
 import { formatDateTime } from "@/shared/utils/date";
-import type { PagadorInfo, PagadorSummaryPreview } from "./types";
+import type { PayerInfo, PayerSummaryPreview } from "./types";

-type PagadorHeaderCardProps = {
-	pagador: PagadorInfo;
+type PayerHeaderCardProps = {
+	payer: PayerInfo;
 	selectedPeriod: string;
-	summary: PagadorSummaryPreview;
+	summary: PayerSummaryPreview;
 };

-export function PagadorHeaderCard({
-	pagador,
+export function PayerHeaderCard({
+	payer,
 	selectedPeriod,
 	summary,
-}: PagadorHeaderCardProps) {
+}: PayerHeaderCardProps) {
 	const router = useRouter();
 	const [isSending, startTransition] = useTransition();
 	const [confirmOpen, setConfirmOpen] = useState(false);

-	const avatarSrc = getAvatarSrc(pagador.avatarUrl);
-	const createdAtLabel = formatDate(pagador.createdAt);
-	const isAdmin = pagador.role === PAGADOR_ROLE_ADMIN;
+	const avatarSrc = getAvatarSrc(payer.avatarUrl);
+	const createdAtLabel = formatDate(payer.createdAt);
+	const isAdmin = payer.role === PAYER_ROLE_ADMIN;

 	const lastMailLabel =
-		formatDateTime(pagador.lastMailAt, {
+		formatDateTime(payer.lastMailAt, {
 			dateStyle: "short",
 			timeStyle: "short",
 		}) ?? "Nunca enviado";

-	const disableSend = isSending || !pagador.email || !pagador.canEdit;
+	const disableSend = isSending || !payer.email || !payer.canEdit;

 	const openConfirmDialog = () => {
-		if (!pagador.email) {
+		if (!payer.email) {
 			toast.error("Cadastre um e-mail para este pagador antes de enviar.");
 			return;
 		}
@@ -72,14 +72,14 @@ export function PagadorHeaderCard({
 	};

 	const handleSendSummary = () => {
-		if (!pagador.email) {
+		if (!payer.email) {
 			toast.error("Cadastre um e-mail para este pagador antes de enviar.");
 			return;
 		}

 		startTransition(async () => {
-			const result = await sendPagadorSummaryAction({
-				pagadorId: pagador.id,
+			const result = await sendPayerSummaryAction({
+				payerId: payer.id,
 				period: selectedPeriod,
 			});

@@ -109,7 +109,7 @@ export function PagadorHeaderCard({
 					<div className="relative flex size-16 shrink-0 items-center justify-center overflow-hidden">
 						<Image
 							src={avatarSrc}
-							alt={`Avatar de ${pagador.name}`}
+							alt={`Avatar de ${payer.name}`}
 							width={64}
 							height={64}
 							className="h-full w-full rounded-full object-cover"
@@ -119,7 +119,7 @@ export function PagadorHeaderCard({
 					<div className="flex flex-1 flex-col gap-2">
 						<div className="flex flex-wrap items-center gap-2">
 							<CardTitle className="text-xl font-semibold text-foreground">
-								{pagador.name}
+								{payer.name}
 							</CardTitle>
 							{isAdmin ? (
 								<RiVerifiedBadgeFill
@@ -128,12 +128,12 @@ export function PagadorHeaderCard({
 								/>
 							) : null}
 							<Badge
-								variant={getStatusBadgeVariant(pagador.status)}
+								variant={getStatusBadgeVariant(payer.status)}
 								className="text-xs"
 							>
-								{pagador.status}
+								{payer.status}
 							</Badge>
-							{pagador.isAutoSend ? (
+							{payer.isAutoSend ? (
 								<Badge variant="info" className="gap-1 text-xs">
 									<RiMailSendLine className="size-3.5" aria-hidden />
 									Envio automático
@@ -144,14 +144,14 @@ export function PagadorHeaderCard({
 						<CardDescription className="flex flex-wrap items-center gap-x-3 gap-y-1 text-sm">
 							<span>Criado em {createdAtLabel}</span>
 							<span className="hidden text-border/80 sm:inline">•</span>
-							{pagador.email ? (
+							{payer.email ? (
 								<Link
 									prefetch
-									href={`mailto:${pagador.email}`}
+									href={`mailto:${payer.email}`}
 									className="inline-flex items-center gap-1.5 text-primary"
 								>
 									<RiMailLine className="size-4" aria-hidden />
-									{pagador.email}
+									{payer.email}
 								</Link>
 							) : (
 								<span>Sem e-mail cadastrado</span>
@@ -161,7 +161,7 @@ export function PagadorHeaderCard({
 				</div>

 				<div className="flex w-full flex-col items-stretch gap-2 lg:w-auto lg:items-end">
-					{pagador.canEdit ? (
+					{payer.canEdit ? (
 						<>
 							<Button
 								type="button"
@@ -184,7 +184,7 @@ export function PagadorHeaderCard({
 				</div>
 			</CardHeader>

-			{pagador.canEdit ? (
+			{payer.canEdit ? (
 				<Dialog
 					open={confirmOpen}
 					onOpenChange={(open) => {
@@ -202,7 +202,7 @@ export function PagadorHeaderCard({
 								</span>{" "}
 								para{" "}
 								<span className="font-medium text-foreground">
-									{pagador.email}
+									{payer.email}
 								</span>
 							</DialogDescription>
 						</DialogHeader>
--- a/src/features/payers/components/details/payer-history-card.tsx
+++ b/src/features/payers/components/details/payer-history-card.tsx
@@ -21,7 +21,7 @@ import {
 	ChartTooltipContent,
 } from "@/shared/components/ui/chart";
 import { WidgetEmptyState } from "@/shared/components/widget-empty-state";
-import type { PagadorHistoryPoint } from "@/shared/lib/payers/details";
+import type { PayerHistoryPoint } from "@/shared/lib/payers/details";
 import { currencyFormatter } from "@/shared/utils/currency";

 const chartConfig = {
@@ -32,7 +32,7 @@ const chartConfig = {
 };

 type PagadorHistoryCardProps = {
-	data: PagadorHistoryPoint[];
+	data: PayerHistoryPoint[];
 };

 const ValueLabel = (props: LabelProps) => {
@@ -57,7 +57,7 @@ const ValueLabel = (props: LabelProps) => {
 	);
 };

-export function PagadorHistoryCard({ data }: PagadorHistoryCardProps) {
+export function PayerHistoryCard({ data }: PagadorHistoryCardProps) {
 	const hasData = data.length > 0;

 	return (
--- a/src/features/payers/components/details/payer-info-card.tsx
+++ b/src/features/payers/components/details/payer-info-card.tsx
@@ -8,17 +8,17 @@ import {
 	CardHeader,
 	CardTitle,
 } from "@/shared/components/ui/card";
-import { PAGADOR_ROLE_ADMIN } from "@/shared/lib/payers/constants";
+import { PAYER_ROLE_ADMIN } from "@/shared/lib/payers/constants";
 import { formatDateTime } from "@/shared/utils/date";
 import { cn } from "@/shared/utils/ui";
-import type { PagadorInfo } from "./types";
+import type { PayerInfo } from "./types";

-type PagadorInfoCardProps = {
-	pagador: PagadorInfo;
+type PayerInfoCardProps = {
+	payer: PayerInfo;
 };

-export function PagadorInfoCard({ pagador }: PagadorInfoCardProps) {
-	const showSensitiveDetails = pagador.canEdit;
+export function PagadorInfoCard({ payer }: PayerInfoCardProps) {
+	const showSensitiveDetails = payer.canEdit;

 	const getStatusBadgeVariant = (status: string): "success" | "outline" => {
 		const normalizedStatus = status.toLowerCase();
@@ -32,7 +32,7 @@ export function PagadorInfoCard({ pagador }: PagadorInfoCardProps) {
 		<Card className="border gap-4">
 			<CardHeader className="gap-1.5">
 				<CardTitle className="text-lg font-semibold">
-					Detalhes do pagador
+					Detalhes do payer
 				</CardTitle>
 				<CardDescription>
 					{showSensitiveDetails
@@ -46,10 +46,10 @@ export function PagadorInfoCard({ pagador }: PagadorInfoCardProps) {
 					label="Status"
 					value={
 						<Badge
-							variant={getStatusBadgeVariant(pagador.status)}
+							variant={getStatusBadgeVariant(payer.status)}
 							className="text-xs"
 						>
-							{pagador.status}
+							{payer.status}
 						</Badge>
 					}
 				/>
@@ -59,23 +59,23 @@ export function PagadorInfoCard({ pagador }: PagadorInfoCardProps) {
 					value={
 						<span className="inline-flex items-center gap-2">
 							<RiUser3Line className="size-4 text-muted-foreground" />
-							{resolveRoleLabel(pagador.role)}
+							{resolveRoleLabel(payer.role)}
 						</span>
 					}
 				/>
 				{showSensitiveDetails ? (
 					<InfoItem
 						label="Envio automático"
-						value={pagador.isAutoSend ? "Ativado" : "Desativado"}
+						value={payer.isAutoSend ? "Ativado" : "Desativado"}
 					/>
 				) : null}
 				{showSensitiveDetails ? (
 					<InfoItem
 						label="Último envio"
-						value={formatDateTime(pagador.lastMailAt) ?? "Nunca enviado"}
+						value={formatDateTime(payer.lastMailAt) ?? "Nunca enviado"}
 					/>
 				) : null}
-				{showSensitiveDetails && !pagador.email ? (
+				{showSensitiveDetails && !payer.email ? (
 					<InfoItem
 						label="Aviso"
 						value={
@@ -90,8 +90,8 @@ export function PagadorInfoCard({ pagador }: PagadorInfoCardProps) {
 					<InfoItem
 						label="Observações"
 						value={
-							pagador.note ? (
-								<span className="text-muted-foreground">{pagador.note}</span>
+							payer.note ? (
+								<span className="text-muted-foreground">{payer.note}</span>
 							) : (
 								"Sem observações"
 							)
@@ -105,8 +105,8 @@ export function PagadorInfoCard({ pagador }: PagadorInfoCardProps) {
 }

 const resolveRoleLabel = (role: string | null) => {
-	if (role === PAGADOR_ROLE_ADMIN) return "Administrador";
-	return "Pagador";
+	if (role === PAYER_ROLE_ADMIN) return "Administrador";
+	return "Payer";
 };

 type InfoItemProps = {
--- a/src/features/payers/components/details/payer-leave-share-card.tsx
+++ b/src/features/payers/components/details/payer-leave-share-card.tsx
@@ -4,7 +4,7 @@ import { RiLogoutBoxLine } from "@remixicon/react";
 import { useRouter } from "next/navigation";
 import { useState, useTransition } from "react";
 import { toast } from "sonner";
-import { deletePagadorShareAction } from "@/features/payers/actions";
+import { deletePayerShareAction } from "@/features/payers/actions";
 import { Button } from "@/shared/components/ui/button";
 import {
 	Card,
@@ -20,7 +20,7 @@ interface PagadorLeaveShareCardProps {
 	createdAt: string;
 }

-export function PagadorLeaveShareCard({
+export function PayerLeaveShareCard({
 	shareId,
 	pagadorName,
 	createdAt,
@@ -31,7 +31,7 @@ export function PagadorLeaveShareCard({

 	const handleLeave = () => {
 		startTransition(async () => {
-			const result = await deletePagadorShareAction({ shareId });
+			const result = await deletePayerShareAction({ shareId });

 			if (!result.success) {
 				toast.error(result.error);
--- a/src/features/payers/components/details/payer-monthly-summary-card.tsx
+++ b/src/features/payers/components/details/payer-monthly-summary-card.tsx
@@ -6,7 +6,7 @@ import {
 	CardHeader,
 	CardTitle,
 } from "@/shared/components/ui/card";
-import type { PagadorMonthlyBreakdown } from "@/shared/lib/payers/details";
+import type { PayerMonthlyBreakdown } from "@/shared/lib/payers/details";
 import { cn } from "@/shared/utils/ui";

 const segmentConfig = {
@@ -26,10 +26,10 @@ const segmentConfig = {

 type PagadorMonthlySummaryCardProps = {
 	periodLabel: string;
-	breakdown: PagadorMonthlyBreakdown;
+	breakdown: PayerMonthlyBreakdown;
 };

-export function PagadorMonthlySummaryCard({
+export function PayerMonthlySummaryCard({
 	periodLabel,
 	breakdown,
 }: PagadorMonthlySummaryCardProps) {
--- a/src/features/payers/components/details/payer-payment-method-cards.tsx
+++ b/src/features/payers/components/details/payer-payment-method-cards.tsx
@@ -11,18 +11,18 @@ import { CardContent } from "@/shared/components/ui/card";
 import { Progress } from "@/shared/components/ui/progress";
 import { WidgetEmptyState } from "@/shared/components/widget-empty-state";
 import type {
-	PagadorBoletoItem,
-	PagadorPaymentStatusData,
+	PayerBoletoItem,
+	PayerPaymentStatusData,
 } from "@/shared/lib/payers/details";
 import { cn } from "@/shared/utils/ui";

-// --- PagadorBoletoCard ---
+// --- PayerBoletoCard ---

 type PagadorBoletoCardProps = {
-	items: PagadorBoletoItem[];
+	items: PayerBoletoItem[];
 };

-export function PagadorBoletoCard({ items }: PagadorBoletoCardProps) {
+export function PayerBoletoCard({ items }: PagadorBoletoCardProps) {
 	if (items.length === 0) {
 		return (
 			<CardContent className="px-0">
@@ -72,13 +72,13 @@ export function PagadorBoletoCard({ items }: PagadorBoletoCardProps) {
 	);
 }

-// --- PagadorPaymentStatusCard ---
+// --- PayerPaymentStatusCard ---

 type PagadorPaymentStatusCardProps = {
-	data: PagadorPaymentStatusData;
+	data: PayerPaymentStatusData;
 };

-export function PagadorPaymentStatusCard({
+export function PayerPaymentStatusCard({
 	data,
 }: PagadorPaymentStatusCardProps) {
 	const { paidAmount, paidCount, pendingAmount, pendingCount, totalAmount } =
--- a/src/features/payers/components/details/payer-sharing-card.tsx
+++ b/src/features/payers/components/details/payer-sharing-card.tsx
@@ -5,8 +5,8 @@ import { useRouter } from "next/navigation";
 import { useState, useTransition } from "react";
 import { toast } from "sonner";
 import {
-	deletePagadorShareAction,
-	regeneratePagadorShareCodeAction,
+	deletePayerShareAction,
+	regeneratePayerShareCodeAction,
 } from "@/features/payers/actions";
 import { Button } from "@/shared/components/ui/button";
 import {
@@ -25,13 +25,13 @@ type PagadorShare = {
 };

 interface PagadorSharingCardProps {
-	pagadorId: string;
+	payerId: string;
 	shareCode: string;
 	shares: PagadorShare[];
 }

-export function PagadorSharingCard({
-	pagadorId,
+export function PayerSharingCard({
+	payerId,
 	shareCode,
 	shares,
 }: PagadorSharingCardProps) {
@@ -51,14 +51,14 @@ export function PagadorSharingCard({

 	const handleRegenerate = () => {
 		startRegenerate(async () => {
-			const result = await regeneratePagadorShareCodeAction({ pagadorId });
+			const result = await regeneratePayerShareCodeAction({ payerId });

 			if (!result.success) {
 				toast.error(result.error);
 				return;
 			}

-			setCurrentCode(result.code);
+			if ("code" in result) setCurrentCode(result.code);
 			toast.success("Novo código gerado com sucesso.");
 			router.refresh();
 		});
@@ -67,7 +67,7 @@ export function PagadorSharingCard({
 	const handleRemove = (shareId: string) => {
 		setRemovePendingId(shareId);
 		startRegenerate(async () => {
-			const result = await deletePagadorShareAction({ shareId });
+			const result = await deletePayerShareAction({ shareId });

 			if (!result.success) {
 				toast.error(result.error);
--- a/src/features/payers/components/details/types.ts
+++ b/src/features/payers/components/details/types.ts
@@ -1,4 +1,4 @@
-export type PagadorInfo = {
+export type PayerInfo = {
 	id: string;
 	name: string;
 	email: string | null;
@@ -13,7 +13,7 @@ export type PagadorInfo = {
 	canEdit: boolean;
 };

-export type PagadorSummaryPreview = {
+export type PayerSummaryPreview = {
 	periodLabel: string;
 	totalExpenses: number;
 	paymentSplits: {
--- a/src/features/payers/components/payer-card.tsx
+++ b/src/features/payers/components/payer-card.tsx
@@ -11,20 +11,20 @@ import Image from "next/image";
 import Link from "next/link";
 import { Badge } from "@/shared/components/ui/badge";
 import { Card } from "@/shared/components/ui/card";
-import { PAGADOR_ROLE_ADMIN } from "@/shared/lib/payers/constants";
+import { PAYER_ROLE_ADMIN } from "@/shared/lib/payers/constants";
 import { getAvatarSrc } from "@/shared/lib/payers/utils";
-import type { Pagador } from "./types";
+import type { Payer } from "./types";

-interface PagadorCardProps {
-	pagador: Pagador;
+interface PayerCardProps {
+	payer: Payer;
 	onEdit?: () => void;
 	onRemove?: () => void;
 }

-export function PagadorCard({ pagador, onEdit, onRemove }: PagadorCardProps) {
-	const avatarSrc = getAvatarSrc(pagador.avatarUrl);
-	const isAdmin = pagador.role === PAGADOR_ROLE_ADMIN;
-	const isReadOnly = !pagador.canEdit;
+export function PayerCard({ payer, onEdit, onRemove }: PayerCardProps) {
+	const avatarSrc = getAvatarSrc(payer.avatarUrl);
+	const isAdmin = payer.role === PAYER_ROLE_ADMIN;
+	const isReadOnly = !payer.canEdit;

 	return (
 		<Card className=" overflow-hidden px-6">
@@ -33,7 +33,7 @@ export function PagadorCard({ pagador, onEdit, onRemove }: PagadorCardProps) {
 				<div className="relative mb-3 flex size-16 items-center justify-center overflow-hidden rounded-full  border-background bg-background shadow-lg">
 					<Image
 						src={avatarSrc}
-						alt={`Avatar de ${pagador.name}`}
+						alt={`Avatar de ${payer.name}`}
 						width={80}
 						height={80}
 						className="h-full w-full object-cover"
@@ -43,19 +43,19 @@ export function PagadorCard({ pagador, onEdit, onRemove }: PagadorCardProps) {
 				{/* Nome e badges */}
 				<div className="flex items-center gap-1.5">
 					<h3 className="text-base font-semibold text-foreground">
-						{pagador.name}
+						{payer.name}
 					</h3>
 					{isAdmin ? (
 						<RiVerifiedBadgeFill className="size-4 text-blue-500" aria-hidden />
 					) : null}
-					{pagador.isAutoSend ? (
+					{payer.isAutoSend ? (
 						<RiMailSendLine className="size-4 text-primary" aria-hidden />
 					) : null}
 				</div>

 				{/* Email */}
-				{pagador.email ? (
-					<p className="mt-1 text-xs text-muted-foreground">{pagador.email}</p>
+				{payer.email ? (
+					<p className="mt-1 text-xs text-muted-foreground">{payer.email}</p>
 				) : (
 					<p className="mt-1 text-xs text-muted-foreground">
 						Sem email cadastrado
@@ -65,10 +65,10 @@ export function PagadorCard({ pagador, onEdit, onRemove }: PagadorCardProps) {
 				{/* Status badges */}
 				<div className="mt-2 flex flex-wrap items-center justify-center gap-1.5">
 					<Badge
-						variant={pagador.status === "Ativo" ? "success" : "outline"}
+						variant={payer.status === "Ativo" ? "success" : "outline"}
 						className="text-xs"
 					>
-						{pagador.status}
+						{payer.status}
 					</Badge>

 					{isReadOnly ? (
@@ -93,7 +93,7 @@ export function PagadorCard({ pagador, onEdit, onRemove }: PagadorCardProps) {
 				) : null}

 				<Link
-					href={`/payers/${pagador.id}`}
+					href={`/payers/${payer.id}`}
 					className={`text-primary flex items-center gap-1 font-medium transition-opacity hover:opacity-80`}
 				>
 					<RiFileList2Line className="size-4" aria-hidden />
--- a/src/features/payers/components/payer-dialog.tsx
+++ b/src/features/payers/components/payer-dialog.tsx
@@ -3,8 +3,8 @@ import Image from "next/image";
 import { useEffect, useMemo, useState, useTransition } from "react";
 import { toast } from "sonner";
 import {
-	createPagadorAction,
-	updatePagadorAction,
+	createPayerAction,
+	updatePayerAction,
 } from "@/features/payers/actions";
 import { Button } from "@/shared/components/ui/button";
 import { Checkbox } from "@/shared/components/ui/checkbox";
@@ -29,50 +29,50 @@ import {
 import { useControlledState } from "@/shared/hooks/use-controlled-state";
 import { useFormState } from "@/shared/hooks/use-form-state";
 import {
-	DEFAULT_PAGADOR_AVATAR,
-	PAGADOR_STATUS_OPTIONS,
-	type PagadorStatus,
+	DEFAULT_PAYER_AVATAR,
+	PAYER_STATUS_OPTIONS,
+	type PayerStatus,
 } from "@/shared/lib/payers/constants";
 import { getAvatarSrc } from "@/shared/lib/payers/utils";
 import { StatusSelectContent } from "./payer-select-items";
-import type { Pagador, PagadorFormValues } from "./types";
+import type { Payer, PayerFormValues } from "./types";

-interface PagadorDialogProps {
+interface PayerDialogProps {
 	mode: "create" | "update";
 	trigger?: React.ReactNode;
-	pagador?: Pagador;
+	payer?: Payer;
 	avatarOptions: string[];
 	open?: boolean;
 	onOpenChange?: (open: boolean) => void;
 }

 const buildInitialValues = ({
-	pagador,
+	payer,
 	avatarOptions,
 }: {
-	pagador?: Pagador;
+	payer?: Payer;
 	avatarOptions: string[];
-}): PagadorFormValues => {
-	const defaultAvatar = avatarOptions[0] ?? DEFAULT_PAGADOR_AVATAR;
+}): PayerFormValues => {
+	const defaultAvatar = avatarOptions[0] ?? DEFAULT_PAYER_AVATAR;

 	return {
-		name: pagador?.name ?? "",
-		email: pagador?.email ?? "",
-		status: (pagador?.status as PagadorStatus) ?? PAGADOR_STATUS_OPTIONS[0],
-		avatarUrl: pagador?.avatarUrl ?? defaultAvatar,
-		note: pagador?.note ?? "",
-		isAutoSend: pagador?.isAutoSend ?? false,
+		name: payer?.name ?? "",
+		email: payer?.email ?? "",
+		status: (payer?.status as PayerStatus) ?? PAYER_STATUS_OPTIONS[0],
+		avatarUrl: payer?.avatarUrl ?? defaultAvatar,
+		note: payer?.note ?? "",
+		isAutoSend: payer?.isAutoSend ?? false,
 	};
 };

-export function PagadorDialog({
+export function PayerDialog({
 	mode,
 	trigger,
-	pagador,
+	payer,
 	avatarOptions,
 	open,
 	onOpenChange,
-}: PagadorDialogProps) {
+}: PayerDialogProps) {
 	const [errorMessage, setErrorMessage] = useState<string | null>(null);
 	const [isPending, startTransition] = useTransition();

@@ -84,19 +84,19 @@ export function PagadorDialog({
 	);

 	const initialState = useMemo(
-		() => buildInitialValues({ pagador, avatarOptions }),
-		[pagador, avatarOptions],
+		() => buildInitialValues({ payer, avatarOptions }),
+		[payer, avatarOptions],
 	);

 	// Use form state hook for form management
 	const { formState, resetForm, updateField } =
-		useFormState<PagadorFormValues>(initialState);
+		useFormState<PayerFormValues>(initialState);

 	const availableAvatars = useMemo(() => {
 		const set = new Set<string>();
 		avatarOptions.forEach((avatar) => set.add(avatar));
 		set.add(initialState.avatarUrl);
-		set.add(DEFAULT_PAGADOR_AVATAR);
+		set.add(DEFAULT_PAYER_AVATAR);
 		return Array.from(set).sort((a, b) =>
 			a.localeCompare(b, "pt-BR", { sensitivity: "base" }),
 		);
@@ -110,22 +110,22 @@ export function PagadorDialog({
 		}
 	}, [dialogOpen, initialState, resetForm]);

-	type PagadorCreatePayload = Parameters<typeof createPagadorAction>[0];
+	type PayerCreatePayload = Parameters<typeof createPayerAction>[0];

 	const handleSubmit = (event: React.FormEvent<HTMLFormElement>) => {
 		event.preventDefault();
 		setErrorMessage(null);
-		const pagadorId = pagador?.id;
+		const payerId = payer?.id;

-		if (mode === "update" && !pagadorId) {
-			const message = "Pagador inválido.";
+		if (mode === "update" && !payerId) {
+			const message = "Payer inválido.";
 			setErrorMessage(message);
 			toast.error(message);
 			return;
 		}

 		const emailValue = formState.email.trim();
-		const payload: PagadorCreatePayload = {
+		const payload: PayerCreatePayload = {
 			name: formState.name.trim(),
 			status: formState.status,
 			avatarUrl: formState.avatarUrl,
@@ -136,7 +136,7 @@ export function PagadorDialog({

 		startTransition(async () => {
 			if (mode === "create") {
-				const result = await createPagadorAction(payload);
+				const result = await createPayerAction(payload);

 				if (result.success) {
 					toast.success(result.message);
@@ -150,12 +150,12 @@ export function PagadorDialog({
 				return;
 			}

-			if (!pagadorId) {
+			if (!payerId) {
 				return;
 			}

-			const result = await updatePagadorAction({
-				id: pagadorId,
+			const result = await updatePayerAction({
+				id: payerId,
 				...payload,
 			});

@@ -193,9 +193,9 @@ export function PagadorDialog({
 						<div className="flex flex-col gap-3">
 							<div className="flex w-full gap-2">
 								<div className="flex flex-col gap-2 w-full">
-									<Label htmlFor="pagador-name">Nome</Label>
+									<Label htmlFor="payer-name">Nome</Label>
 									<Input
-										id="pagador-name"
+										id="payer-name"
 										value={formState.name}
 										onChange={(event) =>
 											updateField("name", event.target.value)
@@ -206,9 +206,9 @@ export function PagadorDialog({
 								</div>

 								<div className="flex flex-col gap-2 w-full">
-									<Label htmlFor="pagador-email">E-mail</Label>
+									<Label htmlFor="payer-email">E-mail</Label>
 									<Input
-										id="pagador-email"
+										id="payer-email"
 										type="email"
 										value={formState.email}
 										onChange={(event) =>
@@ -220,14 +220,14 @@ export function PagadorDialog({
 							</div>

 							<div className="flex flex-col gap-2">
-								<Label htmlFor="pagador-status">Status</Label>
+								<Label htmlFor="payer-status">Status</Label>
 								<Select
 									value={formState.status}
-									onValueChange={(value: PagadorStatus) =>
+									onValueChange={(value: PayerStatus) =>
 										updateField("status", value)
 									}
 								>
-									<SelectTrigger id="pagador-status" className="w-full">
+									<SelectTrigger id="payer-status" className="w-full">
 										<SelectValue placeholder="Selecione o status">
 											{formState.status && (
 												<StatusSelectContent label={formState.status} />
@@ -235,7 +235,7 @@ export function PagadorDialog({
 										</SelectValue>
 									</SelectTrigger>
 									<SelectContent>
-										{PAGADOR_STATUS_OPTIONS.map((status) => (
+										{PAYER_STATUS_OPTIONS.map((status) => (
 											<SelectItem key={status} value={status}>
 												<StatusSelectContent label={status} />
 											</SelectItem>
@@ -247,7 +247,7 @@ export function PagadorDialog({
 							<fieldset className="flex flex-col gap-3">
 								<div className="flex items-start gap-3 rounded-lg border border-border/60 bg-muted/10 p-3">
 									<Checkbox
-										id="pagador-auto-send"
+										id="payer-auto-send"
 										checked={formState.isAutoSend}
 										onCheckedChange={(checked) =>
 											updateField("isAutoSend", Boolean(checked))
@@ -256,7 +256,7 @@ export function PagadorDialog({
 									/>
 									<div className="space-y-1">
 										<Label
-											htmlFor="pagador-auto-send"
+											htmlFor="payer-auto-send"
 											className="text-sm font-medium text-foreground"
 										>
 											Enviar automaticamente
@@ -296,9 +296,9 @@ export function PagadorDialog({
 							</fieldset>

 							<div className="flex flex-col gap-2">
-								<Label htmlFor="pagador-note">Anotações</Label>
+								<Label htmlFor="payer-note">Anotações</Label>
 								<Input
-									id="pagador-note"
+									id="payer-note"
 									value={formState.note}
 									onChange={(event) => updateField("note", event.target.value)}
 									placeholder="Observações sobre este pagador"
--- a/src/features/payers/components/payers-page.tsx
+++ b/src/features/payers/components/payers-page.tsx
@@ -5,84 +5,81 @@ import { useRouter } from "next/navigation";
 import { useMemo, useState, useTransition } from "react";
 import { toast } from "sonner";
 import {
-	deletePagadorAction,
-	joinPagadorByShareCodeAction,
+	deletePayerAction,
+	joinPayerByShareCodeAction,
 } from "@/features/payers/actions";
-import { PagadorCard } from "@/features/payers/components/payer-card";
-import { PagadorDialog } from "@/features/payers/components/payer-dialog";
+import { PayerCard } from "@/features/payers/components/payer-card";
+import { PayerDialog } from "@/features/payers/components/payer-dialog";
 import { ConfirmActionDialog } from "@/shared/components/confirm-action-dialog";
 import { Button } from "@/shared/components/ui/button";
 import { Input } from "@/shared/components/ui/input";
-import { PAGADOR_ROLE_ADMIN } from "@/shared/lib/payers/constants";
-import type { Pagador } from "./types";
+import { PAYER_ROLE_ADMIN } from "@/shared/lib/payers/constants";
+import type { Payer } from "./types";

-interface PagadoresPageProps {
-	pagadores: Pagador[];
+interface PayersPageProps {
+	payers: Payer[];
 	avatarOptions: string[];
 }

-export function PagadoresPage({
-	pagadores,
-	avatarOptions,
-}: PagadoresPageProps) {
+export function PayersPage({ payers, avatarOptions }: PayersPageProps) {
 	const router = useRouter();
 	const [editOpen, setEditOpen] = useState(false);
-	const [selectedPagador, setSelectedPagador] = useState<Pagador | null>(null);
+	const [selectedPayer, setSelectedPayer] = useState<Payer | null>(null);
 	const [removeOpen, setRemoveOpen] = useState(false);
-	const [pagadorToRemove, setPagadorToRemove] = useState<Pagador | null>(null);
+	const [payerToRemove, setPayerToRemove] = useState<Payer | null>(null);
 	const [shareCodeInput, setShareCodeInput] = useState("");
 	const [joinPending, startJoin] = useTransition();

-	const orderedPagadores = useMemo(
+	const orderedPayers = useMemo(
 		() =>
-			[...pagadores].sort((a, b) => {
+			[...payers].sort((a, b) => {
 				// Admin sempre primeiro
-				if (a.role === PAGADOR_ROLE_ADMIN && b.role !== PAGADOR_ROLE_ADMIN) {
+				if (a.role === PAYER_ROLE_ADMIN && b.role !== PAYER_ROLE_ADMIN) {
 					return -1;
 				}
-				if (a.role !== PAGADOR_ROLE_ADMIN && b.role === PAGADOR_ROLE_ADMIN) {
+				if (a.role !== PAYER_ROLE_ADMIN && b.role === PAYER_ROLE_ADMIN) {
 					return 1;
 				}
 				// Se ambos têm o mesmo tipo de role, ordena por nome
 				return a.name.localeCompare(b.name, "pt-BR", { sensitivity: "base" });
 			}),
-		[pagadores],
+		[payers],
 	);

-	const handleEdit = (pagador: Pagador) => {
-		setSelectedPagador(pagador);
+	const handleEdit = (payer: Payer) => {
+		setSelectedPayer(payer);
 		setEditOpen(true);
 	};

 	const handleEditOpenChange = (open: boolean) => {
 		setEditOpen(open);
 		if (!open) {
-			setSelectedPagador(null);
+			setSelectedPayer(null);
 		}
 	};

-	const handleRemoveRequest = (pagador: Pagador) => {
-		if (pagador.role === PAGADOR_ROLE_ADMIN) {
+	const handleRemoveRequest = (payer: Payer) => {
+		if (payer.role === PAYER_ROLE_ADMIN) {
 			toast.error("Pagadores administradores não podem ser removidos.");
 			return;
 		}
-		setPagadorToRemove(pagador);
+		setPayerToRemove(payer);
 		setRemoveOpen(true);
 	};

 	const handleRemoveOpenChange = (open: boolean) => {
 		setRemoveOpen(open);
 		if (!open) {
-			setPagadorToRemove(null);
+			setPayerToRemove(null);
 		}
 	};

 	const handleRemoveConfirm = async () => {
-		if (!pagadorToRemove) {
+		if (!payerToRemove) {
 			return;
 		}

-		const result = await deletePagadorAction({ id: pagadorToRemove.id });
+		const result = await deletePayerAction({ id: payerToRemove.id });

 		if (result.success) {
 			toast.success(result.message);
@@ -93,8 +90,8 @@ export function PagadoresPage({
 		throw new Error(result.error);
 	};

-	const removeTitle = pagadorToRemove
-		? `Remover pagador "${pagadorToRemove.name}"?`
+	const removeTitle = payerToRemove
+		? `Remover pagador "${payerToRemove.name}"?`
 		: "Remover pagador?";

 	const handleJoinByCode = (event: React.FormEvent<HTMLFormElement>) => {
@@ -105,7 +102,7 @@ export function PagadoresPage({
 		}

 		startJoin(async () => {
-			const result = await joinPagadorByShareCodeAction({
+			const result = await joinPayerByShareCodeAction({
 				code: shareCodeInput.trim(),
 			});

@@ -124,7 +121,7 @@ export function PagadoresPage({
 		<>
 			<div className="flex flex-col gap-6 w-full">
 				<div className="flex flex-col gap-4 sm:flex-row sm:items-center sm:justify-between">
-					<PagadorDialog
+					<PayerDialog
 						mode="create"
 						avatarOptions={avatarOptions}
 						trigger={
@@ -151,7 +148,7 @@ export function PagadoresPage({
 					</form>
 				</div>

-				{orderedPagadores.length === 0 ? (
+				{orderedPayers.length === 0 ? (
 					<div className="flex min-h-[320px] items-center justify-center rounded-lg border border-dashed bg-muted/30">
 						<div className="max-w-sm text-center text-sm text-muted-foreground">
 							Cadastre seu primeiro pagador para organizar cobranças e
@@ -160,14 +157,14 @@ export function PagadoresPage({
 					</div>
 				) : (
 					<div className="grid gap-4 sm:grid-cols-2 xl:grid-cols-3 2xl:grid-cols-4">
-						{orderedPagadores.map((pagador) => (
-							<PagadorCard
-								key={pagador.id}
-								pagador={pagador}
-								onEdit={pagador.canEdit ? () => handleEdit(pagador) : undefined}
+						{orderedPayers.map((payer) => (
+							<PayerCard
+								key={payer.id}
+								payer={payer}
+								onEdit={payer.canEdit ? () => handleEdit(payer) : undefined}
 								onRemove={
-									pagador.canEdit && pagador.role !== PAGADOR_ROLE_ADMIN
-										? () => handleRemoveRequest(pagador)
+									payer.canEdit && payer.role !== PAYER_ROLE_ADMIN
+										? () => handleRemoveRequest(payer)
 										: undefined
 								}
 							/>
@@ -176,16 +173,16 @@ export function PagadoresPage({
 				)}
 			</div>

-			<PagadorDialog
+			<PayerDialog
 				mode="update"
-				pagador={selectedPagador ?? undefined}
+				payer={selectedPayer ?? undefined}
 				avatarOptions={avatarOptions}
-				open={editOpen && !!selectedPagador}
+				open={editOpen && !!selectedPayer}
 				onOpenChange={handleEditOpenChange}
 			/>

 			<ConfirmActionDialog
-				open={removeOpen && !!pagadorToRemove}
+				open={removeOpen && !!payerToRemove}
 				onOpenChange={handleRemoveOpenChange}
 				title={removeTitle}
 				description="Ao remover este pagador, os registros relacionados a ele deixarão de ser associados automaticamente."
--- a/src/features/payers/components/types.ts
+++ b/src/features/payers/components/types.ts
@@ -1,11 +1,11 @@
-import type { PagadorStatus } from "@/shared/lib/payers/constants";
+import type { PayerStatus } from "@/shared/lib/payers/constants";

-export type Pagador = {
+export type Payer = {
 	id: string;
 	name: string;
 	email: string | null;
 	avatarUrl: string | null;
-	status: PagadorStatus;
+	status: PayerStatus;
 	note: string | null;
 	role: string | null;
 	isAutoSend: boolean;
@@ -17,10 +17,10 @@ export type Pagador = {
 	shareCode?: string | null;
 };

-export type PagadorFormValues = {
+export type PayerFormValues = {
 	name: string;
 	email: string;
-	status: PagadorStatus;
+	status: PayerStatus;
 	avatarUrl: string;
 	note: string;
 	isAutoSend: boolean;
--- a/src/features/payers/detail-actions.ts
+++ b/src/features/payers/detail-actions.ts
@@ -4,22 +4,22 @@ import { and, desc, eq } from "drizzle-orm";
 import { revalidatePath } from "next/cache";
 import { Resend } from "resend";
 import { z } from "zod";
-import { lancamentos, pagadores } from "@/db/schema";
+import { payers, transactions } from "@/db/schema";
 import { getUser } from "@/shared/lib/auth/server";
 import { db } from "@/shared/lib/db";
 import { getResendFromEmail } from "@/shared/lib/email/resend";
 import {
 	fetchPagadorBoletoStats,
 	fetchPagadorCardUsage,
-	fetchPagadorHistory,
-	fetchPagadorMonthlyBreakdown,
+	fetchPayerHistory,
+	fetchPayerMonthlyBreakdown,
 } from "@/shared/lib/payers/details";
 import { formatCurrency } from "@/shared/utils/currency";
 import { formatDateTime } from "@/shared/utils/date";
 import { displayPeriod } from "@/shared/utils/period";

 const inputSchema = z.object({
-	pagadorId: z.string().uuid("Pagador inválido."),
+	payerId: z.string().uuid("Payer inválido."),
 	period: z
 		.string()
 		.regex(/^\d{4}-\d{2}$/, "Período inválido. Informe no formato AAAA-MM."),
@@ -78,12 +78,12 @@ type ParceladoItem = {
 type SummaryPayload = {
 	pagadorName: string;
 	periodLabel: string;
-	monthlyBreakdown: Awaited<ReturnType<typeof fetchPagadorMonthlyBreakdown>>;
-	historyData: Awaited<ReturnType<typeof fetchPagadorHistory>>;
+	monthlyBreakdown: Awaited<ReturnType<typeof fetchPayerMonthlyBreakdown>>;
+	historyData: Awaited<ReturnType<typeof fetchPayerHistory>>;
 	cardUsage: Awaited<ReturnType<typeof fetchPagadorCardUsage>>;
 	boletoStats: Awaited<ReturnType<typeof fetchPagadorBoletoStats>>;
 	boletos: BoletoItem[];
-	lancamentos: LancamentoRow[];
+	transactions: LancamentoRow[];
 	parcelados: ParceladoItem[];
 };

@@ -98,7 +98,7 @@ const buildSummaryHtml = ({
 	cardUsage,
 	boletoStats,
 	boletos,
-	lancamentos,
+	transactions,
 	parcelados,
 }: SummaryPayload) => {
 	// Calcular máximo de despesas para barras de progresso
@@ -173,9 +173,9 @@ const buildSummaryHtml = ({
 					.join("")
 			: `<tr><td colspan="3" style="padding:16px;text-align:center;color:#94a3b8;">Sem boletos neste período.</td></tr>`;

-	const lancamentoRows =
-		lancamentos.length > 0
-			? lancamentos
+	const transactionRows =
+		transactions.length > 0
+			? transactions
 					.map(
 						(item) => `
          <tr>
@@ -361,7 +361,7 @@ const buildSummaryHtml = ({
          <th style="text-align:right;padding:12px 14px;border-bottom:1px solid #e2e8f0;font-weight:600;color:#475569;">Valor</th>
        </tr>
      </thead>
-      <tbody>${lancamentoRows}</tbody>
+      <tbody>${transactionRows}</tbody>
    </table>

    <!-- Lançamentos Parcelados -->
@@ -392,19 +392,19 @@ const buildSummaryHtml = ({
  `;
 };

-export async function sendPagadorSummaryAction(
+export async function sendPayerSummaryAction(
 	input: z.infer<typeof inputSchema>,
 ): Promise<ActionResult> {
 	try {
-		const { pagadorId, period } = inputSchema.parse(input);
+		const { payerId, period } = inputSchema.parse(input);
 		const user = await getUser();

-		const pagadorRow = await db.query.pagadores.findFirst({
-			where: and(eq(pagadores.id, pagadorId), eq(pagadores.userId, user.id)),
+		const pagadorRow = await db.query.payers.findFirst({
+			where: and(eq(payers.id, payerId), eq(payers.userId, user.id)),
 		});

 		if (!pagadorRow) {
-			return { success: false, error: "Pagador não encontrado." };
+			return { success: false, error: "Payer não encontrado." };
 		}

 		if (!pagadorRow.email) {
@@ -432,83 +432,83 @@ export async function sendPagadorSummaryAction(
 			cardUsage,
 			boletoStats,
 			boletoRows,
-			lancamentoRows,
+			transactionRows,
 			parceladoRows,
 		] = await Promise.all([
-			fetchPagadorMonthlyBreakdown({
+			fetchPayerMonthlyBreakdown({
 				userId: user.id,
-				pagadorId,
+				payerId,
 				period,
 			}),
-			fetchPagadorHistory({
+			fetchPayerHistory({
 				userId: user.id,
-				pagadorId,
+				payerId,
 				period,
 			}),
 			fetchPagadorCardUsage({
 				userId: user.id,
-				pagadorId,
+				payerId,
 				period,
 			}),
 			fetchPagadorBoletoStats({
 				userId: user.id,
-				pagadorId,
+				payerId,
 				period,
 			}),
 			db
 				.select({
-					name: lancamentos.name,
-					amount: lancamentos.amount,
-					dueDate: lancamentos.dueDate,
+					name: transactions.name,
+					amount: transactions.amount,
+					dueDate: transactions.dueDate,
 				})
-				.from(lancamentos)
+				.from(transactions)
 				.where(
 					and(
-						eq(lancamentos.userId, user.id),
-						eq(lancamentos.pagadorId, pagadorId),
-						eq(lancamentos.period, period),
-						eq(lancamentos.paymentMethod, "Boleto"),
+						eq(transactions.userId, user.id),
+						eq(transactions.payerId, payerId),
+						eq(transactions.period, period),
+						eq(transactions.paymentMethod, "Boleto"),
 					),
 				)
-				.orderBy(desc(lancamentos.dueDate)),
+				.orderBy(desc(transactions.dueDate)),
 			db
 				.select({
-					id: lancamentos.id,
-					name: lancamentos.name,
-					paymentMethod: lancamentos.paymentMethod,
-					condition: lancamentos.condition,
-					amount: lancamentos.amount,
-					transactionType: lancamentos.transactionType,
-					purchaseDate: lancamentos.purchaseDate,
+					id: transactions.id,
+					name: transactions.name,
+					paymentMethod: transactions.paymentMethod,
+					condition: transactions.condition,
+					amount: transactions.amount,
+					transactionType: transactions.transactionType,
+					purchaseDate: transactions.purchaseDate,
 				})
-				.from(lancamentos)
+				.from(transactions)
 				.where(
 					and(
-						eq(lancamentos.userId, user.id),
-						eq(lancamentos.pagadorId, pagadorId),
-						eq(lancamentos.period, period),
+						eq(transactions.userId, user.id),
+						eq(transactions.payerId, payerId),
+						eq(transactions.period, period),
 					),
 				)
-				.orderBy(desc(lancamentos.purchaseDate)),
+				.orderBy(desc(transactions.purchaseDate)),
 			db
 				.select({
-					name: lancamentos.name,
-					amount: lancamentos.amount,
-					installmentCount: lancamentos.installmentCount,
-					currentInstallment: lancamentos.currentInstallment,
-					purchaseDate: lancamentos.purchaseDate,
+					name: transactions.name,
+					amount: transactions.amount,
+					installmentCount: transactions.installmentCount,
+					currentInstallment: transactions.currentInstallment,
+					purchaseDate: transactions.purchaseDate,
 				})
-				.from(lancamentos)
+				.from(transactions)
 				.where(
 					and(
-						eq(lancamentos.userId, user.id),
-						eq(lancamentos.pagadorId, pagadorId),
-						eq(lancamentos.period, period),
-						eq(lancamentos.condition, "Parcelado"),
-						eq(lancamentos.isAnticipated, false),
+						eq(transactions.userId, user.id),
+						eq(transactions.payerId, payerId),
+						eq(transactions.period, period),
+						eq(transactions.condition, "Parcelado"),
+						eq(transactions.isAnticipated, false),
 					),
 				)
-				.orderBy(desc(lancamentos.purchaseDate)),
+				.orderBy(desc(transactions.purchaseDate)),
 		]);

 		const normalizedBoletos: BoletoItem[] = (
@@ -524,7 +524,7 @@ export async function sendPagadorSummaryAction(
 		}));

 		const normalizedLancamentos: LancamentoRow[] = (
-			lancamentoRows as Array<{
+			transactionRows as Array<{
 				id: string;
 				name: string | null;
 				paymentMethod: string | null;
@@ -574,7 +574,7 @@ export async function sendPagadorSummaryAction(
 			cardUsage,
 			boletoStats,
 			boletos: normalizedBoletos,
-			lancamentos: normalizedLancamentos,
+			transactions: normalizedLancamentos,
 			parcelados: normalizedParcelados,
 		});

@@ -588,11 +588,9 @@ export async function sendPagadorSummaryAction(
 		const now = new Date();

 		await db
-			.update(pagadores)
+			.update(payers)
 			.set({ lastMailAt: now })
-			.where(
-				and(eq(pagadores.id, pagadorRow.id), eq(pagadores.userId, user.id)),
-			);
+			.where(and(eq(payers.id, pagadorRow.id), eq(payers.userId, user.id)));

 		revalidatePath(`/payers/${pagadorRow.id}`);

@@ -600,7 +598,7 @@ export async function sendPagadorSummaryAction(
 	} catch (error) {
 		// Log estruturado em desenvolvimento
 		if (process.env.NODE_ENV === "development") {
-			console.error("[sendPagadorSummaryAction]", error);
+			console.error("[sendPayerSummaryAction]", error);
 		}

 		// Tratar erros de validação separadamente
--- a/src/features/payers/detail-queries.ts
+++ b/src/features/payers/detail-queries.ts
@@ -1,11 +1,11 @@
 import { and, desc, eq, type SQL } from "drizzle-orm";
 import {
-	cartoes,
-	categorias,
-	compartilhamentosPagador,
-	contas,
-	lancamentos,
-	pagadores,
+	cards,
+	categories,
+	financialAccounts,
+	payerShares,
+	payers,
+	transactions,
 	user as usersTable,
 } from "@/db/schema";
 import { db } from "@/shared/lib/db";
@@ -18,23 +18,18 @@ export type ShareData = {
 	createdAt: string;
 };

-export async function fetchPagadorShares(
-	pagadorId: string,
-): Promise<ShareData[]> {
+export async function fetchPayerShares(payerId: string): Promise<ShareData[]> {
 	const shareRows = await db
 		.select({
-			id: compartilhamentosPagador.id,
-			sharedWithUserId: compartilhamentosPagador.sharedWithUserId,
-			createdAt: compartilhamentosPagador.createdAt,
+			id: payerShares.id,
+			sharedWithUserId: payerShares.sharedWithUserId,
+			createdAt: payerShares.createdAt,
 			userName: usersTable.name,
 			userEmail: usersTable.email,
 		})
-		.from(compartilhamentosPagador)
-		.innerJoin(
-			usersTable,
-			eq(compartilhamentosPagador.sharedWithUserId, usersTable.id),
-		)
-		.where(eq(compartilhamentosPagador.pagadorId, pagadorId));
+		.from(payerShares)
+		.innerJoin(usersTable, eq(payerShares.sharedWithUserId, usersTable.id))
+		.where(eq(payerShares.payerId, payerId));

 	return shareRows.map((share) => ({
 		id: share.id,
@@ -46,17 +41,17 @@ export async function fetchPagadorShares(
 }

 export async function fetchCurrentUserShare(
-	pagadorId: string,
+	payerId: string,
 	userId: string,
 ): Promise<{ id: string; createdAt: string } | null> {
-	const shareRow = await db.query.compartilhamentosPagador.findFirst({
+	const shareRow = await db.query.payerShares.findFirst({
 		columns: {
 			id: true,
 			createdAt: true,
 		},
 		where: and(
-			eq(compartilhamentosPagador.pagadorId, pagadorId),
-			eq(compartilhamentosPagador.sharedWithUserId, userId),
+			eq(payerShares.payerId, payerId),
+			eq(payerShares.sharedWithUserId, userId),
 		),
 	});

@@ -71,28 +66,31 @@ export async function fetchCurrentUserShare(
 }

 export async function fetchPagadorLancamentos(filters: SQL[]) {
-	const lancamentoRows = await db
+	const transactionRows = await db
 		.select({
-			lancamento: lancamentos,
-			pagador: pagadores,
-			conta: contas,
-			cartao: cartoes,
-			categoria: categorias,
+			transaction: transactions,
+			payer: payers,
+			financialAccount: financialAccounts,
+			card: cards,
+			category: categories,
 		})
-		.from(lancamentos)
-		.leftJoin(pagadores, eq(lancamentos.pagadorId, pagadores.id))
-		.leftJoin(contas, eq(lancamentos.contaId, contas.id))
-		.leftJoin(cartoes, eq(lancamentos.cartaoId, cartoes.id))
-		.leftJoin(categorias, eq(lancamentos.categoriaId, categorias.id))
+		.from(transactions)
+		.leftJoin(payers, eq(transactions.payerId, payers.id))
+		.leftJoin(
+			financialAccounts,
+			eq(transactions.accountId, financialAccounts.id),
+		)
+		.leftJoin(cards, eq(transactions.cardId, cards.id))
+		.leftJoin(categories, eq(transactions.categoryId, categories.id))
 		.where(and(...filters))
-		.orderBy(desc(lancamentos.purchaseDate), desc(lancamentos.createdAt));
+		.orderBy(desc(transactions.purchaseDate), desc(transactions.createdAt));

 	// Transformar resultado para o formato esperado
-	return lancamentoRows.map((row: Record<string, unknown>) => ({
-		...row.lancamento,
-		pagador: row.pagador,
-		conta: row.conta,
-		cartao: row.cartao,
-		categoria: row.categoria,
+	return transactionRows.map((row) => ({
+		...row.transaction,
+		payer: row.payer,
+		financialAccount: row.financialAccount,
+		card: row.card,
+		category: row.category,
 	}));
 }
--- a/src/features/payers/lib/avatar-options.ts
+++ b/src/features/payers/lib/avatar-options.ts
@@ -1,6 +1,6 @@
 import { readdir } from "node:fs/promises";
 import path from "node:path";
-import { DEFAULT_PAGADOR_AVATAR } from "@/shared/lib/payers/constants";
+import { DEFAULT_PAYER_AVATAR } from "@/shared/lib/payers/constants";

 const AVATAR_DIRECTORY = path.join(process.cwd(), "public", "avatars");
 const AVATAR_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".svg", ".webp"]);
@@ -20,11 +20,11 @@ export async function loadAvatarOptions() {
 			.sort((a, b) => a.localeCompare(b, "pt-BR", { sensitivity: "base" }));

 		if (items.length === 0) {
-			items.push(DEFAULT_PAGADOR_AVATAR);
+			items.push(DEFAULT_PAYER_AVATAR);
 		}

 		return Array.from(new Set(items));
 	} catch {
-		return [DEFAULT_PAGADOR_AVATAR];
+		return [DEFAULT_PAYER_AVATAR];
 	}
 }
--- a/src/features/payers/lib/build-readonly-option-sets.ts
+++ b/src/features/payers/lib/build-readonly-option-sets.ts
@@ -1,9 +1,9 @@
-import type { pagadores } from "@/db/schema";
+import type { payers } from "@/db/schema";
 import type {
-	ContaCartaoFilterOption,
-	LancamentoFilterOption,
-	LancamentoItem,
+	AccountCardFilterOption,
+	TransactionFilterOption,
 	SelectOption,
+	TransactionItem,
 } from "@/features/transactions/components/types";
 import type { buildOptionSets } from "@/features/transactions/page-helpers";

@@ -15,15 +15,15 @@ const normalizeOptionLabel = (
 ) => (value?.trim().length ? value.trim() : fallback);

 export function buildReadOnlyOptionSets(
-	items: LancamentoItem[],
-	pagador: typeof pagadores.$inferSelect,
+	items: TransactionItem[],
+	payer: typeof payers.$inferSelect,
 ): OptionSet {
-	const pagadorLabel = normalizeOptionLabel(pagador.name, "Pagador");
-	const pagadorOptions: SelectOption[] = [
+	const pagadorLabel = normalizeOptionLabel(payer.name, "Payer");
+	const payerOptions: SelectOption[] = [
 		{
-			value: pagador.id,
+			value: payer.id,
 			label: pagadorLabel,
-			slug: pagador.id,
+			slug: payer.id,
 		},
 	];

@@ -32,51 +32,54 @@ export function buildReadOnlyOptionSets(
 	const categoriaOptionsMap = new Map<string, SelectOption>();

 	items.forEach((item) => {
-		if (item.contaId && !contaOptionsMap.has(item.contaId)) {
-			contaOptionsMap.set(item.contaId, {
-				value: item.contaId,
-				label: normalizeOptionLabel(item.contaName, "Conta sem nome"),
-				slug: item.contaId,
+		if (item.accountId && !contaOptionsMap.has(item.accountId)) {
+			contaOptionsMap.set(item.accountId, {
+				value: item.accountId,
+				label: normalizeOptionLabel(
+					item.contaName,
+					"FinancialAccount sem nome",
+				),
+				slug: item.accountId,
 			});
 		}
-		if (item.cartaoId && !cartaoOptionsMap.has(item.cartaoId)) {
-			cartaoOptionsMap.set(item.cartaoId, {
-				value: item.cartaoId,
+		if (item.cardId && !cartaoOptionsMap.has(item.cardId)) {
+			cartaoOptionsMap.set(item.cardId, {
+				value: item.cardId,
 				label: normalizeOptionLabel(item.cartaoName, "Cartão sem nome"),
-				slug: item.cartaoId,
+				slug: item.cardId,
 			});
 		}
-		if (item.categoriaId && !categoriaOptionsMap.has(item.categoriaId)) {
-			categoriaOptionsMap.set(item.categoriaId, {
-				value: item.categoriaId,
-				label: normalizeOptionLabel(item.categoriaName, "Categoria"),
-				slug: item.categoriaId,
+		if (item.categoryId && !categoriaOptionsMap.has(item.categoryId)) {
+			categoriaOptionsMap.set(item.categoryId, {
+				value: item.categoryId,
+				label: normalizeOptionLabel(item.categoriaName, "Category"),
+				slug: item.categoryId,
 			});
 		}
 	});

-	const contaOptions = Array.from(contaOptionsMap.values());
-	const cartaoOptions = Array.from(cartaoOptionsMap.values());
-	const categoriaOptions = Array.from(categoriaOptionsMap.values());
+	const accountOptions = Array.from(contaOptionsMap.values());
+	const cardOptions = Array.from(cartaoOptionsMap.values());
+	const categoryOptions = Array.from(categoriaOptionsMap.values());

-	const pagadorFilterOptions: LancamentoFilterOption[] = [
-		{ slug: pagador.id, label: pagadorLabel },
+	const payerFilterOptions: TransactionFilterOption[] = [
+		{ slug: payer.id, label: pagadorLabel },
 	];

-	const categoriaFilterOptions: LancamentoFilterOption[] = categoriaOptions.map(
+	const categoryFilterOptions: TransactionFilterOption[] = categoryOptions.map(
 		(option) => ({
 			slug: option.value,
 			label: option.label,
 		}),
 	);

-	const contaCartaoFilterOptions: ContaCartaoFilterOption[] = [
-		...contaOptions.map((option) => ({
+	const accountCardFilterOptions: AccountCardFilterOption[] = [
+		...accountOptions.map((option) => ({
 			slug: option.value,
 			label: option.label,
 			kind: "conta" as const,
 		})),
-		...cartaoOptions.map((option) => ({
+		...cardOptions.map((option) => ({
 			slug: option.value,
 			label: option.label,
 			kind: "cartao" as const,
@@ -84,14 +87,14 @@ export function buildReadOnlyOptionSets(
 	];

 	return {
-		pagadorOptions,
-		splitPagadorOptions: [],
-		defaultPagadorId: pagador.id,
-		contaOptions,
-		cartaoOptions,
-		categoriaOptions,
-		pagadorFilterOptions,
-		categoriaFilterOptions,
-		contaCartaoFilterOptions,
+		payerOptions,
+		splitPayerOptions: [],
+		defaultPayerId: payer.id,
+		accountOptions,
+		cardOptions,
+		categoryOptions,
+		payerFilterOptions,
+		categoryFilterOptions,
+		accountCardFilterOptions,
 	};
 }
--- a/src/features/payers/queries.ts
+++ b/src/features/payers/queries.ts
@@ -2,21 +2,21 @@ import { eq } from "drizzle-orm";
 import { user } from "@/db/schema";
 import { loadAvatarOptions } from "@/features/payers/lib/avatar-options";
 import { db } from "@/shared/lib/db";
-import { fetchPagadoresWithAccess } from "@/shared/lib/payers/access";
-import type { PagadorStatus } from "@/shared/lib/payers/constants";
+import { fetchPayersWithAccess } from "@/shared/lib/payers/access";
+import type { PayerStatus } from "@/shared/lib/payers/constants";
 import {
-	PAGADOR_ROLE_ADMIN,
-	PAGADOR_STATUS_OPTIONS,
+	PAYER_ROLE_ADMIN,
+	PAYER_STATUS_OPTIONS,
 } from "@/shared/lib/payers/constants";

-export type PagadorData = {
+export type PayerData = {
 	id: string;
 	name: string;
 	email: string | null;
 	avatarUrl: string | null;
-	status: PagadorStatus;
+	status: PayerStatus;
 	note: string | null;
-	role: string;
+	role: string | null;
 	isAutoSend: boolean;
 	createdAt: string;
 	canEdit: boolean;
@@ -26,19 +26,19 @@ export type PagadorData = {
 	shareCode: string | null;
 };

-const resolveStatus = (status: string | null): PagadorStatus => {
+const resolveStatus = (status: string | null): PayerStatus => {
 	const normalized = status?.trim() ?? "";
-	const found = PAGADOR_STATUS_OPTIONS.find(
+	const found = PAYER_STATUS_OPTIONS.find(
 		(option) => option.toLowerCase() === normalized.toLowerCase(),
 	);
-	return found ?? PAGADOR_STATUS_OPTIONS[0];
+	return found ?? PAYER_STATUS_OPTIONS[0];
 };

-export async function fetchPagadoresForUser(
+export async function fetchPayersForUser(
 	userId: string,
-): Promise<{ pagadores: PagadorData[]; avatarOptions: string[] }> {
-	const [pagadorRows, localAvatarOptions, userData] = await Promise.all([
-		fetchPagadoresWithAccess(userId),
+): Promise<{ payers: PayerData[]; avatarOptions: string[] }> {
+	const [payerRows, localAvatarOptions, userData] = await Promise.all([
+		fetchPayersWithAccess(userId),
 		loadAvatarOptions(),
 		db.query.user.findFirst({
 			columns: { image: true },
@@ -51,7 +51,7 @@ export async function fetchPagadoresForUser(
 		? [userImage, ...localAvatarOptions]
 		: localAvatarOptions;

-	const pagadores = pagadorRows
+	const payers = payerRows
 		.map((pagador) => ({
 			id: pagador.id,
 			name: pagador.name,
@@ -69,12 +69,10 @@ export async function fetchPagadoresForUser(
 			shareCode: pagador.canEdit ? (pagador.shareCode ?? null) : null,
 		}))
 		.sort((a, b) => {
-			if (a.role === PAGADOR_ROLE_ADMIN && b.role !== PAGADOR_ROLE_ADMIN)
-				return -1;
-			if (a.role !== PAGADOR_ROLE_ADMIN && b.role === PAGADOR_ROLE_ADMIN)
-				return 1;
+			if (a.role === PAYER_ROLE_ADMIN && b.role !== PAYER_ROLE_ADMIN) return -1;
+			if (a.role !== PAYER_ROLE_ADMIN && b.role === PAYER_ROLE_ADMIN) return 1;
 			return 0;
 		});

-	return { pagadores, avatarOptions };
+	return { payers, avatarOptions };
 }