# Guía de prueba — Separación por rubro (productos y proveedores)

> **Qué se resolvió.** Agogo opera dos negocios distintos en dos sucursales, pero el catálogo y
> los proveedores eran de la empresa entera: el del taller veía los 11.799 productos de regalería
> mezclados con los suyos. Ahora cada quien ve lo suyo, sin dejar de poder ver todo cuando lo necesita.
>
> **Importante**: el filtro es una **comodidad, no un candado**. Siempre existe la opción
> "Todos los rubros". Nadie queda encerrado ni pierde acceso a nada.

**Fecha**: 08/09/2026 · **Empresa de prueba**: Agogo Regalos · **Doc de diseño**: `plan-rubros-multi-sucursal.md`

---

## Antes de empezar

Ingresá al sistema con cualquiera de estos usuarios (usá la clave que ya tenés):

| Usuario | Sucursal asignada | Rubro con el que debería arrancar |
|---|---|---|
| `agogo` | Agogo | **Regalería** |
| `CAJA` | Agogo | **Regalería** |
| `taller` | Taller 8 Center | **Taller** |
| `2009839` | las dos | **Todos los rubros** |
| `maura` | ninguna | **Todos los rubros** |

Los dos últimos son a propósito: cuando el sistema no puede deducir un solo rubro, no elige por vos.

> Si acabás de actualizar el sistema, **reiniciá el backend una vez**: los permisos nuevos se
> registran al arrancar.

---

## Números de referencia

Todo lo que sigue se puede verificar contra esta tabla. Si un número no coincide, algo anda mal.

| | Todos los rubros | Regalería | Taller |
|---|---|---|---|
| **Productos** | 11.799 | 10.015 | 1.790 |
| **Proveedores** | 41 | 2 | 41 |

Los productos propios de cada rubro son 10.009 y 1.784; los **6 restantes son compartidos** y
aparecen en los dos lados. Por eso las columnas suman más que el total: así tiene que ser.

En proveedores pasa lo mismo al revés: los 39 con historial de compras son del taller y hay
**2 sin rubro** que se ven siempre. Regalería tiene solo esos 2 porque **nunca registró compras
en el sistema** — no es un error, es que ese módulo no se usó todavía de ese lado.

---

## Prueba 0 — Que todas las pantallas abran, con cada usuario

**Hacé esta primera y con los tres usuarios** (`agogo`, `taller` y `2009839`). Es aburrida y es la
que más problemas encuentra.

Entrá a cada pantalla y confirmá que **carga y muestra contenido**:

- [ ] Productos → Inventario
- [ ] Productos → Inventario → pestaña **Categorías**
- [ ] **Contactos → Proveedores** ← la que más falla
- [ ] Compras → Nueva compra
- [ ] Configuración → Empresa → Rubros

**Qué buscar**: una pantalla **en blanco** o que se queda cargando para siempre. Ese es el síntoma
de que algo se rompió al dibujarla.

> **Por qué está esta prueba.** Durante el desarrollo, Contactos → Proveedores quedó en blanco para
> todos los usuarios. Lo puntual ya está corregido, pero el punto es otro: **este tipo de falla no
> da ningún error visible ni deja rastro en el servidor** — la pantalla simplemente no aparece. No
> hay forma de detectarla salvo abriendo cada pantalla y mirándola.
>
> Si te pasa, apretá **F12 → pestaña Console**, sacale una foto al texto en rojo y mandánoslo: ahí
> está exactamente qué se rompió.

---

## Prueba 1 — El catálogo arranca filtrado

1. Entrá como **`taller`**.
2. En el panel lateral, justo debajo del nombre de la empresa, tenés el selector **Rubro**. Debe decir **Taller**.
3. Andá a **Productos → Inventario**.

**Qué tenés que ver:**
- El contador dice **"1790 productos en catálogo"** (antes decía 11.799).
- Los productos son del rubro: zapatas, bujías, repuestos.
- Cada fila tiene un chip **Taller** de color ámbar, al lado de IVA y Activo.

4. Repetí con **`agogo`**: el selector dice **Regalería** y el contador **10.015**, con cotillón,
   cosmética y regalería. El chip dice **Regalería**, en rosa.

---

## Prueba 2 — Cambiar de rubro sin cerrar sesión

Con cualquiera de los dos usuarios, en la misma pantalla de Inventario:

1. Abrí el selector **Rubro** del panel lateral. Tiene tres opciones: *Todos los rubros · Regalería · Taller*.
2. Elegí **Taller** → el contador pasa a **1.790** sin recargar la página.
3. Elegí **Regalería** → **10.015**.
4. Elegí **Todos los rubros** → **11.799**.
5. **Recargá la página (F5)**: el rubro que elegiste último se mantiene.

Esto último importa: la elección es tuya y no se pisa sola. Solo la primera vez que entrás se
aplica el rubro de tu sucursal.

---

## Prueba 3 — La búsqueda respeta el rubro

Esta es la que más vale la pena mirar, porque es donde el filtro se podía romper en silencio.

1. Poné el rubro en **Taller** y buscá `bujia` → aparecen **4 productos**.
2. Cambiá a **Regalería** con la misma búsqueda → **ningún resultado**.
3. Cambiá a **Todos los rubros** → vuelven los 4.

Si en Regalería aparecieran bujías, el filtro no estaría combinándose bien con la búsqueda.

Probá lo mismo al revés con `cotillon`: **102 resultados** en Regalería, ninguno en Taller.

---

## Prueba 4 — Proveedores en Compras

1. Entrá como **`taller`** (rubro Taller).
2. Andá a **Compras → Nueva compra**.
3. Hacé clic en el campo **Proveedor** sin escribir nada.

**Qué tenés que ver:** la lista trae los proveedores del taller (41 entre propios y compartidos).

4. Cambiá el rubro en el panel lateral a **Regalería** y volvé a abrir el campo Proveedor.

**Qué tenés que ver:** ahora solo aparecen **2** — los que no tienen rubro asignado.

Este mismo buscador se usa en Órdenes de Compra, Recepciones, Pagos a Proveedor, Gastos, Notas de
Crédito de Compra e Importaciones. **Si anda acá, anda en todas.** Igual conviene abrir una o dos
más para confirmar.

---

## Prueba 5 — Etiquetar un proveedor a mano

1. Andá a **Contactos → Proveedores**.
2. Editá cualquier proveedor. Arriba del todo vas a ver **"Rubros que atiende"**.
3. Dejalo **vacío** y guardá → el proveedor aparece en los dos rubros. El texto de ayuda lo dice.
4. Volvé a editarlo, elegí **Taller**, guardá.
5. Poné el selector en **Regalería**: el proveedor ya no aparece en la lista ni en el buscador de compras.
6. Poné el selector en **Taller**: vuelve a aparecer, con un chip **Taller** en su fila.

> **La regla de oro**: sin rubros seleccionados, el proveedor se ve en todos lados. Es el estado
> correcto para quien te vende a las dos sucursales. Ante la duda, dejalo vacío.

---

## Prueba 6 — Categorías con rubro

Las categorías son el otro camino: en vez de etiquetar producto por producto, etiquetás la
categoría y **los productos la heredan**.

1. **Productos → Inventario → pestaña Categorías**.
2. **Nueva Categoría**, poné un nombre, elegí un color y en **Rubro** elegí *Taller*. Guardá.
3. La categoría aparece en el árbol con un chip **Taller** y el punto del color que elegiste.
4. Creá otra con **Sin rubro (compartida)** → aparece sin chip.

Para ver la herencia funcionando hace falta un producto **sin rubro propio**: asignale esa
categoría a un producto compartido (de los 42) y vas a ver que empieza a filtrar por el rubro de
la categoría.

> **Cuándo gana cada cosa**: si el producto tiene rubro propio, ése manda. Si no, hereda el de su
> categoría. Los 11.757 productos que ya marcó la migración tienen rubro propio, así que cambiarles
> la categoría no les cambia el rubro.

---

## Prueba 7 — El ABM de rubros

Está en **Configuración → Empresa → Rubros**.

1. Verificá que aparecen **Regalería (REGALOS)** y **Taller (TALLER)**, cada uno con su color, su
   icono y un chip con la sucursal que lo opera.
2. **Nuevo Rubro**: poné un código (se pasa a mayúsculas solo), un nombre, elegí color e icono y
   asignale una sucursal. Guardá y verificá que aparece en la lista.
3. Editalo y cambiale el color: el chip cambia en todas las pantallas donde se muestra.
4. Dalo de baja con el botón de encendido. Deja de ofrecerse en el selector del header, **pero no
   se pierde nada**: lo que estaba etiquetado con ese rubro sigue igual, y podés reactivarlo
   editándolo.

Probá también con un usuario **sin permiso de administración** (por ejemplo `CAJA`): la pantalla
debe decirle que no tiene permiso. Eso es lo esperado.

> **Ojo con las sucursales que no ves.** El listado de sucursales viene recortado a las que tenés
> asignadas. Si editás un rubro que está en una sucursal ajena, el formulario igual te la muestra
> para que no se la borres sin querer. Vale la pena confirmarlo: entrá con `agogo` y editá el rubro
> **Taller** — tenés que ver el chip "Taller 8 Center" aunque esa sucursal no sea tuya.

---

## Búsquedas verificadas

Los valores de la Prueba 3 están comprobados contra los datos reales:

| Búsqueda | Todos | Regalería | Taller |
|---|---|---|---|
| `bujia` | 4 | 0 | 4 |
| `cotillon` | 102 | 102 | 0 |

---

## Casos límite que vale la pena mirar

| Situación | Qué debería pasar |
|---|---|
| Usuario sin sucursal asignada (`maura`) | Arranca en **Todos los rubros**, ve todo |
| Usuario asignado a las dos (`2009839`) | Arranca en **Todos los rubros** — el sistema no elige por él |
| Empresa con **un solo rubro** o ninguno | **El selector no aparece.** Todo se comporta como antes |
| Producto sin categoría y sin rubro | Se ve en todos los rubros |
| Dar de baja un rubro que está en uso | Deja de ofrecerse en los selectores, pero las asignaciones no se pierden |

El tercer caso es el más importante para el resto de tus clientes: **si no usan rubros, no ven
ningún cambio.** Vale la pena entrar con otra empresa y confirmarlo.

---

## Qué reportar

Si algo no coincide, contanos:

1. **Con qué usuario** y **qué rubro** tenías en el header.
2. **En qué pantalla** y qué esperabas ver.
3. **El número que viste** vs. el de la tabla de referencia.

Lo más valioso de reportar es un producto o proveedor que **aparezca donde no debería**, o que
**desaparezca de los dos rubros** — ese sería el único caso realmente problemático, porque
significaría que alguien perdió de vista algo suyo.

Y si una pantalla queda **en blanco**, avisá aunque no sepas por qué: con la foto de la consola
(F12 → Console) se ubica el problema en minutos.
