Leads

Ruta y puntos de edición

Ruta: /pimia/leads. Revisión: 2aec1b16cc01.

Esta ficha procede de lectura estática del código. Los componentes asociados pueden incluir diálogos cerrados y bloques condicionales. Las expresiones dinámicas se conservan como código; no equivalen a campos siempre visibles ni a permisos concedidos.

Vista en el tenant de referencia

Leads en Pimia

Captura de escritorio del tenant de demostración Reformas Vera, S.L., tomada el 10 de septiembre de 2026. Los datos ilustran la composición de la pantalla y pueden cambiar.

Capa	Archivo relativo al repositorio
Ruta	`src/app/pimia/leads/page.tsx`
Adaptador Next.js	`src/host/screens/PimiaLeadScreens.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaLeadsScreen.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaStates.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaLeadActions.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaScreenShell.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaPageHeader.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaStatCards.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaStatusTabs.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaFilterBar.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaLeadBoard.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaTablePanel.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaLeadList.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaLeadDialog.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaConnectDialog.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaLeadStage.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaSortableHead.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaAmountCell.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaAssigneeField.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaStatusBadge.tsx`

PimiaLeadsScreen

Fuente: src/features/pimia/ui/PimiaLeadsScreen.tsx.

Campos y controles

La columna «Reglas JSX» recoge propiedades explícitas; la validación adicional vive en los helpers y en el servidor. El enlace de estado indica dónde se lee el valor.

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
Sin etiqueta literal resoluble	`Select`	`String(limit)`	`No declaradas en este nodo`	640

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Nuevo lead	`() => { setEditing(null); setIsCreateOpen(true); }`	`No declarado en este nodo`	284
Rótulo dinámico / icono	`() => onChange(mode)`	`No declarado en este nodo`	539
Traer hasta	`() => onLimitChange(nextLimit)`	`isBusy`	630

Estados reutilizados

PimiaNotConnected
PimiaRowsSkeleton
PimiaErrorState
PimiaEmpty

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

gap-2, text-xs, text-muted-foreground, gap-1, p-0.5, gap-3, bg-background.

PimiaStates

Fuente: src/features/pimia/ui/PimiaStates.tsx.

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Conectar una empresa	`() => setIsConnectOpen(true)`	`No declarado en este nodo`	99
Rótulo dinámico / icono	`() => void goPimiaPath(notFound.listPath)`	`No declarado en este nodo`	233
Rótulo dinámico / icono	`delegado al contenedor`	`No declarado en este nodo`	247
Rótulo dinámico / icono	`() => void goPimiaPath( closedDoor.action?.kind === "plan" ? PLAN_PATH : MODULES_SETTINGS_PATH, )`	`No declarado en este nodo`	257
Volver a conectar	`() => setIsConnectOpen(true)`	`No declarado en este nodo`	273
Reintentar	`onRetry`	`No declarado en este nodo`	279

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

gap-4, p-8, text-center, text-base, text-foreground, text-sm, text-muted-foreground, gap-2, overflow-hidden, bg-muted/40.

PimiaLeadActions

Fuente: src/features/pimia/ui/PimiaLeadActions.tsx.

Campos y controles

La columna «Reglas JSX» recoge propiedades explícitas; la validación adicional vive en los helpers y en el servidor. El enlace de estado indica dónde se lee el valor.

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
Texto de la nota	`Textarea`	`noteText`	`No declaradas en este nodo`	497

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Rótulo dinámico / icono	`() => void handleStage(stage)`	`isCurrent`	283
Mover a « »	`() => void handleStage(primaryStage)`	`isBusy`	309
`Acciones de ${lead.title}`	`delegado al contenedor`	`isBusy`	332
Ver el lead	`() => { if (onOpen) { onOpen(lead.id); } else { void goPimiaLead(lead.id); } }`	`No declarado en este nodo`	350
Editar	`() => onEdit(lead)`	`No declarado en este nodo`	372
Añadir nota	`() => setIsNoteOpen(true)`	`No declarado en este nodo`	390
Rótulo dinámico / icono	`() => { void goPimiaCustomer(lead.convertedToCustomerId as string); }`	`No declarado en este nodo`	403
Eliminar	`() => setIsConfirmingDelete(true)`	`No declarado en este nodo`	417
Eliminar	`() => void handleDelete()`	`No declarado en este nodo`	462
Cancelar	`() => setIsNoteOpen(false)`	`No declarado en este nodo`	513
Guardar la nota	`submit del formulario`	`addNote.isPending`	520

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

text-xs, text-muted-foreground, gap-1.5, text-sm, text-destructive.

PimiaFilterBar

Fuente: src/features/pimia/ui/PimiaFilterBar.tsx.

Campos y controles

La columna «Reglas JSX» recoge propiedades explícitas; la validación adicional vive en los helpers y en el servidor. El enlace de estado indica dónde se lee el valor.

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
searchLabel ?? searchPlaceholder	`Input`	`searchValue ?? ""`	`No declaradas en este nodo`	56

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

text-muted-foreground, gap-2.

PimiaLeadBoard

Fuente: src/features/pimia/ui/PimiaLeadBoard.tsx.

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Rótulo dinámico / icono	`() => onOpen(lead.id)`	`No declarado en este nodo`	246

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

gap-4, overflow-x-auto, overflow-y-hidden, gap-2, text-sm, text-foreground, text-xs, text-muted-foreground, overflow-y-auto, p-2, gap-1, text-left.

PimiaLeadList

Fuente: src/features/pimia/ui/PimiaLeadList.tsx.

Columnas declaradas

Contacto
Etapa
Probabilidad
Asignado
Acciones

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Rótulo dinámico / icono	`() => onOpen(lead.id)`	`No declarado en este nodo`	177

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

hover:bg-transparent, text-left, text-foreground, text-xs, text-muted-foreground, text-right.

PimiaLeadDialog

Fuente: src/features/pimia/ui/PimiaLeadDialog.tsx.

Campos y controles

La columna «Reglas JSX» recoge propiedades explícitas; la validación adicional vive en los helpers y en el servidor. El enlace de estado indica dónde se lee el valor.

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
Título de la oportunidad	`Input`	`form.title`	`No declaradas en este nodo`	331
Persona de contacto	`Input`	`form.personName`	`No declaradas en este nodo`	349
Organización	`Input`	`form.organizationName`	`No declaradas en este nodo`	358
Email	`Input`	`form.email`	`type=email`	379
Teléfono	`Input`	`form.phone`	`No declaradas en este nodo`	418
Sin etiqueta literal resoluble	`Select`	`form.stage`	`No declaradas en este nodo`	430
Probabilidad (%, opcional)	`Input`	`form.probability`	`No declaradas en este nodo`	468
Valor esperado (€)	`Input`	`form.expectedAmountCents`	`No declaradas en este nodo`	510
Cierre previsto	`Input`	`form.expectedCloseDate`	`type=date`	533
Origen	`Input`	`form.source`	`No declaradas en este nodo`	554
Tipo	`Input`	`form.leadType`	`No declaradas en este nodo`	571
Etiquetas	`Input`	`pendingTag`	`No declaradas en este nodo`	590
Descripción	`Textarea`	`form.description`	`No declaradas en este nodo`	665

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Añadir	`commitTag`	`pendingTag.trim() === ""`	604
`Quitar la etiqueta «${tag}»`	`() => set( "tags", form.tags.filter((current) => current !== tag), )`	`No declarado en este nodo`	621
Cancelar	`() => onOpenChange(false)`	`No declarado en este nodo`	686
Rótulo dinámico / icono	`submit del formulario`	`isSaving`	696

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

overflow-y-auto, text-xs, text-destructive, gap-4, sm:grid-cols-2, text-muted-foreground, gap-2, gap-1.5, gap-1, bg-muted, hover:text-foreground, text-sm.

PimiaConnectDialog

Fuente: src/features/pimia/ui/PimiaConnectDialog.tsx.

Campos y controles

La columna «Reglas JSX» recoge propiedades explícitas; la validación adicional vive en los helpers y en el servidor. El enlace de estado indica dónde se lee el valor.

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
Tu empresa	`Input`	`baseUrl`	`disabled=connect.isPending`	114

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Cancelar	`() => handleOpenChange(false)`	`No declarado en este nodo`	155
Rótulo dinámico / icono	`submit del formulario`	`!canSubmit`	162

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

text-sm, text-foreground, gap-2, text-muted-foreground, text-xs, text-destructive.

PimiaLeadStage

Fuente: src/features/pimia/ui/PimiaLeadStage.tsx.

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Rótulo dinámico / icono	`() => onSelect(candidate)`	`isCurrent \|\| isBusy`	265

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

overflow-hidden, bg-muted, text-sm, text-foreground, grid-cols-2, gap-2, sm:grid-cols-3, lg:grid-cols-6, text-xs, text-muted-foreground.

PimiaSortableHead

Fuente: src/features/pimia/ui/PimiaSortableHead.tsx.

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Rótulo dinámico / icono	`() => onSortChange({ direction: isActive && sort.direction === "desc" ? "asc" : ("desc" as const), field, })`	`No declarado en este nodo`	61

PimiaAssigneeField

Fuente: src/features/pimia/ui/PimiaAssigneeField.tsx.

Campos y controles

La columna «Reglas JSX» recoge propiedades explícitas; la validación adicional vive en los helpers y en el servidor. El enlace de estado indica dónde se lee el valor.

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
Sin etiqueta literal resoluble	`Select`	`assignedUserId === null ? SIN_NADIE : String(assignedUserId)`	`No declaradas en este nodo`	161

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Asignármelo a mí	`() => onChange(currentUserId, currentUserName)`	`No declarado en este nodo`	137
Dejarlo sin responsable	`() => onChange(null, null)`	`No declarado en este nodo`	148

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

p-3, text-sm, text-foreground, gap-2, text-muted-foreground, text-xs.

Hooks, adaptadores y utilidades relacionados

src/features/pimia/api/auth.ts
src/features/pimia/api/estimates.ts
src/features/pimia/api/invoices.ts
src/features/pimia/api/leads.ts
src/features/pimia/api/pimiaClient.ts
src/features/pimia/api/team.ts
src/features/pimia/hooks/usePimiaAuth.ts
src/features/pimia/hooks/usePimiaEquipo.ts
src/features/pimia/hooks/usePimiaLeads.ts
src/features/pimia/hooks/usePimiaResources.ts
src/features/pimia/hooks/usePimiaTiempos.ts
src/features/pimia/lib/calendar.ts
src/features/pimia/lib/closedDoors.ts
src/features/pimia/lib/leadBoard.ts
src/features/pimia/lib/leadForm.ts
src/features/pimia/lib/leads.ts
src/features/pimia/lib/missingRecord.ts
src/features/pimia/lib/money.ts
src/features/pimia/lib/scopeDenial.ts
src/features/pimia/lib/team.ts

Antes de entregar un retoque

Revisa los archivos de formulario y sus helpers antes de cambiar tipos, obligatoriedad o valores iniciales.
Prueba carga, error, vacío, permisos insuficientes y guardado pendiente en las variantes que usa esta pantalla.
Comprueba escritorio, móvil, teclado, tema oscuro y scroll con suficientes filas.
Conserva los handlers y la invalidación de datos al modificar la presentación.

En esta página