La correspondencia con una base desplegada requiere contraste con su catálogo. Las relaciones entre servicios se distinguen de las claves foráneas locales.
Volver a los diagramas · Campos CSV · Versión Markdown
Los identificadores externos y los campos históricos sin FK se explican en la lectura técnica. La fuente técnica identifica la migración que declara la estructura.
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 | |
| 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 y cardinalidad
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 y cardinalidad
(user_id) → platform_user(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_external_identity_user
FOREIGN KEY (user_id) REFERENCES esquema.platform_user (id)
ON DELETE RESTRICTMigració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 y cardinalidad
(user_id) → platform_user(id). Cada hija: 1 padre; cada padre: 0..1 hijas.
Definición de la restricción
CONSTRAINT fk_local_credential_user
FOREIGN KEY (user_id) REFERENCES esquema.platform_user (id)
ON DELETE RESTRICTMigració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 y cardinalidad
(user_id) → platform_user(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_platform_session_user
FOREIGN KEY (user_id) REFERENCES esquema.platform_user (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 155
(external_identity_id) → external_identity(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_platform_session_external_identity
FOREIGN KEY (external_identity_id) REFERENCES esquema.external_identity (id)
ON DELETE RESTRICTMigració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 y cardinalidad
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 y cardinalidad
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 y cardinalidad
(user_id) → platform_user(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_user_module_access_user
FOREIGN KEY (user_id) REFERENCES esquema.platform_user (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 258
(module_id) → platform_module(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_user_module_access_module
FOREIGN KEY (module_id) REFERENCES esquema.platform_module (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 258
(granted_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_user_module_access_granted_by
FOREIGN KEY (granted_by_user_id) REFERENCES esquema.platform_user (id)
ON DELETE SET NULLMigració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 y cardinalidad
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 y cardinalidad
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 y cardinalidad
(user_id) → platform_user(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_user_role_user
FOREIGN KEY (user_id) REFERENCES esquema.platform_user (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 348
(role_id) → role(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_user_role_role
FOREIGN KEY (role_id) REFERENCES esquema.role (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 348
(assigned_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_user_role_assigned_by
FOREIGN KEY (assigned_by_user_id) REFERENCES esquema.platform_user (id)
ON DELETE SET NULLMigració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 y cardinalidad
(role_id) → role(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_role_permission_role
FOREIGN KEY (role_id) REFERENCES esquema.role (id)
ON DELETE CASCADEMigración 1786406400000 · línea 380
(permission_id) → permission(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_role_permission_permission
FOREIGN KEY (permission_id) REFERENCES esquema.permission (id)
ON DELETE CASCADEMigración 1786406400000 · línea 380
(granted_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_role_permission_granted_by
FOREIGN KEY (granted_by_user_id) REFERENCES esquema.platform_user (id)
ON DELETE SET NULLMigració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 y cardinalidad
(permission_id) → permission(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_permission_dependency_permission
FOREIGN KEY (permission_id) REFERENCES esquema.permission (id)
ON DELETE CASCADEMigración 1786406400000 · línea 403
(required_permission_id) → permission(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_permission_dependency_required
FOREIGN KEY (required_permission_id) REFERENCES esquema.permission (id)
ON DELETE CASCADEMigració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 y cardinalidad
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 y cardinalidad
(space_type_id) → space_type(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_type
FOREIGN KEY (space_type_id) REFERENCES esquema.space_type (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 456
(parent_id) → space(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_parent
FOREIGN KEY (parent_id) REFERENCES esquema.space (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 456
(created_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_created_by
FOREIGN KEY (created_by_user_id) REFERENCES esquema.platform_user (id)
ON DELETE SET NULLMigración 1786406400000 · línea 456
(updated_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_updated_by
FOREIGN KEY (updated_by_user_id) REFERENCES esquema.platform_user (id)
ON DELETE SET NULLMigració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 y cardinalidad
(space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_code_alias_space
FOREIGN KEY (space_id) REFERENCES esquema.space (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 513
(created_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_code_alias_created_by
FOREIGN KEY (created_by_user_id) REFERENCES esquema.platform_user (id)
ON DELETE SET NULLMigració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 y cardinalidad
(space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_parent_history_space
FOREIGN KEY (space_id) REFERENCES esquema.space (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 539
(parent_space_id) → space(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_parent_history_parent
FOREIGN KEY (parent_space_id) REFERENCES esquema.space (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 539
(changed_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_parent_history_changed_by
FOREIGN KEY (changed_by_user_id) REFERENCES esquema.platform_user (id)
ON DELETE SET NULLMigració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 y cardinalidad
(source_space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_lineage_source
FOREIGN KEY (source_space_id) REFERENCES esquema.space (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 575
(target_space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_lineage_target
FOREIGN KEY (target_space_id) REFERENCES esquema.space (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 575
(created_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_lineage_created_by
FOREIGN KEY (created_by_user_id) REFERENCES esquema.platform_user (id)
ON DELETE SET NULLMigració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 y cardinalidad
(space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_module_setting_space
FOREIGN KEY (space_id) REFERENCES esquema.space (id)
ON DELETE CASCADEMigración 1786406400000 · línea 608
(module_id) → platform_module(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_module_setting_module
FOREIGN KEY (module_id) REFERENCES esquema.platform_module (id)
ON DELETE CASCADEMigración 1786406400000 · línea 608
(updated_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_module_setting_updated_by
FOREIGN KEY (updated_by_user_id) REFERENCES esquema.platform_user (id)
ON DELETE SET NULLMigració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 y cardinalidad
(module_id) → platform_module(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_service_client_module
FOREIGN KEY (module_id) REFERENCES esquema.platform_module (id)
ON DELETE RESTRICTMigració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 y cardinalidad
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 y cardinalidad
(service_client_id) → service_client(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_service_client_scope_client
FOREIGN KEY (service_client_id) REFERENCES esquema.service_client (id)
ON DELETE CASCADEMigración 1786406400000 · línea 690
(scope_code) → service_scope(code). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_service_client_scope_scope
FOREIGN KEY (scope_code) REFERENCES esquema.service_scope (code)
ON DELETE CASCADEMigración 1786406400000 · línea 690
(granted_by_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_service_client_scope_granted_by
FOREIGN KEY (granted_by_user_id) REFERENCES esquema.platform_user (id)
ON DELETE SET NULLMigració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 y cardinalidad
(service_client_id) → service_client(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_idempotency_record_client
FOREIGN KEY (service_client_id) REFERENCES esquema.service_client (id)
ON DELETE CASCADEMigración 1786406400000 · línea 713
(actor_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_idempotency_record_actor_user
FOREIGN KEY (actor_user_id) REFERENCES esquema.platform_user (id)
ON DELETE CASCADEMigració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 y cardinalidad
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 y cardinalidad
(space_id) → space(id). Cada hija: 1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_catalog_change_space
FOREIGN KEY (space_id) REFERENCES esquema.space (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 784
(module_id) → platform_module(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_space_catalog_change_module
FOREIGN KEY (module_id) REFERENCES esquema.platform_module (id)
ON DELETE RESTRICTMigració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 y cardinalidad
(actor_user_id) → platform_user(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_audit_log_actor_user
FOREIGN KEY (actor_user_id) REFERENCES esquema.platform_user (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 827
(actor_service_client_id) → service_client(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_audit_log_actor_service
FOREIGN KEY (actor_service_client_id) REFERENCES esquema.service_client (id)
ON DELETE RESTRICTMigración 1786406400000 · línea 827
(session_id) → platform_session(id). Cada hija: 0..1 padre; cada padre: 0..N hijas.
Definición de la restricción
CONSTRAINT fk_audit_log_session
FOREIGN KEY (session_id) REFERENCES esquema.platform_session (id)
ON DELETE RESTRICTMigració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