Schema JSONB audit_logs de Tracevault, columnas generadas tras migraciones 002–003, e índices por defecto.

Forma

Cada evento cae en una fila JSONB-first. No hay columnas old_values / new_values separadas — la librería se mantiene orientada a eventos. Mirá el SQL en node_modules/tracevault/sql/ o usá generateInitSql para DDL combinado equivalente.

Columna	Tipo	Notas
id	UUID	Generado por evento.
event	VARCHAR	Nombre del evento (obligatorio en emit).
actor_id	VARCHAR	Nullable.
actor_type	VARCHAR	Nullable.
target_id	VARCHAR	Nullable.
target_type	VARCHAR	Nullable.
data	JSONB	Payload libre.
meta	JSONB	Metadata libre.
mode	VARCHAR	sync \| async.
occurred_at	TIMESTAMPTZ	Provisto o generado al emitir.
created_at	TIMESTAMPTZ	Default now() en DB.
correlation_id	VARCHAR	Nullable.
request_id	VARCHAR	Nullable.
environment	VARCHAR	Nullable.
outcome	VARCHAR(64)	Generado (002+). NULLIF(BTRIM(data->>'outcome'),''). Omitido en insert.
error_code	VARCHAR(255)	Generado. NULLIF(BTRIM(data->'error'->>'code'),''). Omitido en insert.
severity	VARCHAR(32)	Generado (003+). NULLIF(BTRIM(data->>'severity'),''). Omitido en insert.

Índices (por defecto)

event, (actor_id, actor_type), (target_id, target_type), occurred_at DESC
Parcial (correlation_id, occurred_at DESC, id DESC) donde correlation_id no es null
Parcial (error_code, occurred_at DESC) donde error_code no es null
Parcial (outcome, occurred_at DESC) donde outcome no es null
Parcial (severity, occurred_at DESC) donde severity no es null

Lectura

Las columnas generadas existen para lecturas indexadas y acotadas vía audit.query. Para analytics, filtros JSONB o joins, usá la herramienta SQL que ya tenés — Tracevault no bloquea acceso raw.

Referencia canónica: README.