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
nullcuando se vacían. Antes viajaban comoundefinedy 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ón | Comportamiento |
|---|---|
Tipo general con POS encendido | El POS se envía siempre apagado y el interruptor queda deshabilitado. |
| Campo de texto vacío | Se envía null y el dato se borra en la base. |
| Alta | Nace general, activa, sin POS, sin stock negativo y sin marca veterinaria. |
| Edición | Carga 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:
| Antes | Ahora |
|---|---|
| Nombre · Dirección · Responsable · Usuarios · Estado · Acciones | Almacé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-fixedcon anchos en porcentaje: la tabla ocupa exactamente el ancho disponible, no se estira con el contenido.truncate+titleen 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:
| Pantalla | Antes | Ahora |
|---|---|---|
| Almacenes · celda Contacto | 6045550123 | (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 asignados | valor 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 mapeoalmacé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—formatearTelefonoContactoyformatearTelefonoVisible(formato único del sistema) contelefono.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.tsxypages/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
- 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.
- Cambia el tipo a Tienda: el interruptor de Punto de venta se habilita. Vuelve a General: se apaga y se deshabilita.
- Escribe un teléfono y un NIT, activa Permite stock negativo y guarda.
- Reabre la bodega: los valores vuelven cargados. Borra el teléfono, guarda y reabre: el campo queda vacío.
- 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).
