Especificación Técnica: cat_ciudades¶
Esquema: core.identidad
Base de Datos: core
Servicio: svc-identidad
Tabla Legacy Origen: core_sigfa.cat_ciudades
Propósito: Catálogo global de ciudades, vinculadas a su provincia de pertenencia.
1. Justificación y Mejoras de Arquitectura¶
- Global: identifica ciudades sin contexto empresarial.
- FK a cat_provincias garantiza integridad referencial del territorio (jerarquía país → provincia → ciudad).
- Índice ix_cat_ciudades_provincia_id acelera búsquedas por provincia.
- Evolución del legacy core_sigfa.cat_ciudades en core.identidad.
2. Definiciones de Implementación¶
Table core.identidad.cat_ciudades {
id uuid [pk, default: `gen_random_uuid()`]
provincia_id uuid [not null, ref: > cat_provincias.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 {
provincia_id [name: 'ix_cat_ciudades_provincia_id']
}
}
CREATE TABLE IF NOT EXISTS core.identidad.cat_ciudades (
id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
provincia_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_ciudades_provincia FOREIGN KEY (provincia_id) REFERENCES core.identidad.cat_provincias (id)
);
CREATE INDEX IF NOT EXISTS ix_cat_ciudades_provincia_id ON core.identidad.cat_ciudades (provincia_id);
-- Comentarios
COMMENT ON COLUMN core.identidad.cat_ciudades.provincia_id IS 'Provincia a la que pertenece la ciudad';
COMMENT ON COLUMN core.identidad.cat_ciudades.nombre IS 'Nombre de la ciudad';