87 lines
2.5 KiB
Markdown
87 lines
2.5 KiB
Markdown
# 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_id | CHAR(64) | Hash del emisor (ref players) |
|
|
| 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
|