Lead
Ruta /pimia/leads/[leadId] · componentes, campos y acciones del checkout documentado.
Ruta y puntos de edición
Ruta: /pimia/leads/[leadId]. 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
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/[leadId]/page.tsx |
| Adaptador Next.js | src/host/screens/PimiaLeadScreens.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaLeadScreen.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaAmountCell.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaStates.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/PimiaLeadActions.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaLeadStage.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaStatusBadge.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaEstimateList.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaLeadTasks.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaLeadNotes.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaLeadActivity.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaLeadClosingEstimate.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/PimiaSortableHead.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaEstimateDocument.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaEstimateActions.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaAssigneeField.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaDocumentParts.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaEstimateRejectDialog.tsx |
| Vista o componente asociado | src/features/pimia/ui/PimiaEstimateSendDialog.tsx |
PimiaLeadScreen
Fuente: src/features/pimia/ui/PimiaLeadScreen.tsx.
Acciones
| Rótulo literal | Handler o envío | Deshabilitado cuando | Línea |
|---|---|---|---|
| Leads | () => void goPimiaPath("/pimia/leads") | No declarado en este nodo | 413 |
| Nuevo presupuesto | () => void goPimiaPath( `/pimia/presupuestos/nuevo?lead=${encodeURIComponent(lead.id)}`, ) | No declarado en este nodo | 478 |
| Rótulo dinámico / icono | () => void goPimiaCustomer(lead.convertedToCustomerId as string) | No declarado en este nodo | 693 |
| Rótulo dinámico / icono | () => void goPimiaCustomer(lead.customerId as string) | No declarado en este nodo | 716 |
| Volver a leads | () => void goPimiaPath("/pimia/leads") | No declarado en este nodo | 734 |
Estados reutilizados
-
PimiaNotConnected -
PimiaErrorState -
PimiaRowsSkeleton -
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.
text-sm, text-foreground, gap-4, text-2xs, text-muted-foreground, text-right, text-xs, text-warning, gap-2, lg:grid-cols-3, p-4, overflow-hidden, gap-1, bg-muted, gap-1.5, gap-2.5, bg-warning/5, p-3, bg-success/5, text-success.
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.
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.
PimiaEstimateList
Fuente: src/features/pimia/ui/PimiaEstimateList.tsx.
Columnas declaradas
- Destinatario
- Acciones
Acciones
| Rótulo literal | Handler o envío | Deshabilitado cuando | Línea |
|---|---|---|---|
| Rótulo dinámico / icono | () => onOpen(estimate.id) | No declarado en este nodo | 276 |
| Ver el presupuesto | () => onOpen(estimate.id) | No declarado en este nodo | 401 |
| Ver el cliente | () => onOpenCustomer(customerId) | No declarado en este nodo | 407 |
| Copiar el número | () => { void navigator.clipboard?.writeText(estimate.estimateNumber); } | No declarado en este nodo | 412 |
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-foreground, gap-2, text-muted-foreground, text-right, text-xs.
PimiaLeadTasks
Fuente: src/features/pimia/ui/PimiaLeadTasks.tsx.
Acciones
| Rótulo literal | Handler o envío | Deshabilitado cuando | Línea |
|---|---|---|---|
| Abrir Tareas | () => void goPimiaPath(tasksPath) | No declarado en este nodo | 173 |
| Ver las de este lead | () => void goPimiaPath(tasksPath) | No declarado en este nodo | 200 |
Estados reutilizados
-
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-x-4, gap-y-2, gap-y-1, text-xs, text-muted-foreground, gap-1.5, overflow-hidden, gap-2.
PimiaLeadNotes
Fuente: src/features/pimia/ui/PimiaLeadNotes.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 |
|---|---|---|---|---|
| Nueva nota | Textarea | draft | disabled=createNote.isPending | 97 |
Acciones
| Rótulo literal | Handler o envío | Deshabilitado cuando | Línea |
|---|---|---|---|
| Añadir nota | () => void handleAdd() | trimmed === "" || createNote.isPending | 111 |
Estados reutilizados
-
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.
p-3, text-sm, text-destructive, p-4, text-foreground, text-muted-foreground, text-xs.
PimiaLeadActivity
Fuente: src/features/pimia/ui/PimiaLeadActivity.tsx.
Estados reutilizados
-
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.
p-4, gap-3, bg-background, bg-muted-foreground, bg-border, text-sm, text-foreground, text-xs, text-muted-foreground.
PimiaLeadClosingEstimate
Fuente: src/features/pimia/ui/PimiaLeadClosingEstimate.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 | closingId ?? NONE | disabled=setClosing.isPending | 157 |
Acciones
| Rótulo literal | Handler o envío | Deshabilitado cuando | Línea |
|---|---|---|---|
| Desvincular | () => void apply(null) | setClosing.isPending | 137 |
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-4, text-sm, text-foreground, text-xs, text-muted-foreground.
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 |
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.
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 |
PimiaEstimateDocument
Fuente: src/features/pimia/ui/PimiaEstimateDocument.tsx.
Columnas declaradas
- Concepto
- Importe
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-base, text-foreground, text-muted-foreground, gap-x-6, gap-y-2, text-2xs, text-lg, text-2xl, grid-cols-1, gap-5, sm:grid-cols-3, bg-primary, gap-7, xl:grid-cols-2, overflow-x-auto, text-left, text-sm, gap-2, sm:text-right.
PimiaEstimateActions
Fuente: src/features/pimia/ui/PimiaEstimateActions.tsx.
Acciones
| Rótulo literal | Handler o envío | Deshabilitado cuando | Línea |
|---|---|---|---|
| Rótulo dinámico / icono | () => { if (primary === "send") { setIsSendOpen(true); } else if (primary === "convert") { requestConvert(); } else if (primary === "clone") { setConfirmation("clone"); } else { void handleStatus(primary); } } | isBusy | 311 |
| `Acciones de ${estimate.estimateNumber}` | delegado al contenedor | isBusy | 355 |
| Editar | () => void goPimiaPath( `/pimia/presupuestos/${encodeURIComponent(estimate.id)}/editar`, ) | No declarado en este nodo | 379 |
| Rótulo dinámico / icono | () => setIsSendOpen(true) | No declarado en este nodo | 390 |
| Rótulo dinámico / icono | () => { if (status === "REJECTED") { setIsRejectOpen(true); return; } void handleStatus(status); } | No declarado en este nodo | 401 |
| Duplicar | () => setConfirmation("clone") | No declarado en este nodo | 422 |
| Convertir en factura | requestConvert | No declarado en este nodo | 426 |
| Descargar el PDF | () => void handlePdf() | No declarado en este nodo | 437 |
| Copiar el enlace para el cliente | () => void handleCopyLink() | No declarado en este nodo | 450 |
| Duplicar | () => void handleClone() | No declarado en este nodo | 484 |
| Convertir en factura | () => void handleConvert() | No declarado en este nodo | 507 |
| Volver a conectar | () => { setConfirmation(null); setIsReconnectOpen(true); } | No declarado en este nodo | 528 |
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.
PimiaEstimateRejectDialog
Fuente: src/features/pimia/ui/PimiaEstimateRejectDialog.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 |
|---|---|---|---|---|
| Motivo (opcional) | textarea | reason | No declaradas en este nodo | 129 |
Acciones
| Rótulo literal | Handler o envío | Deshabilitado cuando | Línea |
|---|---|---|---|
| Cancelar | () => onOpenChange(false) | No declarado en este nodo | 155 |
| Marcar como rechazado | submit del formulario | changeStatus.isPending | 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.
gap-1.5, text-2xs, text-muted-foreground, bg-background, text-sm, text-foreground, text-xs, text-destructive.
PimiaEstimateSendDialog
Fuente: src/features/pimia/ui/PimiaEstimateSendDialog.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 |
|---|---|---|---|---|
| Para | Input | to | type=email | 309 |
| Asunto | Input | subject | No declaradas en este nodo | 331 |
| Mensaje | textarea | body | No declaradas en este nodo | 343 |
Acciones
| Rótulo literal | Handler o envío | Deshabilitado cuando | Línea |
|---|---|---|---|
| Cancelar | () => onOpenChange(false) | No declarado en este nodo | 371 |
| Enviar | submit del formulario | !canSend | 378 |
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.5, bg-destructive/10, text-sm, text-foreground, text-destructive, bg-muted/40, text-muted-foreground, gap-1.5, text-2xs, text-xs, bg-background.
Hooks, adaptadores y utilidades relacionados
-
src/features/pimia/api/auth.ts -
src/features/pimia/api/company.ts -
src/features/pimia/api/estimateSharedLink.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/tasks.ts -
src/features/pimia/api/team.ts -
src/features/pimia/hooks/usePimiaAuth.ts -
src/features/pimia/hooks/usePimiaCorreo.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/documentActivity.ts -
src/features/pimia/lib/documentSeries.ts -
src/features/pimia/lib/estimates.ts -
src/features/pimia/lib/leadForm.ts -
src/features/pimia/lib/leads.ts -
src/features/pimia/lib/mailConfig.ts -
src/features/pimia/lib/missingRecord.ts -
src/features/pimia/lib/money.ts -
src/features/pimia/lib/pdfPropio.ts -
src/features/pimia/lib/scopeDenial.ts -
src/features/pimia/lib/tasks.ts -
src/features/pimia/lib/taxes.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.