Especificación Técnica: cat_provincias¶
Esquema: core.identidad
Base de Datos: core
Servicio: svc-identidad
Tabla Legacy Origen: core_sigfa.cat_provincias
Propósito: Catálogo de provincias, vinculadas al país al que pertenecen.
1. Justificación y Mejoras de Arquitectura¶
- Nivel intermedio de la jerarquía geográfica: país → provincia → ciudad.
- FK a
cat_paisesgarantiza integridad referencial del territorio. - Índice
ix_cat_provincias_pais_idacelera búsquedas por país. - Catálogo global: identifica provincias sin contexto empresarial.
2. Definiciones de Implementación¶
Table core.identidad.cat_provincias {
id uuid [pk, default: `gen_random_uuid()`]
pais_id uuid [not null, ref: > cat_paises.id]
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 {
pais_id [name: 'ix_cat_provincias_pais_id']
}
}
CREATE TABLE IF NOT EXISTS core.identidad.cat_provincias (
id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
pais_id UUID 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 fk_cat_provincias_pais FOREIGN KEY (pais_id) REFERENCES core.identidad.cat_paises (id)
);
CREATE INDEX IF NOT EXISTS ix_cat_provincias_pais_id ON core.identidad.cat_provincias (pais_id);
-- Comentarios
COMMENT ON COLUMN core.identidad.cat_provincias.pais_id IS 'País al que pertenece la provincia';
COMMENT ON COLUMN core.identidad.cat_provincias.nombre IS 'Nombre de la provincia';