Saltar al contenido principal

Modelo Técnico: FortuneCookie

Ubicación SSoT: com.neosystima.app.modules.tenant.data.model.FortuneCookie

Campo API: category

String?

1. Definición de Negocio

AtributoDetalle
EtiquetaCategoría
DescripciónCategorización temática del mensaje (ej: WISDOM, HUMOR, HISTORY).
DominioCategorías de Mensajes
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🟢
Forms: 🟢
Formato: Texto
Regla UI: Selector o texto corto.

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🔴
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: WISDOM
  • Fuente / Dueño: Carga de Datos / Sistema
  • Validaciones Raw: N/A
  • Longitud Max: 50

Ejemplo de Integración:

{
"category": "WISDOM, HUMOR"
}

Campo API: ephemerisDe

String?

1. Definición de Negocio

AtributoDetalle
EtiquetaEfeméride (Alemán)
DescripciónHecho histórico relevante del día en idioma alemán.
DominioTexto libre
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🔴
Forms: 🟢
Formato: Texto Largo
Regla UI: Área de texto (Textarea).

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🔴
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: N/A
  • Fuente / Dueño: Carga de Datos / Sistema
  • Validaciones Raw: Opcional.
  • Longitud Max: 500

Ejemplo de Integración:

{
"ephemerisDe": "1989: Fall der Berliner Mauer."
}

Campo API: ephemerisEn

String?

1. Definición de Negocio

AtributoDetalle
EtiquetaEfeméride (Inglés)
DescripciónHecho histórico relevante del día en idioma inglés.
DominioTexto libre
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🔴
Forms: 🟢
Formato: Texto Largo
Regla UI: Área de texto (Textarea).

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🔴
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: N/A
  • Fuente / Dueño: Carga de Datos / Sistema
  • Validaciones Raw: Opcional.
  • Longitud Max: 500

Ejemplo de Integración:

{
"ephemerisEn": "1969: Apollo 11 lands on the Moon."
}

Campo API: ephemerisEs

String?

1. Definición de Negocio

AtributoDetalle
EtiquetaEfeméride (Español)
DescripciónHecho histórico relevante del día en idioma español.
DominioTexto libre
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🔴
Forms: 🟢
Formato: Texto Largo
Regla UI: Área de texto (Textarea).

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🔴
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: N/A
  • Fuente / Dueño: Carga de Datos / Sistema
  • Validaciones Raw: Opcional.
  • Longitud Max: 500

Ejemplo de Integración:

{
"ephemerisEs": "1810: Revolución de Mayo en Argentina."
}

Campo API: ephemerisPt

String?

1. Definición de Negocio

AtributoDetalle
EtiquetaEfeméride (Portugués)
DescripciónHecho histórico relevante del día en idioma portugués.
DominioTexto libre
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🔴
Forms: 🟢
Formato: Texto Largo
Regla UI: Área de texto (Textarea).

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🔴
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: N/A
  • Fuente / Dueño: Carga de Datos / Sistema
  • Validaciones Raw: Opcional.
  • Longitud Max: 500

Ejemplo de Integración:

{
"ephemerisPt": "1500: Descobrimento do Brasil."
}

Campo API: messageDe

String? REQUIRED

1. Definición de Negocio

AtributoDetalle
EtiquetaMensaje (Alemán)
DescripciónTexto de la fortuna o frase inspiradora en idioma alemán.
DominioTexto libre
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🔴
Forms: 🟢
Formato: Texto Largo
Regla UI: Área de texto (Textarea).

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🔴
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: N/A
  • Fuente / Dueño: Carga de Datos / Sistema
  • Validaciones Raw: Obligatorio.
  • Longitud Max: 500

Ejemplo de Integración:

{
"messageDe": "Heute ist ein großartiger Tag, um das Projekt zu starten."
}

Campo API: messageEn

String? REQUIRED

1. Definición de Negocio

AtributoDetalle
EtiquetaMensaje (Inglés)
DescripciónTexto de la fortuna o frase inspiradora en idioma inglés.
DominioTexto libre
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🔴
Forms: 🟢
Formato: Texto Largo
Regla UI: Área de texto (Textarea).

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🔴
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: N/A
  • Fuente / Dueño: Carga de Datos / Sistema
  • Validaciones Raw: Obligatorio.
  • Longitud Max: 500

Ejemplo de Integración:

{
"messageEn": "Today is a great day to start that project you've been postponing."
}

Campo API: messageEs

String? REQUIRED

1. Definición de Negocio

AtributoDetalle
EtiquetaMensaje (Español)
DescripciónTexto de la fortuna o frase inspiradora en idioma español.
DominioTexto libre
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🟢
Forms: 🟢
Formato: Texto Largo
Regla UI: Área de texto (Textarea).

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🔴
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: N/A
  • Fuente / Dueño: Carga de Datos / Sistema
  • Validaciones Raw: Obligatorio.
  • Longitud Max: 500

Ejemplo de Integración:

{
"messageEs": "Hoy es un gran día para empezar ese proyecto que tanto pospones."
}

Campo API: messagePt

String? REQUIRED

1. Definición de Negocio

AtributoDetalle
EtiquetaMensaje (Portugués)
DescripciónTexto de la fortuna o frase inspiradora en idioma portugués.
DominioTexto libre
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🔴
Forms: 🟢
Formato: Texto Largo
Regla UI: Área de texto (Textarea).

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🔴
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: N/A
  • Fuente / Dueño: Carga de Datos / Sistema
  • Validaciones Raw: Obligatorio.
  • Longitud Max: 500

Ejemplo de Integración:

{
"messagePt": "Hoje é um ótimo dia para começar aquele projeto que você tanto adia."
}

Campo API: name

String?

1. Definición de Negocio

AtributoDetalle
EtiquetaNombre Identificador
DescripciónNombre corto o etiqueta interna para identificar la galleta (no se muestra al cliente final).
DominioLibre
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🟢
Forms: 🟢
Formato: Texto
Regla UI: Campo de texto estándar.

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🔴
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: N/A
  • Fuente / Dueño: Carga de Datos / Sistema
  • Validaciones Raw: Opcional.
  • Longitud Max: 50

Ejemplo de Integración:

{
"name": "Inspiración Lunes, Efeméride 25 de Mayo"
}

Campo API: status

Status?

1. Definición de Negocio

AtributoDetalle
EtiquetaEstado
DescripciónIndica si la galleta está activa para ser mostrada o si ha sido archivada.
DominioTabla Status
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🟢
Forms: 🟢
Formato: ID Foráneo
Regla UI: Selector de estados del sistema.

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🟢
Auditado🟢

4. Especificaciones Técnicas

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

Ejemplo de Integración:

{
"status": "1 (Activo), 2 (Inactivo)"
}

Campo API: code

String? REQUIRED

1. Definición de Negocio

AtributoDetalle
EtiquetaCódigo de Referencia
DescripciónIdentificador único de negocio para el registro.A diferencia del ID numérico interno, este código está pensado para ser expuesto y facilitar búsquedas o referencias.
DominioSecuencia controlada o formato prefijado
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🟢
Forms: 🟢
Formato: Alfanumérico
Regla UI: Se muestra como referencia (usualmente entre paréntesis) junto al título del formulario. No es un campo editable en el flujo estándar.

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🟢
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: Generado por secuencia
  • Fuente / Dueño: Generado automáticamente por el motor de secuencias del sistema / Sistema
  • Validaciones Raw: Debe ser estrictamente único en toda la tabla.
  • Longitud Max: 20

Ejemplo de Integración:

{
"code": "000001, CLI-005, STY-20"
}

Campo API: createdAt

Instant? REQUIRED

1. Definición de Negocio

AtributoDetalle
EtiquetaFecha de Creación
DescripciónFecha y hora exacta en la que se insertó el registro por primera vez.
DominioFechas válidas pasadas o presentes
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas 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ámetroValor
SensibilidadLOW
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

AtributoDetalle
EtiquetaCreado Por
DescripciónIdentificador principal del usuario que creó originalmente el registro.
DominioUsuarios válidos en el contexto de seguridad
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas 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ámetroValor
SensibilidadMEDIUM
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

AtributoDetalle
EtiquetaIdentificador del Sistema
DescripciónIdentificador numérico interno y clave primaria (Primary Key) del registro en la base de datos.
DominioNúmeros enteros positivos mayores a 0
Público🔴

2. Capa de Interfaz (Frontend)

RequerimientoReglas 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ámetroValor
SensibilidadLOW
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: isSystem

Boolean REQUIRED

1. Definición de Negocio

AtributoDetalle
EtiquetaRegistro de Sistema
DescripciónMarca técnica que indica si el registro fue creado por el sistema y posee restricciones (ej: no se puede borrar o editar su código).
Dominio{true, false}
Público🔴

2. Capa de Interfaz (Frontend)

RequerimientoReglas Visuales
Grilla: 🔴
Forms: 🟢
Formato: Booleano
Regla UI: Casilla de verificación (Checkbox) o Interruptor (Toggle). En formularios se muestra deshabilitado (solo lectura).

3. Seguridad y Auditoría

ParámetroValor
SensibilidadLOW
Encriptado🔴
Indexado🔴
Auditado🟢

4. Especificaciones Técnicas

  • Valor Default: false
  • Fuente / Dueño: Generado por el sistema / Sistema
  • Validaciones Raw: No modificable por el usuario final (bloqueado a nivel de servicio).
  • Longitud Max: 255

Ejemplo de Integración:

{
"isSystem": "true, false"
}

Campo API: lastModifiedBy

String?

1. Definición de Negocio

AtributoDetalle
EtiquetaModificado Por
DescripciónIdentificador principal del usuario que realizó la última modificación al registro.
DominioUsuarios válidos en el contexto de seguridad
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas 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ámetroValor
SensibilidadLOW
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

AtributoDetalle
EtiquetaÚltima Actualización
DescripciónFecha y hora de la última modificación del registro.
DominioFechas válidas pasadas o presentes
Público🟢

2. Capa de Interfaz (Frontend)

RequerimientoReglas 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ámetroValor
SensibilidadLOW
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"
}