Reputación¶

Valoraciones, respuestas del comercio, incidencias y alertas operativas.

Dos decisiones estructurales gobiernan el módulo. La primera: una valoración pertenece a una reserva entregada, no a un comercio, y su llave foránea a reserva es única por construcción (OneToOneField). Eso hace imposible por construcción valorar sin haber comprado y valorar dos veces la misma compra, sin escribir ninguna comprobación. La segunda: alerta es la única referencia polimórfica aceptada del modelo, y esta página explica por qué.

Requerimientos cubiertos¶

• RF-U-42
• RF-U-43
• RF-C-50
• RF-A-25
• RF-A-26
• RF-A-32
• RF-A-33
• RF-A-34
• RF-A-35
• RF-A-44
• RF-A-58

valoracion¶

Calificación de una entrega. Relación 1:1 con reserva.

• Régimen: Mutable protegida
• Volumen estimado: 100-500 filas diarias
• Origen:

  • RF-U-42
  • RF-A-26

Columnas¶

Llaves foráneas¶

Constraints¶

CONSTRAINT chk_valoracion_puntuacion CHECK (puntuacion BETWEEN 1 AND 5)
CONSTRAINT chk_valoracion_comentario_longitud CHECK (length(comentario) <= 300)

CONSTRAINT chk_valoracion_moderacion_coherente
CHECK ((moderada_at IS NULL) = (moderada_by IS NULL))

CONSTRAINT chk_valoracion_oculta_con_motivo
CHECK (oculta_at IS NULL OR motivo_moderacion_id IS NOT NULL)

CONSTRAINT chk_valoracion_editada_plazo
CHECK (editada_at IS NULL OR editada_at <= plazo_hasta_at)

Triggers¶

trg_valoracion_reserva_retirada es lo que hace cierta la frase con la que abre este módulo. El OneToOneField hacia reserva hace imposible valorar dos veces la misma compra, pero no hace imposible valorar una compra que nunca ocurrió: nada impide hoy una valoración sobre una reserva cancelada o expirada. El trigger exige retirada_at IS NOT NULL y now() <= plazo_hasta_at.

trg_valoracion_edicion implementa la "sola edición dentro del mismo plazo" de RF-U-42: si puntuacion o comentario cambian, exige que editada_at estuviera en nulo y lo fija. La moderación administrativa (RF-A-26) no cuenta como edición, porque toca otras columnas.

trg_valoracion_calificacion recalcula sobre las valoraciones visibles del comercio (oculta_at IS NULL), de modo que ocultar un comentario por moderación ajusta el promedio en la misma transacción. Cuando no queda ninguna, escribe NULL en el promedio y 0 en el conteo, que es el par que chk_comercio_calificacion_coherente admite.

Notas de diseño¶

plazo_hasta_at es un snapshot y no se calcula al vuelo: el plazo es configurable, y un usuario cuya reserva se entregó bajo un plazo de 72 h no debería perder la oportunidad porque el parámetro bajó a 48 mientras tanto. Quien lo congela es trg_valoracion_snapshot, leyendo valoracion.plazo_horas una sola vez, al crear la fila.

respuesta_valoracion¶

Respuesta pública del comercio. Relación 1:1 con valoracion.

• Régimen: Mutable protegida
• Volumen estimado: decenas de filas diarias
• Origen:

  • RF-C-50
  • RF-A-26

Columnas¶

Nace en el estado "pendiente"-equivalente, no "publicada": asimetría de negocio deliberada frente a valoracion, que nace publicada. Toda respuesta de comercio pasa por moderación antes de ser visible; la valoración del cliente no.

Constraints¶

CONSTRAINT chk_respuestavaloracion_texto_longitud
CHECK (length(texto) BETWEEN 1 AND 300)

CONSTRAINT chk_respuestavaloracion_moderacion
CHECK ((moderada_at IS NULL) = (moderada_by IS NULL))

CONSTRAINT chk_respuestavaloracion_rechazo_con_motivo
CHECK (oculta_at IS NULL OR motivo_rechazo_id IS NOT NULL)

Triggers¶

La llave foránea a usuario_comercio garantiza que el autor es personal de algún comercio, no del comercio que la valoración juzga. Sin el trigger, el operador de un comercio podría responder públicamente en el hilo de otro.

Una sola respuesta por valoración, garantizada por el OneToOneField, es lo que impide que un intercambio público se convierta en un hilo de discusión que nadie va a moderar.

incidencia¶

Reporte de un problema con una entrega.

• Régimen: Mutable protegida
• Volumen estimado: decenas de filas diarias
• Origen:

  • RF-U-43
  • RF-A-32
  • RF-A-33
  • RF-A-34

Columnas¶

Constraints¶

CONSTRAINT chk_incidencia_origen
CHECK (origen IN ('usuario', 'comercio', 'administracion', 'sistema'))

CONSTRAINT chk_incidencia_reportante
CHECK ((origen = 'sistema') = (reportada_by IS NULL))

CONSTRAINT chk_incidencia_descripcion_longitud
CHECK (length(descripcion) BETWEEN 1 AND 500)

CONSTRAINT chk_incidencia_prioridad CHECK (prioridad BETWEEN 1 AND 3)

CONSTRAINT chk_incidencia_resolucion_coherente
CHECK ((resuelta_at IS NULL) = (resuelta_by IS NULL))

CONSTRAINT chk_incidencia_resolucion_completa
CHECK (resuelta_at IS NULL OR length(resolucion) > 0)

Unicidad¶

Índices¶

Triggers¶

trg_incidencia_movimiento es el que sostiene la alerta de 48 h. RF-A-32 es explícito en que la antigüedad se calcula "sobre la fecha del último cambio y no sobre la de apertura", y una columna que el llamador puede escribir a mano no mide eso: basta con no actualizarla para que un caso abandonado nunca dispare la alerta. Es el mismo argumento por el que updated_at la mantiene la base y no el ORM.

trg_incidencia_reportante completa lo que chk_incidencia_reportante deja abierto. La constraint exige que haya reportante cuando el origen no es sistema; el trigger exige que sea el reportante correcto: para origen = 'usuario', la cuenta del perfil que hizo la reserva; para origen = 'comercio', un miembro activo del comercio señalado. Sin él, cualquier cuenta puede abrir una incidencia sobre la reserva de otra persona, y unq_incidencia_reserva_reportante no lo impide porque el par sigue siendo distinto.

incidencia_descargo¶

Descargo del comercio dentro de una incidencia.

• Régimen: Mutable protegida, igual desviación que factor_impacto: la marca respondido_at es un UPDATE real, incompatible con append-only puro.
• Volumen estimado: una a tres filas por incidencia
• Origen:

  • RF-A-34

Columnas¶

Llaves foráneas¶

Constraints¶

CONSTRAINT chk_incidenciadescargo_texto_longitud CHECK (length(texto) <= 1000)
CONSTRAINT chk_incidenciadescargo_vigencia CHECK (vence_at > solicitado_at)

CONSTRAINT chk_incidenciadescargo_respuesta
CHECK (respondido_at IS NULL OR (length(texto) > 0 AND autor_id IS NOT NULL))

CONSTRAINT chk_incidenciadescargo_respuesta_plazo
CHECK (respondido_at IS NULL OR respondido_at <= vence_at)

RF-A-34 dice que "si el plazo vence sin respuesta, la incidencia continúa y esa ausencia queda registrada": la ausencia es el valor nulo, y una respuesta escrita después de vence_at la borraría sin dejar rastro de que llegó tarde.

Triggers¶

trg_readonly_snapshot cubre incidencia_id, autor_id, texto, solicitado_at y vence_at.

trg_incidenciadescargo_respuesta es la mitad que trg_readonly_snapshot no puede dar: la columna tiene que ser mutable una vez, y solo una vez, y eso es una condición sobre el valor viejo (OLD.respondido_at IS NULL) que un ReadOnly no distingue.

alerta¶

Señales operativas que exigen revisión humana. Es la única tabla del modelo con referencia polimórfica.

• Régimen: Mutable protegida
• Volumen estimado: decenas de filas diarias
• Origen:

  • RF-A-25
  • RF-A-44
  • RF-A-58

Columnas¶

tipo/codigo son los nombres reales de lo que las notas de dominio llamaban "familia"/"tipo" en versiones anteriores; esta ficha usa los nombres finales.

Llaves foráneas¶

Constraints¶

CONSTRAINT chk_alerta_tipo CHECK (tipo IN ('moderacion', 'cumplimiento', 'seguridad'))
CONSTRAINT chk_alerta_severidad CHECK (severidad IN ('informativa', 'advertencia', 'critica'))

CONSTRAINT chk_alerta_entidad_tipo
CHECK (entidad_tipo IN ('publicacion', 'comercio', 'usuario', 'reserva', 'parametro', 'exportacion'))

CONSTRAINT chk_alerta_revision_coherente
CHECK ((revisada_at IS NULL) = (revisada_by IS NULL))

CONSTRAINT chk_alerta_datos_tipo CHECK (jsonb_typeof(datos) = 'object')

CONSTRAINT chk_alerta_comercio_entidad
CHECK (entidad_tipo <> 'comercio' OR comercio_id = entidad_id)

Cuando la entidad señalada es un comercio, comercio_id y entidad_id nombran lo mismo, y dos columnas que nombran lo mismo sin restricción que las amarre acaban nombrando cosas distintas. Es el único caso del polimorfismo en que las dos columnas son comparables entre sí.

Unicidad¶

Ese índice único es la diferencia entre un tablero útil y uno que nadie mira: sin él, el proceso diario de cumplimiento generaría una alerta nueva por comercio y por día mientras la tasa siguiera por encima del umbral.

Triggers¶

Vigente. Busca alerta_especificacion por codigo; si no existe (o está inactiva), rechaza. Si tipo/entidad_tipo no coinciden con los de la especificación, rechaza. Por cada clave de claves_requeridas, exige que datos la traiga. Ver Catálogos para el diseño completo de la tabla de especificación.

Las alertas no las inserta nadie a mano: llegan desde trg_publicacion_alerta_moderacion y trg_valoracion_alerta_baja, o desde los procesos programados de cumplimiento y antigüedad. Este trigger es la barrera común a todos esos caminos.

¿Por qué se acepta el polimorfismo aquí?¶

Una referencia polimórfica sin llave foránea renuncia a la integridad referencial, y en este modelo eso solo se acepta aquí. Las alternativas son peores: seis columnas nulas con llave foránea cada una (cinco nulos por fila, y agregar un séptimo tipo de entidad exige alterar una tabla en crecimiento), o seis tablas de alerta (el tablero unificado requeriría una unión de seis).

El riesgo real, una alerta que apunta a una entidad inexistente, está acotado porque ninguna de las entidades referenciadas admite DELETE real: todas están protegidas por su régimen de auditoría.

Las tres familias¶