# Mantenimiento · 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.

## maintenance_member

Proyección local de miembro procedente de Core.

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

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

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| core_user_id | uuid | NO | PK |  | Migración 1790112000000 · línea 151 |
| email_snapshot | varchar(320) | SÍ |  |  | Migración 1790112000000 · línea 151 |
| display_name_snapshot | varchar(200) | SÍ |  |  | Migración 1790112000000 · línea 151 |
| module_access_status | varchar(16) | NO |  |  | Migración 1790112000000 · línea 151 |
| core_profile_version | bigint | SÍ |  |  | Migración 1790112000000 · línea 151 |
| core_access_version | bigint | SÍ |  |  | Migración 1790112000000 · línea 151 |
| last_synced_at | timestamptz | SÍ |  |  | Migración 1790112000000 · línea 151 |
| created_at | timestamptz | NO |  |  | Migración 1790112000000 · línea 151 |
| updated_at | timestamptz | NO |  |  | Migración 1790112000000 · línea 151 |
| core_user_status | varchar(16) | SÍ |  |  | Migración 1790208000000 · línea 65 |

Claves foráneas:


Restricciones CHECK:

- `CHECK (email_snapshot IS NULL OR (email_snapshot <> '' AND email_snapshot=lower(btrim(email_snapshot))))` · Migración 1790112000000 · línea 151
- `CHECK (display_name_snapshot IS NULL OR btrim(display_name_snapshot)<>'')` · Migración 1790112000000 · línea 151
- `CONSTRAINT maintenance_member_core_user_status_ck CHECK (core_user_status IS NULL OR core_user_status IN ('pending_access','active','suspended','blocked'))` · Migración 1790208000000 · línea 65

Índices declarados:

- `CREATE INDEX maintenance_member_status_idx ON esquema.maintenance_member(module_access_status,core_user_id)` · Migración 1790112000000 · línea 151

## 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 1790112000000 · línea 151 |
| code | varchar(120) | NO |  |  | Migración 1790112000000 · línea 151 |
| name | varchar(160) | NO |  |  | Migración 1790112000000 · línea 151 |
| category | varchar(120) | NO |  |  | Migración 1790112000000 · línea 151 |
| is_system | boolean | NO |  |  | Migración 1790112000000 · línea 151 |
| is_active | boolean | NO |  |  | Migración 1790112000000 · línea 151 |
| created_at | timestamptz | NO |  |  | Migración 1790112000000 · línea 151 |

Claves foráneas:


Restricciones CHECK:

- `CHECK (btrim(code)<>'' AND btrim(name)<>'')` · Migración 1790112000000 · línea 151

Índices declarados:

Sin declaración adicional identificada.

## 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 1790112000000 · línea 151 |
| code | varchar(120) | NO |  |  | Migración 1790112000000 · línea 151 |
| name | varchar(160) | NO |  |  | Migración 1790112000000 · línea 151 |
| description | varchar(4000) | SÍ |  |  | Migración 1790112000000 · línea 151 |
| is_system | boolean | NO |  |  | Migración 1790112000000 · línea 151 |
| is_protected | boolean | NO |  |  | Migración 1790112000000 · línea 151 |
| is_active | boolean | NO |  |  | Migración 1790112000000 · línea 151 |
| version | integer | NO |  |  | Migración 1790112000000 · línea 151 |
| created_by_core_user_id | uuid | SÍ |  |  | Migración 1790112000000 · línea 151 |
| updated_by_core_user_id | uuid | SÍ |  |  | Migración 1790112000000 · línea 151 |
| created_at | timestamptz | NO |  |  | Migración 1790112000000 · línea 151 |
| updated_at | timestamptz | NO |  |  | Migración 1790112000000 · línea 151 |

Claves foráneas:


Restricciones CHECK:

- `CHECK (btrim(code)<>'' AND btrim(name)<>'')` · Migración 1790112000000 · línea 151

Índices declarados:

Sin declaración adicional identificada.

## 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 1790112000000 · línea 151 |
| permission_id | uuid | NO | PK, FK | permission(id) | Migración 1790112000000 · línea 151 |
| granted_by_core_user_id | uuid | SÍ |  |  | Migración 1790112000000 · línea 151 |
| granted_at | timestamptz | NO |  |  | Migración 1790112000000 · línea 151 |

Claves foráneas:

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

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

- `CREATE INDEX maintenance_role_permission_reverse_idx ON esquema.role_permission(permission_id,role_id)` · Migración 1790112000000 · línea 151

## 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 1790112000000 · línea 151 |
| required_permission_id | uuid | NO | PK, FK | permission(id) | Migración 1790112000000 · línea 151 |

Claves foráneas:

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

Restricciones CHECK:

- `CHECK (permission_id<>required_permission_id)` · Migración 1790112000000 · línea 151

Índices declarados:

Sin declaración adicional identificada.

## member_role

Asignación de roles locales a miembros.

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

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

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| core_user_id | uuid | NO | PK, FK | maintenance_member(core_user_id) | Migración 1790112000000 · línea 151 |
| role_id | uuid | NO | PK, FK | role(id) | Migración 1790112000000 · línea 151 |
| is_active | boolean | NO |  |  | Migración 1790112000000 · línea 151 |
| version | integer | NO |  |  | Migración 1790112000000 · línea 151 |
| assigned_by_core_user_id | uuid | SÍ |  |  | Migración 1790112000000 · línea 151 |
| assigned_at | timestamptz | NO |  |  | Migración 1790112000000 · línea 151 |
| revoked_by_core_user_id | uuid | SÍ |  |  | Migración 1790112000000 · línea 151 |
| revoked_at | timestamptz | SÍ |  |  | Migración 1790112000000 · línea 151 |
| revocation_reason | varchar(1000) | SÍ |  |  | Migración 1790112000000 · línea 151 |
| assigned_by_actor_type | varchar(8) | NO |  |  | Migración 1790208000000 · línea 65 |
| assigned_by_operation_code | varchar(120) | SÍ |  |  | Migración 1790208000000 · línea 65 |
| revoked_by_actor_type | varchar(8) | SÍ |  |  | Migración 1790208000000 · línea 65 |
| revoked_by_operation_code | varchar(120) | SÍ |  |  | Migración 1790208000000 · línea 65 |

Claves foráneas:

- (core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1790112000000 · línea 151.
- (role_id) → role(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1790112000000 · línea 151.

Restricciones CHECK:

- `CHECK ((is_active AND revoked_at IS NULL AND revoked_by_core_user_id IS NULL AND revocation_reason IS NULL) OR (NOT is_active AND revoked_at IS NOT NULL AND revocation_reason IS NOT NULL AND btrim(revocation_reason)<>''))` · Migración 1790112000000 · línea 151
- `CONSTRAINT maintenance_member_role_assigned_actor_ck CHECK ((assigned_by_actor_type='user' AND assigned_by_core_user_id IS NOT NULL AND assigned_by_operation_code IS NULL) OR (assigned_by_actor_type='system' AND assigned_by_core_user_id IS NULL AND assigned_by_operation_code IS NOT NULL AND btrim(assigned_by_operation_code)<>''))` · Migración 1790208000000 · línea 65
- `CONSTRAINT maintenance_member_role_revoked_actor_ck CHECK ((is_active AND revoked_by_actor_type IS NULL AND revoked_by_operation_code IS NULL) OR (NOT is_active AND ((revoked_by_actor_type='user' AND revoked_by_core_user_id IS NOT NULL AND revoked_by_operation_code IS NULL) OR (revoked_by_actor_type='system' AND revoked_by_core_user_id IS NULL AND revoked_by_operation_code IS NOT NULL AND btrim(revoked_by_operation_code)<>''))))` · Migración 1790208000000 · línea 65

Índices declarados:

- `CREATE INDEX maintenance_member_role_active_idx ON esquema.member_role(core_user_id,role_id) WHERE is_active` · Migración 1790112000000 · línea 151
- `CREATE INDEX maintenance_member_role_reverse_idx ON esquema.member_role(role_id,core_user_id)` · Migración 1790112000000 · línea 151

## member_role_history

Registro de member role history. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (core_user_id, role_id, version).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1790112000000 · línea 151 |
| core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1790112000000 · línea 151 |
| role_id | uuid | NO | FK | role(id) | Migración 1790112000000 · línea 151 |
| transition | varchar(16) | NO |  |  | Migración 1790112000000 · línea 151 |
| version | integer | NO |  |  | Migración 1790112000000 · línea 151 |
| actor_core_user_id | uuid | SÍ |  |  | Migración 1790112000000 · línea 151 |
| reason | varchar(1000) | SÍ |  |  | Migración 1790112000000 · línea 151 |
| occurred_at | timestamptz | NO |  |  | Migración 1790112000000 · línea 151 |
| actor_type | varchar(8) | NO |  |  | Migración 1790208000000 · línea 65 |
| actor_operation_code | varchar(120) | SÍ |  |  | Migración 1790208000000 · línea 65 |

Claves foráneas:

- (core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1790112000000 · línea 151.
- (role_id) → role(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1790112000000 · línea 151.

Restricciones CHECK:

- `CONSTRAINT maintenance_role_history_actor_ck CHECK ((actor_type='user' AND actor_core_user_id IS NOT NULL AND actor_operation_code IS NULL) OR (actor_type='system' AND actor_core_user_id IS NULL AND actor_operation_code IS NOT NULL AND btrim(actor_operation_code)<>''))` · Migración 1790208000000 · línea 65

Índices declarados:

- `CREATE INDEX maintenance_member_role_history_member_idx ON esquema.member_role_history(core_user_id,occurred_at DESC)` · Migración 1790112000000 · línea 151

## rbac_idempotency_record

Registro de rbac idempotency record. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (principal_core_user_id, operation, idempotency_key).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1790112000000 · línea 151 |
| principal_core_user_id | uuid | NO |  |  | Migración 1790112000000 · línea 151 |
| operation | varchar(120) | NO |  |  | Migración 1790112000000 · línea 151 |
| idempotency_key | varchar(120) | NO |  |  | Migración 1790112000000 · línea 151 |
| request_hash | char(64) | NO |  |  | Migración 1790112000000 · línea 151 |
| response_status | integer | SÍ |  |  | Migración 1790112000000 · línea 151 |
| response_body | jsonb | SÍ |  |  | Migración 1790112000000 · línea 151 |
| completed_at | timestamptz | SÍ |  |  | Migración 1790112000000 · línea 151 |
| created_at | timestamptz | NO |  |  | Migración 1790112000000 · línea 151 |
| expires_at | timestamptz | NO |  |  | Migración 1790112000000 · línea 151 |

Claves foráneas:


Restricciones CHECK:

- `CHECK (expires_at>created_at)` · Migración 1790112000000 · línea 151
- `CHECK ((completed_at IS NULL AND response_status IS NULL AND response_body IS NULL) OR (completed_at IS NOT NULL AND response_status IS NOT NULL AND response_body IS NOT NULL))` · Migración 1790112000000 · línea 151

Índices declarados:

- `CREATE INDEX maintenance_rbac_idempotency_expiry_idx ON esquema.rbac_idempotency_record(expires_at)` · Migración 1790112000000 · línea 151

## maintenance_audit_log

Registro de audit log. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; 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 |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1790112000000 · línea 151 |
| occurred_at | timestamptz | NO | PK |  | Migración 1790112000000 · línea 151 |
| domain | varchar(120) | NO |  |  | Migración 1790112000000 · línea 151 |
| action | varchar(120) | NO |  |  | Migración 1790112000000 · línea 151 |
| target_type | varchar(120) | NO |  |  | Migración 1790112000000 · línea 151 |
| target_id | varchar(120) | NO |  |  | Migración 1790112000000 · línea 151 |
| actor_core_user_id | uuid | SÍ |  |  | Migración 1790112000000 · línea 151 |
| actor_email_snapshot | varchar(320) | SÍ |  |  | Migración 1790112000000 · línea 151 |
| actor_name_snapshot | varchar(200) | SÍ |  |  | Migración 1790112000000 · línea 151 |
| actor_roles_snapshot | jsonb | NO |  |  | Migración 1790112000000 · línea 151 |
| outcome | varchar(16) | NO |  |  | Migración 1790112000000 · línea 151 |
| reason | varchar(1000) | SÍ |  |  | Migración 1790112000000 · línea 151 |
| request_id | varchar(128) | SÍ |  |  | Migración 1790112000000 · línea 151 |
| correlation_id | varchar(128) | SÍ |  |  | Migración 1790112000000 · línea 151 |
| required_protection_level | integer | NO |  |  | Migración 1790112000000 · línea 151 |
| actor_type | varchar(8) | NO |  |  | Migración 1790208000000 · línea 65 |
| actor_operation_code | varchar(120) | SÍ |  |  | Migración 1790208000000 · línea 65 |

Claves foráneas:


Restricciones CHECK:

- `CHECK (jsonb_typeof(actor_roles_snapshot)='array')` · Migración 1790112000000 · línea 151
- `CONSTRAINT maintenance_audit_actor_ck CHECK ((actor_type='user' AND actor_core_user_id IS NOT NULL AND actor_operation_code IS NULL) OR (actor_type='system' AND actor_core_user_id IS NULL AND actor_operation_code IS NOT NULL AND btrim(actor_operation_code)<>''))` · Migración 1790208000000 · línea 65

Índices declarados:

- `CREATE INDEX maintenance_audit_actor_idx ON esquema.maintenance_audit_log(actor_core_user_id,occurred_at DESC,id DESC)` · Migración 1790112000000 · línea 151
- `CREATE INDEX maintenance_audit_target_idx ON esquema.maintenance_audit_log(domain,target_type,target_id,occurred_at DESC,id DESC)` · Migración 1790112000000 · línea 151
- `CREATE INDEX maintenance_audit_correlation_idx ON esquema.maintenance_audit_log(correlation_id,occurred_at DESC,id DESC)` · Migración 1790112000000 · línea 151
- `CREATE INDEX maintenance_audit_protection_idx ON esquema.maintenance_audit_log(required_protection_level,occurred_at DESC,id DESC)` · Migración 1790112000000 · línea 151

## maintenance_audit_change

Registro de audit change. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; 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 1790112000000 · línea 269 |
| audit_occurred_at | timestamptz | NO | FK | maintenance_audit_log(occurred_at, id) | Migración 1790112000000 · línea 269 |
| audit_log_id | uuid | NO | FK | maintenance_audit_log(occurred_at, id) | Migración 1790112000000 · línea 269 |
| field_code | varchar(120) | NO |  |  | Migración 1790112000000 · línea 269 |
| field_label_snapshot | varchar(160) | NO |  |  | Migración 1790112000000 · línea 269 |
| old_value | jsonb | SÍ |  |  | Migración 1790112000000 · línea 269 |
| new_value | jsonb | SÍ |  |  | Migración 1790112000000 · línea 269 |
| sort_order | integer | NO |  |  | Migración 1790112000000 · línea 269 |

Claves foráneas:

- (audit_occurred_at, audit_log_id) → maintenance_audit_log(occurred_at, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1790112000000 · línea 269.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

- `CREATE INDEX maintenance_audit_change_header_idx ON esquema.maintenance_audit_change(audit_occurred_at,audit_log_id,sort_order)` · Migración 1790112000000 · línea 269

## core_sync_checkpoint

Avance de sincronización externa.

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

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

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| checkpoint_code | varchar(120) | NO | PK |  | Migración 1790208000000 · línea 65 |
| state | varchar(16) | NO |  |  | Migración 1790208000000 · línea 65 |
| cursor | text | SÍ |  |  | Migración 1790208000000 · línea 65 |
| last_attempt_at | timestamptz | SÍ |  |  | Migración 1790208000000 · línea 65 |
| last_success_at | timestamptz | SÍ |  |  | Migración 1790208000000 · línea 65 |
| last_error_code | varchar(120) | SÍ |  |  | Migración 1790208000000 · línea 65 |
| version | bigint | NO |  |  | Migración 1790208000000 · línea 65 |
| updated_at | timestamptz | NO |  |  | Migración 1790208000000 · línea 65 |
| snapshot_version | varchar(2000) | SÍ |  |  | Migración 1790812800000 · línea 28 |
| projection_revision | bigint | NO |  |  | Migración 1790812800000 · línea 28 |

Claves foráneas:


Restricciones CHECK:

- `CONSTRAINT core_sync_checkpoint_state_ck CHECK (state IN ('uninitialized','syncing','healthy','degraded','failed'))` · Migración 1790208000000 · línea 65
- `CONSTRAINT core_sync_checkpoint_version_ck CHECK (version>=1)` · Migración 1790208000000 · línea 65
- `CONSTRAINT core_sync_checkpoint_projection_revision_ck CHECK (projection_revision>=0)` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_sync_checkpoint_snapshot_version_ck CHECK (snapshot_version IS NULL OR length(snapshot_version)>0)` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_sync_checkpoint_spatial_health_ck CHECK (checkpoint_code<>'core.space-catalog.mantenimiento.v1' OR state<>'healthy' OR last_success_at IS NOT NULL)` · Migración 1790812800000 · línea 28

Índices declarados:

Sin declaración adicional identificada.

## core_inbox_event

Mensaje externo persistido antes de procesarse.

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

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

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| source_event_id | uuid | NO | PK |  | Migración 1790812800000 · línea 28 |
| producer | varchar(16) | NO |  |  | Migración 1790812800000 · línea 28 |
| event_type | varchar(120) | NO |  |  | Migración 1790812800000 · línea 28 |
| schema_version | integer | NO |  |  | Migración 1790812800000 · línea 28 |
| aggregate_type | varchar(120) | NO |  |  | Migración 1790812800000 · línea 28 |
| aggregate_id | uuid | NO |  |  | Migración 1790812800000 · línea 28 |
| aggregate_version | bigint | NO |  |  | Migración 1790812800000 · línea 28 |
| source_cursor | varchar(2000) | SÍ |  |  | Migración 1790812800000 · línea 28 |
| correlation_id | varchar(120) | SÍ |  |  | Migración 1790812800000 · línea 28 |
| occurred_at | timestamptz | NO |  |  | Migración 1790812800000 · línea 28 |
| payload_hash | varchar(64) | NO |  |  | Migración 1790812800000 · línea 28 |
| payload | jsonb | NO |  |  | Migración 1790812800000 · línea 28 |
| processing_status | varchar(16) | NO |  |  | Migración 1790812800000 · línea 28 |
| processing_attempts | integer | NO |  |  | Migración 1790812800000 · línea 28 |
| received_at | timestamptz | NO |  |  | Migración 1790812800000 · línea 28 |
| processed_at | timestamptz | SÍ |  |  | Migración 1790812800000 · línea 28 |
| next_attempt_at | timestamptz | SÍ |  |  | Migración 1790812800000 · línea 28 |
| lease_expires_at | timestamptz | SÍ |  |  | Migración 1790812800000 · línea 28 |
| last_error_code | varchar(120) | SÍ |  |  | Migración 1790812800000 · línea 28 |

Claves foráneas:


Restricciones CHECK:

- `CONSTRAINT core_inbox_producer_ck CHECK (producer='core')` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_schema_version_ck CHECK (schema_version=1)` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_event_type_ck CHECK (btrim(event_type)<>'')` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_aggregate_type_ck CHECK (btrim(aggregate_type)<>'')` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_aggregate_version_ck CHECK (aggregate_version>=1)` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_payload_hash_ck CHECK (payload_hash ~ '^[0-9a-f]{64}$')` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_payload_ck CHECK (jsonb_typeof(payload)='object')` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_status_ck CHECK (processing_status IN ('pending','processing','processed','failed'))` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_attempts_ck CHECK (processing_attempts>=0)` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_processed_ck CHECK ((processing_status='processed')=(processed_at IS NOT NULL))` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_lease_ck CHECK ((processing_status='processing')=(lease_expires_at IS NOT NULL))` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_retry_ck CHECK ((processing_status='failed')=(next_attempt_at IS NOT NULL))` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_inbox_claimed_ck CHECK (processing_status='pending' OR processing_attempts>=1)` · Migración 1790812800000 · línea 28

Índices declarados:

- `CREATE INDEX core_inbox_claim_idx ON esquema.core_inbox_event(next_attempt_at,received_at,source_event_id) WHERE processing_status IN ('pending','failed')` · Migración 1790812800000 · línea 28
- `CREATE INDEX core_inbox_lease_recovery_idx ON esquema.core_inbox_event(lease_expires_at,received_at,source_event_id) WHERE processing_status='processing'` · Migración 1790812800000 · línea 28

## core_space_projection

Proyección local de espacios canónicos.

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

PK: core_space_id. Unicidad total: (code).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| core_space_id | uuid | NO | PK |  | Migración 1790812800000 · línea 28 |
| code | varchar(120) | NO |  |  | Migración 1790812800000 · línea 28 |
| name | varchar(200) | NO |  |  | Migración 1790812800000 · línea 28 |
| type_code | varchar(120) | NO |  |  | Migración 1790812800000 · línea 28 |
| parent_core_space_id | uuid | SÍ | FK | core_space_projection(core_space_id) | Migración 1790812800000 · línea 28 |
| sort_order | integer | NO |  |  | Migración 1790812800000 · línea 28 |
| path_text | varchar(4000) | NO |  |  | Migración 1790812800000 · línea 28 |
| path_ids | jsonb | NO |  |  | Migración 1790812800000 · línea 28 |
| source_status | varchar(16) | NO |  |  | Migración 1790812800000 · línea 28 |
| effective_status | varchar(16) | NO |  |  | Migración 1790812800000 · línea 28 |
| module_selection_state | varchar(8) | NO |  |  | Migración 1790812800000 · línea 28 |
| module_setting_is_explicit | boolean | NO |  |  | Migración 1790812800000 · línea 28 |
| module_setting_version | bigint | NO |  |  | Migración 1790812800000 · línea 28 |
| selectable | boolean | NO |  |  | Migración 1790812800000 · línea 28 |
| context_only | boolean | NO |  |  | Migración 1790812800000 · línea 28 |
| color_hex | varchar(7) | SÍ |  |  | Migración 1790812800000 · línea 28 |
| effective_color_hex | varchar(7) | SÍ |  |  | Migración 1790812800000 · línea 28 |
| core_version | bigint | NO |  |  | Migración 1790812800000 · línea 28 |
| catalog_sequence | bigint | NO |  |  | Migración 1790812800000 · línea 28 |
| is_tombstone | boolean | NO |  |  | Migración 1790812800000 · línea 28 |
| synced_at | timestamptz | NO |  |  | Migración 1790812800000 · línea 28 |

Claves foráneas:

- (parent_core_space_id) → core_space_projection(core_space_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1790812800000 · línea 28.

Restricciones CHECK:

- `CONSTRAINT core_space_code_ck CHECK (btrim(code)<>'')` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_name_ck CHECK (btrim(name)<>'')` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_type_ck CHECK (btrim(type_code)<>'')` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_sort_order_ck CHECK (sort_order>=0)` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_path_ids_ck CHECK (jsonb_typeof(path_ids)='array')` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_source_status_ck CHECK (source_status IN ('active','inactive','retired'))` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_effective_status_ck CHECK (effective_status IN ('active','inactive','retired'))` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_selection_state_ck CHECK (module_selection_state IN ('enabled','disabled'))` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_setting_version_ck CHECK ((module_setting_is_explicit AND module_setting_version>=1) OR (NOT module_setting_is_explicit AND module_setting_version=0))` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_selectable_ck CHECK (NOT selectable OR (NOT context_only AND NOT is_tombstone AND parent_core_space_id IS NOT NULL AND effective_status='active' AND module_selection_state='enabled'))` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_color_ck CHECK (color_hex ~ '^#[0-9A-Fa-f]{6}$')` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_effective_color_ck CHECK (effective_color_hex ~ '^#[0-9A-Fa-f]{6}$')` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_version_ck CHECK (core_version>=1)` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_sequence_ck CHECK (catalog_sequence>=0)` · Migración 1790812800000 · línea 28

Índices declarados:

- `CREATE INDEX core_space_parent_idx ON esquema.core_space_projection(parent_core_space_id,sort_order,core_space_id)` · Migración 1790812800000 · línea 28
- `CREATE INDEX core_space_selectable_idx ON esquema.core_space_projection(selectable,core_space_id)` · Migración 1790812800000 · línea 28
- `CREATE INDEX core_space_status_idx ON esquema.core_space_projection(effective_status,core_space_id)` · Migración 1790812800000 · línea 28
- `CREATE INDEX core_space_sequence_idx ON esquema.core_space_projection(catalog_sequence,core_space_id)` · Migración 1790812800000 · línea 28

## core_space_relation_projection

Proyección de relaciones espaciales.

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

PK: ancestor_core_space_id, descendant_core_space_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| ancestor_core_space_id | uuid | NO | PK, FK | core_space_projection(core_space_id) | Migración 1790812800000 · línea 28 |
| descendant_core_space_id | uuid | NO | PK, FK | core_space_projection(core_space_id) | Migración 1790812800000 · línea 28 |
| depth | integer | NO |  |  | Migración 1790812800000 · línea 28 |
| catalog_sequence | bigint | NO |  |  | Migración 1790812800000 · línea 28 |
| synced_at | timestamptz | NO |  |  | Migración 1790812800000 · línea 28 |

Claves foráneas:

- (ancestor_core_space_id) → core_space_projection(core_space_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1790812800000 · línea 28.
- (descendant_core_space_id) → core_space_projection(core_space_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1790812800000 · línea 28.

Restricciones CHECK:

- `CONSTRAINT core_space_relation_depth_ck CHECK (depth>=0)` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_relation_sequence_ck CHECK (catalog_sequence>=0)` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_relation_reflexive_ck CHECK ((ancestor_core_space_id=descendant_core_space_id)=(depth=0))` · Migración 1790812800000 · línea 28

Índices declarados:

- `CREATE INDEX core_space_relation_reverse_idx ON esquema.core_space_relation_projection(descendant_core_space_id,ancestor_core_space_id)` · Migración 1790812800000 · línea 28

## core_space_lineage_projection

Proyección de jerarquía espacial.

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

PK: core_lineage_id. Unicidad total: (source_core_space_id, target_core_space_id, relation_type).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| core_lineage_id | uuid | NO | PK |  | Migración 1790812800000 · línea 28 |
| source_core_space_id | uuid | NO | FK | core_space_projection(core_space_id) | Migración 1790812800000 · línea 28 |
| target_core_space_id | uuid | NO | FK | core_space_projection(core_space_id) | Migración 1790812800000 · línea 28 |
| relation_type | varchar(16) | NO |  |  | Migración 1790812800000 · línea 28 |
| effective_at | timestamptz | NO |  |  | Migración 1790812800000 · línea 28 |
| catalog_sequence | bigint | NO |  |  | Migración 1790812800000 · línea 28 |
| synced_at | timestamptz | NO |  |  | Migración 1790812800000 · línea 28 |

Claves foráneas:

- (source_core_space_id) → core_space_projection(core_space_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1790812800000 · línea 28.
- (target_core_space_id) → core_space_projection(core_space_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1790812800000 · línea 28.

Restricciones CHECK:

- `CONSTRAINT core_space_lineage_type_ck CHECK (relation_type IN ('split_into','merged_into','replaced_by'))` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_lineage_sequence_ck CHECK (catalog_sequence>=0)` · Migración 1790812800000 · línea 28
- `CONSTRAINT core_space_lineage_distinct_ck CHECK (source_core_space_id<>target_core_space_id)` · Migración 1790812800000 · línea 28

Índices declarados:

- `CREATE INDEX core_space_lineage_target_idx ON esquema.core_space_lineage_projection(target_core_space_id,source_core_space_id)` · Migración 1790812800000 · línea 28

## technical_catalog_value

Valor técnico normalizado de catálogo.

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

PK: id. Unicidad total: (catalog_key, code); (catalog_key, name_normalized); (catalog_key, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791158400000 · línea 32 |
| catalog_key | varchar(40) | NO |  |  | Migración 1791158400000 · línea 32 |
| code | varchar(80) | NO |  |  | Migración 1791158400000 · línea 32 |
| name | varchar(160) | NO |  |  | Migración 1791158400000 · línea 32 |
| name_normalized | text | NO |  |  | Migración 1791158400000 · línea 32 |
| description | varchar(4000) | SÍ |  |  | Migración 1791158400000 · línea 32 |
| is_active | boolean | NO |  |  | Migración 1791158400000 · línea 32 |
| sort_order | integer | NO |  |  | Migración 1791158400000 · línea 32 |
| non_operational | boolean | SÍ |  |  | Migración 1791158400000 · línea 32 |
| semantic_rank | integer | SÍ |  |  | Migración 1791158400000 · línea 32 |
| symbol | varchar(24) | SÍ |  |  | Migración 1791158400000 · línea 32 |
| direction | varchar(16) | SÍ |  |  | Migración 1791158400000 · línea 32 |
| color_hex | varchar(7) | SÍ |  |  | Migración 1791158400000 · línea 32 |
| version | integer | NO |  |  | Migración 1791158400000 · línea 32 |
| created_at | timestamptz | NO |  |  | Migración 1791158400000 · línea 32 |
| updated_at | timestamptz | NO |  |  | Migración 1791158400000 · línea 32 |
| created_actor_type | varchar(8) | NO |  |  | Migración 1791158400000 · línea 32 |
| created_by_core_user_id | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1791158400000 · línea 32 |
| created_operation_code | varchar(120) | SÍ |  |  | Migración 1791158400000 · línea 32 |
| updated_actor_type | varchar(8) | NO |  |  | Migración 1791158400000 · línea 32 |
| updated_by_core_user_id | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1791158400000 · línea 32 |
| updated_operation_code | varchar(120) | SÍ |  |  | Migración 1791158400000 · línea 32 |

Claves foráneas:

- (created_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791158400000 · línea 32.
- (updated_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791158400000 · línea 32.

Restricciones CHECK:

- `CONSTRAINT technical_catalog_key_ck CHECK (catalog_key IN ( 'asset_categories','component_types','asset_operational_states','component_states', 'criticalities','measurement_units','internal_staff_specialties','provider_trades', 'technical_relation_types','work_order_priorities'))` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_code_ck CHECK (code ~ '^[a-z][a-z0-9_]{0,79}$')` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_name_ck CHECK (name_normalized <> '')` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_order_ck CHECK (sort_order >= 0)` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_version_ck CHECK (version >= 1)` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_dates_ck CHECK (updated_at >= created_at)` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_non_operational_ck CHECK ( (catalog_key='component_states' AND non_operational IS NOT NULL) OR (catalog_key<>'component_states' AND non_operational IS NULL))` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_rank_ck CHECK ( (catalog_key IN ('criticalities','work_order_priorities') AND semantic_rank IS NOT NULL AND semantic_rank>0) OR (catalog_key NOT IN ('criticalities','work_order_priorities') AND semantic_rank IS NULL))` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_symbol_ck CHECK ( (catalog_key='measurement_units' AND symbol IS NOT NULL AND btrim(symbol)<>'') OR (catalog_key<>'measurement_units' AND symbol IS NULL))` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_direction_ck CHECK ( (catalog_key='technical_relation_types' AND direction IS NOT NULL AND direction IN ('directed','symmetric')) OR (catalog_key<>'technical_relation_types' AND direction IS NULL))` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_color_ck CHECK ( (catalog_key='work_order_priorities' AND color_hex IS NOT NULL AND color_hex ~ '^#[0-9a-fA-F]{6}$') OR (catalog_key<>'work_order_priorities' AND color_hex IS NULL))` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_created_actor_ck CHECK ( (created_actor_type='user' AND created_by_core_user_id IS NOT NULL AND created_operation_code IS NULL) OR (created_actor_type='system' AND created_by_core_user_id IS NULL AND created_operation_code IS NOT NULL AND created_operation_code ~ '^[a-z][a-z0-9_.:-]{0,119}$'))` · Migración 1791158400000 · línea 32
- `CONSTRAINT technical_catalog_updated_actor_ck CHECK ( (updated_actor_type='user' AND updated_by_core_user_id IS NOT NULL AND updated_operation_code IS NULL) OR (updated_actor_type='system' AND updated_by_core_user_id IS NULL AND updated_operation_code IS NOT NULL AND updated_operation_code ~ '^[a-z][a-z0-9_.:-]{0,119}$'))` · Migración 1791158400000 · línea 32

Índices declarados:

- `CREATE INDEX technical_catalog_order_idx ON esquema.technical_catalog_value(catalog_key,sort_order,code,id)` · Migración 1791158400000 · línea 32
- `CREATE INDEX technical_catalog_activation_idx ON esquema.technical_catalog_value(catalog_key,is_active,sort_order,code,id)` · Migración 1791158400000 · línea 32

## catalog_idempotency_record

Registro de catalog idempotency record. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (principal_core_user_id, operation, idempotency_key).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791158400000 · línea 32 |
| principal_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791158400000 · línea 32 |
| operation | varchar(120) | NO |  |  | Migración 1791158400000 · línea 32 |
| idempotency_key | varchar(120) | NO |  |  | Migración 1791158400000 · línea 32 |
| request_hash | char(64) | NO |  |  | Migración 1791158400000 · línea 32 |
| response_status | integer | SÍ |  |  | Migración 1791158400000 · línea 32 |
| response_body | jsonb | SÍ |  |  | Migración 1791158400000 · línea 32 |
| response_etag | varchar(180) | SÍ |  |  | Migración 1791158400000 · línea 32 |
| response_location | varchar(512) | SÍ |  |  | Migración 1791158400000 · línea 32 |
| completed_at | timestamptz | SÍ |  |  | Migración 1791158400000 · línea 32 |
| created_at | timestamptz | NO |  |  | Migración 1791158400000 · línea 32 |

Claves foráneas:

- (principal_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791158400000 · línea 32.

Restricciones CHECK:

- `CONSTRAINT catalog_idempotency_operation_ck CHECK (operation ~ '^[a-z][a-z0-9_.:-]{0,119}$')` · Migración 1791158400000 · línea 32
- `CONSTRAINT catalog_idempotency_key_ck CHECK (idempotency_key ~ '^[A-Za-z0-9._:-]{1,120}$')` · Migración 1791158400000 · línea 32
- `CONSTRAINT catalog_idempotency_hash_ck CHECK (request_hash ~ '^[0-9a-f]{64}$')` · Migración 1791158400000 · línea 32
- `CONSTRAINT catalog_idempotency_response_ck CHECK ( (completed_at IS NULL AND response_status IS NULL AND response_body IS NULL AND response_etag IS NULL AND response_location IS NULL) OR (completed_at IS NOT NULL AND completed_at>=created_at AND response_status IS NOT NULL AND response_status IN (200,201) AND response_body IS NOT NULL AND jsonb_typeof(response_body)='object' AND response_etag IS NOT NULL))` · Migración 1791158400000 · línea 32

Índices declarados:

Sin declaración adicional identificada.

## asset_type

Definición de familia técnica de activos.

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 1791331200000 · línea 39 |
| name | varchar(160) | SÍ |  |  | Migración 1791331200000 · línea 39 |
| name_normalized | text | SÍ |  |  | Migración 1791331200000 · línea 39 |
| category_catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791331200000 · línea 39 |
| category_id | uuid | SÍ | FK | technical_catalog_value(catalog_key, id) | Migración 1791331200000 · línea 39 |
| description | varchar(4000) | SÍ |  |  | Migración 1791331200000 · línea 39 |
| status | varchar(8) | NO |  |  | Migración 1791331200000 · línea 39 |
| version | integer | NO |  |  | Migración 1791331200000 · línea 39 |
| created_at | timestamptz | NO |  |  | Migración 1791331200000 · línea 39 |
| updated_at | timestamptz | NO |  |  | Migración 1791331200000 · línea 39 |
| created_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791331200000 · línea 39 |
| updated_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791331200000 · línea 39 |

Claves foráneas:

- (category_catalog_key, category_id) → technical_catalog_value(catalog_key, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.
- (created_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.
- (updated_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.

Restricciones CHECK:

- `CONSTRAINT asset_type_name_ck CHECK (name IS NULL OR name_normalized<>'')` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_category_ck CHECK (category_catalog_key='asset_categories')` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_status_ck CHECK (status IN ('draft','active','inactive'))` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_activation_ck CHECK (status<>'active' OR (name IS NOT NULL AND category_id IS NOT NULL))` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_version_ck CHECK (version>=1)` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_dates_ck CHECK (updated_at>=created_at)` · Migración 1791331200000 · línea 39

Índices declarados:

- `CREATE UNIQUE INDEX asset_type_active_name_key ON esquema.asset_type(name_normalized) WHERE status='active'` · Migración 1791331200000 · línea 39
- `CREATE INDEX asset_type_list_idx ON esquema.asset_type(status,updated_at DESC,id)` · Migración 1791331200000 · línea 39
- `CREATE INDEX asset_type_category_list_idx ON esquema.asset_type(category_id,status,updated_at DESC,id)` · Migración 1791331200000 · línea 39

## asset_type_attribute

Registro de asset type attribute. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (asset_type_id, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791331200000 · línea 39 |
| asset_type_id | uuid | NO | FK | asset_type(id) | Migración 1791331200000 · línea 39 |
| label | varchar(160) | SÍ |  |  | Migración 1791331200000 · línea 39 |
| data_type | varchar(24) | SÍ |  |  | Migración 1791331200000 · línea 39 |
| is_required | boolean | NO |  |  | Migración 1791331200000 · línea 39 |
| help_text | varchar(4000) | SÍ |  |  | Migración 1791331200000 · línea 39 |
| sort_order | integer | NO |  |  | Migración 1791331200000 · línea 39 |
| is_active | boolean | NO |  |  | Migración 1791331200000 · línea 39 |
| numeric_kind | varchar(8) | SÍ |  |  | Migración 1791331200000 · línea 39 |
| minimum | numeric | SÍ |  |  | Migración 1791331200000 · línea 39 |
| maximum | numeric | SÍ |  |  | Migración 1791331200000 · línea 39 |
| unit_catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791331200000 · línea 39 |
| unit_id | uuid | SÍ | FK | technical_catalog_value(catalog_key, id) | Migración 1791331200000 · línea 39 |
| created_at | timestamptz | NO |  |  | Migración 1791331200000 · línea 39 |

Claves foráneas:

- (asset_type_id) → asset_type(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.
- (unit_catalog_key, unit_id) → technical_catalog_value(catalog_key, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.

Restricciones CHECK:

- `CONSTRAINT asset_type_attribute_label_ck CHECK (label IS NULL OR btrim(label)<>'')` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_attribute_data_type_ck CHECK (data_type IS NULL OR data_type IN ( 'short_text','long_text','number','number_with_unit','date','boolean','single_choice'))` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_attribute_order_ck CHECK (sort_order>=0)` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_attribute_numeric_ck CHECK ( (data_type IS NOT NULL AND data_type IN ('number','number_with_unit') AND (numeric_kind IS NULL OR numeric_kind IN ('integer','decimal'))) OR (numeric_kind IS NULL AND minimum IS NULL AND maximum IS NULL))` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_attribute_limits_ck CHECK ( (minimum IS NULL OR minimum::text NOT IN ('NaN','Infinity','-Infinity')) AND (maximum IS NULL OR maximum::text NOT IN ('NaN','Infinity','-Infinity')) AND (minimum IS NULL OR maximum IS NULL OR minimum<=maximum) AND (numeric_kind IS DISTINCT FROM 'integer' OR ((minimum IS NULL OR minimum=trunc(minimum)) AND (maximum IS NULL OR maximum=trunc(maximum)))))` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_attribute_unit_ck CHECK (unit_catalog_key='measurement_units' AND (unit_id IS NULL OR (data_type IS NOT NULL AND data_type='number_with_unit')))` · Migración 1791331200000 · línea 39

Índices declarados:

- `CREATE INDEX asset_type_attribute_order_idx ON esquema.asset_type_attribute(asset_type_id,sort_order,id)` · Migración 1791331200000 · línea 39

## asset_type_attribute_option

Registro de asset type attribute option. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (asset_type_id, attribute_id, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791331200000 · línea 39 |
| asset_type_id | uuid | NO | FK | asset_type_attribute(asset_type_id, id) | Migración 1791331200000 · línea 39 |
| attribute_id | uuid | NO | FK | asset_type_attribute(asset_type_id, id) | Migración 1791331200000 · línea 39 |
| label | varchar(160) | SÍ |  |  | Migración 1791331200000 · línea 39 |
| sort_order | integer | NO |  |  | Migración 1791331200000 · línea 39 |
| is_active | boolean | NO |  |  | Migración 1791331200000 · línea 39 |
| created_at | timestamptz | NO |  |  | Migración 1791331200000 · línea 39 |

Claves foráneas:

- (asset_type_id, attribute_id) → asset_type_attribute(asset_type_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.

Restricciones CHECK:

- `CONSTRAINT asset_type_option_label_ck CHECK (label IS NULL OR btrim(label)<>'')` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_option_order_ck CHECK (sort_order>=0)` · Migración 1791331200000 · línea 39

Índices declarados:

- `CREATE INDEX asset_type_option_order_idx ON esquema.asset_type_attribute_option(asset_type_id,attribute_id,sort_order,id)` · Migración 1791331200000 · línea 39

## asset_type_component_suggestion

Registro de asset type component suggestion. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (asset_type_id, id); (asset_type_id, reference_key).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK, FK | asset_type_component_state(asset_type_id, component_suggestion_id, state_id) | Migración 1791331200000 · línea 39 |
| asset_type_id | uuid | NO | FK | asset_type(id); asset_type_component_state(asset_type_id, component_suggestion_id, state_id) | Migración 1791331200000 · línea 39 |
| reference_key | varchar(80) | NO |  |  | Migración 1791331200000 · línea 39 |
| component_catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791331200000 · línea 39 |
| component_type_id | uuid | SÍ | FK | technical_catalog_value(catalog_key, id) | Migración 1791331200000 · línea 39 |
| suggested_name | varchar(160) | SÍ |  |  | Migración 1791331200000 · línea 39 |
| suggested_quantity | integer | SÍ |  |  | Migración 1791331200000 · línea 39 |
| state_catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791331200000 · línea 39 |
| initial_state_id | uuid | SÍ | FK | technical_catalog_value(catalog_key, id); asset_type_component_state(asset_type_id, component_suggestion_id, state_id) | Migración 1791331200000 · línea 39 |
| included_by_default | boolean | NO |  |  | Migración 1791331200000 · línea 39 |
| help_text | varchar(4000) | SÍ |  |  | Migración 1791331200000 · línea 39 |
| sort_order | integer | NO |  |  | Migración 1791331200000 · línea 39 |
| is_active | boolean | NO |  |  | Migración 1791331200000 · línea 39 |
| created_at | timestamptz | NO |  |  | Migración 1791331200000 · línea 39 |

Claves foráneas:

- (asset_type_id) → asset_type(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.
- (component_catalog_key, component_type_id) → technical_catalog_value(catalog_key, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.
- (state_catalog_key, initial_state_id) → technical_catalog_value(catalog_key, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.
- (asset_type_id, id, initial_state_id) → asset_type_component_state(asset_type_id, component_suggestion_id, state_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.

Restricciones CHECK:

- `CONSTRAINT asset_type_component_reference_ck CHECK (reference_key ~ '^[a-z][a-z0-9_]{0,79}$')` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_component_catalog_ck CHECK (component_catalog_key='component_types')` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_component_name_ck CHECK (suggested_name IS NULL OR btrim(suggested_name)<>'')` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_component_quantity_ck CHECK (suggested_quantity IS NULL OR suggested_quantity>=1)` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_component_order_ck CHECK (sort_order>=0)` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_component_state_ck CHECK (state_catalog_key='component_states')` · Migración 1791331200000 · línea 39

Índices declarados:

- `CREATE INDEX asset_type_component_order_idx ON esquema.asset_type_component_suggestion(asset_type_id,sort_order,id)` · Migración 1791331200000 · línea 39

## asset_type_component_state

Registro de asset type component state. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: asset_type_id, component_suggestion_id, state_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| asset_type_id | uuid | NO | PK, FK | asset_type_component_suggestion(asset_type_id, id) | Migración 1791331200000 · línea 39 |
| component_suggestion_id | uuid | NO | PK, FK | asset_type_component_suggestion(asset_type_id, id) | Migración 1791331200000 · línea 39 |
| state_catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791331200000 · línea 39 |
| state_id | uuid | NO | PK, FK | technical_catalog_value(catalog_key, id) | Migración 1791331200000 · línea 39 |

Claves foráneas:

- (asset_type_id, component_suggestion_id) → asset_type_component_suggestion(asset_type_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.
- (state_catalog_key, state_id) → technical_catalog_value(catalog_key, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.

Restricciones CHECK:

- `CONSTRAINT asset_type_component_state_catalog_ck CHECK (state_catalog_key='component_states')` · Migración 1791331200000 · línea 39

Índices declarados:

- `CREATE INDEX asset_type_component_state_catalog_idx ON esquema.asset_type_component_state(state_catalog_key,state_id)` · Migración 1791331200000 · línea 39

## asset_type_idempotency_record

Registro de asset type idempotency record. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (principal_core_user_id, operation, idempotency_key).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791331200000 · línea 39 |
| principal_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791331200000 · línea 39 |
| operation | varchar(120) | NO |  |  | Migración 1791331200000 · línea 39 |
| idempotency_key | varchar(120) | NO |  |  | Migración 1791331200000 · línea 39 |
| request_hash | char(64) | NO |  |  | Migración 1791331200000 · línea 39 |
| response_status | integer | SÍ |  |  | Migración 1791331200000 · línea 39 |
| response_body | jsonb | SÍ |  |  | Migración 1791331200000 · línea 39 |
| response_etag | varchar(180) | SÍ |  |  | Migración 1791331200000 · línea 39 |
| response_location | varchar(512) | SÍ |  |  | Migración 1791331200000 · línea 39 |
| completed_at | timestamptz | SÍ |  |  | Migración 1791331200000 · línea 39 |
| created_at | timestamptz | NO |  |  | Migración 1791331200000 · línea 39 |

Claves foráneas:

- (principal_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791331200000 · línea 39.

Restricciones CHECK:

- `CONSTRAINT asset_type_idempotency_operation_ck CHECK (operation ~ '^[a-z][a-z0-9_.:-]{0,119}$')` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_idempotency_key_ck CHECK (idempotency_key ~ '^[A-Za-z0-9._:-]{1,120}$')` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_idempotency_hash_ck CHECK (request_hash ~ '^[0-9a-f]{64}$')` · Migración 1791331200000 · línea 39
- `CONSTRAINT asset_type_idempotency_response_ck CHECK ( (completed_at IS NULL AND response_status IS NULL AND response_body IS NULL AND response_etag IS NULL AND response_location IS NULL) OR (completed_at IS NOT NULL AND completed_at>=created_at AND response_status IS NOT NULL AND response_status IN (200,201) AND response_body IS NOT NULL AND jsonb_typeof(response_body)='object' AND response_etag IS NOT NULL))` · Migración 1791331200000 · línea 39

Índices declarados:

Sin declaración adicional identificada.

## asset

Activo mantenible.

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

PK: id. Unicidad total: (id, asset_type_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791504000000 · línea 44 |
| code | varchar(160) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| code_normalized | text | SÍ |  |  | Migración 1791504000000 · línea 44 |
| name | varchar(160) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| asset_type_id | uuid | SÍ | FK | asset_type(id) | Migración 1791504000000 · línea 44 |
| space_id | uuid | SÍ | FK | core_space_projection(core_space_id) | Migración 1791504000000 · línea 44 |
| operational_state_catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791504000000 · línea 44 |
| operational_state_id | uuid | SÍ | FK | technical_catalog_value(catalog_key, id) | Migración 1791504000000 · línea 44 |
| criticality_catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791504000000 · línea 44 |
| criticality_id | uuid | SÍ | FK | technical_catalog_value(catalog_key, id) | Migración 1791504000000 · línea 44 |
| manufacturer | varchar(160) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| model | varchar(160) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| serial_number | varchar(160) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| commissioned_on | date | SÍ |  |  | Migración 1791504000000 · línea 44 |
| notes | varchar(4000) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| condition | varchar(10) | NO |  |  | Migración 1791504000000 · línea 44 |
| version | integer | NO |  |  | Migración 1791504000000 · línea 44 |
| draft_data | jsonb | SÍ |  |  | Migración 1791504000000 · línea 44 |
| registered_at | timestamptz | SÍ |  |  | Migración 1791504000000 · línea 44 |
| archived_at | timestamptz | SÍ |  |  | Migración 1791504000000 · línea 44 |
| archive_reason | varchar(1000) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| created_at | timestamptz | NO |  |  | Migración 1791504000000 · línea 44 |
| updated_at | timestamptz | NO |  |  | Migración 1791504000000 · línea 44 |
| created_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791504000000 · línea 44 |
| updated_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791504000000 · línea 44 |

Claves foráneas:

- (asset_type_id) → asset_type(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (space_id) → core_space_projection(core_space_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (operational_state_catalog_key, operational_state_id) → technical_catalog_value(catalog_key, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (criticality_catalog_key, criticality_id) → technical_catalog_value(catalog_key, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (created_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (updated_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.

Restricciones CHECK:

- `CONSTRAINT asset_state_catalog_ck CHECK (operational_state_catalog_key='asset_operational_states')` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_criticality_catalog_ck CHECK (criticality_catalog_key='criticalities')` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_condition_ck CHECK (condition IN ('draft','registered','archived'))` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_code_ck CHECK (code IS NULL OR (code=btrim(code) AND code<>''))` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_name_ck CHECK (name IS NULL OR btrim(name)<>'')` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_version_ck CHECK (version>=1)` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_dates_ck CHECK (updated_at>=created_at AND (registered_at IS NULL OR registered_at>=created_at))` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_registration_ck CHECK ( (registered_at IS NULL AND condition<>'registered') OR (registered_at IS NOT NULL AND condition<>'draft' AND code IS NOT NULL AND name IS NOT NULL AND asset_type_id IS NOT NULL AND space_id IS NOT NULL AND operational_state_id IS NOT NULL AND criticality_id IS NOT NULL))` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_draft_data_ck CHECK ((registered_at IS NULL AND draft_data IS NOT NULL AND jsonb_typeof(draft_data)='object') OR (registered_at IS NOT NULL AND draft_data IS NULL))` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_archive_ck CHECK ((condition='archived' AND archived_at IS NOT NULL AND archive_reason IS NOT NULL AND btrim(archive_reason)<>'') OR (condition<>'archived' AND archived_at IS NULL AND archive_reason IS NULL))` · Migración 1791504000000 · línea 44

Índices declarados:

- `CREATE UNIQUE INDEX asset_code_key ON esquema.asset(code_normalized) WHERE code IS NOT NULL` · Migración 1791504000000 · línea 44
- `CREATE INDEX asset_list_idx ON esquema.asset(condition,created_at DESC,id DESC)` · Migración 1791504000000 · línea 44
- `CREATE INDEX asset_by_type_list_idx ON esquema.asset(asset_type_id,condition,created_at DESC,id DESC)` · Migración 1791504000000 · línea 44
- `CREATE INDEX asset_space_list_idx ON esquema.asset(space_id,condition,created_at DESC,id DESC)` · Migración 1791504000000 · línea 44
- `CREATE INDEX asset_status_list_idx ON esquema.asset(operational_state_id,criticality_id,condition)` · Migración 1791504000000 · línea 44
- `CREATE INDEX asset_code_prefix_idx ON esquema.asset(code_normalized text_pattern_ops,created_at DESC,id DESC)` · Migración 1791504000000 · línea 44

## asset_attribute_value

Registro de asset attribute value. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: asset_id, attribute_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| asset_id | uuid | NO | PK, FK | asset(id, asset_type_id) | Migración 1791504000000 · línea 44 |
| asset_type_id | uuid | NO | FK | asset(id, asset_type_id); asset_type_attribute(asset_type_id, id); asset_type_attribute_option(asset_type_id, attribute_id, id) | Migración 1791504000000 · línea 44 |
| attribute_id | uuid | NO | PK, FK | asset_type_attribute(asset_type_id, id); asset_type_attribute_option(asset_type_id, attribute_id, id) | Migración 1791504000000 · línea 44 |
| data_type | varchar(24) | NO |  |  | Migración 1791504000000 · línea 44 |
| value_text | varchar(4000) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| value_number | numeric | SÍ |  |  | Migración 1791504000000 · línea 44 |
| value_date | date | SÍ |  |  | Migración 1791504000000 · línea 44 |
| value_boolean | boolean | SÍ |  |  | Migración 1791504000000 · línea 44 |
| option_id | uuid | SÍ | FK | asset_type_attribute_option(asset_type_id, attribute_id, id) | Migración 1791504000000 · línea 44 |
| unit_catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791504000000 · línea 44 |
| unit_id | uuid | SÍ | FK | technical_catalog_value(catalog_key, id) | Migración 1791504000000 · línea 44 |
| updated_asset_version | integer | NO |  |  | Migración 1791504000000 · línea 44 |

Claves foráneas:

- (asset_id, asset_type_id) → asset(id, asset_type_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (asset_type_id, attribute_id) → asset_type_attribute(asset_type_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (asset_type_id, attribute_id, option_id) → asset_type_attribute_option(asset_type_id, attribute_id, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (unit_catalog_key, unit_id) → technical_catalog_value(catalog_key, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.

Restricciones CHECK:

- `CONSTRAINT asset_attribute_value_version_ck CHECK (updated_asset_version>=1)` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_attribute_value_shape_ck CHECK (data_type IN ('short_text','long_text','number','number_with_unit','date','boolean','single_choice') AND num_nonnulls(value_text,value_number,value_date,value_boolean,option_id)<=1 AND (value_text IS NULL OR (data_type IN ('short_text','long_text') AND btrim(value_text)<>'' AND (data_type<>'short_text' OR length(value_text)<=160))) AND (value_number IS NULL OR (data_type IN ('number','number_with_unit') AND value_number::text NOT IN ('NaN','Infinity','-Infinity'))) AND (value_date IS NULL OR data_type='date') AND (value_boolean IS NULL OR data_type='boolean') AND (option_id IS NULL OR data_type='single_choice') AND unit_catalog_key='measurement_units' AND (unit_id IS NULL OR data_type='number_with_unit') AND (data_type<>'number_with_unit' OR value_number IS NULL OR unit_id IS NOT NULL))` · Migración 1791504000000 · línea 44

Índices declarados:

- `CREATE INDEX asset_attribute_value_usage_idx ON esquema.asset_attribute_value(asset_type_id,attribute_id,option_id)` · Migración 1791504000000 · línea 44

## asset_attribute_value_history

Registro de asset attribute value history. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (asset_id, attribute_id, asset_version).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791504000000 · línea 44 |
| asset_id | uuid | NO | FK | asset(id, asset_type_id) | Migración 1791504000000 · línea 44 |
| asset_type_id | uuid | NO | FK | asset(id, asset_type_id); asset_type_attribute(asset_type_id, id); asset_type_attribute_option(asset_type_id, attribute_id, id) | Migración 1791504000000 · línea 44 |
| attribute_id | uuid | NO | FK | asset_type_attribute(asset_type_id, id); asset_type_attribute_option(asset_type_id, attribute_id, id) | Migración 1791504000000 · línea 44 |
| asset_version | integer | NO |  |  | Migración 1791504000000 · línea 44 |
| data_type | varchar(24) | NO |  |  | Migración 1791504000000 · línea 44 |
| value_text | varchar(4000) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| value_number | numeric | SÍ |  |  | Migración 1791504000000 · línea 44 |
| value_date | date | SÍ |  |  | Migración 1791504000000 · línea 44 |
| value_boolean | boolean | SÍ |  |  | Migración 1791504000000 · línea 44 |
| option_id | uuid | SÍ | FK | asset_type_attribute_option(asset_type_id, attribute_id, id) | Migración 1791504000000 · línea 44 |
| unit_catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791504000000 · línea 44 |
| unit_id | uuid | SÍ | FK | technical_catalog_value(catalog_key, id) | Migración 1791504000000 · línea 44 |
| occurred_at | timestamptz | NO |  |  | Migración 1791504000000 · línea 44 |
| actor_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791504000000 · línea 44 |

Claves foráneas:

- (asset_id, asset_type_id) → asset(id, asset_type_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (asset_type_id, attribute_id) → asset_type_attribute(asset_type_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (asset_type_id, attribute_id, option_id) → asset_type_attribute_option(asset_type_id, attribute_id, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (unit_catalog_key, unit_id) → technical_catalog_value(catalog_key, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (actor_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.

Restricciones CHECK:

- `CONSTRAINT asset_attribute_history_version_ck CHECK (asset_version>=1)` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_attribute_history_shape_ck CHECK (data_type IN ('short_text','long_text','number','number_with_unit','date','boolean','single_choice') AND num_nonnulls(value_text,value_number,value_date,value_boolean,option_id)<=1 AND (value_text IS NULL OR (data_type IN ('short_text','long_text') AND btrim(value_text)<>'' AND (data_type<>'short_text' OR length(value_text)<=160))) AND (value_number IS NULL OR (data_type IN ('number','number_with_unit') AND value_number::text NOT IN ('NaN','Infinity','-Infinity'))) AND (value_date IS NULL OR data_type='date') AND (value_boolean IS NULL OR data_type='boolean') AND (option_id IS NULL OR data_type='single_choice') AND unit_catalog_key='measurement_units' AND (unit_id IS NULL OR data_type='number_with_unit') AND (data_type<>'number_with_unit' OR value_number IS NULL OR unit_id IS NOT NULL))` · Migración 1791504000000 · línea 44

Índices declarados:

- `CREATE INDEX asset_attribute_history_usage_idx ON esquema.asset_attribute_value_history(asset_type_id,attribute_id,option_id)` · Migración 1791504000000 · línea 44

## asset_component

Componente concreto de un activo.

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

PK: id. Unicidad total: (asset_id, id); (asset_type_id, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK, FK | asset_component_applicable_state(component_id, state_id) | Migración 1791504000000 · línea 44 |
| asset_id | uuid | NO | FK | asset(id, asset_type_id) | Migración 1791504000000 · línea 44 |
| asset_type_id | uuid | NO | FK | asset(id, asset_type_id); asset_type_component_suggestion(asset_type_id, id) | Migración 1791504000000 · línea 44 |
| composition_reference_id | uuid | NO | FK | asset_type_component_suggestion(asset_type_id, id) | Migración 1791504000000 · línea 44 |
| name | varchar(160) | NO |  |  | Migración 1791504000000 · línea 44 |
| quantity | integer | NO |  |  | Migración 1791504000000 · línea 44 |
| current_state_id | uuid | NO | FK | asset_component_applicable_state(component_id, state_id) | Migración 1791504000000 · línea 44 |
| observations | varchar(4000) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| version | integer | NO |  |  | Migración 1791504000000 · línea 44 |
| created_asset_version | integer | NO |  |  | Migración 1791504000000 · línea 44 |
| created_at | timestamptz | NO |  |  | Migración 1791504000000 · línea 44 |
| updated_at | timestamptz | NO |  |  | Migración 1791504000000 · línea 44 |
| created_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791504000000 · línea 44 |
| updated_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791504000000 · línea 44 |
| condition | varchar(8) | NO |  |  | Migración 1791676800000 · línea 42 |
| retired_at | timestamptz | SÍ |  |  | Migración 1791676800000 · línea 42 |
| retirement_reason | varchar(1000) | SÍ |  |  | Migración 1791676800000 · línea 42 |

Claves foráneas:

- (asset_id, asset_type_id) → asset(id, asset_type_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (asset_type_id, composition_reference_id) → asset_type_component_suggestion(asset_type_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (created_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (updated_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (id, current_state_id) → asset_component_applicable_state(component_id, state_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.

Restricciones CHECK:

- `CONSTRAINT asset_component_name_ck CHECK (btrim(name)<>'')` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_component_quantity_ck CHECK (quantity>=1)` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_component_version_ck CHECK (version>=1 AND created_asset_version>=1)` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_component_dates_ck CHECK (updated_at>=created_at)` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_component_condition_ck CHECK (condition IN ('current','retired'))` · Migración 1791676800000 · línea 42
- `CONSTRAINT asset_component_retirement_ck CHECK ( (condition='current' AND retired_at IS NULL AND retirement_reason IS NULL) OR (condition='retired' AND retired_at IS NOT NULL AND retired_at>=created_at AND retirement_reason IS NOT NULL AND btrim(retirement_reason)<>''))` · Migración 1791676800000 · línea 42

Índices declarados:

- `CREATE INDEX asset_component_reference_idx ON esquema.asset_component(asset_type_id,composition_reference_id)` · Migración 1791504000000 · línea 44

## asset_component_applicable_state

Registro de asset component applicable state. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: component_id, state_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| component_id | uuid | NO | PK, FK | asset_component(id) | Migración 1791504000000 · línea 44 |
| state_id | uuid | NO | PK, FK | technical_catalog_value(catalog_key, id) | Migración 1791504000000 · línea 44 |
| state_catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791504000000 · línea 44 |

Claves foráneas:

- (component_id) → asset_component(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (state_catalog_key, state_id) → technical_catalog_value(catalog_key, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.

Restricciones CHECK:

- `CONSTRAINT asset_component_applicable_catalog_ck CHECK (state_catalog_key='component_states')` · Migración 1791504000000 · línea 44

Índices declarados:

- `CREATE INDEX asset_component_applicable_catalog_idx ON esquema.asset_component_applicable_state(state_id)` · Migración 1791504000000 · línea 44

## asset_component_history

Registro de asset component history. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (component_id, component_version).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791504000000 · línea 44 |
| asset_id | uuid | NO | FK | asset_component(asset_id, id) | Migración 1791504000000 · línea 44 |
| component_id | uuid | NO | FK | asset_component(asset_id, id); asset_component(asset_type_id, id) | Migración 1791504000000 · línea 44 |
| asset_type_id | uuid | NO | FK | asset_component(asset_type_id, id); asset_type_component_suggestion(asset_type_id, id) | Migración 1791504000000 · línea 44 |
| composition_reference_id | uuid | NO | FK | asset_type_component_suggestion(asset_type_id, id) | Migración 1791504000000 · línea 44 |
| component_version | integer | NO |  |  | Migración 1791504000000 · línea 44 |
| action | varchar(120) | NO |  |  | Migración 1791504000000 · línea 44 |
| snapshot | jsonb | NO |  |  | Migración 1791504000000 · línea 44 |
| occurred_at | timestamptz | NO |  |  | Migración 1791504000000 · línea 44 |
| actor_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791504000000 · línea 44 |

Claves foráneas:

- (asset_id, component_id) → asset_component(asset_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (asset_type_id, component_id) → asset_component(asset_type_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (asset_type_id, composition_reference_id) → asset_type_component_suggestion(asset_type_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (actor_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.

Restricciones CHECK:

- `CONSTRAINT asset_component_history_shape_ck CHECK (component_version>=1 AND action ~ '^[a-z][a-z0-9_.:-]{0,119}$' AND jsonb_typeof(snapshot)='object')` · Migración 1791504000000 · línea 44

Índices declarados:

- `CREATE INDEX asset_component_history_usage_idx ON esquema.asset_component_history(asset_type_id,composition_reference_id)` · Migración 1791504000000 · línea 44

## asset_history

Registro de asset history. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (asset_id, asset_version, event_order).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791504000000 · línea 44 |
| asset_id | uuid | NO | FK | asset(id) | Migración 1791504000000 · línea 44 |
| asset_version | integer | NO |  |  | Migración 1791504000000 · línea 44 |
| event_order | integer | NO |  |  | Migración 1791504000000 · línea 44 |
| action | varchar(120) | NO |  |  | Migración 1791504000000 · línea 44 |
| reason | varchar(1000) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| changes | jsonb | NO |  |  | Migración 1791504000000 · línea 44 |
| occurred_at | timestamptz | NO |  |  | Migración 1791504000000 · línea 44 |
| actor_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791504000000 · línea 44 |
| request_id | varchar(120) | NO |  |  | Migración 1791504000000 · línea 44 |
| correlation_id | varchar(120) | NO |  |  | Migración 1791504000000 · línea 44 |

Claves foráneas:

- (asset_id) → asset(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (actor_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.

Restricciones CHECK:

- `CONSTRAINT asset_history_shape_ck CHECK (asset_version>=1 AND event_order>=0 AND action ~ '^[a-z][a-z0-9_.:-]{0,119}$' AND jsonb_typeof(changes)='array')` · Migración 1791504000000 · línea 44

Índices declarados:

Sin declaración adicional identificada.

## asset_replacement

Registro de asset replacement. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

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

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| predecessor_id | uuid | NO | PK, FK | asset(id) | Migración 1791504000000 · línea 44 |
| successor_id | uuid | NO | FK | asset(id) | Migración 1791504000000 · línea 44 |
| occurred_at | timestamptz | NO |  |  | Migración 1791504000000 · línea 44 |
| actor_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791504000000 · línea 44 |
| reason | varchar(1000) | SÍ |  |  | Migración 1791504000000 · línea 44 |

Claves foráneas:

- (predecessor_id) → asset(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1791504000000 · línea 44.
- (successor_id) → asset(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.
- (actor_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.

Restricciones CHECK:

- `CONSTRAINT asset_replacement_distinct_ck CHECK (predecessor_id<>successor_id)` · Migración 1791504000000 · línea 44

Índices declarados:

- `CREATE INDEX asset_replacement_successor_idx ON esquema.asset_replacement(successor_id)` · Migración 1791504000000 · línea 44

## asset_idempotency_record

Registro de asset idempotency record. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (principal_core_user_id, operation, idempotency_key).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791504000000 · línea 44 |
| principal_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791504000000 · línea 44 |
| operation | varchar(120) | NO |  |  | Migración 1791504000000 · línea 44 |
| idempotency_key | varchar(120) | NO |  |  | Migración 1791504000000 · línea 44 |
| request_hash | char(64) | NO |  |  | Migración 1791504000000 · línea 44 |
| response_status | integer | SÍ |  |  | Migración 1791504000000 · línea 44 |
| response_body | jsonb | SÍ |  |  | Migración 1791504000000 · línea 44 |
| response_etag | varchar(180) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| response_location | varchar(512) | SÍ |  |  | Migración 1791504000000 · línea 44 |
| completed_at | timestamptz | SÍ |  |  | Migración 1791504000000 · línea 44 |
| created_at | timestamptz | NO |  |  | Migración 1791504000000 · línea 44 |

Claves foráneas:

- (principal_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791504000000 · línea 44.

Restricciones CHECK:

- `CONSTRAINT asset_idempotency_operation_ck CHECK (operation ~ '^[a-z][a-z0-9_.:-]{0,119}$')` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_idempotency_key_ck CHECK (idempotency_key ~ '^[A-Za-z0-9._:-]{1,120}$')` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_idempotency_hash_ck CHECK (request_hash ~ '^[0-9a-f]{64}$')` · Migración 1791504000000 · línea 44
- `CONSTRAINT asset_idempotency_response_ck CHECK ( (completed_at IS NULL AND response_status IS NULL AND response_body IS NULL AND response_etag IS NULL AND response_location IS NULL) OR (completed_at IS NOT NULL AND completed_at>=created_at AND response_status IS NOT NULL AND response_status IN (200,201) AND response_body IS NOT NULL AND jsonb_typeof(response_body)='object' AND response_etag IS NOT NULL))` · Migración 1791504000000 · línea 44

Índices declarados:

Sin declaración adicional identificada.

## asset_relation

Relación técnica entre activos.

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

PK: id. Unicidad total: (id, origin_asset_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791676800000 · línea 42 |
| relation_type_catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791676800000 · línea 42 |
| relation_type_id | uuid | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791676800000 · línea 42 |
| direction | varchar(16) | NO |  |  | Migración 1791676800000 · línea 42 |
| origin_asset_id | uuid | NO | FK | asset(id) | Migración 1791676800000 · línea 42 |
| destination_asset_id | uuid | NO | FK | asset(id) | Migración 1791676800000 · línea 42 |
| observations | varchar(4000) | SÍ |  |  | Migración 1791676800000 · línea 42 |
| condition | varchar(8) | NO |  |  | Migración 1791676800000 · línea 42 |
| version | integer | NO |  |  | Migración 1791676800000 · línea 42 |
| finished_at | timestamptz | SÍ |  |  | Migración 1791676800000 · línea 42 |
| finalization_reason | varchar(1000) | SÍ |  |  | Migración 1791676800000 · línea 42 |
| restored_from_relation_id | uuid | SÍ | FK | asset_relation(id) | Migración 1791676800000 · línea 42 |
| created_at | timestamptz | NO |  |  | Migración 1791676800000 · línea 42 |
| updated_at | timestamptz | NO |  |  | Migración 1791676800000 · línea 42 |
| created_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791676800000 · línea 42 |
| updated_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791676800000 · línea 42 |

Claves foráneas:

- (relation_type_catalog_key, relation_type_id) → technical_catalog_value(catalog_key, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791676800000 · línea 42.
- (origin_asset_id) → asset(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791676800000 · línea 42.
- (destination_asset_id) → asset(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791676800000 · línea 42.
- (restored_from_relation_id) → asset_relation(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791676800000 · línea 42.
- (created_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791676800000 · línea 42.
- (updated_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791676800000 · línea 42.

Restricciones CHECK:

- `CONSTRAINT asset_relation_catalog_ck CHECK (relation_type_catalog_key='technical_relation_types')` · Migración 1791676800000 · línea 42
- `CONSTRAINT asset_relation_direction_ck CHECK (direction IN ('directed','symmetric'))` · Migración 1791676800000 · línea 42
- `CONSTRAINT asset_relation_endpoints_ck CHECK (origin_asset_id<>destination_asset_id AND (direction<>'symmetric' OR origin_asset_id<destination_asset_id))` · Migración 1791676800000 · línea 42
- `CONSTRAINT asset_relation_condition_ck CHECK (condition IN ('active','finished'))` · Migración 1791676800000 · línea 42
- `CONSTRAINT asset_relation_version_ck CHECK (version>=1)` · Migración 1791676800000 · línea 42
- `CONSTRAINT asset_relation_dates_ck CHECK (updated_at>=created_at)` · Migración 1791676800000 · línea 42
- `CONSTRAINT asset_relation_finalization_ck CHECK ( (condition='active' AND finished_at IS NULL AND finalization_reason IS NULL) OR (condition='finished' AND finished_at IS NOT NULL AND finished_at>=created_at AND finalization_reason IS NOT NULL AND btrim(finalization_reason)<>''))` · Migración 1791676800000 · línea 42
- `CONSTRAINT asset_relation_restored_from_ck CHECK (restored_from_relation_id IS NULL OR restored_from_relation_id<>id)` · Migración 1791676800000 · línea 42

Índices declarados:

- `CREATE UNIQUE INDEX asset_relation_active_key ON esquema.asset_relation(relation_type_id,origin_asset_id,destination_asset_id) WHERE condition='active'` · Migración 1791676800000 · línea 42
- `CREATE UNIQUE INDEX asset_relation_restoration_key ON esquema.asset_relation(restored_from_relation_id) WHERE restored_from_relation_id IS NOT NULL` · Migración 1791676800000 · línea 42
- `CREATE INDEX asset_relation_origin_list_idx ON esquema.asset_relation(origin_asset_id,condition,created_at DESC,id DESC)` · Migración 1791676800000 · línea 42
- `CREATE INDEX asset_relation_destination_list_idx ON esquema.asset_relation(destination_asset_id,condition,created_at DESC,id DESC)` · Migración 1791676800000 · línea 42

## asset_relation_participant

Participantes de una relación técnica.

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

PK: relation_id, component_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| relation_id | uuid | NO | PK, FK | asset_relation(id, origin_asset_id) | Migración 1791676800000 · línea 42 |
| origin_asset_id | uuid | NO | FK | asset_relation(id, origin_asset_id); asset_component(asset_id, id) | Migración 1791676800000 · línea 42 |
| component_id | uuid | NO | PK, FK | asset_component(asset_id, id) | Migración 1791676800000 · línea 42 |

Claves foráneas:

- (relation_id, origin_asset_id) → asset_relation(id, origin_asset_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791676800000 · línea 42.
- (origin_asset_id, component_id) → asset_component(asset_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791676800000 · línea 42.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

- `CREATE INDEX asset_relation_participant_component_idx ON esquema.asset_relation_participant(component_id,relation_id)` · Migración 1791676800000 · línea 42

## asset_relation_history

Registro de asset relation history. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (relation_id, relation_version).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791676800000 · línea 42 |
| relation_id | uuid | NO | FK | asset_relation(id) | Migración 1791676800000 · línea 42 |
| relation_version | integer | NO |  |  | Migración 1791676800000 · línea 42 |
| action | varchar(120) | NO |  |  | Migración 1791676800000 · línea 42 |
| reason | varchar(1000) | SÍ |  |  | Migración 1791676800000 · línea 42 |
| snapshot | jsonb | NO |  |  | Migración 1791676800000 · línea 42 |
| actor_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791676800000 · línea 42 |
| request_id | varchar(160) | SÍ |  |  | Migración 1791676800000 · línea 42 |
| correlation_id | varchar(160) | SÍ |  |  | Migración 1791676800000 · línea 42 |
| occurred_at | timestamptz | NO |  |  | Migración 1791676800000 · línea 42 |

Claves foráneas:

- (relation_id) → asset_relation(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791676800000 · línea 42.
- (actor_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791676800000 · línea 42.

Restricciones CHECK:

- `CONSTRAINT asset_relation_history_shape_ck CHECK (relation_version>=1 AND action ~ '^[a-z][a-z0-9_.:-]{0,119}$' AND jsonb_typeof(snapshot)='object')` · Migración 1791676800000 · línea 42

Índices declarados:

- `CREATE INDEX asset_relation_history_page_idx ON esquema.asset_relation_history(relation_id,occurred_at DESC,id DESC)` · Migración 1791676800000 · línea 42

## internal_staff

Persona del directorio operativo.

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

PK: id. Unicidad total: (name_normalized); (linked_core_user_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791849600000 · línea 66 |
| full_name | varchar(200) | NO |  |  | Migración 1791849600000 · línea 66 |
| name_normalized | text | NO |  |  | Migración 1791849600000 · línea 66 |
| phone | varchar(120) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| contact_email | varchar(320) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| notes | varchar(4000) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| linked_core_user_id | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1791849600000 · línea 66 |
| is_active | boolean | NO |  |  | Migración 1791849600000 · línea 66 |
| version | integer | NO |  |  | Migración 1791849600000 · línea 66 |
| created_at | timestamptz | NO |  |  | Migración 1791849600000 · línea 66 |
| updated_at | timestamptz | NO |  |  | Migración 1791849600000 · línea 66 |
| created_actor_type | varchar(8) | NO |  |  | Migración 1791849600000 · línea 66 |
| created_by_core_user_id | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1791849600000 · línea 66 |
| created_operation_code | varchar(120) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| updated_actor_type | varchar(8) | NO |  |  | Migración 1791849600000 · línea 66 |
| updated_by_core_user_id | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1791849600000 · línea 66 |
| updated_operation_code | varchar(120) | SÍ |  |  | Migración 1791849600000 · línea 66 |

Claves foráneas:

- (created_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.
- (updated_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.
- (linked_core_user_id) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..1 hijas. Migración 1791849600000 · línea 66.

Restricciones CHECK:

- `CONSTRAINT internal_staff_version_ck CHECK(version>=1)` · Migración 1791849600000 · línea 66
- `CONSTRAINT internal_staff_dates_ck CHECK(updated_at>=created_at)` · Migración 1791849600000 · línea 66
- `CONSTRAINT internal_staff_created_actor_ck CHECK( (created_actor_type='user' AND created_by_core_user_id IS NOT NULL AND created_operation_code IS NULL) OR (created_actor_type='system' AND created_by_core_user_id IS NULL AND created_operation_code ~ '^[a-z][a-z0-9_.:-]{0,119}$' AND created_operation_code IS NOT NULL))` · Migración 1791849600000 · línea 66
- `CONSTRAINT internal_staff_updated_actor_ck CHECK( (updated_actor_type='user' AND updated_by_core_user_id IS NOT NULL AND updated_operation_code IS NULL) OR (updated_actor_type='system' AND updated_by_core_user_id IS NULL AND updated_operation_code ~ '^[a-z][a-z0-9_.:-]{0,119}$' AND updated_operation_code IS NOT NULL))` · Migración 1791849600000 · línea 66
- `CONSTRAINT internal_staff_name_ck CHECK(name_normalized<>'')` · Migración 1791849600000 · línea 66

Índices declarados:

- `CREATE INDEX internal_staff_list_idx ON esquema.internal_staff(is_active,name_normalized,id)` · Migración 1791849600000 · línea 66

## provider

Empresa proveedora.

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

PK: id. Unicidad total: (cuit).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791849600000 · línea 66 |
| commercial_name | varchar(200) | NO |  |  | Migración 1791849600000 · línea 66 |
| name_normalized | text | NO |  |  | Migración 1791849600000 · línea 66 |
| legal_name | varchar(200) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| cuit | varchar(11) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| address | varchar(500) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| general_phones | text[] | NO |  |  | Migración 1791849600000 · línea 66 |
| contact_email | varchar(320) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| notes | varchar(4000) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| is_active | boolean | NO |  |  | Migración 1791849600000 · línea 66 |
| version | integer | NO |  |  | Migración 1791849600000 · línea 66 |
| created_at | timestamptz | NO |  |  | Migración 1791849600000 · línea 66 |
| updated_at | timestamptz | NO |  |  | Migración 1791849600000 · línea 66 |
| created_actor_type | varchar(8) | NO |  |  | Migración 1791849600000 · línea 66 |
| created_by_core_user_id | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1791849600000 · línea 66 |
| created_operation_code | varchar(120) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| updated_actor_type | varchar(8) | NO |  |  | Migración 1791849600000 · línea 66 |
| updated_by_core_user_id | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1791849600000 · línea 66 |
| updated_operation_code | varchar(120) | SÍ |  |  | Migración 1791849600000 · línea 66 |

Claves foráneas:

- (created_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.
- (updated_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.

Restricciones CHECK:

- `CONSTRAINT provider_version_ck CHECK(version>=1)` · Migración 1791849600000 · línea 66
- `CONSTRAINT provider_dates_ck CHECK(updated_at>=created_at)` · Migración 1791849600000 · línea 66
- `CONSTRAINT provider_created_actor_ck CHECK( (created_actor_type='user' AND created_by_core_user_id IS NOT NULL AND created_operation_code IS NULL) OR (created_actor_type='system' AND created_by_core_user_id IS NULL AND created_operation_code ~ '^[a-z][a-z0-9_.:-]{0,119}$' AND created_operation_code IS NOT NULL))` · Migración 1791849600000 · línea 66
- `CONSTRAINT provider_updated_actor_ck CHECK( (updated_actor_type='user' AND updated_by_core_user_id IS NOT NULL AND updated_operation_code IS NULL) OR (updated_actor_type='system' AND updated_by_core_user_id IS NULL AND updated_operation_code ~ '^[a-z][a-z0-9_.:-]{0,119}$' AND updated_operation_code IS NOT NULL))` · Migración 1791849600000 · línea 66
- `CONSTRAINT provider_name_ck CHECK(name_normalized<>'')` · Migración 1791849600000 · línea 66
- `CONSTRAINT provider_cuit_ck CHECK(cuit IS NULL OR esquema.maintenance_directory_cuit_valid(cuit))` · Migración 1791849600000 · línea 66
- `CONSTRAINT provider_phones_ck CHECK(array_position(general_phones,NULL) IS NULL AND array_position(general_phones,'') IS NULL)` · Migración 1791849600000 · línea 66

Índices declarados:

- `CREATE INDEX provider_list_idx ON esquema.provider(is_active,name_normalized,id)` · Migración 1791849600000 · línea 66

## provider_contact

Contacto de empresa proveedora.

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

PK: id. Unicidad total: (provider_id, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791849600000 · línea 66 |
| provider_id | uuid | NO | FK | provider(id) | Migración 1791849600000 · línea 66 |
| identification | varchar(200) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| description | varchar(4000) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| phone | varchar(120) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| email | varchar(320) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| is_active | boolean | NO |  |  | Migración 1791849600000 · línea 66 |
| version | integer | NO |  |  | Migración 1791849600000 · línea 66 |
| created_at | timestamptz | NO |  |  | Migración 1791849600000 · línea 66 |
| updated_at | timestamptz | NO |  |  | Migración 1791849600000 · línea 66 |
| created_actor_type | varchar(8) | NO |  |  | Migración 1791849600000 · línea 66 |
| created_by_core_user_id | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1791849600000 · línea 66 |
| created_operation_code | varchar(120) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| updated_actor_type | varchar(8) | NO |  |  | Migración 1791849600000 · línea 66 |
| updated_by_core_user_id | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1791849600000 · línea 66 |
| updated_operation_code | varchar(120) | SÍ |  |  | Migración 1791849600000 · línea 66 |

Claves foráneas:

- (created_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.
- (updated_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.
- (provider_id) → provider(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.

Restricciones CHECK:

- `CONSTRAINT provider_contact_version_ck CHECK(version>=1)` · Migración 1791849600000 · línea 66
- `CONSTRAINT provider_contact_dates_ck CHECK(updated_at>=created_at)` · Migración 1791849600000 · línea 66
- `CONSTRAINT provider_contact_created_actor_ck CHECK( (created_actor_type='user' AND created_by_core_user_id IS NOT NULL AND created_operation_code IS NULL) OR (created_actor_type='system' AND created_by_core_user_id IS NULL AND created_operation_code ~ '^[a-z][a-z0-9_.:-]{0,119}$' AND created_operation_code IS NOT NULL))` · Migración 1791849600000 · línea 66
- `CONSTRAINT provider_contact_updated_actor_ck CHECK( (updated_actor_type='user' AND updated_by_core_user_id IS NOT NULL AND updated_operation_code IS NULL) OR (updated_actor_type='system' AND updated_by_core_user_id IS NULL AND updated_operation_code ~ '^[a-z][a-z0-9_.:-]{0,119}$' AND updated_operation_code IS NOT NULL))` · Migración 1791849600000 · línea 66
- `CONSTRAINT provider_contact_channel_ck CHECK(NULLIF(btrim(phone),'') IS NOT NULL OR NULLIF(btrim(email),'') IS NOT NULL)` · Migración 1791849600000 · línea 66

Índices declarados:

- `CREATE INDEX provider_contact_list_idx ON esquema.provider_contact(provider_id,is_active,id)` · Migración 1791849600000 · línea 66

## internal_staff_specialty

Registro de internal staff specialty. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: internal_staff_id, catalog_value_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| internal_staff_id | uuid | NO | PK, FK | internal_staff(id) | Migración 1791849600000 · línea 66 |
| catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791849600000 · línea 66 |
| catalog_value_id | uuid | NO | PK, FK | technical_catalog_value(catalog_key, id) | Migración 1791849600000 · línea 66 |

Claves foráneas:

- (internal_staff_id) → internal_staff(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.
- (catalog_key, catalog_value_id) → technical_catalog_value(catalog_key, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.

Restricciones CHECK:

- `CONSTRAINT internal_staff_specialty_catalog_ck CHECK(catalog_key='internal_staff_specialties')` · Migración 1791849600000 · línea 66

Índices declarados:

- `CREATE INDEX internal_staff_specialty_value_idx ON esquema.internal_staff_specialty(catalog_value_id,internal_staff_id)` · Migración 1791849600000 · línea 66

## provider_trade

Registro de provider trade. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: provider_id, catalog_value_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| provider_id | uuid | NO | PK, FK | provider(id) | Migración 1791849600000 · línea 66 |
| catalog_key | varchar(40) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1791849600000 · línea 66 |
| catalog_value_id | uuid | NO | PK, FK | technical_catalog_value(catalog_key, id) | Migración 1791849600000 · línea 66 |

Claves foráneas:

- (provider_id) → provider(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.
- (catalog_key, catalog_value_id) → technical_catalog_value(catalog_key, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.

Restricciones CHECK:

- `CONSTRAINT provider_trade_catalog_ck CHECK(catalog_key='provider_trades')` · Migración 1791849600000 · línea 66

Índices declarados:

- `CREATE INDEX provider_trade_value_idx ON esquema.provider_trade(catalog_value_id,provider_id)` · Migración 1791849600000 · línea 66

## directory_idempotency_record

Registro de directory idempotency record. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (principal_core_user_id, operation, idempotency_key).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791849600000 · línea 66 |
| principal_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1791849600000 · línea 66 |
| operation | varchar(120) | NO |  |  | Migración 1791849600000 · línea 66 |
| idempotency_key | varchar(120) | NO |  |  | Migración 1791849600000 · línea 66 |
| request_hash | char(64) | NO |  |  | Migración 1791849600000 · línea 66 |
| response_status | integer | SÍ |  |  | Migración 1791849600000 · línea 66 |
| response_body | jsonb | SÍ |  |  | Migración 1791849600000 · línea 66 |
| response_etag | varchar(180) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| response_location | varchar(512) | SÍ |  |  | Migración 1791849600000 · línea 66 |
| completed_at | timestamptz | SÍ |  |  | Migración 1791849600000 · línea 66 |
| created_at | timestamptz | NO |  |  | Migración 1791849600000 · línea 66 |

Claves foráneas:

- (principal_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.

Restricciones CHECK:

- `CONSTRAINT directory_idempotency_operation_ck CHECK(operation ~ '^[a-z][a-z0-9_.:-]{0,119}$')` · Migración 1791849600000 · línea 66
- `CONSTRAINT directory_idempotency_key_ck CHECK(idempotency_key ~ '^[A-Za-z0-9._:-]{1,120}$')` · Migración 1791849600000 · línea 66
- `CONSTRAINT directory_idempotency_hash_ck CHECK(request_hash ~ '^[0-9a-f]{64}$')` · Migración 1791849600000 · línea 66
- `CONSTRAINT directory_idempotency_response_ck CHECK( (completed_at IS NULL AND response_status IS NULL AND response_body IS NULL AND response_etag IS NULL AND response_location IS NULL) OR (completed_at IS NOT NULL AND completed_at>=created_at AND response_status IN (200,201) AND response_status IS NOT NULL AND jsonb_typeof(response_body)='object' AND response_body IS NOT NULL AND response_etag IS NOT NULL))` · Migración 1791849600000 · línea 66

Índices declarados:

Sin declaración adicional identificada.

## directory_seed_correspondence

Registro de directory seed correspondence. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: source_namespace, source_key. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| source_namespace | varchar(120) | NO | PK |  | Migración 1791849600000 · línea 66 |
| source_key | varchar(120) | NO | PK |  | Migración 1791849600000 · línea 66 |
| entity_kind | varchar(24) | NO |  |  | Migración 1791849600000 · línea 66 |
| internal_staff_id | uuid | SÍ | FK | internal_staff(id) | Migración 1791849600000 · línea 66 |
| provider_id | uuid | SÍ | FK | provider(id) | Migración 1791849600000 · línea 66 |
| provider_contact_id | uuid | SÍ | FK | provider_contact(id) | Migración 1791849600000 · línea 66 |
| initial_record_hash | char(64) | NO |  |  | Migración 1791849600000 · línea 66 |
| source_sha256 | char(64) | NO |  |  | Migración 1791849600000 · línea 66 |
| created_at | timestamptz | NO |  |  | Migración 1791849600000 · línea 66 |

Claves foráneas:

- (internal_staff_id) → internal_staff(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.
- (provider_id) → provider(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.
- (provider_contact_id) → provider_contact(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1791849600000 · línea 66.

Restricciones CHECK:

- `CONSTRAINT directory_seed_correspondence_shape_ck CHECK( (entity_kind='internal_staff' AND internal_staff_id IS NOT NULL AND provider_id IS NULL AND provider_contact_id IS NULL) OR (entity_kind='provider' AND internal_staff_id IS NULL AND provider_id IS NOT NULL AND provider_contact_id IS NULL) OR (entity_kind='provider_contact' AND internal_staff_id IS NULL AND provider_id IS NULL AND provider_contact_id IS NOT NULL))` · Migración 1791849600000 · línea 66
- `CONSTRAINT directory_seed_correspondence_keys_ck CHECK(source_namespace ~ '^[a-z][a-z0-9_.:-]{0,119}$' AND source_key ~ '^[A-Za-z0-9._:-]{1,120}$')` · Migración 1791849600000 · línea 66
- `CONSTRAINT directory_seed_correspondence_hash_ck CHECK(initial_record_hash ~ '^[0-9a-f]{64}$' AND source_sha256 ~ '^[0-9a-f]{64}$')` · Migración 1791849600000 · línea 66

Índices declarados:

- `CREATE UNIQUE INDEX directory_seed_staff_key ON esquema.directory_seed_correspondence(source_namespace,internal_staff_id) WHERE internal_staff_id IS NOT NULL` · Migración 1791849600000 · línea 66
- `CREATE UNIQUE INDEX directory_seed_provider_key ON esquema.directory_seed_correspondence(source_namespace,provider_id) WHERE provider_id IS NOT NULL` · Migración 1791849600000 · línea 66
- `CREATE UNIQUE INDEX directory_seed_contact_key ON esquema.directory_seed_correspondence(source_namespace,provider_contact_id) WHERE provider_contact_id IS NOT NULL` · Migración 1791849600000 · línea 66

## directory_seed_application

Registro de directory seed application. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (source_namespace, manifest_hash).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1791849600000 · línea 66 |
| source_namespace | varchar(120) | NO |  |  | Migración 1791849600000 · línea 66 |
| manifest_hash | char(64) | NO |  |  | Migración 1791849600000 · línea 66 |
| dataset_hash | char(64) | NO |  |  | Migración 1791849600000 · línea 66 |
| approved_plan_hash | char(64) | NO |  |  | Migración 1791849600000 · línea 66 |
| operation_code | varchar(120) | NO |  |  | Migración 1791849600000 · línea 66 |
| inserted_staff | integer | NO |  |  | Migración 1791849600000 · línea 66 |
| inserted_providers | integer | NO |  |  | Migración 1791849600000 · línea 66 |
| inserted_contacts | integer | NO |  |  | Migración 1791849600000 · línea 66 |
| occurred_at | timestamptz | NO |  |  | Migración 1791849600000 · línea 66 |

Claves foráneas:


Restricciones CHECK:

- `CONSTRAINT directory_seed_application_hash_ck CHECK(manifest_hash ~ '^[0-9a-f]{64}$' AND dataset_hash ~ '^[0-9a-f]{64}$' AND approved_plan_hash ~ '^[0-9a-f]{64}$')` · Migración 1791849600000 · línea 66
- `CONSTRAINT directory_seed_application_shape_ck CHECK(source_namespace ~ '^[a-z][a-z0-9_.:-]{0,119}$' AND operation_code='maintenance-directory-seed-v1' AND inserted_staff>=0 AND inserted_providers>=0 AND inserted_contacts>=0)` · Migración 1791849600000 · línea 66

Índices declarados:

Sin declaración adicional identificada.

## maintenance_document

Documento asociado a propietario operativo.

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

PK: id. Unicidad total: (owner_asset_id, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK, FK | maintenance_document_revision(document_id, id) | Migración 1792022400000 · línea 48 |
| owner_kind | varchar(16) | NO |  |  | Migración 1792022400000 · línea 48 |
| owner_asset_id | uuid | SÍ | FK | asset(id) | Migración 1792022400000 · línea 48 |
| owner_provider_id | uuid | SÍ | FK | provider(id) | Migración 1792022400000 · línea 48 |
| owner_staff_id | uuid | SÍ | FK | internal_staff(id) | Migración 1792022400000 · línea 48 |
| title | varchar(200) | NO |  |  | Migración 1792022400000 · línea 48 |
| notes | varchar(4000) | SÍ |  |  | Migración 1792022400000 · línea 48 |
| version | integer | NO |  |  | Migración 1792022400000 · línea 48 |
| current_revision_id | uuid | NO | FK | maintenance_document_revision(document_id, id) | Migración 1792022400000 · línea 48 |
| is_retired | boolean | NO |  |  | Migración 1792022400000 · línea 48 |
| retired_at | timestamptz | SÍ |  |  | Migración 1792022400000 · línea 48 |
| retire_reason | varchar(1000) | SÍ |  |  | Migración 1792022400000 · línea 48 |
| created_at | timestamptz | NO |  |  | Migración 1792022400000 · línea 48 |
| updated_at | timestamptz | NO |  |  | Migración 1792022400000 · línea 48 |
| created_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1792022400000 · línea 48 |
| updated_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1792022400000 · línea 48 |
| owner_notice_id | uuid | SÍ | FK | maintenance_notice(id) | Migración 1793145600000 · línea 14 |
| owner_intervention_id | uuid | SÍ | FK | work_order_intervention(id) | Migración 1794441600000 · línea 378 |

Claves foráneas:

- (owner_asset_id) → asset(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (owner_provider_id) → provider(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (owner_staff_id) → internal_staff(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (created_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (updated_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (id, current_revision_id) → maintenance_document_revision(document_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (owner_notice_id) → maintenance_notice(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (owner_intervention_id) → work_order_intervention(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 378.

Restricciones CHECK:

- `CHECK(updated_at>=created_at)` · Migración 1792022400000 · línea 48
- `CHECK((is_retired AND retired_at IS NOT NULL AND retire_reason IS NOT NULL AND btrim(retire_reason)<>'') OR (NOT is_retired AND retired_at IS NULL AND retire_reason IS NULL))` · Migración 1792022400000 · línea 48
- `CONSTRAINT maintenance_document_owner_ck CHECK( (owner_kind='asset' AND owner_asset_id IS NOT NULL AND num_nonnulls(owner_provider_id,owner_staff_id,owner_notice_id,owner_intervention_id)=0) OR (owner_kind='provider' AND owner_provider_id IS NOT NULL AND num_nonnulls(owner_asset_id,owner_staff_id,owner_notice_id,owner_intervention_id)=0) OR (owner_kind='staff' AND owner_staff_id IS NOT NULL AND num_nonnulls(owner_asset_id,owner_provider_id,owner_notice_id,owner_intervention_id)=0) OR (owner_kind='notice' AND owner_notice_id IS NOT NULL AND num_nonnulls(owner_asset_id,owner_provider_id,owner_staff_id,owner_intervention_id)=0) OR (owner_kind='intervention' AND owner_intervention_id IS NOT NULL AND num_nonnulls(owner_asset_id,owner_provider_id,owner_staff_id,owner_notice_id)=0))` · Migración 1794441600000 · línea 382

Índices declarados:

- `CREATE INDEX maintenance_document_asset_list_idx ON esquema.maintenance_document(owner_asset_id,is_retired,created_at DESC,id DESC) WHERE owner_asset_id IS NOT NULL` · Migración 1792022400000 · línea 48
- `CREATE INDEX maintenance_document_provider_list_idx ON esquema.maintenance_document(owner_provider_id,is_retired,created_at DESC,id DESC) WHERE owner_provider_id IS NOT NULL` · Migración 1792022400000 · línea 48
- `CREATE INDEX maintenance_document_staff_list_idx ON esquema.maintenance_document(owner_staff_id,is_retired,created_at DESC,id DESC) WHERE owner_staff_id IS NOT NULL` · Migración 1792022400000 · línea 48
- `CREATE INDEX maintenance_document_notice_list_idx ON esquema.maintenance_document(owner_notice_id,is_retired,created_at DESC,id DESC) WHERE owner_notice_id IS NOT NULL` · Migración 1793145600000 · línea 14
- `CREATE INDEX maintenance_document_intervention_list_idx ON esquema.maintenance_document(owner_intervention_id,is_retired,created_at DESC,id DESC) WHERE owner_intervention_id IS NOT NULL` · Migración 1794441600000 · línea 390

## maintenance_document_file

Archivo físico y propiedades documentales.

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 1792022400000 · línea 48 |
| upload_id | uuid | NO | FK | maintenance_document_upload(id) | Migración 1792022400000 · línea 48 |
| storage_instance_id | uuid | NO |  |  | Migración 1792022400000 · línea 48 |
| storage_key | uuid | NO |  |  | Migración 1792022400000 · línea 48 |
| original_name | varchar(255) | NO |  |  | Migración 1792022400000 · línea 48 |
| declared_mime | varchar(120) | SÍ |  |  | Migración 1792022400000 · línea 48 |
| expected_size | integer | NO |  |  | Migración 1792022400000 · línea 48 |
| expected_sha256 | char(64) | NO |  |  | Migración 1792022400000 · línea 48 |
| actual_size | integer | SÍ |  |  | Migración 1792022400000 · línea 48 |
| sha256 | char(64) | SÍ |  |  | Migración 1792022400000 · línea 48 |
| format | varchar(4) | SÍ |  |  | Migración 1792022400000 · línea 48 |
| mime | varchar(32) | SÍ |  |  | Migración 1792022400000 · línea 48 |
| state | varchar(16) | NO |  |  | Migración 1792022400000 · línea 48 |
| created_at | timestamptz | NO |  |  | Migración 1792022400000 · línea 48 |
| last_activity_at | timestamptz | NO |  |  | Migración 1792022400000 · línea 48 |
| created_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1792022400000 · línea 48 |

Claves foráneas:

- (created_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (upload_id) → maintenance_document_upload(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.

Restricciones CHECK:

- `CHECK(last_activity_at>=created_at)` · Migración 1792022400000 · línea 48
- `CHECK((actual_size IS NULL AND sha256 IS NULL AND format IS NULL AND mime IS NULL) OR (actual_size=expected_size AND sha256=expected_sha256 AND actual_size IS NOT NULL AND sha256 IS NOT NULL AND format IS NOT NULL AND mime IS NOT NULL AND ((format='jpeg' AND mime='image/jpeg') OR (format='png' AND mime='image/png') OR (format='webp' AND mime='image/webp') OR (format='pdf' AND mime='application/pdf'))))` · Migración 1792022400000 · línea 48
- `CHECK(state NOT IN ('ready','published','confirmed') OR (actual_size IS NOT NULL AND sha256 IS NOT NULL AND format IS NOT NULL AND mime IS NOT NULL))` · Migración 1792022400000 · línea 48

Índices declarados:

- `CREATE INDEX maintenance_document_file_cleanup_idx ON esquema.maintenance_document_file(state,last_activity_at,id) WHERE state<>'confirmed'` · Migración 1792022400000 · línea 48
- `CREATE INDEX maintenance_document_file_upload_idx ON esquema.maintenance_document_file(upload_id,created_at,id)` · Migración 1792022400000 · línea 48

## maintenance_document_revision

Versión documental.

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

PK: id. Unicidad total: (file_id); (document_id, id); (document_id, revision_number).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1792022400000 · línea 48 |
| document_id | uuid | NO | FK | maintenance_document(id) | Migración 1792022400000 · línea 48 |
| revision_number | integer | NO |  |  | Migración 1792022400000 · línea 48 |
| file_id | uuid | NO | FK | maintenance_document_file(id) | Migración 1792022400000 · línea 48 |
| expires_on | date | SÍ |  |  | Migración 1792022400000 · línea 48 |
| created_at | timestamptz | NO |  |  | Migración 1792022400000 · línea 48 |
| created_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1792022400000 · línea 48 |

Claves foráneas:

- (document_id) → maintenance_document(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (file_id) → maintenance_document_file(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1792022400000 · línea 48.
- (created_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

- `CREATE INDEX maintenance_document_revision_expiry_idx ON esquema.maintenance_document_revision(expires_on,document_id) WHERE expires_on IS NOT NULL` · Migración 1792022400000 · línea 48

## maintenance_document_operation

Registro de document operation. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (principal_core_user_id, operation, idempotency_key).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1792022400000 · línea 48 |
| principal_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1792022400000 · línea 48 |
| operation | varchar(120) | NO |  |  | Migración 1792022400000 · línea 48 |
| idempotency_key | uuid | NO |  |  | Migración 1792022400000 · línea 48 |
| request_hash | char(64) | NO |  |  | Migración 1792022400000 · línea 48 |
| request_body | jsonb | NO |  |  | Migración 1792022400000 · línea 48 |
| owner_kind | varchar(16) | NO |  |  | Migración 1792022400000 · línea 48 |
| owner_asset_id | uuid | SÍ | FK | asset(id) | Migración 1792022400000 · línea 48 |
| owner_provider_id | uuid | SÍ | FK | provider(id) | Migración 1792022400000 · línea 48 |
| owner_staff_id | uuid | SÍ | FK | internal_staff(id) | Migración 1792022400000 · línea 48 |
| document_id | uuid | SÍ | FK | maintenance_document(id) | Migración 1792022400000 · línea 48 |
| state | varchar(16) | NO |  |  | Migración 1792022400000 · línea 48 |
| phase | varchar(24) | NO |  |  | Migración 1792022400000 · línea 48 |
| response_status | integer | SÍ |  |  | Migración 1792022400000 · línea 48 |
| response_body | jsonb | SÍ |  |  | Migración 1792022400000 · línea 48 |
| completed_at | timestamptz | SÍ |  |  | Migración 1792022400000 · línea 48 |
| created_at | timestamptz | NO |  |  | Migración 1792022400000 · línea 48 |
| updated_at | timestamptz | NO |  |  | Migración 1792022400000 · línea 48 |
| owner_notice_id | uuid | SÍ | FK | maintenance_notice(id) | Migración 1793145600000 · línea 14 |
| notice_initial_file_id | uuid | SÍ | FK | maintenance_notice_initial_file(id) | Migración 1793145600000 · línea 14 |
| notice_resolution_operation_id | uuid | SÍ | FK | notice_evidence_resolution_operation(id) | Migración 1793232000000 · línea 13 |
| owner_intervention_id | uuid | SÍ | FK | work_order_intervention(id) | Migración 1794441600000 · línea 378 |

Claves foráneas:

- (principal_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (owner_asset_id) → asset(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (owner_provider_id) → provider(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (owner_staff_id) → internal_staff(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (document_id) → maintenance_document(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (owner_notice_id) → maintenance_notice(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (notice_initial_file_id) → maintenance_notice_initial_file(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (notice_resolution_operation_id) → notice_evidence_resolution_operation(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.
- (owner_intervention_id) → work_order_intervention(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 378.

Restricciones CHECK:

- `CHECK(updated_at>=created_at)` · Migración 1792022400000 · línea 48
- `CHECK((state='pending' AND phase<>'terminal' AND completed_at IS NULL AND response_status IS NULL AND response_body IS NULL) OR (state IN ('applied','not_applied') AND phase='terminal' AND completed_at IS NOT NULL AND completed_at>=created_at AND response_status BETWEEN 200 AND 599 AND response_status IS NOT NULL AND response_body IS NOT NULL AND jsonb_typeof(response_body)='object'))` · Migración 1792022400000 · línea 48
- `CONSTRAINT maintenance_document_operation_initial_owner_ck CHECK(notice_initial_file_id IS NULL OR (owner_kind='notice' AND operation='document.created'))` · Migración 1793145600000 · línea 14
- `CONSTRAINT maintenance_document_resolution_owner_ck CHECK(notice_resolution_operation_id IS NULL OR (owner_kind='notice' AND operation='document.created'))` · Migración 1793232000000 · línea 13
- `CONSTRAINT maintenance_document_operation_owner_ck CHECK( (owner_kind='asset' AND owner_asset_id IS NOT NULL AND num_nonnulls(owner_provider_id,owner_staff_id,owner_notice_id,owner_intervention_id)=0) OR (owner_kind='provider' AND owner_provider_id IS NOT NULL AND num_nonnulls(owner_asset_id,owner_staff_id,owner_notice_id,owner_intervention_id)=0) OR (owner_kind='staff' AND owner_staff_id IS NOT NULL AND num_nonnulls(owner_asset_id,owner_provider_id,owner_notice_id,owner_intervention_id)=0) OR (owner_kind='notice' AND owner_notice_id IS NOT NULL AND num_nonnulls(owner_asset_id,owner_provider_id,owner_staff_id,owner_intervention_id)=0) OR (owner_kind='intervention' AND owner_intervention_id IS NOT NULL AND num_nonnulls(owner_asset_id,owner_provider_id,owner_staff_id,owner_notice_id)=0))` · Migración 1794441600000 · línea 382

Índices declarados:

- `CREATE INDEX maintenance_document_operation_owner_idx ON esquema.maintenance_document_operation(owner_kind,owner_asset_id,owner_provider_id,owner_staff_id,state,id)` · Migración 1792022400000 · línea 48
- `CREATE INDEX maintenance_document_operation_notice_idx ON esquema.maintenance_document_operation(owner_notice_id,state,id) WHERE owner_notice_id IS NOT NULL` · Migración 1793145600000 · línea 14
- `CREATE INDEX maintenance_document_operation_intervention_idx ON esquema.maintenance_document_operation(owner_intervention_id,state,id) WHERE owner_intervention_id IS NOT NULL` · Migración 1794441600000 · línea 390

## maintenance_document_upload

Operación de carga documental.

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

PK: id. Unicidad total: (operation_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1792022400000 · línea 48 |
| operation_id | uuid | NO | FK | maintenance_document_operation(id) | Migración 1792022400000 · línea 48 |
| active_file_id | uuid | SÍ | FK | maintenance_document_file(id) | Migración 1792022400000 · línea 48 |
| target_document_id | uuid | SÍ | FK | maintenance_document(id) | Migración 1792022400000 · línea 48 |
| planned_document_id | uuid | NO |  |  | Migración 1792022400000 · línea 48 |
| planned_revision_id | uuid | NO |  |  | Migración 1792022400000 · línea 48 |
| state | varchar(16) | NO |  |  | Migración 1792022400000 · línea 48 |
| created_at | timestamptz | NO |  |  | Migración 1792022400000 · línea 48 |
| last_activity_at | timestamptz | NO |  |  | Migración 1792022400000 · línea 48 |

Claves foráneas:

- (operation_id) → maintenance_document_operation(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1792022400000 · línea 48.
- (active_file_id) → maintenance_document_file(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (target_document_id) → maintenance_document(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.

Restricciones CHECK:

- `CHECK(last_activity_at>=created_at)` · Migración 1792022400000 · línea 48
- `CHECK(state IN ('prepared','closed') OR active_file_id IS NOT NULL)` · Migración 1792022400000 · línea 48

Índices declarados:

- `CREATE INDEX maintenance_document_upload_cleanup_idx ON esquema.maintenance_document_upload(state,last_activity_at,id)` · Migración 1792022400000 · línea 48

## maintenance_asset_document_cover

Portada documental de activo.

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

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

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| asset_id | uuid | NO | PK, FK | asset(id); maintenance_document(owner_asset_id, id) | Migración 1792022400000 · línea 48 |
| document_id | uuid | SÍ | FK | maintenance_document(owner_asset_id, id); maintenance_document_revision(document_id, id) | Migración 1792022400000 · línea 48 |
| revision_id | uuid | SÍ | FK | maintenance_document_revision(document_id, id) | Migración 1792022400000 · línea 48 |
| updated_at | timestamptz | NO |  |  | Migración 1792022400000 · línea 48 |
| updated_by_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1792022400000 · línea 48 |

Claves foráneas:

- (asset_id) → asset(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1792022400000 · línea 48.
- (updated_by_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (asset_id, document_id) → maintenance_document(owner_asset_id, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.
- (document_id, revision_id) → maintenance_document_revision(document_id, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792022400000 · línea 48.

Restricciones CHECK:

- `CHECK((document_id IS NULL)=(revision_id IS NULL))` · Migración 1792022400000 · línea 48

Índices declarados:

Sin declaración adicional identificada.

## work_order_annual_counter

Registro de work order annual counter. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

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

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| emission_year | integer | NO | PK |  | Migración 1792108800000 · línea 55 |
| last_number | bigint | NO |  |  | Migración 1792108800000 · línea 55 |

Claves foráneas:


Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

Sin declaración adicional identificada.

## work_order

Orden de trabajo emitida.

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

PK: id. Unicidad total: (number); (emission_year, annual_number).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1792108800000 · línea 55 |
| emission_year | integer | NO | FK | work_order_annual_counter(emission_year) | Migración 1792108800000 · línea 55 |
| annual_number | bigint | NO |  |  | Migración 1792108800000 · línea 55 |
| number | text | SÍ |  |  | Migración 1792108800000 · línea 55 |
| version | integer | NO |  |  | Migración 1792108800000 · línea 55 |
| title | varchar(200) | NO |  |  | Migración 1792108800000 · línea 55 |
| description | varchar(4000) | SÍ |  |  | Migración 1792108800000 · línea 55 |
| kind | varchar(16) | NO |  |  | Migración 1792108800000 · línea 55 |
| origin_kind | varchar(32) | NO |  |  | Migración 1792108800000 · línea 55 |
| origin_context | jsonb | NO |  |  | Migración 1792108800000 · línea 55 |
| goal_asset_id | uuid | SÍ | FK | asset(id) | Migración 1792108800000 · línea 55 |
| goal_space_id | uuid | SÍ | FK | core_space_projection(core_space_id) | Migración 1792108800000 · línea 55 |
| space_snapshot | jsonb | SÍ |  |  | Migración 1792108800000 · línea 55 |
| goal_space_path_ids | jsonb | SÍ |  |  | Migración 1792108800000 · línea 55 |
| priority_id | uuid | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1792108800000 · línea 55 |
| priority_catalog_key | varchar(80) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1792108800000 · línea 55 |
| priority_snapshot | jsonb | NO |  |  | Migración 1792108800000 · línea 55 |
| scheduled_for | timestamptz | SÍ |  |  | Migración 1792108800000 · línea 55 |
| deadline_at | timestamptz | SÍ |  |  | Migración 1792108800000 · línea 55 |
| estimated_minutes | integer | SÍ |  |  | Migración 1792108800000 · línea 55 |
| planning_notes | varchar(4000) | SÍ |  |  | Migración 1792108800000 · línea 55 |
| state | varchar(24) | NO |  |  | Migración 1792108800000 · línea 55 |
| technical_dataset_key | varchar(120) | SÍ |  |  | Migración 1792108800000 · línea 55 |
| created_at | timestamptz | NO |  |  | Migración 1792108800000 · línea 55 |
| updated_at | timestamptz | NO |  |  | Migración 1792108800000 · línea 55 |
| actor_type | varchar(8) | NO |  |  | Migración 1792108800000 · línea 55 |
| actor_core_user_id | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1792108800000 · línea 55 |
| actor_operation_code | varchar(120) | SÍ |  |  | Migración 1792108800000 · línea 55 |
| creation_transaction_id | xid8 | NO |  |  | Migración 1793577600000 · línea 5 |

Claves foráneas:

- (emission_year) → work_order_annual_counter(emission_year). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (goal_asset_id) → asset(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (goal_space_id) → core_space_projection(core_space_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (actor_core_user_id) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (priority_catalog_key, priority_id) → technical_catalog_value(catalog_key, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.

Restricciones CHECK:

- `CONSTRAINT work_order_goal_ck CHECK (num_nonnulls(goal_asset_id,goal_space_id)=1)` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_space_snapshot_ck CHECK ((goal_space_id IS NULL AND space_snapshot IS NULL) OR (goal_space_id IS NOT NULL AND esquema.maintenance_work_order_snapshot_valid('location',space_snapshot) AND space_snapshot->>'id'=goal_space_id::text))` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_priority_snapshot_ck CHECK (esquema.maintenance_work_order_snapshot_valid('priority',priority_snapshot) AND priority_snapshot->>'id'=priority_id::text)` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_origin_ck CHECK (esquema.maintenance_work_order_snapshot_valid('origin.'||origin_kind,origin_context) AND (origin_kind='manual' OR (kind='preventive' AND origin_kind IN ('preventive_periodic','preventive_event')) OR (kind='corrective' AND origin_kind IN ('corrective_reports','corrective_finding'))))` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_emission_year_ck CHECK (emission_year=extract(year FROM created_at AT TIME ZONE 'America/Argentina/Buenos_Aires'))` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_dates_ck CHECK (updated_at>=created_at)` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_actor_ck CHECK ((actor_type='user' AND actor_core_user_id IS NOT NULL AND actor_operation_code IS NULL) OR (actor_type='system' AND actor_core_user_id IS NULL AND actor_operation_code IS NOT NULL AND actor_operation_code ~ '^[a-z][a-z0-9_.:-]{0,119}$'))` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_dataset_ck CHECK (technical_dataset_key IS NULL OR (actor_type='system' AND technical_dataset_key ~ '^[a-z][a-z0-9_.:-]{0,119}$'))` · Migración 1792108800000 · línea 55

Índices declarados:

- `CREATE INDEX work_order_created_idx ON esquema.work_order(created_at DESC,id DESC)` · Migración 1792108800000 · línea 55
- `CREATE INDEX work_order_goal_asset_idx ON esquema.work_order(goal_asset_id)` · Migración 1792108800000 · línea 55
- `CREATE INDEX work_order_space_path_idx ON esquema.work_order USING gin(goal_space_path_ids)` · Migración 1792108800000 · línea 55

## work_order_asset_scope

Alcance de activos congelado para una OT.

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

PK: work_order_id, asset_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| work_order_id | uuid | NO | PK, FK | work_order(id) | Migración 1792108800000 · línea 55 |
| asset_id | uuid | NO | PK, FK | asset(id) | Migración 1792108800000 · línea 55 |
| role | varchar(12) | NO |  |  | Migración 1792108800000 · línea 55 |
| asset_snapshot | jsonb | NO |  |  | Migración 1792108800000 · línea 55 |
| location_path_ids | jsonb | SÍ |  |  | Migración 1792108800000 · línea 55 |
| relation_id | uuid | SÍ | FK | asset_relation(id) | Migración 1792108800000 · línea 55 |
| relation_snapshot | jsonb | SÍ |  |  | Migración 1792108800000 · línea 55 |
| retired_at | timestamptz | SÍ |  |  | Migración 1793577600000 · línea 5 |

Claves foráneas:

- (work_order_id) → work_order(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (asset_id) → asset(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (relation_id) → asset_relation(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.

Restricciones CHECK:

- `CONSTRAINT work_order_scope_asset_snapshot_ck CHECK (esquema.maintenance_work_order_snapshot_valid('asset',asset_snapshot) AND asset_snapshot->>'id'=asset_id::text)` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_scope_relation_ck CHECK ((role='principal' AND relation_id IS NULL AND relation_snapshot IS NULL) OR (role='secondary' AND relation_id IS NOT NULL AND esquema.maintenance_work_order_snapshot_valid('relation',relation_snapshot) AND relation_snapshot->>'id'=relation_id::text))` · Migración 1792108800000 · línea 55

Índices declarados:

- `CREATE INDEX work_order_scope_asset_idx ON esquema.work_order_asset_scope(asset_id,work_order_id)` · Migración 1792108800000 · línea 55
- `CREATE INDEX work_order_scope_path_idx ON esquema.work_order_asset_scope USING gin(location_path_ids)` · Migración 1792108800000 · línea 55

## work_order_task

Tarea perteneciente a una OT.

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

PK: id. Unicidad total: (work_order_id, position); (work_order_id, id); (work_order_id, active_position).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1792108800000 · línea 55 |
| work_order_id | uuid | NO | FK | work_order(id); work_order_asset_scope(work_order_id, asset_id) | Migración 1792108800000 · línea 55 |
| position | integer | NO |  |  | Migración 1792108800000 · línea 55 |
| title | varchar(200) | NO |  |  | Migración 1792108800000 · línea 55 |
| description | varchar(4000) | SÍ |  |  | Migración 1792108800000 · línea 55 |
| asset_id | uuid | SÍ | FK | work_order_asset_scope(work_order_id, asset_id); asset_component(asset_id, id) | Migración 1792108800000 · línea 55 |
| component_id | uuid | SÍ | FK | asset_component(asset_id, id) | Migración 1792108800000 · línea 55 |
| component_snapshot | jsonb | SÍ |  |  | Migración 1792108800000 · línea 55 |
| space_actions | jsonb | NO |  |  | Migración 1792108800000 · línea 55 |
| template_snapshot | jsonb | SÍ |  |  | Migración 1792108800000 · línea 55 |
| retired_at | timestamptz | SÍ |  |  | Migración 1793577600000 · línea 5 |
| active_position | integer | SÍ |  |  | Migración 1793577600000 · línea 5 |

Claves foráneas:

- (work_order_id) → work_order(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (work_order_id, asset_id) → work_order_asset_scope(work_order_id, asset_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (asset_id, component_id) → asset_component(asset_id, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.

Restricciones CHECK:

- `CONSTRAINT work_order_task_component_ck CHECK ((component_id IS NULL AND component_snapshot IS NULL) OR (asset_id IS NOT NULL AND component_id IS NOT NULL AND esquema.maintenance_work_order_snapshot_valid('component',component_snapshot) AND component_snapshot->>'id'=component_id::text AND component_snapshot->>'asset_id'=asset_id::text))` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_task_actions_ck CHECK (jsonb_typeof(space_actions)='array' AND esquema.maintenance_work_order_snapshot_valid('actions',jsonb_build_object('schema_version',1,'items',space_actions)) AND ((asset_id IS NOT NULL AND space_actions='[]') OR (asset_id IS NULL AND jsonb_array_length(space_actions)>0)))` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_task_template_ck CHECK (template_snapshot IS NULL OR esquema.maintenance_work_order_snapshot_valid('template',template_snapshot))` · Migración 1792108800000 · línea 55

Índices declarados:

Sin declaración adicional identificada.

## work_order_task_measurement

Registro de work order task measurement. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (task_id, position); (task_id, active_position); (work_order_id, task_id, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1792108800000 · línea 55 |
| work_order_id | uuid | NO | FK | work_order_task(work_order_id, id) | Migración 1792108800000 · línea 55 |
| task_id | uuid | NO | FK | work_order_task(work_order_id, id) | Migración 1792108800000 · línea 55 |
| position | integer | NO |  |  | Migración 1792108800000 · línea 55 |
| label | varchar(200) | NO |  |  | Migración 1792108800000 · línea 55 |
| unit_id | uuid | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1792108800000 · línea 55 |
| unit_catalog_key | varchar(80) | NO | FK | technical_catalog_value(catalog_key, id) | Migración 1792108800000 · línea 55 |
| unit_snapshot | jsonb | NO |  |  | Migración 1792108800000 · línea 55 |
| is_required | boolean | NO |  |  | Migración 1792108800000 · línea 55 |
| suggested_decimals | integer | NO |  |  | Migración 1792108800000 · línea 55 |
| warning_min | numeric | SÍ |  |  | Migración 1792108800000 · línea 55 |
| warning_max | numeric | SÍ |  |  | Migración 1792108800000 · línea 55 |
| retired_at | timestamptz | SÍ |  |  | Migración 1793577600000 · línea 5 |
| active_position | integer | SÍ |  |  | Migración 1793577600000 · línea 5 |

Claves foráneas:

- (work_order_id, task_id) → work_order_task(work_order_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (unit_catalog_key, unit_id) → technical_catalog_value(catalog_key, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.

Restricciones CHECK:

- `CONSTRAINT work_order_measurement_unit_ck CHECK (esquema.maintenance_work_order_snapshot_valid('unit',unit_snapshot) AND unit_snapshot->>'id'=unit_id::text)` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_measurement_bounds_ck CHECK ((warning_min IS NULL OR warning_min::text NOT IN ('NaN','Infinity','-Infinity')) AND (warning_max IS NULL OR warning_max::text NOT IN ('NaN','Infinity','-Infinity')) AND (warning_min IS NULL OR warning_max IS NULL OR warning_min<=warning_max))` · Migración 1792108800000 · línea 55

Índices declarados:

Sin declaración adicional identificada.

## work_order_assignment

Asignación operativa de OT.

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

PK: id. Unicidad total: (work_order_id, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1792108800000 · línea 55 |
| work_order_id | uuid | NO | FK | work_order(id) | Migración 1792108800000 · línea 55 |
| kind | varchar(8) | NO |  |  | Migración 1792108800000 · línea 55 |
| staff_id | uuid | SÍ | FK | internal_staff(id) | Migración 1792108800000 · línea 55 |
| provider_id | uuid | SÍ | FK | provider(id); provider_contact(provider_id, id) | Migración 1792108800000 · línea 55 |
| contact_id | uuid | SÍ | FK | provider_contact(provider_id, id) | Migración 1792108800000 · línea 55 |
| subject_snapshot | jsonb | NO |  |  | Migración 1792108800000 · línea 55 |
| contact_snapshot | jsonb | SÍ |  |  | Migración 1792108800000 · línea 55 |
| incorporated_at | timestamptz | NO |  |  | Migración 1792108800000 · línea 55 |
| removed_at | timestamptz | SÍ |  |  | Migración 1792108800000 · línea 55 |

Claves foráneas:

- (work_order_id) → work_order(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (staff_id) → internal_staff(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (provider_id) → provider(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (provider_id, contact_id) → provider_contact(provider_id, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.

Restricciones CHECK:

- `CONSTRAINT work_order_assignment_subject_ck CHECK ((kind='staff' AND staff_id IS NOT NULL AND provider_id IS NULL AND contact_id IS NULL) OR (kind='provider' AND staff_id IS NULL AND provider_id IS NOT NULL))` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_assignment_snapshot_ck CHECK (esquema.maintenance_work_order_snapshot_valid('assignment',subject_snapshot) AND subject_snapshot->>'id'=COALESCE(staff_id,provider_id)::text)` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_assignment_contact_ck CHECK ((contact_id IS NULL AND contact_snapshot IS NULL) OR (contact_id IS NOT NULL AND esquema.maintenance_work_order_snapshot_valid('contact',contact_snapshot) AND contact_snapshot->>'id'=contact_id::text AND contact_snapshot->>'provider_id'=provider_id::text))` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_assignment_dates_ck CHECK (removed_at IS NULL OR removed_at>=incorporated_at)` · Migración 1792108800000 · línea 55

Índices declarados:

- `CREATE UNIQUE INDEX work_order_assignment_staff_key ON esquema.work_order_assignment(work_order_id,staff_id) WHERE removed_at IS NULL AND staff_id IS NOT NULL` · Migración 1792108800000 · línea 55
- `CREATE UNIQUE INDEX work_order_assignment_provider_key ON esquema.work_order_assignment(work_order_id,provider_id) WHERE removed_at IS NULL AND provider_id IS NOT NULL` · Migración 1792108800000 · línea 55
- `CREATE INDEX work_order_assignment_subject_idx ON esquema.work_order_assignment(staff_id,provider_id,work_order_id)` · Migración 1792108800000 · línea 55

## work_order_operation

Registro de work order operation. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; 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 1792108800000 · línea 55 |
| actor_type | varchar(8) | NO |  |  | Migración 1792108800000 · línea 55 |
| principal_core_user_id | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1792108800000 · línea 55 |
| actor_operation_code | varchar(120) | SÍ |  |  | Migración 1792108800000 · línea 55 |
| operation | varchar(120) | NO |  |  | Migración 1792108800000 · línea 55 |
| idempotency_key | uuid | NO |  |  | Migración 1792108800000 · línea 55 |
| request_hash | varchar(64) | NO |  |  | Migración 1792108800000 · línea 55 |
| state | varchar(12) | NO |  |  | Migración 1792108800000 · línea 55 |
| work_order_id | uuid | SÍ | FK | work_order(id) | Migración 1792108800000 · línea 55 |
| response_body | jsonb | SÍ |  |  | Migración 1792108800000 · línea 55 |
| created_at | timestamptz | NO |  |  | Migración 1792108800000 · línea 55 |
| completed_at | timestamptz | SÍ |  |  | Migración 1792108800000 · línea 55 |
| assignment_permission_required | boolean | NO |  |  | Migración 1793750400000 · línea 13 |

Claves foráneas:

- (principal_core_user_id) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.
- (work_order_id) → work_order(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1792108800000 · línea 55.

Restricciones CHECK:

- `CONSTRAINT work_order_operation_actor_ck CHECK ((actor_type='user' AND principal_core_user_id IS NOT NULL AND actor_operation_code IS NULL) OR (actor_type='system' AND principal_core_user_id IS NULL AND actor_operation_code IS NOT NULL AND actor_operation_code ~ '^[a-z][a-z0-9_.:-]{0,119}$'))` · Migración 1792108800000 · línea 55
- `CONSTRAINT work_order_operation_terminal_ck CHECK ((state='pending' AND completed_at IS NULL AND response_body IS NULL AND work_order_id IS NULL) OR (state='applied' AND completed_at IS NOT NULL AND completed_at>=created_at AND response_body IS NOT NULL AND jsonb_typeof(response_body)='object' AND work_order_id IS NOT NULL) OR (state='not_applied' AND completed_at IS NOT NULL AND completed_at>=created_at AND response_body IS NOT NULL AND jsonb_typeof(response_body)='object' AND work_order_id IS NULL))` · Migración 1792108800000 · línea 55

Índices declarados:

- `CREATE UNIQUE INDEX work_order_operation_user_key ON esquema.work_order_operation(principal_core_user_id,operation,idempotency_key) WHERE actor_type='user'` · Migración 1792108800000 · línea 55
- `CREATE UNIQUE INDEX work_order_operation_system_key ON esquema.work_order_operation(actor_operation_code,operation,idempotency_key) WHERE actor_type='system'` · Migración 1792108800000 · línea 55
- `CREATE UNIQUE INDEX work_order_operation_result_key ON esquema.work_order_operation(work_order_id) WHERE state='applied'` · Migración 1792108800000 · línea 55

## work_order_draft

Preparación persistida previa a emisión.

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

PK: id. Unicidad total: (work_order_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1793059200000 · línea 17 |
| version | integer | NO |  |  | Migración 1793059200000 · línea 17 |
| state | varchar(12) | NO |  |  | Migración 1793059200000 · línea 17 |
| title | varchar(200) | NO |  |  | Migración 1793059200000 · línea 17 |
| payload | jsonb | NO |  |  | Migración 1793059200000 · línea 17 |
| created_by | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1793059200000 · línea 17 |
| created_by_snapshot | jsonb | NO |  |  | Migración 1793059200000 · línea 17 |
| updated_by | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1793059200000 · línea 17 |
| updated_by_snapshot | jsonb | NO |  |  | Migración 1793059200000 · línea 17 |
| created_at | timestamptz | NO |  |  | Migración 1793059200000 · línea 17 |
| updated_at | timestamptz | NO |  |  | Migración 1793059200000 · línea 17 |
| completed_at | timestamptz | SÍ |  |  | Migración 1793059200000 · línea 17 |
| work_order_id | uuid | SÍ | FK | work_order(id) | Migración 1793059200000 · línea 17 |

Claves foráneas:

- (created_by) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793059200000 · línea 17.
- (updated_by) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793059200000 · línea 17.
- (work_order_id) → work_order(id). Cada hija: 0..1 padre; cada padre: 0..1 hijas. Migración 1793059200000 · línea 17.

Restricciones CHECK:

- `CONSTRAINT work_order_draft_actor_ck CHECK(COALESCE(jsonb_typeof(created_by_snapshot)='object' AND created_by_snapshot->>'id'=created_by::text AND jsonb_typeof(updated_by_snapshot)='object' AND updated_by_snapshot->>'id'=updated_by::text,false))` · Migración 1793059200000 · línea 17
- `CONSTRAINT work_order_draft_dates_ck CHECK(updated_at>=created_at AND (completed_at IS NULL OR completed_at>=updated_at))` · Migración 1793059200000 · línea 17
- `CONSTRAINT work_order_draft_terminal_ck CHECK((state='draft' AND completed_at IS NULL AND work_order_id IS NULL) OR (state='discarded' AND completed_at IS NOT NULL AND work_order_id IS NULL) OR (state='emitted' AND completed_at IS NOT NULL AND work_order_id IS NOT NULL))` · Migración 1793059200000 · línea 17
- `CONSTRAINT work_order_draft_payload_ck CHECK(COALESCE( jsonb_typeof(payload)='object' AND payload->>'title'=title AND octet_length(payload::text)<=524288 AND (payload->'schema_version'='1'::jsonb OR (payload->'schema_version'='2'::jsonb AND payload->'origin'->>'kind'='notices' AND jsonb_typeof(payload->'origin'->'notices')='array' AND jsonb_array_length(payload->'origin'->'notices') BETWEEN 1 AND 100)),false))` · Migración 1793232000000 · línea 13

Índices declarados:

- `CREATE INDEX work_order_draft_pending_idx ON esquema.work_order_draft(updated_at DESC,id DESC) WHERE state='draft'` · Migración 1793059200000 · línea 17
- `CREATE INDEX work_order_draft_author_idx ON esquema.work_order_draft(created_by,id)` · Migración 1793059200000 · línea 17
- `CREATE INDEX work_order_draft_notices_idx ON esquema.work_order_draft USING gin((payload->'origin'->'notices') jsonb_path_ops) WHERE state='draft' AND payload->'schema_version'='2'::jsonb` · Migración 1793232000000 · línea 13

## work_order_draft_operation

Registro de work order draft operation. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (principal_core_user_id, operation, idempotency_key).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1793059200000 · línea 17 |
| principal_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1793059200000 · línea 17 |
| operation | varchar(32) | NO |  |  | Migración 1793059200000 · línea 17 |
| idempotency_key | uuid | NO |  |  | Migración 1793059200000 · línea 17 |
| request_hash | varchar(64) | NO |  |  | Migración 1793059200000 · línea 17 |
| state | varchar(12) | NO |  |  | Migración 1793059200000 · línea 17 |
| draft_id | uuid | SÍ | FK | work_order_draft(id) | Migración 1793059200000 · línea 17 |
| response_status | integer | SÍ |  |  | Migración 1793059200000 · línea 17 |
| response_body | jsonb | SÍ |  |  | Migración 1793059200000 · línea 17 |
| response_etag | varchar(180) | SÍ |  |  | Migración 1793059200000 · línea 17 |
| created_at | timestamptz | NO |  |  | Migración 1793059200000 · línea 17 |
| completed_at | timestamptz | SÍ |  |  | Migración 1793059200000 · línea 17 |

Claves foráneas:

- (principal_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793059200000 · línea 17.
- (draft_id) → work_order_draft(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793059200000 · línea 17.

Restricciones CHECK:

- `CONSTRAINT work_order_draft_operation_terminal_ck CHECK((state='pending' AND completed_at IS NULL AND response_status IS NULL AND response_body IS NULL AND response_etag IS NULL AND draft_id IS NULL) OR (state IN ('applied','not_applied') AND completed_at IS NOT NULL AND completed_at>=created_at AND response_status IS NOT NULL AND response_status BETWEEN 200 AND 599 AND response_body IS NOT NULL AND jsonb_typeof(response_body)='object' AND (state<>'applied' OR draft_id IS NOT NULL)))` · Migración 1793059200000 · línea 17

Índices declarados:

- `CREATE INDEX work_order_draft_operation_target_idx ON esquema.work_order_draft_operation(draft_id)` · Migración 1793059200000 · línea 17

## work_order_planning_precision

Registro de work order planning precision. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

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

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| work_order_id | uuid | NO | PK, FK | work_order(id) | Migración 1793059200000 · línea 17 |
| scheduled_precision | varchar(8) | SÍ |  |  | Migración 1793059200000 · línea 17 |
| deadline_precision | varchar(8) | SÍ |  |  | Migración 1793059200000 · línea 17 |

Claves foráneas:

- (work_order_id) → work_order(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1793059200000 · línea 17.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

Sin declaración adicional identificada.

## maintenance_notice_counter

Registro de notice counter. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

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

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| year | integer | NO | PK |  | Migración 1793145600000 · línea 14 |
| last_value | bigint | NO |  |  | Migración 1793145600000 · línea 14 |

Claves foráneas:


Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

Sin declaración adicional identificada.

## maintenance_notice

Aviso operativo.

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

PK: id. Unicidad total: (number); (year, annual_number).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1793145600000 · línea 14 |
| version | integer | NO |  |  | Migración 1793145600000 · línea 14 |
| number | varchar(40) | NO |  |  | Migración 1793145600000 · línea 14 |
| year | integer | NO | FK | maintenance_notice_counter(year) | Migración 1793145600000 · línea 14 |
| annual_number | bigint | NO |  |  | Migración 1793145600000 · línea 14 |
| state | varchar(16) | NO |  |  | Migración 1793145600000 · línea 14 |
| title | varchar(200) | NO |  |  | Migración 1793145600000 · línea 14 |
| description | varchar(4000) | NO |  |  | Migración 1793145600000 · línea 14 |
| space_id | uuid | NO | FK | core_space_projection(core_space_id) | Migración 1793145600000 · línea 14 |
| space_snapshot | jsonb | NO |  |  | Migración 1793145600000 · línea 14 |
| asset_id | uuid | SÍ | FK | asset(id) | Migración 1793145600000 · línea 14 |
| asset_snapshot | jsonb | SÍ |  |  | Migración 1793145600000 · línea 14 |
| priority_id | uuid | SÍ | FK | technical_catalog_value(id) | Migración 1793145600000 · línea 14 |
| priority_snapshot | jsonb | SÍ |  |  | Migración 1793145600000 · línea 14 |
| created_by | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1793145600000 · línea 14 |
| created_by_snapshot | jsonb | NO |  |  | Migración 1793145600000 · línea 14 |
| created_at | timestamptz | NO |  |  | Migración 1793145600000 · línea 14 |
| updated_at | timestamptz | NO |  |  | Migración 1793145600000 · línea 14 |
| updated_by | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1793145600000 · línea 14 |

Claves foráneas:

- (year) → maintenance_notice_counter(year). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (space_id) → core_space_projection(core_space_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (asset_id) → asset(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (priority_id) → technical_catalog_value(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (created_by) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (updated_by) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.

Restricciones CHECK:

- `CONSTRAINT maintenance_notice_number_ck CHECK(number='AV-'||year::text||'-'||lpad(annual_number::text,GREATEST(4,length(annual_number::text)),'0'))` · Migración 1793145600000 · línea 14
- `CONSTRAINT maintenance_notice_moment_ck CHECK(updated_at>=created_at AND extract(year FROM created_at AT TIME ZONE 'America/Argentina/Buenos_Aires')::int=year)` · Migración 1793145600000 · línea 14
- `CONSTRAINT maintenance_notice_snapshots_ck CHECK(COALESCE( space_snapshot->'schema_version'='1'::jsonb AND space_snapshot->>'id'=space_id::text AND jsonb_typeof(space_snapshot->'path_ids')='array' AND jsonb_array_length(space_snapshot->'path_ids')>0 AND space_snapshot->'path_ids'->>-1=space_id::text AND created_by_snapshot->>'id'=created_by::text AND ((asset_id IS NULL AND asset_snapshot IS NULL) OR (asset_id IS NOT NULL AND asset_snapshot->'schema_version'='1'::jsonb AND asset_snapshot->>'id'=asset_id::text)) AND ((priority_id IS NULL AND priority_snapshot IS NULL) OR (priority_id IS NOT NULL AND priority_snapshot->'schema_version'='1'::jsonb AND priority_snapshot->>'id'=priority_id::text)),false))` · Migración 1793145600000 · línea 14
- `CONSTRAINT maintenance_notice_state_check CHECK(state IN ('pending','dismissed','converted'))` · Migración 1793232000000 · línea 13

Índices declarados:

- `CREATE INDEX maintenance_notice_created_idx ON esquema.maintenance_notice(created_at DESC,id DESC)` · Migración 1793145600000 · línea 14
- `CREATE INDEX maintenance_notice_space_path_idx ON esquema.maintenance_notice USING gin((space_snapshot->'path_ids'))` · Migración 1793145600000 · línea 14
- `CREATE INDEX maintenance_notice_asset_idx ON esquema.maintenance_notice(asset_id,created_at DESC,id DESC) WHERE asset_id IS NOT NULL` · Migración 1793145600000 · línea 14
- `CREATE INDEX maintenance_notice_author_idx ON esquema.maintenance_notice(created_by,created_at DESC,id DESC)` · Migración 1793145600000 · línea 14
- `CREATE INDEX maintenance_notice_state_idx ON esquema.maintenance_notice(state,created_at DESC,id DESC)` · Migración 1793145600000 · línea 14
- `CREATE INDEX maintenance_notice_priority_idx ON esquema.maintenance_notice(priority_id,created_at DESC,id DESC)` · Migración 1793145600000 · línea 14

## maintenance_notice_operation

Registro de notice operation. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (principal_core_user_id, idempotency_key).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1793145600000 · línea 14 |
| principal_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1793145600000 · línea 14 |
| operation | varchar(24) | NO |  |  | Migración 1793145600000 · línea 14 |
| idempotency_key | uuid | NO |  |  | Migración 1793145600000 · línea 14 |
| request_hash | char(64) | NO |  |  | Migración 1793145600000 · línea 14 |
| request_body | jsonb | NO |  |  | Migración 1793145600000 · línea 14 |
| notice_id | uuid | SÍ | FK | maintenance_notice(id) | Migración 1793145600000 · línea 14 |
| state | varchar(12) | NO |  |  | Migración 1793145600000 · línea 14 |
| response_status | integer | SÍ |  |  | Migración 1793145600000 · línea 14 |
| response_body | jsonb | SÍ |  |  | Migración 1793145600000 · línea 14 |
| response_etag | varchar(180) | SÍ |  |  | Migración 1793145600000 · línea 14 |
| created_at | timestamptz | NO |  |  | Migración 1793145600000 · línea 14 |
| completed_at | timestamptz | SÍ |  |  | Migración 1793145600000 · línea 14 |

Claves foráneas:

- (principal_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (notice_id) → maintenance_notice(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.

Restricciones CHECK:

- `CONSTRAINT maintenance_notice_operation_terminal_ck CHECK( (state='pending' AND completed_at IS NULL AND response_status IS NULL AND response_body IS NULL AND response_etag IS NULL) OR (state IN ('applied','not_applied') AND completed_at IS NOT NULL AND completed_at>=created_at AND response_status IS NOT NULL AND response_status BETWEEN 200 AND 599 AND response_body IS NOT NULL AND jsonb_typeof(response_body)='object' AND (state<>'applied' OR notice_id IS NOT NULL)))` · Migración 1793145600000 · línea 14

Índices declarados:

- `CREATE INDEX maintenance_notice_operation_target_idx ON esquema.maintenance_notice_operation(notice_id)` · Migración 1793145600000 · línea 14

## maintenance_notice_initial_file

Registro de notice initial file. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (upload_key); (completed_document_id); (notice_id, position); (discard_resolution_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1793145600000 · línea 14 |
| notice_id | uuid | NO | FK | maintenance_notice(id) | Migración 1793145600000 · línea 14 |
| position | smallint | NO |  |  | Migración 1793145600000 · línea 14 |
| upload_key | uuid | NO |  |  | Migración 1793145600000 · línea 14 |
| create_operation_id | uuid | NO | FK | maintenance_notice_operation(id) | Migración 1793145600000 · línea 14 |
| descriptor | jsonb | NO |  |  | Migración 1793145600000 · línea 14 |
| completed_document_id | uuid | SÍ | FK | maintenance_document(id) | Migración 1793145600000 · línea 14 |
| discarded_at | timestamptz | SÍ |  |  | Migración 1793232000000 · línea 13 |
| discarded_by | uuid | SÍ | FK | maintenance_member(core_user_id) | Migración 1793232000000 · línea 13 |
| discard_resolution_id | uuid | SÍ | FK | notice_evidence_resolution_operation(id) | Migración 1793232000000 · línea 13 |

Claves foráneas:

- (notice_id) → maintenance_notice(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (create_operation_id) → maintenance_notice_operation(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (completed_document_id) → maintenance_document(id). Cada hija: 0..1 padre; cada padre: 0..1 hijas. Migración 1793145600000 · línea 14.
- (discarded_by) → maintenance_member(core_user_id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.
- (discard_resolution_id) → notice_evidence_resolution_operation(id). Cada hija: 0..1 padre; cada padre: 0..1 hijas. Migración 1793232000000 · línea 13.

Restricciones CHECK:

- `CONSTRAINT maintenance_notice_initial_descriptor_ck CHECK(COALESCE(jsonb_typeof(descriptor)='object' AND jsonb_typeof(descriptor->'original_name')='string' AND length(descriptor->>'original_name') BETWEEN 1 AND 255 AND jsonb_typeof(descriptor->'size')='number' AND (descriptor->>'size')::numeric BETWEEN 1 AND 26214400 AND descriptor->>'sha256' ~ '^[0-9a-f]{64}$',false))` · Migración 1793145600000 · línea 14
- `CONSTRAINT maintenance_notice_initial_discard_ck CHECK( (discarded_at IS NULL AND discarded_by IS NULL AND discard_resolution_id IS NULL) OR (discarded_at IS NOT NULL AND discarded_by IS NOT NULL AND discard_resolution_id IS NOT NULL AND completed_document_id IS NULL))` · Migración 1793232000000 · línea 13

Índices declarados:

Sin declaración adicional identificada.

## maintenance_notice_activity

Registro de notice activity. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; 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 1793145600000 · línea 14 |
| notice_id | uuid | NO | FK | maintenance_notice(id) | Migración 1793145600000 · línea 14 |
| kind | varchar(24) | NO |  |  | Migración 1793145600000 · línea 14 |
| text | varchar(4000) | NO |  |  | Migración 1793145600000 · línea 14 |
| actor_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1793145600000 · línea 14 |
| actor_snapshot | jsonb | NO |  |  | Migración 1793145600000 · línea 14 |
| occurred_at | timestamptz | NO |  |  | Migración 1793145600000 · línea 14 |
| notice_version | integer | SÍ |  |  | Migración 1793145600000 · línea 14 |
| document_id | uuid | SÍ | FK | maintenance_document(id) | Migración 1793145600000 · línea 14 |
| work_order_id | uuid | SÍ | FK | work_order(id) | Migración 1793232000000 · línea 13 |

Claves foráneas:

- (notice_id) → maintenance_notice(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (actor_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (document_id) → maintenance_document(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793145600000 · línea 14.
- (work_order_id) → work_order(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.

Restricciones CHECK:

- `CONSTRAINT maintenance_notice_activity_kind_check CHECK(kind IN ('note','dismissed','reopened','evidence_retired','converted'))` · Migración 1793232000000 · línea 13
- `CONSTRAINT maintenance_notice_activity_kind_ck CHECK( (kind='note' AND notice_version IS NULL AND document_id IS NULL AND work_order_id IS NULL) OR (kind IN ('dismissed','reopened') AND length(text)<=1000 AND notice_version>=2 AND document_id IS NULL AND work_order_id IS NULL) OR (kind='evidence_retired' AND length(text)<=1000 AND notice_version>=2 AND document_id IS NOT NULL AND work_order_id IS NULL) OR (kind='converted' AND length(text)<=1000 AND notice_version>=2 AND document_id IS NULL AND work_order_id IS NOT NULL))` · Migración 1793232000000 · línea 13

Índices declarados:

- `CREATE INDEX maintenance_notice_activity_list_idx ON esquema.maintenance_notice_activity(notice_id,occurred_at,id)` · Migración 1793145600000 · línea 14
- `CREATE INDEX maintenance_notice_activity_document_idx ON esquema.maintenance_notice_activity(document_id) WHERE document_id IS NOT NULL` · Migración 1793145600000 · línea 14
- `CREATE UNIQUE INDEX maintenance_notice_activity_conversion_idx ON esquema.maintenance_notice_activity(notice_id) WHERE kind='converted'` · Migración 1793232000000 · línea 13

## work_order_notice_conversion

Operación de conversión de aviso en OT.

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

PK: work_order_id. Unicidad total: (emission_operation_id); (draft_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| work_order_id | uuid | NO | PK, FK | work_order(id) | Migración 1793232000000 · línea 13 |
| emission_operation_id | uuid | NO | FK | work_order_operation(id) | Migración 1793232000000 · línea 13 |
| requested_notice_ids | uuid[] | NO |  |  | Migración 1793232000000 · línea 13 |
| draft_id | uuid | SÍ | FK | work_order_draft(id) | Migración 1793232000000 · línea 13 |
| converted_by | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1793232000000 · línea 13 |
| converted_at | timestamptz | NO |  |  | Migración 1793232000000 · línea 13 |

Claves foráneas:

- (work_order_id) → work_order(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1793232000000 · línea 13.
- (emission_operation_id) → work_order_operation(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1793232000000 · línea 13.
- (draft_id) → work_order_draft(id). Cada hija: 0..1 padre; cada padre: 0..1 hijas. Migración 1793232000000 · línea 13.
- (converted_by) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

Sin declaración adicional identificada.

## work_order_notice_origin

Vínculo de aviso de origen con OT.

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

PK: notice_id. Unicidad total: (work_order_id, notice_id); (work_order_id, position).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| notice_id | uuid | NO | PK, FK | maintenance_notice(id) | Migración 1793232000000 · línea 13 |
| work_order_id | uuid | NO | FK | work_order_notice_conversion(work_order_id) | Migración 1793232000000 · línea 13 |
| position | smallint | NO |  |  | Migración 1793232000000 · línea 13 |
| notice_version | integer | NO |  |  | Migración 1793232000000 · línea 13 |
| content_token | char(64) | NO |  |  | Migración 1793232000000 · línea 13 |
| selected_revision_ids | uuid[] | NO |  |  | Migración 1793232000000 · línea 13 |
| snapshot | jsonb | NO |  |  | Migración 1793232000000 · línea 13 |

Claves foráneas:

- (notice_id) → maintenance_notice(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1793232000000 · línea 13.
- (work_order_id) → work_order_notice_conversion(work_order_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

Sin declaración adicional identificada.

## work_order_notice_evidence

Evidencia de aviso conservada en OT.

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

PK: work_order_id, revision_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| work_order_id | uuid | NO | PK, FK | work_order_notice_origin(work_order_id, notice_id) | Migración 1793232000000 · línea 13 |
| notice_id | uuid | NO | FK | work_order_notice_origin(work_order_id, notice_id) | Migración 1793232000000 · línea 13 |
| document_id | uuid | NO | FK | maintenance_document(id) | Migración 1793232000000 · línea 13 |
| revision_id | uuid | NO | PK, FK | maintenance_document_revision(id) | Migración 1793232000000 · línea 13 |

Claves foráneas:

- (document_id) → maintenance_document(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.
- (revision_id) → maintenance_document_revision(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.
- (work_order_id, notice_id) → work_order_notice_origin(work_order_id, notice_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

- `CREATE INDEX work_order_notice_evidence_origin_idx ON esquema.work_order_notice_evidence(notice_id,document_id)` · Migración 1793232000000 · línea 13

## notice_evidence_resolution_operation

Registro de notice evidence resolution operation. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (principal_core_user_id, idempotency_key).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1793232000000 · línea 13 |
| notice_id | uuid | NO | FK | maintenance_notice(id) | Migración 1793232000000 · línea 13 |
| principal_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1793232000000 · línea 13 |
| idempotency_key | uuid | NO |  |  | Migración 1793232000000 · línea 13 |
| decision | varchar(8) | NO |  |  | Migración 1793232000000 · línea 13 |
| initial_file_id | uuid | SÍ | FK | maintenance_notice_initial_file(id) | Migración 1793232000000 · línea 13 |
| document_operation_id | uuid | SÍ | FK | maintenance_document_operation(id) | Migración 1793232000000 · línea 13 |
| active_document_operation_id | uuid | SÍ | FK | maintenance_document_operation(id) | Migración 1793232000000 · línea 13 |
| request_hash | char(64) | NO |  |  | Migración 1793232000000 · línea 13 |
| request_body | jsonb | NO |  |  | Migración 1793232000000 · línea 13 |
| state | varchar(12) | NO |  |  | Migración 1793232000000 · línea 13 |
| response_status | integer | SÍ |  |  | Migración 1793232000000 · línea 13 |
| response_body | jsonb | SÍ |  |  | Migración 1793232000000 · línea 13 |
| created_at | timestamptz | NO |  |  | Migración 1793232000000 · línea 13 |
| completed_at | timestamptz | SÍ |  |  | Migración 1793232000000 · línea 13 |

Claves foráneas:

- (notice_id) → maintenance_notice(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.
- (principal_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.
- (initial_file_id) → maintenance_notice_initial_file(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.
- (document_operation_id) → maintenance_document_operation(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.
- (active_document_operation_id) → maintenance_document_operation(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1793232000000 · línea 13.

Restricciones CHECK:

- `CONSTRAINT notice_resolution_subject_ck CHECK((initial_file_id IS NULL)<>(document_operation_id IS NULL))` · Migración 1793232000000 · línea 13
- `CONSTRAINT notice_resolution_terminal_ck CHECK( (state='pending' AND response_status IS NULL AND response_body IS NULL AND completed_at IS NULL) OR (state IN ('applied','not_applied') AND response_status IS NOT NULL AND response_status BETWEEN 200 AND 599 AND response_body IS NOT NULL AND jsonb_typeof(response_body)='object' AND completed_at IS NOT NULL AND completed_at>=created_at))` · Migración 1793232000000 · línea 13

Índices declarados:

- `CREATE INDEX notice_evidence_resolution_target_idx ON esquema.notice_evidence_resolution_operation(notice_id,state,id)` · Migración 1793232000000 · línea 13

## work_order_mutation_operation

Registro de work order mutation operation. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (principal_core_user_id, idempotency_key).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1793577600000 · línea 5 |
| principal_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1793577600000 · línea 5 |
| work_order_id | uuid | NO | FK | work_order(id) | Migración 1793577600000 · línea 5 |
| action | varchar(16) | NO |  |  | Migración 1793577600000 · línea 5 |
| idempotency_key | uuid | NO |  |  | Migración 1793577600000 · línea 5 |
| request_hash | char(64) | NO |  |  | Migración 1793577600000 · línea 5 |
| request_body | jsonb | NO |  |  | Migración 1793577600000 · línea 5 |
| expected_version | integer | NO |  |  | Migración 1793577600000 · línea 5 |
| transaction_id | xid8 | NO |  |  | Migración 1793577600000 · línea 5 |
| state | varchar(12) | NO |  |  | Migración 1793577600000 · línea 5 |
| result_version | integer | SÍ |  |  | Migración 1793577600000 · línea 5 |
| response_status | integer | SÍ |  |  | Migración 1793577600000 · línea 5 |
| response_body | jsonb | SÍ |  |  | Migración 1793577600000 · línea 5 |
| response_etag | text | SÍ |  |  | Migración 1793577600000 · línea 5 |
| created_at | timestamptz | NO |  |  | Migración 1793577600000 · línea 5 |
| completed_at | timestamptz | SÍ |  |  | Migración 1793577600000 · línea 5 |
| component_permission_required | boolean | NO |  |  | Migración 1794787200000 · línea 27 |
| execution_permission_required | boolean | NO |  |  | Migración 1794873600000 · línea 35 |

Claves foráneas:

- (principal_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793577600000 · línea 5.
- (work_order_id) → work_order(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793577600000 · línea 5.

Restricciones CHECK:

- `CONSTRAINT work_order_mutation_terminal_ck CHECK( (state='pending' AND num_nonnulls(result_version,response_status,response_body,response_etag,completed_at)=0) OR (state='applied' AND result_version IS NOT NULL AND result_version::bigint=expected_version::bigint+1 AND response_status IS NOT NULL AND response_status=200 AND response_body IS NOT NULL AND jsonb_typeof(response_body)='object' AND response_etag IS NOT NULL AND completed_at IS NOT NULL AND completed_at>=created_at) OR (state='not_applied' AND result_version IS NULL AND response_status IS NOT NULL AND response_status BETWEEN 400 AND 599 AND response_body IS NOT NULL AND jsonb_typeof(response_body)='object' AND response_etag IS NULL AND completed_at IS NOT NULL AND completed_at>=created_at))` · Migración 1793577600000 · línea 5
- `CONSTRAINT work_order_mutation_operation_action_check CHECK(action IN ('update','planning','postpone','cancel','assign','execute','correct','void','submit_review','close','reopen'))` · Migración 1794873600000 · línea 35

Índices declarados:

- `CREATE UNIQUE INDEX work_order_mutation_version_key ON esquema.work_order_mutation_operation(work_order_id,result_version) WHERE state='applied'` · Migración 1793577600000 · línea 5
- `CREATE INDEX work_order_mutation_order_idx ON esquema.work_order_mutation_operation(work_order_id,created_at,id)` · Migración 1793577600000 · línea 5

## work_order_change

Registro de work order change. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (operation_id, entity_type, entity_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1793577600000 · línea 5 |
| operation_id | uuid | NO | FK | work_order_mutation_operation(id) | Migración 1793577600000 · línea 5 |
| work_order_id | uuid | NO | FK | work_order(id) | Migración 1793577600000 · línea 5 |
| version | integer | NO |  |  | Migración 1793577600000 · línea 5 |
| entity_type | varchar(40) | NO |  |  | Migración 1793577600000 · línea 5 |
| entity_id | uuid | NO |  |  | Migración 1793577600000 · línea 5 |
| before_value | jsonb | SÍ |  |  | Migración 1793577600000 · línea 5 |
| after_value | jsonb | NO |  |  | Migración 1793577600000 · línea 5 |
| occurred_at | timestamptz | NO |  |  | Migración 1793577600000 · línea 5 |

Claves foráneas:

- (operation_id) → work_order_mutation_operation(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793577600000 · línea 5.
- (work_order_id) → work_order(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793577600000 · línea 5.

Restricciones CHECK:

- `CONSTRAINT work_order_change_entity_type_check CHECK(entity_type IN ('work_order','work_order_asset_scope','work_order_task','work_order_task_measurement','work_order_planning_precision','work_order_assignment','work_order_intervention'))` · Migración 1794441600000 · línea 33

Índices declarados:

- `CREATE INDEX work_order_change_order_idx ON esquema.work_order_change(work_order_id,version,entity_type,entity_id)` · Migración 1793577600000 · línea 5

## work_order_activity

Registro de work order activity. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (operation_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1793577600000 · línea 5 |
| operation_id | uuid | NO | FK | work_order_mutation_operation(id) | Migración 1793577600000 · línea 5 |
| work_order_id | uuid | NO | FK | work_order(id) | Migración 1793577600000 · línea 5 |
| version | integer | NO |  |  | Migración 1793577600000 · línea 5 |
| action | varchar(12) | NO |  |  | Migración 1793577600000 · línea 5 |
| actor_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1793577600000 · línea 5 |
| actor_name | varchar(200) | SÍ |  |  | Migración 1793577600000 · línea 5 |
| occurred_at | timestamptz | NO |  |  | Migración 1793577600000 · línea 5 |
| scheduled_for | timestamptz | SÍ |  |  | Migración 1793577600000 · línea 5 |
| scheduled_precision | varchar(8) | SÍ |  |  | Migración 1793577600000 · línea 5 |
| note | varchar(1000) | SÍ |  |  | Migración 1793577600000 · línea 5 |

Claves foráneas:

- (operation_id) → work_order_mutation_operation(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1793577600000 · línea 5.
- (work_order_id) → work_order(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793577600000 · línea 5.
- (actor_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1793577600000 · línea 5.

Restricciones CHECK:

- `CONSTRAINT work_order_activity_content_ck CHECK( (action='postpone' AND ((scheduled_for IS NULL)=(scheduled_precision IS NULL))) OR (action='cancel' AND scheduled_for IS NULL AND scheduled_precision IS NULL AND NULLIF(btrim(note),'') IS NOT NULL))` · Migración 1793577600000 · línea 5

Índices declarados:

- `CREATE INDEX work_order_activity_order_idx ON esquema.work_order_activity(work_order_id,occurred_at DESC,id DESC)` · Migración 1793577600000 · línea 5

## work_order_print_request

Solicitud controlada de impresión.

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

PK: id. Unicidad total: (principal_core_user_id, idempotency_key); (request_order).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1794355200000 · línea 30 |
| request_order | bigint | NO |  |  | Migración 1794355200000 · línea 30 |
| principal_core_user_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1794355200000 · línea 30 |
| idempotency_key | uuid | NO |  |  | Migración 1794355200000 · línea 30 |
| request_hash | varchar(64) | NO |  |  | Migración 1794355200000 · línea 30 |
| work_order_id | uuid | NO | FK | work_order(id) | Migración 1794355200000 · línea 30 |
| expected_version | integer | NO |  |  | Migración 1794355200000 · línea 30 |
| preparation_id | uuid | NO |  |  | Migración 1794355200000 · línea 30 |
| prepared_at | timestamptz | SÍ |  |  | Migración 1794355200000 · línea 30 |
| document_sha256 | varchar(64) | SÍ |  |  | Migración 1794355200000 · línea 30 |
| pdf_sha256 | varchar(64) | SÍ |  |  | Migración 1794355200000 · línea 30 |
| state | varchar(12) | NO |  |  | Migración 1794355200000 · línea 30 |
| requested_at | timestamptz | SÍ |  |  | Migración 1794355200000 · línea 30 |
| response_status | integer | NO |  |  | Migración 1794355200000 · línea 30 |
| response_body | jsonb | NO |  |  | Migración 1794355200000 · línea 30 |
| completed_at | timestamptz | NO |  |  | Migración 1794355200000 · línea 30 |

Claves foráneas:

- (principal_core_user_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794355200000 · línea 30.
- (work_order_id) → work_order(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794355200000 · línea 30.

Restricciones CHECK:

- `CONSTRAINT work_order_print_request_hash_ck CHECK(request_hash ~ '^[0-9a-f]{64}$')` · Migración 1794355200000 · línea 30
- `CONSTRAINT work_order_print_request_version_ck CHECK(expected_version>0)` · Migración 1794355200000 · línea 30
- `CONSTRAINT work_order_print_request_terminal_ck CHECK( (state='applied' AND response_status=200 AND requested_at IS NOT NULL AND prepared_at IS NOT NULL AND document_sha256 IS NOT NULL AND document_sha256 ~ '^[0-9a-f]{64}$' AND pdf_sha256 IS NOT NULL AND pdf_sha256 ~ '^[0-9a-f]{64}$') OR (state='not_applied' AND response_status BETWEEN 400 AND 599 AND requested_at IS NULL))` · Migración 1794355200000 · línea 30
- `CONSTRAINT work_order_print_request_response_ck CHECK(( jsonb_typeof(response_body)='object' AND octet_length(response_body::text)<=16384 AND response_body->>'state' IS NOT DISTINCT FROM state AND response_body->>'key' IS NOT DISTINCT FROM idempotency_key::text AND response_body->>'request_hash' IS NOT DISTINCT FROM request_hash AND CASE WHEN state='applied' THEN jsonb_typeof(response_body->'result')='object' AND response_body#>>'{result,id}'=work_order_id::text AND response_body#>>'{result,version}'=expected_version::text AND response_body#>>'{result,preparation_id}'=preparation_id::text AND (response_body#>>'{result,requested_at}')::timestamptz=requested_at AND length(response_body#>>'{result,number}')>0 ELSE jsonb_typeof(response_body->'error')='object' AND response_body#>>'{error,status}'=response_status::text AND length(response_body#>>'{error,code}')>0 AND length(response_body#>>'{error,message}')>0 END) IS TRUE)` · Migración 1794355200000 · línea 30

Índices declarados:

- `CREATE INDEX work_order_print_request_latest_idx ON esquema.work_order_print_request(work_order_id,request_order DESC) WHERE state='applied'` · Migración 1794355200000 · línea 30

## work_order_intervention

Intervención de trabajo.

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

PK: id. Unicidad total: (original_save_order); (work_order_id, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK, FK | work_order_intervention_revision(intervention_id, id) | Migración 1794441600000 · línea 33 |
| work_order_id | uuid | NO | FK | work_order(id) | Migración 1794441600000 · línea 33 |
| original_save_order | bigint | NO |  |  | Migración 1794441600000 · línea 33 |
| version | integer | NO |  |  | Migración 1794441600000 · línea 33 |
| current_revision_id | uuid | NO | FK | work_order_intervention_revision(intervention_id, id) | Migración 1794441600000 · línea 33 |
| created_at | timestamptz | NO |  |  | Migración 1794441600000 · línea 33 |
| created_by | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1794441600000 · línea 33 |
| creator_name | varchar(200) | SÍ |  |  | Migración 1794441600000 · línea 33 |
| creator_email | varchar(320) | SÍ |  |  | Migración 1794441600000 · línea 33 |
| updated_at | timestamptz | NO |  |  | Migración 1794441600000 · línea 33 |

Claves foráneas:

- (work_order_id) → work_order(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.
- (created_by) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.
- (id, current_revision_id) → work_order_intervention_revision(intervention_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

- `CREATE INDEX work_order_intervention_order_idx ON esquema.work_order_intervention(work_order_id,original_save_order DESC,id)` · Migración 1794441600000 · línea 33

## work_order_intervention_revision

Revisión de intervención.

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

PK: id. Unicidad total: (operation_id); (intervention_id, revision_number); (intervention_id, id); (work_order_id, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK, FK | work_order_intervention_performer(revision_id, id) | Migración 1794441600000 · línea 33 |
| work_order_id | uuid | NO | FK | work_order_intervention(work_order_id, id) | Migración 1794441600000 · línea 33 |
| intervention_id | uuid | NO | FK | work_order_intervention(work_order_id, id) | Migración 1794441600000 · línea 33 |
| revision_number | integer | NO |  |  | Migración 1794441600000 · línea 33 |
| operation_id | uuid | NO | FK | work_order_mutation_operation(id) | Migración 1794441600000 · línea 33 |
| status | varchar(8) | NO |  |  | Migración 1794441600000 · línea 33 |
| performed_on | date | NO |  |  | Migración 1794441600000 · línea 33 |
| general_result | varchar(4000) | NO |  |  | Migración 1794441600000 · línea 33 |
| effective_minutes | integer | SÍ |  |  | Migración 1794441600000 · línea 33 |
| executor_notes | varchar(4000) | SÍ |  |  | Migración 1794441600000 · línea 33 |
| operator_notes | varchar(4000) | SÍ |  |  | Migración 1794441600000 · línea 33 |
| responsible_performer_id | uuid | SÍ | FK | work_order_intervention_performer(revision_id, id) | Migración 1794441600000 · línea 33 |
| reason | varchar(1000) | SÍ |  |  | Migración 1794441600000 · línea 33 |
| recorded_at | timestamptz | NO |  |  | Migración 1794441600000 · línea 33 |
| recorded_by | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1794441600000 · línea 33 |
| actor_name | varchar(200) | SÍ |  |  | Migración 1794441600000 · línea 33 |
| actor_email | varchar(320) | SÍ |  |  | Migración 1794441600000 · línea 33 |

Claves foráneas:

- (operation_id) → work_order_mutation_operation(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1794441600000 · línea 33.
- (recorded_by) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.
- (work_order_id, intervention_id) → work_order_intervention(work_order_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.
- (id, responsible_performer_id) → work_order_intervention_performer(revision_id, id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.

Restricciones CHECK:

- `CHECK((revision_number=1 AND status='valid' AND reason IS NULL) OR (revision_number>1 AND NULLIF(btrim(reason),'') IS NOT NULL))` · Migración 1794441600000 · línea 33

Índices declarados:

- `CREATE INDEX work_order_intervention_revision_date_idx ON esquema.work_order_intervention_revision(work_order_id,performed_on DESC,intervention_id,revision_number DESC)` · Migración 1794441600000 · línea 33

## work_order_intervention_performer

Registro de work order intervention performer. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (revision_id, kind, subject_id); (revision_id, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1794441600000 · línea 33 |
| work_order_id | uuid | NO | FK | work_order_intervention_revision(work_order_id, id); work_order_assignment(work_order_id, id) | Migración 1794441600000 · línea 33 |
| revision_id | uuid | NO | FK | work_order_intervention_revision(work_order_id, id) | Migración 1794441600000 · línea 33 |
| kind | varchar(8) | NO |  |  | Migración 1794441600000 · línea 33 |
| staff_id | uuid | SÍ | FK | internal_staff(id) | Migración 1794441600000 · línea 33 |
| provider_id | uuid | SÍ | FK | provider(id) | Migración 1794441600000 · línea 33 |
| subject_id | uuid | SÍ |  |  | Migración 1794441600000 · línea 33 |
| assignment_id | uuid | NO | FK | work_order_assignment(work_order_id, id) | Migración 1794441600000 · línea 33 |
| subject_snapshot | jsonb | NO |  |  | Migración 1794441600000 · línea 33 |
| external_first_name | varchar(100) | SÍ |  |  | Migración 1794441600000 · línea 33 |
| external_last_name | varchar(100) | SÍ |  |  | Migración 1794441600000 · línea 33 |

Claves foráneas:

- (staff_id) → internal_staff(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.
- (provider_id) → provider(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.
- (work_order_id, revision_id) → work_order_intervention_revision(work_order_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.
- (work_order_id, assignment_id) → work_order_assignment(work_order_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.

Restricciones CHECK:

- `CHECK((kind='staff' AND staff_id IS NOT NULL AND provider_id IS NULL AND external_first_name IS NULL AND external_last_name IS NULL) OR (kind='provider' AND staff_id IS NULL AND provider_id IS NOT NULL AND NULLIF(btrim(external_first_name),'') IS NOT NULL AND NULLIF(btrim(external_last_name),'') IS NOT NULL))` · Migración 1794441600000 · línea 33
- `CHECK(esquema.maintenance_work_order_snapshot_valid('assignment',subject_snapshot) AND subject_snapshot->>'id'=COALESCE(staff_id,provider_id)::text)` · Migración 1794441600000 · línea 33

Índices declarados:

- `CREATE INDEX work_order_intervention_performer_subject_idx ON esquema.work_order_intervention_performer(kind,subject_id,work_order_id,revision_id)` · Migración 1794441600000 · línea 33

## work_order_intervention_task_result

Registro de work order intervention task result. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (revision_id, task_id); (work_order_id, task_id, id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1794441600000 · línea 33 |
| work_order_id | uuid | NO | FK | work_order_intervention_revision(work_order_id, id); work_order_task(work_order_id, id) | Migración 1794441600000 · línea 33 |
| revision_id | uuid | NO | FK | work_order_intervention_revision(work_order_id, id) | Migración 1794441600000 · línea 33 |
| task_id | uuid | NO | FK | work_order_task(work_order_id, id) | Migración 1794441600000 · línea 33 |
| answer | varchar(8) | SÍ |  |  | Migración 1794441600000 · línea 33 |
| note | varchar(4000) | SÍ |  |  | Migración 1794441600000 · línea 33 |
| definition_snapshot | jsonb | NO |  |  | Migración 1794441600000 · línea 33 |
| definition_hash | char(64) | NO |  |  | Migración 1794441600000 · línea 33 |

Claves foráneas:

- (work_order_id, revision_id) → work_order_intervention_revision(work_order_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.
- (work_order_id, task_id) → work_order_task(work_order_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.

Restricciones CHECK:

- `CHECK(answer IS DISTINCT FROM 'not_done' OR NULLIF(btrim(note),'') IS NOT NULL)` · Migración 1794441600000 · línea 33

Índices declarados:

- `CREATE INDEX work_order_intervention_task_history_idx ON esquema.work_order_intervention_task_result(task_id,revision_id,id)` · Migración 1794441600000 · línea 33
- `CREATE INDEX work_order_intervention_task_target_idx ON esquema.work_order_intervention_task_result( ((definition_snapshot->>'asset_id')::uuid),((definition_snapshot->>'component_id')::uuid),revision_id)` · Migración 1794441600000 · línea 33

## work_order_intervention_reading

Registro de work order intervention reading. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: task_result_id, measurement_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| work_order_id | uuid | NO | FK | work_order_intervention_task_result(work_order_id, task_id, id); work_order_task_measurement(work_order_id, task_id, id) | Migración 1794441600000 · línea 33 |
| task_id | uuid | NO | FK | work_order_intervention_task_result(work_order_id, task_id, id); work_order_task_measurement(work_order_id, task_id, id) | Migración 1794441600000 · línea 33 |
| task_result_id | uuid | NO | PK, FK | work_order_intervention_task_result(work_order_id, task_id, id) | Migración 1794441600000 · línea 33 |
| measurement_id | uuid | NO | PK, FK | work_order_task_measurement(work_order_id, task_id, id) | Migración 1794441600000 · línea 33 |
| value | numeric | NO |  |  | Migración 1794441600000 · línea 33 |

Claves foráneas:

- (work_order_id, task_id, task_result_id) → work_order_intervention_task_result(work_order_id, task_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.
- (work_order_id, task_id, measurement_id) → work_order_task_measurement(work_order_id, task_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794441600000 · línea 33.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

- `CREATE INDEX work_order_intervention_reading_source_idx ON esquema.work_order_intervention_reading(measurement_id,task_result_id)` · Migración 1794441600000 · línea 33

## work_order_component_fact

Hecho registrado sobre componente.

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

PK: id. Unicidad total: (intervention_id, component_id); (work_order_id, id); (id, intervention_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK, FK | work_order_component_fact_revision(fact_id, id) | Migración 1794787200000 · línea 27 |
| work_order_id | uuid | NO | FK | work_order_intervention(work_order_id, id); work_order_asset_scope(work_order_id, asset_id) | Migración 1794787200000 · línea 27 |
| intervention_id | uuid | NO | FK | work_order_intervention(work_order_id, id) | Migración 1794787200000 · línea 27 |
| asset_id | uuid | NO | FK | work_order_asset_scope(work_order_id, asset_id); asset_component(asset_id, id) | Migración 1794787200000 · línea 27 |
| component_id | uuid | NO | FK | asset_component(asset_id, id) | Migración 1794787200000 · línea 27 |
| version | integer | NO |  |  | Migración 1794787200000 · línea 27 |
| current_revision_id | uuid | NO | FK | work_order_component_fact_revision(fact_id, id) | Migración 1794787200000 · línea 27 |
| created_at | timestamptz | NO |  |  | Migración 1794787200000 · línea 27 |
| created_by | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1794787200000 · línea 27 |

Claves foráneas:

- (created_by) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.
- (work_order_id, intervention_id) → work_order_intervention(work_order_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.
- (work_order_id, asset_id) → work_order_asset_scope(work_order_id, asset_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.
- (asset_id, component_id) → asset_component(asset_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.
- (id, current_revision_id) → work_order_component_fact_revision(fact_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

- `CREATE INDEX work_order_component_fact_component_idx ON esquema.work_order_component_fact(component_id,created_at DESC,id)` · Migración 1794787200000 · línea 27

## work_order_component_fact_revision

Registro de work order component fact revision. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: id. Unicidad total: (fact_id, revision_number); (fact_id, id); (operation_id, fact_id).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1794787200000 · línea 27 |
| fact_id | uuid | NO | FK | work_order_component_fact(work_order_id, id) | Migración 1794787200000 · línea 27 |
| work_order_id | uuid | NO | FK | work_order_component_fact(work_order_id, id); work_order_intervention_revision(work_order_id, id) | Migración 1794787200000 · línea 27 |
| intervention_revision_id | uuid | NO | FK | work_order_intervention_revision(work_order_id, id) | Migración 1794787200000 · línea 27 |
| operation_id | uuid | NO | FK | work_order_mutation_operation(id) | Migración 1794787200000 · línea 27 |
| revision_number | integer | NO |  |  | Migración 1794787200000 · línea 27 |
| status | varchar(8) | NO |  |  | Migración 1794787200000 · línea 27 |
| performed_on | date | NO |  |  | Migración 1794787200000 · línea 27 |
| mode | varchar(20) | NO |  |  | Migración 1794787200000 · línea 27 |
| component_context | jsonb | NO |  |  | Migración 1794787200000 · línea 27 |
| installed_quantity | integer | NO |  |  | Migración 1794787200000 · línea 27 |
| found_state_id | uuid | NO | FK | technical_catalog_value(id) | Migración 1794787200000 · línea 27 |
| result_state_id | uuid | NO | FK | technical_catalog_value(id) | Migración 1794787200000 · línea 27 |
| found_state | jsonb | NO |  |  | Migración 1794787200000 · línea 27 |
| result_state | jsonb | NO |  |  | Migración 1794787200000 · línea 27 |
| resolution | varchar(16) | SÍ |  |  | Migración 1794787200000 · línea 27 |
| replaced | boolean | NO |  |  | Migración 1794787200000 · línea 27 |
| work_performed | boolean | NO |  |  | Migración 1794787200000 · línea 27 |
| has_pending | boolean | NO |  |  | Migración 1794787200000 · línea 27 |
| description | varchar(4000) | SÍ |  |  | Migración 1794787200000 · línea 27 |
| affected_quantity | integer | NO |  |  | Migración 1794787200000 · línea 27 |
| replaced_quantity | integer | NO |  |  | Migración 1794787200000 · línea 27 |
| effect_kind | varchar(16) | NO |  |  | Migración 1794787200000 · línea 27 |
| effect_history_id | uuid | SÍ | FK | asset_component_history(id) | Migración 1794787200000 · línea 27 |
| reason | varchar(1000) | SÍ |  |  | Migración 1794787200000 · línea 27 |
| recorded_at | timestamptz | NO |  |  | Migración 1794787200000 · línea 27 |
| recorded_by | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1794787200000 · línea 27 |
| actor_name | varchar(200) | SÍ |  |  | Migración 1794787200000 · línea 27 |
| actor_email | varchar(320) | SÍ |  |  | Migración 1794787200000 · línea 27 |

Claves foráneas:

- (operation_id) → work_order_mutation_operation(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.
- (found_state_id) → technical_catalog_value(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.
- (result_state_id) → technical_catalog_value(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.
- (effect_history_id) → asset_component_history(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.
- (recorded_by) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.
- (work_order_id, fact_id) → work_order_component_fact(work_order_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.
- (work_order_id, intervention_revision_id) → work_order_intervention_revision(work_order_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.

Restricciones CHECK:

- `CHECK(found_state->>'id'=found_state_id::text AND result_state->>'id'=result_state_id::text AND jsonb_typeof(found_state->'is_non_operational')='boolean' AND jsonb_typeof(result_state->'is_non_operational')='boolean')` · Migración 1794787200000 · línea 27
- `CHECK((mode='reviewed_unchanged' AND found_state_id=result_state_id AND resolution IS NULL AND NOT replaced AND NOT work_performed AND affected_quantity=installed_quantity AND replaced_quantity=0 AND effect_kind IN ('unchanged','history_only','preserved','rectified')) OR (mode='intervention' AND resolution IS NOT NULL))` · Migración 1794787200000 · línea 27
- `CHECK((replaced AND replaced_quantity>=1) OR (NOT replaced AND replaced_quantity=0))` · Migración 1794787200000 · línea 27
- `CHECK(NOT (work_performed OR replaced OR resolution='no' OR (result_state->>'is_non_operational')::boolean OR has_pending) OR NULLIF(btrim(description),'') IS NOT NULL)` · Migración 1794787200000 · línea 27
- `CHECK((effect_kind IN ('updated','rectified'))=(effect_history_id IS NOT NULL))` · Migración 1794787200000 · línea 27
- `CHECK((revision_number=1 AND status='valid' AND reason IS NULL) OR (revision_number>1 AND NULLIF(btrim(reason),'') IS NOT NULL))` · Migración 1794787200000 · línea 27

Índices declarados:

- `CREATE INDEX component_fact_revision_date_idx ON esquema.work_order_component_fact_revision(performed_on DESC,fact_id,revision_number DESC)` · Migración 1794787200000 · línea 27
- `CREATE INDEX component_fact_revision_operation_idx ON esquema.work_order_component_fact_revision(operation_id,id)` · Migración 1794787200000 · línea 27

## work_order_component_fact_task_origin

Registro de work order component fact task origin. Finalidad inferida a partir del nombre, los campos y las relaciones declaradas..

Finalidad inferida; estructura verificada en código y migraciones. Esquema configurable del módulo.

PK: fact_revision_id, task_id. Unicidad total: sin declaración identificada.

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| fact_revision_id | uuid | NO | PK, FK | work_order_component_fact_revision(fact_id, id) | Migración 1794787200000 · línea 27 |
| fact_id | uuid | NO | FK | work_order_component_fact_revision(fact_id, id) | Migración 1794787200000 · línea 27 |
| work_order_id | uuid | NO | FK | work_order_task(work_order_id, id) | Migración 1794787200000 · línea 27 |
| task_id | uuid | NO | PK, FK | work_order_task(work_order_id, id) | Migración 1794787200000 · línea 27 |
| definition_snapshot | jsonb | NO |  |  | Migración 1794787200000 · línea 27 |
| definition_hash | char(64) | NO |  |  | Migración 1794787200000 · línea 27 |

Claves foráneas:

- (fact_id, fact_revision_id) → work_order_component_fact_revision(fact_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.
- (work_order_id, task_id) → work_order_task(work_order_id, id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794787200000 · línea 27.

Restricciones CHECK:

Sin declaración adicional identificada.

Índices declarados:

- `CREATE INDEX component_fact_task_origin_task_idx ON esquema.work_order_component_fact_task_origin(task_id,fact_id)` · Migración 1794787200000 · línea 27

## work_order_decision

Decisión sobre el ciclo de una OT.

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

PK: id. Unicidad total: (operation_id); (work_order_id, version).

| Campo | Tipo | NULL | Clave | Referencia física | Fuente técnica |
|---|---|---|---|---|---|
| id | uuid | NO | PK |  | Migración 1794873600000 · línea 35 |
| operation_id | uuid | NO | FK | work_order_mutation_operation(id) | Migración 1794873600000 · línea 35 |
| work_order_id | uuid | NO | FK | work_order(id) | Migración 1794873600000 · línea 35 |
| version | integer | NO |  |  | Migración 1794873600000 · línea 35 |
| action | varchar(16) | NO |  |  | Migración 1794873600000 · línea 35 |
| source_state | varchar(20) | NO |  |  | Migración 1794873600000 · línea 35 |
| target_state | varchar(20) | NO |  |  | Migración 1794873600000 · línea 35 |
| actor_id | uuid | NO | FK | maintenance_member(core_user_id) | Migración 1794873600000 · línea 35 |
| actor_name | varchar(200) | SÍ |  |  | Migración 1794873600000 · línea 35 |
| occurred_at | timestamptz | NO |  |  | Migración 1794873600000 · línea 35 |
| note | varchar(1000) | SÍ |  |  | Migración 1794873600000 · línea 35 |
| preceding_decision_id | uuid | SÍ | FK | work_order_decision(id) | Migración 1794873600000 · línea 35 |
| historical_closed_origin | boolean | NO |  |  | Migración 1794873600000 · línea 35 |
| accepted_manifest | jsonb | NO |  |  | Migración 1794873600000 · línea 35 |
| accepted_exceptions | jsonb | NO |  |  | Migración 1794873600000 · línea 35 |

Claves foráneas:

- (operation_id) → work_order_mutation_operation(id). Cada hija: 1 padre; cada padre: 0..1 hijas. Migración 1794873600000 · línea 35.
- (work_order_id) → work_order(id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794873600000 · línea 35.
- (actor_id) → maintenance_member(core_user_id). Cada hija: 1 padre; cada padre: 0..N hijas. Migración 1794873600000 · línea 35.
- (preceding_decision_id) → work_order_decision(id). Cada hija: 0..1 padre; cada padre: 0..N hijas. Migración 1794873600000 · línea 35.

Restricciones CHECK:

- `CHECK((action='submit_review' AND source_state IN ('open','assigned','in_progress','reopened') AND target_state='pending_review') OR (action='close' AND source_state IN ('open','assigned','in_progress','reopened','pending_review') AND target_state='closed') OR (action='reopen' AND source_state IN ('pending_review','closed') AND target_state='reopened' AND NULLIF(btrim(note),'') IS NOT NULL))` · Migración 1794873600000 · línea 35
- `CHECK(NOT historical_closed_origin OR (action='reopen' AND source_state='closed' AND preceding_decision_id IS NULL))` · Migración 1794873600000 · línea 35

Índices declarados:

- `CREATE INDEX work_order_decision_history_idx ON esquema.work_order_decision(work_order_id,version DESC,id)` · Migración 1794873600000 · línea 35

