Modelo Técnico: AdminUser

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

Campo API: email

String? REQUIRED

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Email Administrativo
Descripción	Correo electrónico corporativo para notificaciones críticas y recuperación de cuenta.
Dominio	Email
Público	🟢

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🟢 Forms: 🟢	Formato: Email Regla UI: Validación de formato de correo electrónico.

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Ingreso manual / Plataforma
• Validaciones Raw: Único en la base de datos principal.
• Longitud Max: 50

Ejemplo de Integración:

{
  "email": "admin@neosystima.com"
}

---

Campo API: password

String? REQUIRED

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Contraseña
Descripción	Credencial de seguridad cifrada de alto nivel para la autenticación.
Dominio	Cifrado
Público	🔴

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🔴 Forms: 🟢	Formato: Hash BCrypt / Argon2 Regla UI: Campo de tipo Password (oculto). Requiere validación estricta de fortaleza.

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Ingreso manual / Plataforma
• Validaciones Raw: Mínimo 8 caracteres, al menos una mayúscula, un número y un símbolo especial.
• Longitud Max: 255

Ejemplo de Integración:

{
  "password": "********"
}

---

Campo API: roles

MainRole>

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Roles de Plataforma
Descripción	Niveles de acceso globales para gobernar el comportamiento general de los tenants.
Dominio	Tabla MainRole
Público	🟢

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🟢 Forms: 🟢	Formato: Colección Regla UI: Selector múltiple para asignar roles globales (ej: PLATFORM_ADMIN, SUPPORT).

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Administrador de Sistemas / Plataforma
• Validaciones Raw: Debe poseer al menos un rol activo.
• Longitud Max: 255

Ejemplo de Integración:

{
  "roles": "SUPER_ADMIN, SUPPORT_STAFF"
}

---

Campo API: status

Status?

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Estado de Cuenta
Descripción	Controla si el administrador tiene permiso activo para ingresar a las herramientas globales.
Dominio	Tabla Status
Público	🟢

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🟢 Forms: 🟢	Formato: ID Foráneo Regla UI: Selector de estados filtrado por el scope ADMIN.

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Sistema / Plataforma
• Validaciones Raw: Limitado a los estados permitidos por el sistema.
• Longitud Max: 255

Ejemplo de Integración:

{
  "status": "1 (Activo), 3 (Bloqueado)"
}

---

Campo API: termsAcceptedAt

Instant?

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Fecha de Aceptación (Admin)
Descripción	Registro temporal de aceptación de confidencialidad o NDA administrativo.
Dominio	Tiempo
Público	🟢

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🔴 Forms: 🟢	Formato: Timestamp ISO Regla UI: Solo lectura. Registro automático del sistema.

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Sistema / Plataforma
• Validaciones Raw: N/A
• Longitud Max: 255

Ejemplo de Integración:

{
  "termsAcceptedAt": "2026-05-20T14:30:00Z"
}

---

Campo API: termsVersion

String?

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Versión de Términos (Admin)
Descripción	Control de versionado de los acuerdos legales internos aceptados.
Dominio	Versión
Público	🟢

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🔴 Forms: 🟢	Formato: Texto corto Regla UI: Solo lectura.

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Sistema / Plataforma
• Validaciones Raw: N/A
• Longitud Max: 20

Ejemplo de Integración:

{
  "termsVersion": "v1.0-INTERNAL"
}

---

Campo API: username

String? REQUIRED

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Usuario Administrador
Descripción	Identificador único de acceso al sistema central (Super Admin / Staff).
Dominio	[a-z0-9_.]
Público	🟢

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🟢 Forms: 🟢	Formato: Minúsculas Regla UI: Texto sin espacios. Se valida disponibilidad en tiempo real.

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Ingreso manual / Plataforma
• Validaciones Raw: Único en la base de datos principal.
• Longitud Max: 50

Ejemplo de Integración:

{
  "username": "sysadmin, root_user"
}

---

Campo API: createdAt

Instant? REQUIRED

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Fecha de Creación
Descripción	Fecha y hora exacta en la que se insertó el registro por primera vez.
Dominio	Fechas válidas pasadas o presentes
Público	🟢

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🔴 Forms: 🟢	Formato: Timestamp (ISO 8601) Regla UI: Selector de fecha/hora. En creación está oculto, en edición se muestra como solo lectura.

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: CURRENT_TIMESTAMP
• Fuente / Dueño: Generado automáticamente por el framework de auditoría / Sistema
• Validaciones Raw: No modificable tras su creación (updatable = false).
• Longitud Max: 255

Ejemplo de Integración:

{
  "createdAt": "2025-10-15T14:30:00Z"
}

---

Campo API: createdBy

String?

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Creado Por
Descripción	Identificador principal del usuario que creó originalmente el registro.
Dominio	Usuarios válidos en el contexto de seguridad
Público	🟢

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🔴 Forms: 🟢	Formato: Alfanumérico Regla UI: Campo de texto estándar. En creación está oculto, en edición se muestra como solo lectura.

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Extraído del contexto de seguridad (SecurityContext) / Sistema
• Validaciones Raw: No modificable tras la creación.
• Longitud Max: 50

Ejemplo de Integración:

{
  "createdBy": "admin, guest, USR-001"
}

---

Campo API: id

Long? REQUIRED

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Identificador del Sistema
Descripción	Identificador numérico interno y clave primaria (Primary Key) del registro en la base de datos.
Dominio	Números enteros positivos mayores a 0
Público	🔴

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🔴 Forms: 🔴	Formato: Numérico (BigInt) Regla UI: Campo oculto o deshabilitado. No se expone directamente al usuario final para edición.

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: Asignación automática
• Fuente / Dueño: Autoincrementable y asignado por el motor de BD al insertar (INSERT). / Sistema
• Validaciones Raw: Único e irrepetible. De solo lectura tras su creación.
• Longitud Max: 255

Ejemplo de Integración:

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

---

Campo API: lastModifiedBy

String?

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Modificado Por
Descripción	Identificador principal del usuario que realizó la última modificación al registro.
Dominio	Usuarios válidos en el contexto de seguridad
Público	🟢

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🔴 Forms: 🟢	Formato: Alfanumérico Regla UI: Campo de texto estándar. En creación está oculto, en edición se muestra como solo lectura.

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: N/A
• Fuente / Dueño: Extraído del contexto de seguridad (SecurityContext) / Sistema
• Validaciones Raw: Ninguna adicional.
• Longitud Max: 50

Ejemplo de Integración:

{
  "lastModifiedBy": "admin, manager"
}

---

Campo API: updatedAt

Instant?

1. Definición de Negocio

Atributo	Detalle
Etiqueta	Última Actualización
Descripción	Fecha y hora de la última modificación del registro.
Dominio	Fechas válidas pasadas o presentes
Público	🟢

2. Capa de Interfaz (Frontend)

Requerimiento	Reglas Visuales
Grilla: 🔴 Forms: 🟢	Formato: Timestamp (ISO 8601) Regla UI: Selector de fecha/hora. En creación está oculto, en edición se muestra como solo lectura.

3. Seguridad y Auditoría

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

4. Especificaciones Técnicas

• Valor Default: CURRENT_TIMESTAMP
• Fuente / Dueño: Generado automáticamente por el framework de auditoría / Sistema
• Validaciones Raw: Se actualiza automáticamente en cada operación de modificación (UPDATE).
• Longitud Max: 255

Ejemplo de Integración:

{
  "updatedAt": "2025-10-16T09:15:00Z"
}

---