Especificación Técnica: cat_paises¶
Esquema: core.identidad
Base de Datos: core
Servicio: svc-identidad
Tabla Legacy Origen: core_sigfa.cat_paises
Propósito: Catálogo global de países de referencia para empresas y personas del dominio identidad.
1. Justificación y Mejoras de Arquitectura¶
- Catálogo global reutilizable por todo el núcleo: no depende de ninguna empresa.
- PK UUID generada con gen_random_uuid() para evitar colisiones entre bases.
- Unique sobre codigo (ISO 3166-1 alfa-3) garantiza referencias estables.
- Evolución directa del legacy core_sigfa.cat_paises, ahora en core.identidad y sin columna empresa_id.
2. Definiciones de Implementación¶
Table core.identidad.cat_paises {
id uuid [pk, default: `gen_random_uuid()`]
codigo varchar(3) [not null]
nombre varchar(100) [not null]
// Auditoría General
is_activo boolean [not null, default: `true`, note: 'Estado lógico del registro']
created_at timestamptz [not null, default: `now()`, note: 'Fecha de creación']
updated_at timestamptz [not null, default: `now()`, note: 'Fecha de última actualización']
deleted_at timestamptz [note: 'Fecha de eliminación lógica']
created_by uuid [note: 'Usuario creador']
updated_by uuid [note: 'Usuario modificador']
Indexes {
(codigo) [unique, name: 'uq_cat_paises_codigo']
}
}
CREATE TABLE IF NOT EXISTS core.identidad.cat_paises (
id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
codigo VARCHAR(3) NOT NULL,
nombre VARCHAR(100) NOT NULL,
-- Auditoría General
is_activo BOOLEAN NOT NULL DEFAULT true,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
deleted_at TIMESTAMPTZ,
created_by UUID,
updated_by UUID,
CONSTRAINT uq_cat_paises_codigo UNIQUE (codigo)
);
-- Comentarios
COMMENT ON COLUMN core.identidad.cat_paises.codigo IS 'Código ISO 3166-1 alfa-3';
COMMENT ON COLUMN core.identidad.cat_paises.nombre IS 'Nombre oficial del país';