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).