Categorías de Centros de Costo Maestras

Modo Maestro

Categorías de Centros de Costo

Catálogo maestro de categorías que clasifica los centros de costo. Heredado por todos los tenants.

Total Categorías

Activas

Filtros:

Icono	Código	Nombre	Descripción	Estado
corporate_fare	CAT-ADM	Administrativa	Gestión institucional, secretaría y dirección del plantel	Activa
school	CAT-ACA	Académica	Procesos de enseñanza-aprendizaje y gestión curricular	Activa
volunteer_activism	CAT-BES	Bienestar Estudiantil	Apoyo psicosocial, orientación y acompañamiento al estudiante	Activa
construction	CAT-INF	Infraestructura	Mantenimiento y mejora de planta física y dotación	Activa
restaurant	CAT-COM	Servicios Complementarios	Restaurante escolar, tienda estudiantil y servicios PAE	Activa

-- ══════════════════════════════════════════════════════════════════ -- TABLA PRINCIPAL -- ══════════════════════════════════════════════════════════════════ CREATE TABLE master_cost_center_categories ( -- Identidad id UUID STORAGE PLAIN DEFAULT gen_random_uuid() NOT NULL, tenant_id UUID STORAGE PLAIN, -- NULL = Super Admin; valor = tenant propietario -- Datos del catálogo code VARCHAR(20) STORAGE PLAIN NOT NULL, -- Formato: ^CAT-[A-Z0-9]+$ | Inmutable post-creación name_short VARCHAR(100) NOT NULL, -- Nombre principal. 3–100 chars. Ej: "Administración" name_long VARCHAR(300), -- Descripción extendida. Opcional. Max 300 chars icon_id INTEGER STORAGE PLAIN NOT NULL, -- FK → icons.id (Material Symbols Outlined) -- Clasificación state_id VARCHAR(40) NOT NULL, -- FK → statuses.id | active / inactive / archived origen_id INTEGER STORAGE PLAIN NOT NULL, -- FK → origins.id | master / inherited / local -- Auditoría estándar created_at TIMESTAMP WITH TIME ZONE STORAGE PLAIN DEFAULT now() NOT NULL, updated_at TIMESTAMP WITH TIME ZONE STORAGE PLAIN DEFAULT now() NOT NULL, created_by UUID STORAGE PLAIN NOT NULL, -- FK → users.id updated_by UUID STORAGE PLAIN NOT NULL, -- FK → users.id archived_at TIMESTAMP WITH TIME ZONE STORAGE PLAIN, -- NULL = no archivado | soft delete archived_by UUID STORAGE PLAIN, -- NULL = no archivado | FK → users.id CONSTRAINT pk_mccc PRIMARY KEY (id), CONSTRAINT uq_mccc_code UNIQUE (code), -- code único globalmente en master CONSTRAINT fk_mccc_icon FOREIGN KEY (icon_id) REFERENCES icons(id), CONSTRAINT fk_mccc_state FOREIGN KEY (state_id) REFERENCES statuses(id), CONSTRAINT fk_mccc_origen FOREIGN KEY (origen_id) REFERENCES origins(id), CONSTRAINT fk_mccc_created_by FOREIGN KEY (created_by) REFERENCES users(id), CONSTRAINT fk_mccc_updated_by FOREIGN KEY (updated_by) REFERENCES users(id), CONSTRAINT fk_mccc_archived_by FOREIGN KEY (archived_by) REFERENCES users(id) ); -- Índices CREATE INDEX idx_mccc_code ON master_cost_center_categories (code); CREATE INDEX idx_mccc_state ON master_cost_center_categories (state_id) WHERE archived_at IS NULL; CREATE INDEX idx_mccc_tenant ON master_cost_center_categories (tenant_id) WHERE archived_at IS NULL; CREATE INDEX idx_mccc_origen ON master_cost_center_categories (origen_id); -- ══════════════════════════════════════════════════════════════════ -- INTEGRIDAD REFERENCIAL DESDE MÓDULOS DEPENDIENTES -- ══════════════════════════════════════════════════════════════════ -- Centros de costo maestros (bloquea eliminación de categoría en uso) ALTER TABLE master_cost_centers ADD CONSTRAINT fk_mcc_category FOREIGN KEY (category_id) REFERENCES master_cost_center_categories(id) ON DELETE RESTRICT; -- Centros de costo tenant (misma protección en esquema tenant) -- ALTER TABLE tenant_cost_centers -- ADD CONSTRAINT fk_tcc_category -- FOREIGN KEY (category_id) -- REFERENCES tenant_cost_center_categories(id) -- ON DELETE RESTRICT; -- ══════════════════════════════════════════════════════════════════ -- TABLA audit_logs (genérica — middleware GORM la gestiona) -- ══════════════════════════════════════════════════════════════════ CREATE TABLE audit_logs ( id UUID STORAGE PLAIN DEFAULT gen_random_uuid() NOT NULL, tenant_id UUID STORAGE PLAIN, entity_type VARCHAR(100) NOT NULL, -- Ej: 'master_cost_center_categories' entity_id UUID NOT NULL, action VARCHAR(10) NOT NULL, -- CREATE | UPDATE | ARCHIVE before JSONB, after JSONB NOT NULL, performed_by UUID NOT NULL, -- FK → users.id performed_at TIMESTAMP WITH TIME ZONE DEFAULT now() NOT NULL, ip_address VARCHAR(45), CONSTRAINT pk_audit PRIMARY KEY (id) ); CREATE INDEX idx_audit_entity ON audit_logs (entity_type, entity_id); CREATE INDEX idx_audit_tenant ON audit_logs (tenant_id); -- ══════════════════════════════════════════════════════════════════ -- REGLAS DE NEGOCIO -- ══════════════════════════════════════════════════════════════════ -- state_id → active | inactive | archived -- origen_id → master (SA) | inherited (tenant recibió del SA) | local (creado por tenant) -- tenant_id → NULL = registro Super Admin | UUID = tenant propietario -- code → inmutable post-creación (HTTP 422 IMMUTABLE_FIELD si se intenta cambiar) -- archived_at → soft delete obligatorio; nunca DELETE físico -- Herencia → origen_id = master/inherited → read-only para tenants (HTTP 403 INHERITED_READONLY) -- Unicidad → code único globalmente (master); único por tenant (local) -- Paginación → params: page, limit (default 50, max 200); response: data[], total, page, limit -- Timestamps → UTC en BD; frontend convierte a America/Bogota

Categorías de Centros de Costo

Nueva Categoría