Modelo Técnico: UserTenantMapping

Ubicación SSoT: com.neosystima.app.modules.main.data.model.UserTenantMapping

Campo API: clientCode

String REQUIRED

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Código de Enrutamiento (Tenant)
Descripción	Código de referencia del cliente al que pertenece el usuario. Permite al orquestador saber a qué base de datos física (Tenant DB) debe apuntar la conexión tras autenticar.
Dominio	Códigos de Cliente
Público	🔴

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🟢 Forms: 🟢	Formato: Alfanumérico Regla UI: Solo lectura. Sincronizado automáticamente.

3. Seguridad y Auditoría

Parámetro	Valor
Sensibilidad	LOW
Encriptado	🔴
Indexado	🟢
Auditado	🟢

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Sincronización (Eventos Tenant -> Main) / Plataforma
• Validaciones Raw: Debe existir en la tabla de clientes.
• Longitud Max: 20

Ejemplo de Integración:

{
  "clientCode": "CLI-001, DEMO-123"
}

---

Campo API: email

String REQUIRED

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Email de Enrutamiento
Descripción	Correo electrónico del usuario, utilizado globalmente por la plataforma para el enrutamiento del login (Magic Links) y la recuperación de credenciales cruzadas.
Dominio	Emails
Público	🔴

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🟢 Forms: 🟢	Formato: Email Regla UI: Solo lectura. Sincronizado automáticamente.

3. Seguridad y Auditoría

Parámetro	Valor
Sensibilidad	MEDIUM
Encriptado	🔴
Indexado	🟢
Auditado	🟢

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Sincronización (Eventos Tenant -> Main) / Plataforma
• Validaciones Raw: Estrictamente único a nivel global (Tabla Main).
• Longitud Max: 50

Ejemplo de Integración:

{
  "email": "usuario@empresa.com"
}

---

Campo API: id

Long? REQUIRED

1. Definición de Negocio

Atributo	Detalle
Etiqueta	ID de Mapeo
Descripción	Identificador numérico interno y clave primaria del registro de enrutamiento.
Dominio	Números Enteros
Público	🔴

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🔴 Forms: 🔴	Formato: Numérico (BigInt) Regla UI: Completamente oculto.

3. Seguridad y Auditoría

Parámetro	Valor
Sensibilidad	LOW
Encriptado	🔴
Indexado	🟢
Auditado	🔴

4. Especificaciones Técnicas

• Valor Default: Generado por BD
• Fuente / Dueño: Motor de Base de Datos / Plataforma
• Validaciones Raw: Único e irrepetible. Autoincremental.
• Longitud Max: 255

Ejemplo de Integración:

{
  "id": "1, 2, 3"
}

---

Campo API: username

String REQUIRED

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Nombre de Usuario (Tenant)
Descripción	Nombre de usuario local registrado dentro de un tenant específico.Se utiliza en conjunto con el código de cliente para identificar unívocamente la cuenta a nivel global.
Dominio	Nombres de Usuario
Público	🔴

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🟢 Forms: 🟢	Formato: Alfanumérico Regla UI: Solo lectura. Mantenido por sincronización en segundo plano.

3. Seguridad y Auditoría

Parámetro	Valor
Sensibilidad	MEDIUM
Encriptado	🔴
Indexado	🟢
Auditado	🟢

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Sincronización (Eventos Tenant -> Main) / Plataforma
• Validaciones Raw: Único en combinación con el código de cliente.
• Longitud Max: 50

Ejemplo de Integración:

{
  "username": "jperez, admin_01"
}

---