Modelo Técnico: UserLegalAcceptance
Ubicación SSoT:
com.neosystima.app.modules.main.data.model.UserLegalAcceptance
Campo API: acceptedAt
LocalDateTime
REQUIRED
1. Definición de Negocio
| Atributo | Detalle |
|---|---|
| Etiqueta | Fecha de Aceptación |
| Descripción | Marca de tiempo exacta en la que el usuario hizo clic en 'Aceptar'. |
| Dominio | Tiempo (Timestamp) |
| Público | 🟢 |
2. Capa de Interfaz (Frontend)
| Requerimiento | Reglas Visuales |
|---|---|
| Grilla: 🟢 Forms: 🟢 | Formato: ISO 8601Regla UI: 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:
Sistema/ Plataforma - Validaciones Raw:
Campo inmutable (updatable = false). - Longitud Max:
255
Ejemplo de Integración:
{
"acceptedAt": "2024-05-15T18:30:00Z"
}
Campo API: clientCode
String?
REQUIRED
1. Definición de Negocio
| Atributo | Detalle |
|---|---|
| Etiqueta | Código del Cliente / Tenant |
| Descripción | Referencia al espacio de trabajo o tenant desde el cual el usuario aceptó los términos. |
| Dominio | Códigos de Cliente |
| Público | 🔴 |
2. Capa de Interfaz (Frontend)
| Requerimiento | Reglas Visuales |
|---|---|
| Grilla: 🟢 Forms: 🟢 | Formato: AlfanuméricoRegla UI: Solo lectura en reportes de auditoría. |
3. Seguridad y Auditoría
| Parámetro | Valor |
|---|---|
| Sensibilidad | LOW |
| Encriptado | 🔴 |
| Indexado | 🔴 |
| Auditado | 🔴 |
4. Especificaciones Técnicas
- Valor Default:
N/A - Fuente / Dueño:
Contexto de Seguridad/ Plataforma - Validaciones Raw:
Obligatorio. - Longitud Max:
20
Ejemplo de Integración:
{
"clientCode": "CLI-001, MAIN"
}
Campo API: document
LegalDocument?
1. Definición de Negocio
| Atributo | Detalle |
|---|---|
| Etiqueta | Documento Aceptado |
| Descripción | Referencia a la versión exacta e inmutable del documento legal (LegalDocument) que el usuario leyó y aceptó. |
| Dominio | Tabla LegalDocument |
| Público | 🟢 |
2. Capa de Interfaz (Frontend)
| Requerimiento | Reglas Visuales |
|---|---|
| Grilla: 🟢 Forms: 🟢 | Formato: ID ForáneoRegla UI: Link hacia el detalle del documento legal. |
3. Seguridad y Auditoría
| Parámetro | Valor |
|---|---|
| Sensibilidad | LOW |
| Encriptado | 🔴 |
| Indexado | 🟢 |
| Auditado | 🔴 |
4. Especificaciones Técnicas
- Valor Default:
N/A - Fuente / Dueño:
Motor de Aceptación Legal/ Plataforma - Validaciones Raw:
El documento referenciado debe existir en el sistema. - Longitud Max:
255
Ejemplo de Integración:
{
"document": "10 (Términos v2.0)"
}
Campo API: id
Long?
REQUIRED
1. Definición de Negocio
| Atributo | Detalle |
|---|---|
| Etiqueta | ID de Aceptación |
| Descripción | Identificador numérico y clave primaria del registro de auditoría de consentimiento. |
| 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/ Sistema - Validaciones Raw:
Único e irrepetible. Autoincremental. - Longitud Max:
255
Ejemplo de Integración:
{
"id": "1050, 1051"
}
Campo API: ipAddress
String?
1. Definición de Negocio
| Atributo | Detalle |
|---|---|
| Etiqueta | Dirección IP |
| Descripción | Dirección de red pública (IPv4 o IPv6) desde la cual se emitió el consentimiento. Fundamental como prueba pericial en caso de disputas legales. |
| Dominio | Direcciones de Red |
| Público | 🔴 |
2. Capa de Interfaz (Frontend)
| Requerimiento | Reglas Visuales |
|---|---|
| Grilla: 🔴 Forms: 🟢 | Formato: IPv4 / IPv6Regla UI: Solo visible para roles de cumplimiento normativo (Compliance). |
3. Seguridad y Auditoría
| Parámetro | Valor |
|---|---|
| Sensibilidad | HIGH |
| Encriptado | 🔴 |
| Indexado | 🔴 |
| Auditado | 🔴 |
4. Especificaciones Técnicas
- Valor Default:
N/A - Fuente / Dueño:
Request HTTP (X-Forwarded-For / Remote Address)/ Plataforma - Validaciones Raw:
N/A - Longitud Max:
45
Ejemplo de Integración:
{
"ipAddress": "192.168.1.1, 2001:0db8:85a3:0000:0000:8a2e:0370:7334"
}
Campo API: userAgent
String?
1. Definición de Negocio
| Atributo | Detalle |
|---|---|
| Etiqueta | User Agent (Dispositivo/Navegador) |
| Descripción | Firma completa del dispositivo, sistema operativo y navegador web utilizado por el usuario al aceptar el documento. |
| Dominio | Cabeceras HTTP |
| Público | 🔴 |
2. Capa de Interfaz (Frontend)
| Requerimiento | Reglas Visuales |
|---|---|
| Grilla: 🔴 Forms: 🟢 | Formato: Texto planoRegla UI: Solo lectura en reportes avanzados. |
3. Seguridad y Auditoría
| Parámetro | Valor |
|---|---|
| Sensibilidad | MEDIUM |
| Encriptado | 🔴 |
| Indexado | 🔴 |
| Auditado | 🔴 |
4. Especificaciones Técnicas
- Valor Default:
N/A - Fuente / Dueño:
Request HTTP (User-Agent header)/ Plataforma - Validaciones Raw:
N/A - Longitud Max:
255
Ejemplo de Integración:
{
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36..."
}
Campo API: userCode
String?
REQUIRED
1. Definición de Negocio
| Atributo | Detalle |
|---|---|
| Etiqueta | Código del Usuario |
| Descripción | Referencia cruzada al usuario que otorgó el consentimiento.Se usa el código en texto plano en lugar del ID para preservar la trazabilidad en caso de que el usuario original sea purgado. |
| Dominio | Códigos de Usuario |
| Público | 🔴 |
2. Capa de Interfaz (Frontend)
| Requerimiento | Reglas Visuales |
|---|---|
| Grilla: 🟢 Forms: 🟢 | Formato: AlfanuméricoRegla UI: Solo lectura en reportes de auditoría. |
3. Seguridad y Auditoría
| Parámetro | Valor |
|---|---|
| Sensibilidad | MEDIUM |
| Encriptado | 🔴 |
| Indexado | 🔴 |
| Auditado | 🔴 |
4. Especificaciones Técnicas
- Valor Default:
N/A - Fuente / Dueño:
Contexto de Seguridad (Sesión)/ Plataforma - Validaciones Raw:
Obligatorio. - Longitud Max:
50
Ejemplo de Integración:
{
"userCode": "USR-005, sysadmin"
}