Saltar a contenido

0009. Empresas y sucursales como jerarquía de tenencia

Estado: Aceptado Fecha: 2026-10-25 Autor: Duval Alcivar Módulo(s) afectado(s): panel administrativo (core-admin): dominio empresas y sucursales Evidencia: commits 0275406 (2026-10-25, empresas) y 243a4a4 (2026-10-26, sucursales) y @tanstack/vue-table

Contexto

La empresa es el tenant raíz de la plataforma y la sucursal siempre pertenece a una empresa. El alta de una empresa exige catálogos geográficos encadenados y reglas de identificación que dependen del tipo de documento; la sucursal, en cambio, no tiene sentido sin empresa.

Decisión

Se implementan /empresas/admin y /sucursales/admin sobre la superficie de administración. La empresa se crea y edita con catálogos encadenados país→provincia→ciudad, validación de longitud según el tipo de identificación, borrado lógico y paginación resuelta en el cliente con @tanstack/vue-table. La sucursal cuelga de un empresa_id obligatorio y lleva codigo e is_matriz.

Alternativas descartadas

  • Un formulario único de empresa y sucursal — mezclaría dos niveles de tenencia con reglas propias y dejaría sucursales sin empresa en el mismo flujo.

Consecuencias

La jerarquía queda explícita y la sucursal hereda el contexto de su empresa. La validación de sucursales vive solo en el cliente mientras identidad no exponga el endpoint de validaciones (commit 243a4a4).


Documentado a posteriori desde el código y el historial de Git del repositorio core-admin; la fecha corresponde al commit que introdujo la decisión, no a la fecha de publicación en este sitio (2026-11-09).