# Plataforma / Core · Diccionario de datos

Relevamiento: 20/11/2026 · Modelo reconstruido desde código y migraciones.

La correspondencia con una base desplegada requiere contraste con su catálogo. Las relaciones entre servicios se distinguen de las claves foráneas locales.

## platform_user

Identidad central de una persona usuaria.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 48 |
| email | varchar(320) | NO |  |  | Migración 1786406400000 · línea 48 |
| display_name | varchar(200) | NO |  |  | Migración 1786406400000 · línea 48 |
| status | varchar(32) | NO |  |  | Migración 1786406400000 · línea 48 |
| session_version | integer | NO |  |  | Migración 1786406400000 · línea 48 |
| last_login_at | timestamptz | SÍ |  |  | Migración 1786406400000 · línea 48 |
| created_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 48 |
| updated_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 48 |
| profile_version | integer | NO |  |  | Migración 1789516800000 · línea 31 |

Claves foráneas:


Restricciones CHECK:

- `CONSTRAINT ck_platform_user_email_normalized CHECK (email = lower(btrim(email)) AND email <> '')` · Migración 1786406400000 · línea 48
- `CONSTRAINT ck_platform_user_display_name CHECK (btrim(display_name) <> '')` · Migración 1786406400000 · línea 48
- `CONSTRAINT ck_platform_user_status CHECK (status IN ('pending_access', 'active', 'suspended', 'blocked'))` · Migración 1786406400000 · línea 48
- `CONSTRAINT ck_platform_user_session_version CHECK (session_version >= 1)` · Migración 1786406400000 · línea 48
- `CONSTRAINT ck_platform_user_timestamps CHECK (updated_at >= created_at)` · Migración 1786406400000 · línea 48
- `CONSTRAINT ck_platform_user_profile_version CHECK (profile_version >= 1)` · Migración 1789516800000 · línea 47

Índices declarados:

- `CREATE UNIQUE INDEX IF NOT EXISTS uq_platform_user_email_normalized ON esquema.platform_user (lower(email)) ` · Migración 1786406400000 · línea 70
- `CREATE INDEX IF NOT EXISTS ix_platform_user_status ON esquema.platform_user (status) ` · Migración 1786406400000 · línea 74

## external_identity

Vínculo de identidad con proveedor externo.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (provider, tenant_id, subject_id); (user_id, provider).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 79 |
| user_id | uuid | NO | FK | platform_user(id) | Migración 1786406400000 · línea 79 |
| provider | varchar(32) | NO |  |  | Migración 1786406400000 · línea 79 |
| tenant_id | varchar(128) | NO |  |  | Migración 1786406400000 · línea 79 |
| subject_id | varchar(128) | NO |  |  | Migración 1786406400000 · línea 79 |
| email_snapshot | varchar(320) | NO |  |  | Migración 1786406400000 · línea 79 |
| linked_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 79 |
| last_login_at | timestamptz | SÍ |  |  | Migración 1786406400000 · línea 79 |

Claves foráneas:

- (user_id) → platform_user(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 79.

Restricciones CHECK:

- `CONSTRAINT ck_external_identity_provider CHECK (provider IN ('entra'))` · Migración 1786406400000 · línea 79
- `CONSTRAINT ck_external_identity_values CHECK ( btrim(tenant_id) <> '' AND btrim(subject_id) <> '' AND email_snapshot = lower(btrim(email_snapshot)) AND email_snapshot <> '' )` · Migración 1786406400000 · línea 79

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_external_identity_user ON esquema.external_identity (user_id) ` · Migración 1786406400000 · línea 101
- `CREATE UNIQUE INDEX IF NOT EXISTS uq_external_identity_user_provider ON esquema.external_identity (user_id, provider) ` · Migración 1786492800000 · línea 64

## local_credential

Credencial local y controles de contraseña.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: user_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| user_id | uuid | NO | PK, FK | platform_user(id) | Migración 1786406400000 · línea 106 |
| password_hash | text | NO |  |  | Migración 1786406400000 · línea 106 |
| hash_algorithm | varchar(32) | NO |  |  | Migración 1786406400000 · línea 106 |
| failed_attempt_count | integer | NO |  |  | Migración 1786406400000 · línea 106 |
| locked_until | timestamptz | SÍ |  |  | Migración 1786406400000 · línea 106 |
| password_changed_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 106 |

Claves foráneas:

- (user_id) → platform_user(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1786406400000 · línea 106.

Restricciones CHECK:

- `CONSTRAINT ck_local_credential_failed_attempts CHECK (failed_attempt_count >= 0)` · Migración 1786406400000 · línea 106
- `CONSTRAINT ck_local_credential_hash CHECK ( password_hash <> '' AND hash_algorithm = 'argon2id' )` · Migración 1786492800000 · línea 58

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_local_credential_locked_until ON esquema.local_credential (locked_until) WHERE locked_until IS NOT NULL ` · Migración 1786406400000 · línea 125

## platform_session

Sesión central de acceso.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (token_hash).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 155 |
| user_id | uuid | NO | FK | platform_user(id) | Migración 1786406400000 · línea 155 |
| external_identity_id | uuid | SÍ | FK | external_identity(id) | Migración 1786406400000 · línea 155 |
| auth_method | varchar(32) | NO |  |  | Migración 1786406400000 · línea 155 |
| status | varchar(32) | NO |  |  | Migración 1786406400000 · línea 155 |
| created_ip | inet | SÍ |  |  | Migración 1786406400000 · línea 155 |
| created_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 155 |
| last_seen_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 155 |
| expires_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 155 |
| revoked_at | timestamptz | SÍ |  |  | Migración 1786406400000 · línea 155 |
| token_hash | text | NO |  |  | Migración 1786492800000 · línea 90 |

Claves foráneas:

- (user_id) → platform_user(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 155.
- (external_identity_id) → external_identity(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 155.

Restricciones CHECK:

- `CONSTRAINT ck_platform_session_auth_method CHECK (auth_method IN ('entra', 'local'))` · Migración 1786406400000 · línea 155
- `CONSTRAINT ck_platform_session_status CHECK (status IN ('active', 'revoked', 'expired'))` · Migración 1786406400000 · línea 155
- `CONSTRAINT ck_platform_session_identity CHECK ( (auth_method = 'entra' AND external_identity_id IS NOT NULL) OR (auth_method = 'local' AND external_identity_id IS NULL) )` · Migración 1786406400000 · línea 155
- `CONSTRAINT ck_platform_session_timestamps CHECK ( last_seen_at >= created_at AND expires_at > created_at AND (revoked_at IS NULL OR revoked_at >= created_at) )` · Migración 1786406400000 · línea 155

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_platform_session_user_status_expires ON esquema.platform_session (user_id, status, expires_at) ` · Migración 1786406400000 · línea 187
- `CREATE INDEX IF NOT EXISTS ix_platform_session_status_expires ON esquema.platform_session (status, expires_at) ` · Migración 1786406400000 · línea 191
- `CREATE UNIQUE INDEX IF NOT EXISTS uq_platform_session_token_hash ON esquema.platform_session (token_hash) ` · Migración 1786492800000 · línea 98

## token_signing_key

Ciclo de vida de claves de firma.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (kid).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 196 |
| kid | varchar(128) | NO |  |  | Migración 1786406400000 · línea 196 |
| algorithm | varchar(64) | NO |  |  | Migración 1786406400000 · línea 196 |
| public_jwk | jsonb | NO |  |  | Migración 1786406400000 · línea 196 |
| private_key_secret_ref | varchar(512) | NO |  |  | Migración 1786406400000 · línea 196 |
| status | varchar(32) | NO |  |  | Migración 1786406400000 · línea 196 |
| not_before | timestamptz | NO |  |  | Migración 1786406400000 · línea 196 |
| expires_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 196 |
| retired_at | timestamptz | SÍ |  |  | Migración 1786406400000 · línea 196 |

Claves foráneas:


Restricciones CHECK:

- `CONSTRAINT ck_token_signing_key_values CHECK ( btrim(kid) <> '' AND btrim(algorithm) <> '' AND jsonb_typeof(public_jwk) = 'object' AND btrim(private_key_secret_ref) <> '' )` · Migración 1786406400000 · línea 196
- `CONSTRAINT ck_token_signing_key_status CHECK (status IN ('pending', 'active', 'retiring', 'retired'))` · Migración 1786406400000 · línea 196
- `CONSTRAINT ck_token_signing_key_lifetime CHECK ( expires_at > not_before AND (retired_at IS NULL OR retired_at >= not_before) )` · Migración 1786406400000 · línea 196

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_token_signing_key_status_validity ON esquema.token_signing_key (status, not_before, expires_at) ` · Migración 1786406400000 · línea 221

## platform_module

Módulo habilitable de la plataforma.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (code); (base_path); (api_audience); (api_cookie_path).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 226 |
| code | varchar(64) | NO |  |  | Migración 1786406400000 · línea 226 |
| name | varchar(120) | NO |  |  | Migración 1786406400000 · línea 226 |
| base_path | varchar(160) | NO |  |  | Migración 1786406400000 · línea 226 |
| api_audience | varchar(120) | NO |  |  | Migración 1786406400000 · línea 226 |
| api_cookie_path | varchar(160) | NO |  |  | Migración 1786406400000 · línea 226 |
| status | varchar(32) | NO |  |  | Migración 1786406400000 · línea 226 |
| sort_order | integer | NO |  |  | Migración 1786406400000 · línea 226 |
| created_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 226 |
| updated_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 226 |

Claves foráneas:


Restricciones CHECK:

- `CONSTRAINT ck_platform_module_code CHECK (code = lower(code) AND code ~ '^[a-z][a-z0-9_]*$')` · Migración 1786406400000 · línea 226
- `CONSTRAINT ck_platform_module_paths CHECK ( base_path ~ '^/[a-z][a-z0-9_-]*$' AND api_cookie_path ~ '^/api/[a-z][a-z0-9_-]*$' )` · Migración 1786406400000 · línea 226
- `CONSTRAINT ck_platform_module_status CHECK (status IN ('active', 'inactive'))` · Migración 1786406400000 · línea 226
- `CONSTRAINT ck_platform_module_timestamps CHECK (updated_at >= created_at)` · Migración 1786406400000 · línea 226

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_platform_module_status_sort ON esquema.platform_module (status, sort_order) ` · Migración 1786406400000 · línea 253

## user_module_access

Acceso de una persona a un módulo.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (user_id, module_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 258 |
| user_id | uuid | NO | FK | platform_user(id) | Migración 1786406400000 · línea 258 |
| module_id | uuid | NO | FK | platform_module(id) | Migración 1786406400000 · línea 258 |
| status | varchar(32) | NO |  |  | Migración 1786406400000 · línea 258 |
| reason | text | SÍ |  |  | Migración 1786406400000 · línea 258 |
| granted_by_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1786406400000 · línea 258 |
| version | integer | NO |  |  | Migración 1786406400000 · línea 258 |
| updated_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 258 |

Claves foráneas:

- (user_id) → platform_user(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 258.
- (module_id) → platform_module(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 258.
- (granted_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 258.

Restricciones CHECK:

- `CONSTRAINT ck_user_module_access_status CHECK (status IN ('pending', 'active', 'suspended', 'revoked'))` · Migración 1786406400000 · línea 258
- `CONSTRAINT ck_user_module_access_version CHECK (version >= 1)` · Migración 1786406400000 · línea 258

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_user_module_access_user_status ON esquema.user_module_access (user_id, status) ` · Migración 1786406400000 · línea 283
- `CREATE INDEX IF NOT EXISTS ix_user_module_access_module_status ON esquema.user_module_access (module_id, status) ` · Migración 1786406400000 · línea 287

## role

Rol de autorización del dominio.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (code).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 292 |
| code | varchar(120) | NO |  |  | Migración 1786406400000 · línea 292 |
| name | varchar(160) | NO |  |  | Migración 1786406400000 · línea 292 |
| description | text | NO |  |  | Migración 1786406400000 · línea 292 |
| is_active | boolean | NO |  |  | Migración 1786406400000 · línea 292 |
| is_system | boolean | NO |  |  | Migración 1786406400000 · línea 292 |
| is_protected | boolean | NO |  |  | Migración 1786406400000 · línea 292 |
| protection_level | integer | NO |  |  | Migración 1786406400000 · línea 292 |
| version | integer | NO |  |  | Migración 1786406400000 · línea 292 |
| created_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 292 |

Claves foráneas:


Restricciones CHECK:

- `CONSTRAINT ck_role_code CHECK (code = lower(code) AND code ~ '^[a-z][a-z0-9_]*$')` · Migración 1786406400000 · línea 292
- `CONSTRAINT ck_role_version CHECK (version >= 1)` · Migración 1786406400000 · línea 292
- `CONSTRAINT ck_role_protection CHECK ( protection_level IN (0, 50, 100) AND (is_protected OR protection_level = 0) )` · Migración 1788307200000 · línea 375

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_role_active_protection ON esquema.role (is_active, protection_level) ` · Migración 1786406400000 · línea 314

## permission

Permiso granular del dominio.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (code).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 319 |
| code | varchar(160) | NO |  |  | Migración 1786406400000 · línea 319 |
| name | varchar(200) | NO |  |  | Migración 1786406400000 · línea 319 |
| category | varchar(80) | NO |  |  | Migración 1786406400000 · línea 319 |
| description | text | NO |  |  | Migración 1786406400000 · línea 319 |
| is_reserved | boolean | NO |  |  | Migración 1786406400000 · línea 319 |
| required_protection_level | integer | NO |  |  | Migración 1786406400000 · línea 319 |
| is_active | boolean | NO |  |  | Migración 1786406400000 · línea 319 |

Claves foráneas:


Restricciones CHECK:

- `CONSTRAINT ck_permission_code CHECK (code = lower(code) AND code ~ '^[a-z][a-z0-9_.]*$')` · Migración 1786406400000 · línea 319
- `CONSTRAINT ck_permission_protection CHECK ( required_protection_level IN (0, 50, 100) AND ((is_reserved AND required_protection_level > 0) OR (NOT is_reserved AND required_protection_level = 0)) )` · Migración 1788307200000 · línea 383

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_permission_category_active ON esquema.permission (category, is_active) ` · Migración 1786406400000 · línea 339
- `CREATE INDEX IF NOT EXISTS ix_permission_reserved_level ON esquema.permission (is_reserved, required_protection_level) ` · Migración 1786406400000 · línea 343

## user_role

Asignación de roles a usuarios.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: user_id, role_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| user_id | uuid | NO | PK, FK | platform_user(id) | Migración 1786406400000 · línea 348 |
| role_id | uuid | NO | PK, FK | role(id) | Migración 1786406400000 · línea 348 |
| assigned_by_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1786406400000 · línea 348 |
| assigned_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 348 |
| expires_at | timestamptz | SÍ |  |  | Migración 1786406400000 · línea 348 |
| is_active | boolean | NO |  |  | Migración 1786406400000 · línea 348 |

Claves foráneas:

- (user_id) → platform_user(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 348.
- (role_id) → role(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 348.
- (assigned_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 348.

Restricciones CHECK:

- `CONSTRAINT ck_user_role_expiry CHECK (expires_at IS NULL OR expires_at > assigned_at)` · Migración 1786406400000 · línea 348

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_user_role_active_role ON esquema.user_role (role_id, user_id) WHERE is_active = true ` · Migración 1786406400000 · línea 370
- `CREATE INDEX IF NOT EXISTS ix_user_role_user_active ON esquema.user_role (user_id, is_active) ` · Migración 1786406400000 · línea 375

## role_permission

Tabla puente entre roles y permisos.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: role_id, permission_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| role_id | uuid | NO | PK, FK | role(id) | Migración 1786406400000 · línea 380 |
| permission_id | uuid | NO | PK, FK | permission(id) | Migración 1786406400000 · línea 380 |
| granted_by_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1786406400000 · línea 380 |
| granted_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 380 |

Claves foráneas:

- (role_id) → role(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 380.
- (permission_id) → permission(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 380.
- (granted_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 380.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_role_permission_permission ON esquema.role_permission (permission_id) ` · Migración 1786406400000 · línea 398

## permission_dependency

Dependencias entre permisos.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: permission_id, required_permission_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| permission_id | uuid | NO | PK, FK | permission(id) | Migración 1786406400000 · línea 403 |
| required_permission_id | uuid | NO | PK, FK | permission(id) | Migración 1786406400000 · línea 403 |

Claves foráneas:

- (permission_id) → permission(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 403.
- (required_permission_id) → permission(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 403.

Restricciones CHECK:

- `CONSTRAINT ck_permission_dependency_not_self CHECK (permission_id <> required_permission_id)` · Migración 1786406400000 · línea 403

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_permission_dependency_required ON esquema.permission_dependency (required_permission_id) ` · Migración 1786406400000 · línea 418

## space_type

Tipo de espacio.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (code).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 435 |
| code | varchar(80) | NO |  |  | Migración 1786406400000 · línea 435 |
| name | varchar(160) | NO |  |  | Migración 1786406400000 · línea 435 |
| description | text | NO |  |  | Migración 1786406400000 · línea 435 |
| is_color_anchor | boolean | NO |  |  | Migración 1786406400000 · línea 435 |
| can_have_children | boolean | NO |  |  | Migración 1786406400000 · línea 435 |
| is_active | boolean | NO |  |  | Migración 1786406400000 · línea 435 |
| sort_order | integer | NO |  |  | Migración 1786406400000 · línea 435 |

Claves foráneas:


Restricciones CHECK:

- `CONSTRAINT ck_space_type_code CHECK (code = lower(code) AND code ~ '^[a-z][a-z0-9_]*$')` · Migración 1786406400000 · línea 435
- `CONSTRAINT ck_space_type_name CHECK (btrim(name) <> '')` · Migración 1786406400000 · línea 435

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_space_type_active_sort ON esquema.space_type (is_active, sort_order) ` · Migración 1786406400000 · línea 451

## space

Espacio canónico del predio.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (code).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 456 |
| code | varchar(120) | NO |  |  | Migración 1786406400000 · línea 456 |
| name | varchar(200) | NO |  |  | Migración 1786406400000 · línea 456 |
| description | text | NO |  |  | Migración 1786406400000 · línea 456 |
| space_type_id | uuid | NO | FK | space_type(id) | Migración 1786406400000 · línea 456 |
| parent_id | uuid | SÍ | FK | space(id) | Migración 1786406400000 · línea 456 |
| status | varchar(32) | NO |  |  | Migración 1786406400000 · línea 456 |
| sort_order | integer | NO |  |  | Migración 1786406400000 · línea 456 |
| color_hex | varchar(7) | SÍ |  |  | Migración 1786406400000 · línea 456 |
| area_m2 | numeric(12, 2) | SÍ |  |  | Migración 1786406400000 · línea 456 |
| dimensions | jsonb | SÍ |  |  | Migración 1786406400000 · línea 456 |
| notes | text | SÍ |  |  | Migración 1786406400000 · línea 456 |
| version | integer | NO |  |  | Migración 1786406400000 · línea 456 |
| published_at | timestamptz | SÍ |  |  | Migración 1786406400000 · línea 456 |
| created_by_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1786406400000 · línea 456 |
| updated_by_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1786406400000 · línea 456 |
| created_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 456 |
| updated_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 456 |

Claves foráneas:

- (space_type_id) → space_type(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 456.
- (parent_id) → space(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 456.
- (created_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 456.
- (updated_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 456.

Restricciones CHECK:

- `CONSTRAINT ck_space_code CHECK (code = lower(code) AND code ~ '^[a-z0-9][a-z0-9_-]*$')` · Migración 1786406400000 · línea 456
- `CONSTRAINT ck_space_status CHECK (status IN ('draft', 'active', 'inactive', 'retired'))` · Migración 1786406400000 · línea 456
- `CONSTRAINT ck_space_not_self_parent CHECK (parent_id IS NULL OR parent_id <> id)` · Migración 1786406400000 · línea 456
- `CONSTRAINT ck_space_color CHECK (color_hex IS NULL OR color_hex ~ '^#[0-9A-Fa-f]{6}$')` · Migración 1786406400000 · línea 456
- `CONSTRAINT ck_space_dimensions CHECK ( dimensions IS NULL OR jsonb_typeof(dimensions) = 'object' )` · Migración 1786406400000 · línea 456
- `CONSTRAINT ck_space_version CHECK (version >= 1)` · Migración 1786406400000 · línea 456
- `CONSTRAINT ck_space_timestamps CHECK (updated_at >= created_at)` · Migración 1786406400000 · línea 456
- `CONSTRAINT ck_space_area CHECK (area_m2 IS NULL OR area_m2 > 0)` · Migración 1788393600000 · línea 113
- `CONSTRAINT ck_space_sort_order_nonnegative CHECK (sort_order >= 0)` · Migración 1788393600000 · línea 113
- `CONSTRAINT ck_space_publication CHECK ( (status = 'draft' AND published_at IS NULL) OR (status <> 'draft' AND published_at IS NOT NULL) )` · Migración 1788393600000 · línea 113
- `CONSTRAINT ck_space_root_type CHECK ( (space_type_id = '${PREDIO_SPACE_TYPE.id}'::uuid AND parent_id IS NULL) OR (space_type_id <> '${PREDIO_SPACE_TYPE.id}'::uuid AND parent_id IS NOT NULL) )` · Migración 1788393600000 · línea 113

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_space_parent_sort ON esquema.space (parent_id, sort_order) ` · Migración 1786406400000 · línea 504
- `CREATE INDEX IF NOT EXISTS ix_space_type_status ON esquema.space (space_type_id, status) ` · Migración 1786406400000 · línea 508
- `CREATE UNIQUE INDEX uq_space_single_root ON esquema.space ((true)) WHERE parent_id IS NULL ` · Migración 1788393600000 · línea 127
- `CREATE INDEX ix_space_status_tree_order ON esquema.space (status, sort_order, code, id) ` · Migración 1788393600000 · línea 131

## space_code_alias

Códigos alternativos/históricos de espacios.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (alias_code).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 513 |
| space_id | uuid | NO | FK | space(id) | Migración 1786406400000 · línea 513 |
| alias_code | varchar(120) | NO |  |  | Migración 1786406400000 · línea 513 |
| reason | text | NO |  |  | Migración 1786406400000 · línea 513 |
| created_by_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1786406400000 · línea 513 |
| created_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 513 |

Claves foráneas:

- (space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 513.
- (created_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 513.

Restricciones CHECK:

- `CONSTRAINT ck_space_code_alias_code CHECK ( alias_code = lower(alias_code) AND alias_code ~ '^[a-z0-9][a-z0-9_-]*$' )` · Migración 1786406400000 · línea 513
- `CONSTRAINT ck_space_code_alias_reason CHECK (btrim(reason) <> '')` · Migración 1786406400000 · línea 513

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_space_code_alias_space ON esquema.space_code_alias (space_id) ` · Migración 1786406400000 · línea 534

## space_parent_history

Historia de parentesco de espacios.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 539 |
| space_id | uuid | NO | FK | space(id) | Migración 1786406400000 · línea 539 |
| parent_space_id | uuid | SÍ | FK | space(id) | Migración 1786406400000 · línea 539 |
| valid_from | timestamptz | NO |  |  | Migración 1786406400000 · línea 539 |
| valid_to | timestamptz | SÍ |  |  | Migración 1786406400000 · línea 539 |
| reason | text | NO |  |  | Migración 1786406400000 · línea 539 |
| changed_by_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1786406400000 · línea 539 |
| recorded_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 539 |

Claves foráneas:

- (space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 539.
- (parent_space_id) → space(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 539.
- (changed_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 539.

Restricciones CHECK:

- `CONSTRAINT ck_space_parent_history_not_self CHECK (parent_space_id IS NULL OR parent_space_id <> space_id)` · Migración 1786406400000 · línea 539
- `CONSTRAINT ck_space_parent_history_validity CHECK (valid_to IS NULL OR valid_to > valid_from)` · Migración 1786406400000 · línea 539
- `CONSTRAINT ck_space_parent_history_reason CHECK (btrim(reason) <> '')` · Migración 1786406400000 · línea 539

Índices declarados:

- `CREATE UNIQUE INDEX IF NOT EXISTS uq_space_parent_history_current ON esquema.space_parent_history (space_id) WHERE valid_to IS NULL ` · Migración 1786406400000 · línea 565
- `CREATE INDEX IF NOT EXISTS ix_space_parent_history_parent_valid ON esquema.space_parent_history (parent_space_id, valid_from) ` · Migración 1786406400000 · línea 570
- `CREATE INDEX ix_space_parent_history_space_validity ON esquema.space_parent_history (space_id, valid_from DESC, valid_to) ` · Migración 1788393600000 · línea 135

## space_lineage

Cierre de jerarquía espacial.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (source_space_id, target_space_id, relation_type).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 575 |
| source_space_id | uuid | NO | FK | space(id) | Migración 1786406400000 · línea 575 |
| target_space_id | uuid | NO | FK | space(id) | Migración 1786406400000 · línea 575 |
| relation_type | varchar(32) | NO |  |  | Migración 1786406400000 · línea 575 |
| effective_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 575 |
| reason | text | NO |  |  | Migración 1786406400000 · línea 575 |
| created_by_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1786406400000 · línea 575 |
| created_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 575 |

Claves foráneas:

- (source_space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 575.
- (target_space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 575.
- (created_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 575.

Restricciones CHECK:

- `CONSTRAINT ck_space_lineage_not_self CHECK (source_space_id <> target_space_id)` · Migración 1786406400000 · línea 575
- `CONSTRAINT ck_space_lineage_relation CHECK (relation_type IN ('split_into', 'merged_into', 'replaced_by'))` · Migración 1786406400000 · línea 575
- `CONSTRAINT ck_space_lineage_reason CHECK (btrim(reason) <> '')` · Migración 1786406400000 · línea 575

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_space_lineage_target ON esquema.space_lineage (target_space_id, effective_at) ` · Migración 1786406400000 · línea 603
- `CREATE INDEX ix_space_lineage_source_effective ON esquema.space_lineage (source_space_id, effective_at) ` · Migración 1788393600000 · línea 140

## space_module_setting

Disponibilidad espacial por módulo.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: space_id, module_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| space_id | uuid | NO | PK, FK | space(id) | Migración 1786406400000 · línea 608 |
| module_id | uuid | NO | PK, FK | platform_module(id) | Migración 1786406400000 · línea 608 |
| selection_state | varchar(32) | NO |  |  | Migración 1786406400000 · línea 608 |
| reason | text | NO |  |  | Migración 1786406400000 · línea 608 |
| version | integer | NO |  |  | Migración 1786406400000 · línea 608 |
| updated_by_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1786406400000 · línea 608 |
| created_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 608 |
| updated_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 608 |

Claves foráneas:

- (space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 608.
- (module_id) → platform_module(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 608.
- (updated_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 608.

Restricciones CHECK:

- `CONSTRAINT ck_space_module_setting_state CHECK (selection_state IN ('enabled', 'disabled'))` · Migración 1786406400000 · línea 608
- `CONSTRAINT ck_space_module_setting_reason CHECK (btrim(reason) <> '')` · Migración 1786406400000 · línea 608
- `CONSTRAINT ck_space_module_setting_version CHECK (version >= 1)` · Migración 1786406400000 · línea 608
- `CONSTRAINT ck_space_module_setting_timestamps CHECK (updated_at >= created_at)` · Migración 1786406400000 · línea 608

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_space_module_setting_module_state ON esquema.space_module_setting (module_id, selection_state) ` · Migración 1786406400000 · línea 635

## service_client

Identidad de un cliente de integración.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (client_code).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 647 |
| module_id | uuid | NO | FK | platform_module(id) | Migración 1786406400000 · línea 647 |
| client_code | varchar(120) | NO |  |  | Migración 1786406400000 · línea 647 |
| name | varchar(200) | NO |  |  | Migración 1786406400000 · línea 647 |
| status | varchar(32) | NO |  |  | Migración 1786406400000 · línea 647 |
| auth_method | varchar(32) | NO |  |  | Migración 1786406400000 · línea 647 |
| credential_secret_ref | text | NO |  |  | Migración 1786406400000 · línea 647 |
| token_version | integer | NO |  |  | Migración 1786406400000 · línea 647 |
| created_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 647 |
| updated_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 647 |

Claves foráneas:

- (module_id) → platform_module(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 647.

Restricciones CHECK:

- `CONSTRAINT ck_service_client_code CHECK (client_code = lower(client_code) AND client_code ~ '^[a-z][a-z0-9_-]*$')` · Migración 1786406400000 · línea 647
- `CONSTRAINT ck_service_client_status CHECK (status IN ('active', 'suspended', 'revoked'))` · Migración 1786406400000 · línea 647
- `CONSTRAINT ck_service_client_auth_method CHECK (auth_method IN ('private_key_jwt', 'mtls'))` · Migración 1786406400000 · línea 647
- `CONSTRAINT ck_service_client_secret_ref CHECK (btrim(credential_secret_ref) <> '')` · Migración 1786406400000 · línea 647
- `CONSTRAINT ck_service_client_version CHECK (token_version >= 1)` · Migración 1786406400000 · línea 647
- `CONSTRAINT ck_service_client_timestamps CHECK (updated_at >= created_at)` · Migración 1786406400000 · línea 647

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_service_client_module_status ON esquema.service_client (module_id, status) ` · Migración 1786406400000 · línea 675

## service_scope

Alcance autorizado de un servicio.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: code. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| code | varchar(160) | NO | PK |  | Migración 1786406400000 · línea 680 |
| description | text | NO |  |  | Migración 1786406400000 · línea 680 |
| is_active | boolean | NO |  |  | Migración 1786406400000 · línea 680 |

Claves foráneas:


Restricciones CHECK:

- `CONSTRAINT ck_service_scope_code CHECK (code = lower(code) AND code ~ '^[a-z][a-z0-9_.:]*$')` · Migración 1786406400000 · línea 680

Índices declarados:

Sin declaración adicional identificada.

## service_client_scope

Tabla puente cliente/alcance.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: service_client_id, scope_code. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| service_client_id | uuid | NO | PK, FK | service_client(id) | Migración 1786406400000 · línea 690 |
| scope_code | varchar(160) | NO | PK, FK | service_scope(code) | Migración 1786406400000 · línea 690 |
| granted_by_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1786406400000 · línea 690 |
| granted_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 690 |

Claves foráneas:

- (service_client_id) → service_client(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 690.
- (scope_code) → service_scope(code). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 690.
- (granted_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 690.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_service_client_scope_scope ON esquema.service_client_scope (scope_code) ` · Migración 1786406400000 · línea 708

## idempotency_record

Control de repetición de solicitudes.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: record_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| service_client_id | uuid | SÍ | FK | service_client(id) | Migración 1786406400000 · línea 713 |
| idempotency_key | varchar(200) | NO |  |  | Migración 1786406400000 · línea 713 |
| operation | varchar(160) | NO |  |  | Migración 1786406400000 · línea 713 |
| request_hash | varchar(128) | NO |  |  | Migración 1786406400000 · línea 713 |
| response_status | integer | NO |  |  | Migración 1786406400000 · línea 713 |
| response_body | jsonb | NO |  |  | Migración 1786406400000 · línea 713 |
| created_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 713 |
| expires_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 713 |
| record_id | bigint | NO | PK |  | Migración 1788307200000 · línea 75 |
| actor_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1788307200000 · línea 79 |

Claves foráneas:

- (service_client_id) → service_client(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 713.
- (actor_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1788307200000 · línea 79.

Restricciones CHECK:

- `CONSTRAINT ck_idempotency_record_values CHECK ( btrim(idempotency_key) <> '' AND btrim(operation) <> '' AND btrim(request_hash) <> '' AND response_status BETWEEN 100 AND 599 )` · Migración 1786406400000 · línea 713
- `CONSTRAINT ck_idempotency_record_lifetime CHECK (expires_at > created_at)` · Migración 1786406400000 · línea 713
- `CONSTRAINT ck_idempotency_record_scope CHECK ( (service_client_id IS NOT NULL AND actor_user_id IS NULL) OR (service_client_id IS NULL AND actor_user_id IS NOT NULL) )` · Migración 1788307200000 · línea 79

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_idempotency_record_expires ON esquema.idempotency_record (expires_at) ` · Migración 1786406400000 · línea 734
- `CREATE UNIQUE INDEX uq_idempotency_record_service_key ON esquema.idempotency_record (service_client_id, idempotency_key) WHERE service_client_id IS NOT NULL ` · Migración 1788307200000 · línea 93
- `CREATE UNIQUE INDEX uq_idempotency_record_actor_key ON esquema.idempotency_record (actor_user_id, idempotency_key) WHERE actor_user_id IS NOT NULL ` · Migración 1788307200000 · línea 98

## outbox_event

Mensaje saliente transaccional.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: event_id. Unicidad total: (sequence); (aggregate_type, aggregate_id, aggregate_version).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| event_id | uuid | NO | PK |  | Migración 1786406400000 · línea 739 |
| sequence | bigint | SÍ |  |  | Migración 1786406400000 · línea 739 |
| event_type | varchar(200) | NO |  |  | Migración 1786406400000 · línea 739 |
| schema_version | integer | NO |  |  | Migración 1786406400000 · línea 739 |
| aggregate_type | varchar(120) | NO |  |  | Migración 1786406400000 · línea 739 |
| aggregate_id | uuid | NO |  |  | Migración 1786406400000 · línea 739 |
| aggregate_version | integer | NO |  |  | Migración 1786406400000 · línea 739 |
| correlation_id | uuid | NO |  |  | Migración 1786406400000 · línea 739 |
| payload | jsonb | NO |  |  | Migración 1786406400000 · línea 739 |
| status | varchar(32) | NO |  |  | Migración 1786406400000 · línea 739 |
| attempt_count | integer | NO |  |  | Migración 1786406400000 · línea 739 |
| occurred_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 739 |
| available_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 739 |
| next_attempt_at | timestamptz | SÍ |  |  | Migración 1786406400000 · línea 739 |
| published_at | timestamptz | SÍ |  |  | Migración 1786406400000 · línea 739 |
| last_error | text | SÍ |  |  | Migración 1786406400000 · línea 739 |
| lease_expires_at | timestamptz | SÍ |  |  | Migración 1789516800000 · línea 53 |

Claves foráneas:


Restricciones CHECK:

- `CONSTRAINT ck_outbox_event_values CHECK ( btrim(event_type) <> '' AND schema_version >= 1 AND btrim(aggregate_type) <> '' AND aggregate_version >= 1 AND jsonb_typeof(payload) = 'object' )` · Migración 1786406400000 · línea 739
- `CONSTRAINT ck_outbox_event_status CHECK (status IN ('pending', 'publishing', 'published', 'failed'))` · Migración 1786406400000 · línea 739
- `CONSTRAINT ck_outbox_event_attempts CHECK (attempt_count >= 0)` · Migración 1786406400000 · línea 739
- `CONSTRAINT ck_outbox_event_timestamps CHECK ( available_at >= occurred_at AND (next_attempt_at IS NULL OR next_attempt_at >= occurred_at) AND (published_at IS NULL OR published_at >= occurred_at) )` · Migración 1786406400000 · línea 739

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_outbox_event_claim ON esquema.outbox_event (status, available_at, next_attempt_at, sequence) ` · Migración 1786406400000 · línea 775
- `CREATE INDEX IF NOT EXISTS ix_outbox_event_aggregate ON esquema.outbox_event (aggregate_type, aggregate_id, aggregate_version) ` · Migración 1786406400000 · línea 779
- `CREATE INDEX ix_outbox_event_lease_recovery ON esquema.outbox_event (lease_expires_at, sequence) WHERE status = 'publishing' ` · Migración 1789516800000 · línea 57

## space_catalog_change

Registro incremental de cambios del catálogo.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: sequence. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| sequence | bigint | NO | PK |  | Migración 1786406400000 · línea 784 |
| space_id | uuid | NO | FK | space(id) | Migración 1786406400000 · línea 784 |
| module_id | uuid | SÍ | FK | platform_module(id) | Migración 1786406400000 · línea 784 |
| entity_version | integer | NO |  |  | Migración 1786406400000 · línea 784 |
| change_type | varchar(80) | NO |  |  | Migración 1786406400000 · línea 784 |
| projection_payload | jsonb | NO |  |  | Migración 1786406400000 · línea 784 |
| outbox_event_id | uuid | SÍ |  |  | Migración 1786406400000 · línea 784 |
| occurred_at | timestamptz | NO |  |  | Migración 1786406400000 · línea 784 |

Claves foráneas:

- (space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 784.
- (module_id) → platform_module(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 784.

Restricciones CHECK:

- `CONSTRAINT ck_space_catalog_change_values CHECK ( entity_version >= 1 AND btrim(change_type) <> '' AND jsonb_typeof(projection_payload) = 'object' )` · Migración 1786406400000 · línea 784

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_space_catalog_change_space_sequence ON esquema.space_catalog_change (space_id, sequence) ` · Migración 1786406400000 · línea 806
- `CREATE INDEX IF NOT EXISTS ix_space_catalog_change_module_sequence ON esquema.space_catalog_change (module_id, sequence) ` · Migración 1786406400000 · línea 810
- `CREATE UNIQUE INDEX IF NOT EXISTS uq_space_catalog_change_outbox_event ON esquema.space_catalog_change (outbox_event_id) WHERE outbox_event_id IS NOT NULL ` · Migración 1786406400000 · línea 814
- `CREATE INDEX ix_space_catalog_change_module_space_sequence ON esquema.space_catalog_change (module_id, space_id, sequence DESC) ` · Migración 1788393600000 · línea 145

## audit_log

Registro canónico de auditoría particionado.

Estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: occurred_at, id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| occurred_at | timestamptz | NO | PK |  | Migración 1786406400000 · línea 827 |
| id | uuid | NO | PK |  | Migración 1786406400000 · línea 827 |
| domain | varchar(32) | NO |  |  | Migración 1786406400000 · línea 827 |
| action | varchar(200) | NO |  |  | Migración 1786406400000 · línea 827 |
| actor_type | varchar(32) | NO |  |  | Migración 1786406400000 · línea 827 |
| actor_user_id | uuid | SÍ | FK | platform_user(id) | Migración 1786406400000 · línea 827 |
| actor_service_client_id | uuid | SÍ | FK | service_client(id) | Migración 1786406400000 · línea 827 |
| session_id | uuid | SÍ | FK | platform_session(id) | Migración 1786406400000 · línea 827 |
| actor_email_snapshot | varchar(320) | SÍ |  |  | Migración 1786406400000 · línea 827 |
| actor_name_snapshot | varchar(200) | SÍ |  |  | Migración 1786406400000 · línea 827 |
| target_type | varchar(160) | NO |  |  | Migración 1786406400000 · línea 827 |
| target_id | varchar(320) | SÍ |  |  | Migración 1786406400000 · línea 827 |
| result | varchar(32) | NO |  |  | Migración 1786406400000 · línea 827 |
| reason | text | SÍ |  |  | Migración 1786406400000 · línea 827 |
| before_data | jsonb | SÍ |  |  | Migración 1786406400000 · línea 827 |
| after_data | jsonb | SÍ |  |  | Migración 1786406400000 · línea 827 |
| request_id | uuid | SÍ |  |  | Migración 1786406400000 · línea 827 |
| correlation_id | uuid | SÍ |  |  | Migración 1786406400000 · línea 827 |
| source_ip | inet | SÍ |  |  | Migración 1786406400000 · línea 827 |
| user_agent | text | SÍ |  |  | Migración 1786406400000 · línea 827 |
| required_protection_level | integer | NO |  |  | Migración 1788307200000 · línea 115 |
| error_code | varchar(160) | SÍ |  |  | Migración 1788307200000 · línea 115 |

Claves foráneas:

- (actor_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 827.
- (actor_service_client_id) → service_client(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 827.
- (session_id) → platform_session(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1786406400000 · línea 827.

Restricciones CHECK:

- `CONSTRAINT ck_audit_log_action CHECK (btrim(action) <> '')` · Migración 1786406400000 · línea 827
- `CONSTRAINT ck_audit_log_actor_type CHECK (actor_type IN ('user', 'service', 'system'))` · Migración 1786406400000 · línea 827
- `CONSTRAINT ck_audit_log_email_snapshot CHECK ( actor_email_snapshot IS NULL OR actor_email_snapshot = lower(btrim(actor_email_snapshot)) )` · Migración 1786406400000 · línea 827
- `CONSTRAINT ck_audit_log_target_type CHECK (btrim(target_type) <> '')` · Migración 1786406400000 · línea 827
- `CONSTRAINT ck_audit_log_result CHECK (result IN ('success', 'denied', 'failure'))` · Migración 1786406400000 · línea 827
- `CONSTRAINT ck_audit_log_before_data CHECK ( before_data IS NULL OR jsonb_typeof(before_data) = 'object' )` · Migración 1786406400000 · línea 827
- `CONSTRAINT ck_audit_log_after_data CHECK ( after_data IS NULL OR jsonb_typeof(after_data) = 'object' )` · Migración 1786406400000 · línea 827
- `CONSTRAINT ck_audit_log_domain CHECK (domain IN ('auth', 'access', 'rbac', 'spaces', 'admin', 'audit'))` · Migración 1788307200000 · línea 120
- `CONSTRAINT ck_audit_log_protection_level CHECK (required_protection_level IN (0, 50, 100))` · Migración 1788307200000 · línea 120
- `CONSTRAINT ck_audit_log_error_code CHECK (error_code IS NULL OR btrim(error_code) <> '')` · Migración 1788307200000 · línea 120
- `CONSTRAINT ck_audit_log_actor CHECK ( (actor_type = 'user' AND actor_user_id IS NOT NULL AND actor_service_client_id IS NULL) OR (actor_type = 'service' AND actor_service_client_id IS NOT NULL) OR (actor_type = 'system' AND actor_user_id IS NULL AND actor_service_client_id IS NULL) )` · Migración 1789516800000 · línea 63

Índices declarados:

- `CREATE INDEX IF NOT EXISTS ix_audit_log_actor_user_occurred ON esquema.audit_log (actor_user_id, occurred_at DESC) ` · Migración 1786406400000 · línea 903
- `CREATE INDEX IF NOT EXISTS ix_audit_log_actor_service_occurred ON esquema.audit_log (actor_service_client_id, occurred_at DESC) ` · Migración 1786406400000 · línea 907
- `CREATE INDEX IF NOT EXISTS ix_audit_log_domain_action_occurred ON esquema.audit_log (domain, action, occurred_at DESC) ` · Migración 1786406400000 · línea 911
- `CREATE INDEX IF NOT EXISTS ix_audit_log_target_occurred ON esquema.audit_log (target_type, target_id, occurred_at DESC) ` · Migración 1786406400000 · línea 915
- `CREATE INDEX IF NOT EXISTS ix_audit_log_request ON esquema.audit_log (request_id) WHERE request_id IS NOT NULL ` · Migración 1786406400000 · línea 919
- `CREATE INDEX IF NOT EXISTS ix_audit_log_correlation ON esquema.audit_log (correlation_id) WHERE correlation_id IS NOT NULL ` · Migración 1786406400000 · línea 924
- `CREATE INDEX ix_audit_log_visibility_occurred ON esquema.audit_log (required_protection_level, occurred_at DESC, id DESC) ` · Migración 1788307200000 · línea 130
- `CREATE INDEX ix_audit_log_id_occurred ON esquema.audit_log (id, occurred_at DESC) ` · Migración 1788307200000 · línea 134

