Inventario en Sevastopol

Propósito

El dominio inventario del frontend cubre el ciclo de mercaderías del tenant: maestros (existencias + categorías), kardex (stock + saldo), procesamiento de compras SII hacia inventario, provisiones de cierre de existencias y cálculo del costo de ventas. Es contraparte contable de Gastos y Activo Fijo — la clasificación del proveedor (administrada en ProveedoresInventarioIsland) decide a cuál de las tres rutas va cada compra.

Dos islands cooperan:

• InventarioIsland — island grande con 6 tabs sobre /api/inventario/*. Operación diaria + cierre.
• ProveedoresInventarioIsland — clasificación del padrón de proveedores que dirige las compras hacia existencias, gasto o activo fijo según tipo_proveedor y giro_aplicable.

Note

Hay dos features distintas con nombre “provisiones” en el sistema:

• Provisiones de cierre de existencias — tab provisiones dentro de InventarioIsland, sobre /api/inventario/provisiones-cierre. Ajustes contables al cierre de mes para reflejar el valor real del stock.
• Provisiones de gastos — island independiente en /dev/sevastopol/islands/provisiones/, sobre /api/inventario/provision-ajustes. Ajustes por desfase entre fecha_documento y período_libro.

Ambas comparten el proxy /api/inventario pero modelan reglas contables independientes.

Islands del dominio

Island	Endpoint base	Documentación
InventarioIsland (6 tabs)	/api/inventario/{existencias,categorias,stock,saldo-stock,compras-existencias,provisiones-cierre,costo-ventas,entradas}	Inventario (UI)
ProveedoresInventarioIsland	/api/inventario/proveedores + /api/parameters/giros-comerciales + /api/admin/company	Proveedores (UI)

Decisiones de UX

Decisión	Motivo
Una island enorme con 6 tabs en vez de 6 islands	Las tabs comparten existencias, categorías y stock como contexto. Separar forzaría 6x cargas y rompería el flujo natural (alta de existencia → consulta de stock → procesamiento de compra → cierre + costo).
Proveedores en island aparte	La clasificación es maestro de baja frecuencia con UI específica (selector multi-giro, lista de pendientes). Embebida como séptima tab agregaría carga lateral en cada apertura de Inventario.
Mode-locked views (CostoVentasView, ProvisionesGastosView) re-exportadas	InventarioIsland exporta variantes que fijan la tab inicial. El sidebar del dashboard puede tener entradas dedicadas que abren el “costo de ventas” o “provisiones” sin la tab bar visible. Mismo código, distinto modo.
Clasificación de proveedor → routing contable	genera_existencias / genera_activo_fijo / genera_gasto son flags por proveedor. Al procesar una compra SII, el sistema decide automáticamente la ruta sin requerir intervención manual. Los proveedores MIXTO exigen criterio adicional por línea.
giro_aplicable acota la lista	Solo se muestran proveedores cuyos giros intersectan con giro_codigo de la empresa. Evita listas ruidosas en tenants con giros únicos.
Lista de pendientes en proveedores	Detecta proveedores presentes en compras del periodo pero ausentes del padrón clasificado — el operador completa la clasificación antes de procesar el cierre.

Lenguaje compartido

Ambas islands usan los tokens de ContabilidadWorkspace:

Componente	Uso
ContabilidadWorkspaceHeader	Header con pills y controls.
WorkspaceSectionCard	Secciones por tab o sub-tabla.
InlineMetricPill	Métricas inline (totales, conteos, montos).
WorkspaceTabBar (Inventario)	Cambio entre las 6 tabs internas.

Hooks compartidos

Hook	Uso
useActiveTenant	Recarga maestros + datos del tab activo al cambiar tenant.
useActivePeriod	Inicializa filtros año/mes. Stock, compras, provisiones y costo de ventas son per-período.

Backend de referencia

Inventario (Orchestrator) agrupa los servicios:

• InventarioService — maestros + stock.
• ExistenciasService — gestión de existencias.
• ComprasInventarioService — procesamiento de compras de inventario.
• StockService — kardex y consulta.

Endpoints base

Endpoint	Tab consumidora
/api/inventario/existencias	existencias
/api/inventario/categorias	categorias, existencias (selector)
/api/inventario/stock	stock
/api/inventario/saldo-stock	stock (resumen por categoría), costo_ventas
/api/inventario/entradas	kardex de entradas.
/api/inventario/compras-existencias	compras, provisiones (origen)
/api/inventario/provisiones-cierre	provisiones
/api/inventario/costo-ventas + /costo-ventas-cierre	costo_ventas
/api/inventario/proveedores	ProveedoresInventarioIsland + selector en otros tabs.
/api/operaciones (VENTA + BOLETA)	costo_ventas (ventas netas para prorrateo).
/api/admin/chart-of-accounts	Selectores de cuenta.
/api/admin/company	Config de giros del tenant.
/api/parameters/giros-comerciales	Catálogo de giros.

Relación con otros dominios

• Operaciones SII alimenta las compras que terminan en el tab compras para procesamiento.
• Gastos y Activo Fijo son las rutas alternativas — la clasificación del proveedor decide cuál.
• Provisiones de gastos (dominio aparte) cubre el otro tipo de provisión (desfase doc/libro).
• Ciclo contable cierra el período cuando costo de ventas y provisiones están contabilizados.

Estas relaciones se documentan en cada destino, no aquí.