Componente: Áreas organizacionales¶

Selector: app-modal-area-organizacional
Ubicación: src/app/views/analytics/components/modal-area-organizacional
Acceso: Usuarios que gestionan reportes.

¿Qué resuelve?¶

Las áreas ya no son textos escritos en el código. Un administrador puede crear, editar, activar o desactivar áreas como Finanzas, BPO / Marketing u Operaciones, y asociar los roles reales de la plataforma. Una nueva área se incorpora sin desplegar una versión nueva del frontend.

El botón Áreas organizacionales está disponible en Gestión de Reportes y en Telemetría. Ambos usan el mismo componente y la misma colección.

Cómo se usa¶

1. Abrir Áreas organizacionales.
2. Escribir un nombre claro y único. La descripción es opcional.
3. Elegir el estado y marcar los roles que la componen.
4. Guardar. La alerta confirma “Área creada” y el modal permanece abierto para continuar administrando.
5. Elegir Editar desde la lista inferior para ajustar nombre, estado, descripción o roles.

Las áreas inactivas se conservan para trazabilidad, pero no se ofrecen como categoría nueva ni se usan para clasificar consumo futuro.

Campos protegidos¶

Antes de guardar se compara el nombre normalizado: mayúsculas, tildes y espacios no crean un área distinta. Por ejemplo, Finanzas, FINANZAS y finánzas se consideran el mismo nombre.

Colección AreasOrganizacionales¶

Índice obligatorio en base de datos¶

La validación de pantalla mejora la experiencia, pero el índice único protege ante dos administradores guardando al mismo tiempo. Antes de crearlo, revisar duplicados:

use LogighoDB

db.AreasOrganizacionales.aggregate([
  { $group: { _id: '$NombreNormalizado', total: { $sum: 1 }, nombres: { $push: '$Nombre' } } },
  { $match: { _id: { $ne: null }, total: { $gt: 1 } } }
])

db.AreasOrganizacionales.createIndex(
  { NombreNormalizado: 1 },
  { name: 'nombre_normalizado_unico', unique: true }
)

Estas instrucciones las ejecuta el responsable de base de datos. No se deben ejecutar si la consulta previa devuelve duplicados.

Relación con reportes y telemetría¶

• En Gestión de Reportes, las categorías disponibles se leen de las áreas activas; no hay catálogo hardcodeado.
• En Telemetría, el área se deriva de los roles del usuario al iniciar la sesión. Si no hay coincidencia, se registra Sin clasificar como respaldo.
• La sesión guarda su área como fotografía histórica. Editar un área hoy no modifica los eventos antiguos, permitiendo interpretar correctamente cada período.

Servicios y flujo¶

flowchart LR
    A[Administrador] --> B[Modal de áreas]
    B --> C[Validación de campos y duplicado]
    C --> D[(AreasOrganizacionales)]
    D --> E[Gestión de reportes]
    D --> F[Telemetría]
    R[(Roles)] --> B

Historial de cambios¶