Almacén

Ruta y puntos de edición

Ruta: /pimia/almacen. 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

Almacén 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/almacen/page.tsx`
Adaptador Next.js	`src/host/screens/PimiaItemScreens.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaAlmacenScreen.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/PimiaFilterBar.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaTablePanel.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaPagination.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaWarehousesPanel.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaStockCountsPanel.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaItemMovementsSheet.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaConnectDialog.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaWarehouseDialog.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaStockAdjustmentDialog.tsx`

PimiaAlmacenScreen

Fuente: src/features/pimia/ui/PimiaAlmacenScreen.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`	`reason`	`No declaradas en este nodo`	179
Sin etiqueta literal resoluble	`Select`	`warehouse`	`No declaradas en este nodo`	202
Desde	`Input`	`fromDate`	`type=date`	228
Hasta	`Input`	`toDate`	`type=date`	240

Columnas declaradas

Fecha
Artículo
Motivo
Cantidad
Saldo del artículo

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Rótulo dinámico / icono	`() => setDrill({ id: movement.itemId ?? 0, name: movement.itemName ?? "", })`	`No declarado en este nodo`	313
Rótulo dinámico / icono	`() => void goPimiaPath(documento.path)`	`No declarado en este nodo`	357

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.

overflow-x-auto, overflow-y-hidden, bg-muted/40, text-sm, text-muted-foreground, text-foreground, gap-1.5, text-right, p-0, text-xs.

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.

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.

PimiaPagination

Fuente: src/features/pimia/ui/PimiaPagination.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(pageSize)`	`No declaradas en este nodo`	82

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Anterior	`() => onPageChange(Math.max(1, page - 1))`	`page <= 1 \|\| isBusy`	104
Siguiente	`() => onPageChange(page + 1)`	`page >= lastPage \|\| isBusy`	115

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-3, text-xs, text-muted-foreground, gap-2.

PimiaWarehousesPanel

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

Columnas declaradas

Almacén
Código
Dirección
Acciones
Artículo
Existencias aquí
Comprometido (del artículo)

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Nuevo almacén	`abrirAlta`	`!query.isSuccess`	100
Rótulo dinámico / icono	`() => setVerExistencias( verExistencias === warehouse.id ? null : warehouse.id, )`	`No declarado en este nodo`	176
Editar	`() => abrirEdicion(warehouse)`	`No declarado en este nodo`	191
Borrar	`() => void pedirBorrado(warehouse)`	`impedimento !== null \|\| borrar.isPending`	198

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-2, text-sm, text-muted-foreground, text-foreground, bg-destructive/5, text-destructive, text-right, gap-1, text-xs.

PimiaStockCountsPanel

Fuente: src/features/pimia/ui/PimiaStockCountsPanel.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`	`almacenNuevo`	`No declaradas en este nodo`	93

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Contar el almacén	`() => void abrirRecuento()`	`!query.isSuccess \|\| crear.isPending`	114
Rótulo dinámico / icono	() => void goPimiaPath( `/pimia/almacen/recuentos/${recuento.id}`, )	`No declarado en este nodo`	169
Rótulo dinámico / icono	() => void goPimiaPath(`/pimia/almacen/recuentos/${recuento.id}`)	`No declarado en este nodo`	203

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-3, text-sm, text-muted-foreground, gap-2, gap-1.5, bg-destructive/5, text-destructive, p-0, text-xs.

PimiaItemMovementsSheet

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

Columnas declaradas

Fecha
Motivo
Cantidad
Saldo

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Rótulo dinámico / icono	`() => { onClose(); goPimiaPath(destino.path); }`	`No declarado en este nodo`	237
Ajustar existencias	`() => setAjusteAbierto(true)`	`No declarado en este nodo`	270
Rótulo dinámico / icono	`() => void goPimiaPath(documento.path)`	`No declarado en este nodo`	340

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.

overflow-y-auto, bg-muted/40, text-xs, text-foreground, gap-4, text-sm, text-muted-foreground, text-destructive, hover:text-foreground, overflow-x-auto, text-right, p-0.

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.

PimiaWarehouseDialog

Fuente: src/features/pimia/ui/PimiaWarehouseDialog.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
Nombre	`Input`	`draft.name`	`maxLength=191`	123
Código (opcional)	`Input`	`draft.code`	`maxLength=32`	138
Dirección (opcional)	`Input`	`draft.address`	`maxLength=255`	155
Almacén por defecto	`Checkbox`	`draft.isDefault`	`disabled=esDefecto`	168
Activo	`Checkbox`	`draft.isActive`	`disabled=esDefecto`	191

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Cancelar	`() => onOpenChange(false)`	`No declarado en este nodo`	218
Rótulo dinámico / icono	`submit del formulario`	`guardando`	225

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
Cantidad	`Input`	`draft.quantity`	`No declaradas en este nodo`	138
Sin etiqueta literal resoluble	`Select`	`warehouseId`	`No declaradas en este nodo`	164
Motivo	`Input`	`draft.note`	`maxLength=255`	190

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Cancelar	`() => onOpenChange(false)`	`No declarado en este nodo`	211
Ajustar	`submit del formulario`	`ajustar.isPending`	218

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, text-sm, text-destructive.

Hooks, adaptadores y utilidades relacionados

src/features/pimia/api/auth.ts
src/features/pimia/api/pimiaClient.ts
src/features/pimia/hooks/usePimiaArticulos.ts
src/features/pimia/hooks/usePimiaAuth.ts
src/features/pimia/hooks/usePimiaRecuentos.ts
src/features/pimia/hooks/usePimiaResources.ts
src/features/pimia/lib/closedDoors.ts
src/features/pimia/lib/missingRecord.ts
src/features/pimia/lib/money.ts
src/features/pimia/lib/pagination.ts
src/features/pimia/lib/scopeDenial.ts
src/features/pimia/lib/stockCommitments.ts
src/features/pimia/lib/stockCounts.ts
src/features/pimia/lib/stockMovements.ts
src/features/pimia/lib/warehouses.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