Saltar al contenido principal

Almacenes — el formulario ya gestiona todas las propiedades de la bodega

El formulario de Inventarios ▸ Almacenes solo permitía editar nombre, dirección, responsable y descripción. El resto de columnas de la tabla almacenes —tipo de bodega, teléfono de contacto, NIT, punto de venta, stock negativo e inventario veterinario— existía en la base y en la API, pero no había forma de marcarla desde la interfaz: había que recurrir a la base de datos. Ahora el formulario las gestiona todas.

Qué cambió​

  • Tipo de bodega (general, tienda, dispensacion): selector con la descripción de cada opción. Al volver a General se apaga el punto de venta, porque el POS solo existe en bodegas de tienda o dispensación.
  • Teléfono de contacto y NIT de la razón social: campos de texto (el NIT es el que se imprime en el comprobante del POS).
  • Bloque «Operación» con tres interruptores:
    • Punto de venta (POS) — se deshabilita en bodegas generales y explica el requisito.
    • Permite stock negativo — la regla clínica de veterinaria (ADR-026); el resto del almacén sigue sin admitir stock negativo.
    • Inventario de la clínica veterinaria — delimita el inventario y los permisos de los roles veterinarios.
  • Almacén activo desde el propio formulario, además del botón de encendido de la fila.
  • Cada interruptor lleva etiqueta asociada y texto de ayuda (aria-describedby).
  • La card «Operación» va a la derecha del formulario. La modal pasó a 880 px y se divide en dos columnas: a la izquierda identificación, contacto y ubicación; a la derecha las banderas de operación y el estado. Así crece a lo ancho y no hacia abajo (antes el formulario se extendía ~820 px y obligaba a desplazarse). En pantallas estrechas la card cae debajo de los campos.
  • Los textos opcionales ahora se envían como null cuando se vacían. Antes viajaban como undefined y TypeORM conservaba el valor anterior: no era posible borrar la dirección ni la descripción de una bodega.

Reglas que aplica el formulario​

SituaciónComportamiento
Tipo general con POS encendidoEl POS se envía siempre apagado y el interruptor queda deshabilitado.
Campo de texto vacíoSe envía null y el dato se borra en la base.
AltaNace general, activa, sin POS, sin stock negativo y sin marca veterinaria.
EdiciónCarga todas las columnas del registro, incluidas las banderas.

Tour guiado​

El recorrido del formulario pasó de 7 a 12 pasos: nombre, tipo, teléfono, dirección, NIT, responsable, descripción, bloque de operación, activo, cancelar y guardar. El de la pantalla pasó de 20 a 23: se sumaron las celdas «Tipo», «Contacto» y «Operación». Como el resto de guiones, se ajustan a lo que está realmente pintado.

Grilla: nuevas columnas sin desplazamiento horizontal​

La tabla pasó de 6 a 8 columnas y ahora se lee de un vistazo:

AntesAhora
Nombre · Dirección · Responsable · Usuarios · Estado · AccionesAlmacén (nombre + dirección) · Tipo · Contacto (teléfono + NIT) · Responsable · Operación (POS / Stock − / Vet) · Usuarios · Estado · Acciones

Para que quepa sin scroll horizontal:

  • table-fixed con anchos en porcentaje: la tabla ocupa exactamente el ancho disponible, no se estira con el contenido.
  • truncate + title en los textos largos (nombre, dirección, responsable, NIT): se recortan con puntos suspensivos y el valor completo aparece al pasar el puntero.
  • Insignias compactas (11 px) para tipo y banderas, encabezados a 12 px y celdas de contacto a dos líneas.
  • Dirección y NIT se integran como segunda línea de sus celdas en lugar de ocupar columnas propias, que es lo que obligaba a desplazarse.
  • Los botones de acción usan flex-wrap: en anchos muy cortos bajan de línea en lugar de empujar la tabla.

Contacto con icono y máscara​

El teléfono de la bodega se muestra con su icono y el formato (310)-247-7988, y debajo el NIT cuando existe. La máscara vive en src/utils/telefono.ts: quita separadores y el indicativo 57 y, si el número no tiene 10 dígitos —extensiones, internacionales ya escritos— respeta el valor tal cual, sin inventar separadores.

El teléfono se muestra igual en todo el sistema​

La máscara dejó de ser un detalle de la grilla de Almacenes: formatearTelefonoVisible() (src/utils/telefono.ts) es ahora el único formato de presentación. En Colombia —o cuando el registro no guarda país, como almacenes y proveedores— devuelve (310)-247-7988; en otros países, +52 55 1234 5678.

Se aplicó en:

PantallaAntesAhora
Almacenes · celda Contacto6045550123(604)-555-0123 con icono
Usuarios · listado (user/table.tsx)+57 300 123 4567(300)-123-4567
Menú · «Datos del usuario» (user-info.tsx)copia local 300-123-4567(300)-123-4567
Perfil (profile.tsx)valor crudo(300)-123-4567
Chat · ficha del usuario (user-card-tooltip.tsx)copia local 300-123-4567(300)-123-4567
Proveedores · contacto· 3001234567· (300)-123-4567
Oficinas · ficha, usuarios asignadosvalor crudo(300)-123-4567
Personal de la clínica+57 300 123 4567(300)-123-4567 (o internacional si es de otro país)
Clínica · agenda, pacientes y cartera (cliente)valor crudo(300)-123-4567

Las dos copias locales que existían (user-info.tsx y user-card-tooltip.tsx) se eliminaron: eran la causa de que el mismo dato se viera de tres formas distintas. La oficina no guarda un teléfono propio, pero su ficha lista a los usuarios asignados con el suyo; los clientes de la clínica veterinaria también pasan por la utilidad en la agenda, la ficha del paciente y la cartera.

Acciones con color​

Cada icono de la fila tiene su tono, con variante para modo oscuro: azul editar, ámbar inactivar, verde reactivar, violeta horario y accesos, rojo eliminar. El color acompaña al aria-label y al title; no los sustituye.

Archivos clave​

  • ccf-almacen-web/src/models/almacen.entity.ts — columnas del almacén, catálogo de tipos y mapeo almacén ⇄ formulario (formularioDesdeAlmacen, solicitudDesdeFormulario).
  • ccf-almacen-web/src/pages/almacenes.tsx — formulario de dos columnas, interruptores, grilla con las nuevas columnas y payload completo.
  • ccf-almacen-web/src/config/tours.ts — 5 pasos nuevos del formulario y 3 de la grilla (tipo, contacto y operación).
  • ccf-almacen-web/src/__tests__/almacen-formulario.test.ts — pruebas del mapeo (todas las columnas, POS en general, textos vacíos y responsable).
  • ccf-almacen-web/src/utils/telefono.ts — formatearTelefonoContacto y formatearTelefonoVisible (formato único del sistema) con telefono.spec.ts.
  • ccf-almacen-web/src/components/user/table.tsx, user/user-info.tsx, general-dashboard/profile.tsx, chat/user-card-tooltip.tsx, veterinaria/veterinaria-personal.tsx y pages/proveedores.tsx — consumidores del formato.
  • ccf-almacen-web/design.md — regla «Teléfonos» del sistema visual.
  • ccf-almacen-wiki/docs/manuales/inventarios/gestionar-almacenes.md — manual del usuario.

No hubo cambios en la API: CreateAlmacenDto y UpdateAlmacenDto ya aceptaban todas las columnas, y el PUT /api/almacenes/:id sigue siendo el mismo.

Cómo verificarlo​

  1. Abre Inventarios ▸ Almacenes y pulsa el lápiz de una bodega: la card Operación está a la derecha y el formulario cabe sin bajar media pantalla.
  2. Cambia el tipo a Tienda: el interruptor de Punto de venta se habilita. Vuelve a General: se apaga y se deshabilita.
  3. Escribe un teléfono y un NIT, activa Permite stock negativo y guarda.
  4. Reabre la bodega: los valores vuelven cargados. Borra el teléfono, guarda y reabre: el campo queda vacío.
  5. En el listado, la fila muestra el tipo, el contacto y las insignias de operación; reduce la ventana y comprueba que la tabla no genera barra horizontal (el texto se recorta y se lee completo al pasar el puntero).