# Schema LOG

Log inmutable de mensajes del sistema TZZR.

## Tabla 1: log.messages

Registra todos los mensajes entre usuarios y agentes IA.

| Campo | Tipo | Descripción |
|-------|------|-------------|
| id | BIGSERIAL | Índice incremental |
| hash | CHAR(64) | SHA256 único del mensaje |
| session_hash | CHAR(64) | SHA256 de la sesión |
| thread_hash | CHAR(64) | SHA256 del hilo (nullable) |
| sender_type | ENUM | user, agent, orchestrator, system, tool |
| sender_id | CHAR(64) | Hash del emisor (ref players) |
| receiver_type | ENUM | user, agent, orchestrator, system, tool |
| receiver_id | CHAR(64) | Hash del receptor (ref players) |
| leader_id | CHAR(64) | Coordinador multiagente (nullable) |
| role | TEXT | Rol del emisor |
| content | TEXT | Contenido del mensaje |
| attachments | JSONB | Adjuntos |
| prev_hash | CHAR(64) | Hash mensaje anterior (cadena integridad) |
| hashtags | CHAR(64)[] | Etiquetas asociadas |
| ambient | JSONB | Contexto ambiental (nullable) |
| created_at | TIMESTAMPTZ | Timestamp |

## Tabla 2: log.message_refs

Relaciona cada mensaje con su contexto y conocimiento.

| Campo | Tipo | Descripción |
|-------|------|-------------|
| id | BIGSERIAL | Índice incremental |
| message_hash | CHAR(64) | Mensaje que se envía |
| ref_hash | CHAR(64) | Referencia (mensaje, registro contable, secretaría) |
| ref_type | ENUM | context, accountant, secretary |
| position | INT | Orden de la referencia |
| thread_hash | CHAR(64) | Hilo (nullable) |

### Tipos de referencia

- **context**: Mensajes anteriores incluidos como contexto
- **accountant**: Registros de libros contables (conocimiento)
- **secretary**: Registros de secretaría (conocimiento)

## Inmutabilidad

Ambas tablas:
- **INSERT**: Permitido
- **UPDATE**: Bloqueado por trigger
- **DELETE**: Bloqueado por trigger

## Cadena de integridad

```
msg1.hash = SHA256(msg1)
msg2.prev_hash = msg1.hash
msg2.hash = SHA256(msg2)
...
```

Primer mensaje de sesión: `prev_hash = NULL`

## Índices

### log.messages
- `session_hash` - Mensajes de una sesión
- `thread_hash` - Mensajes de un hilo
- `sender_id` - Mensajes enviados
- `receiver_id` - Mensajes recibidos
- `prev_hash` - Cadena de integridad
- `created_at` - Orden cronológico
- `hashtags` (GIN) - Búsqueda por etiquetas

### log.message_refs
- `message_hash` - Referencias de un mensaje
- `ref_hash` - Uso de una referencia
- `ref_type` - Filtrar por tipo
- `thread_hash` - Referencias de un hilo

## Relaciones externas

- `sender_id`, `receiver_id`, `leader_id` → `core.players`
- `hashtags` → `core.hashtags`
- `ref_hash` (context) → `log.messages`
- `ref_hash` (accountant) → libros contables
- `ref_hash` (secretary) → registros secretaría