Toscana Systems - Innovación que Transforma

7.1 Reglas de oro

R1 · Identidad — un paciente = un CUI-RENAP. Sin CUI: identificador transitorio que se fusiona al obtenerlo.

R2 · Episodio — toda atención clínica vive dentro de un episodio (CE, ER, Hosp). Sin episodio no se firma nada.

R3 · Inmutabilidad — nota firmada nunca se edita. Solo addendum con su propia firma.

R4 · Codificación — diagnósticos en CIE-10, procedimientos en CIE-9-CM, fármacos en ATC, exámenes de laboratorio en LOINC, conceptos clínicos en SNOMED CT.

R5 · Trazabilidad lote-paciente — toda dispensación o consumo quirúrgico anota lote + vencimiento + paciente.

R6 · Auditoría — toda modificación a entidad clínica genera evento + fila WORM con hash encadenado.

7.2 Entidades transaccionales (18)

#	Entidad	Servicio dueño	Campos clave
1	paciente	identidad-paciente	`id (ULID), cui (cifrado), hmac_cui, nombres, apellidos, fecha_nac, sexo, etnia_id, idioma_id, municipio_id, telefono, version`
2	identificador_alterno	identidad-paciente	`paciente_id, tipo (DPI/pasaporte/RN/IGSS), valor, vigente`
3	episodio	episodios	`id, paciente_id, tipo (CE/ER/HOS), servicio_id, apertura, cierre, motivo_alta, dx_egreso (CIE-10), estado`
4	nota_clinica	expediente-clínico	`id, episodio_id, autor_id, tipo (anam/evol/intercon/op), texto (Mongo), firmada_at, firma_hash`
5	addendum	expediente-clínico	`id, nota_id, autor_id, texto, firmada_at`
6	orden	órdenes-médicas	`id, episodio_id, tipo (LAB/IMG/PROC/DIETA/RX), prioridad, estado, items`
7	receta	farmacia	`id, episodio_id, item_id, atc, dosis, via, frecuencia, dias, lbm_codigo, alergia_check`
8	dispensacion	farmacia	`id, receta_id, lote_id, cantidad, fecha, dispensador_id`
9	muestra_lab	laboratorio	`id, orden_id, codigo_barras, recogida_at, recibida_at, estado`
10	resultado_lab	laboratorio	`id, muestra_id, loinc, valor, unidad, ref_min, ref_max, alerta, liberado_at, validador_id`
11	estudio_imagen	imagenologia	`id, episodio_id, modalidad (RX/US/TC/RM), fecha, informe_id, dicom_uid`
12	signo_vital	signos-vitales	`paciente_id, ts (Timescale), tipo (PA/FC/FR/T/SatO2), valor`
13	triaje	emergencia	`id, episodio_id, manchester, motivo, evaluador_id, asignacion_at`
14	asignacion_cama	encamamiento	`id, episodio_id, cama_id, desde, hasta, motivo`
15	cirugia	quirofano	`id, episodio_id, sala_id, programada_at, inicio, cierre, dx_pre, dx_post, procedimiento_cie9`
16	parto	obstetricia	`id, episodio_id, tipo (vag/ces), gesta, para, complicaciones, hora_inicio, hora_nac`
17	recien_nacido	obstetricia	`id, parto_id, cui_provisional, sexo, peso, talla, apgar1, apgar5, vacunas`
18	factura	facturacion	`id, episodio_id, convenio (gratuidad/IGSS/priv), monto, items, emitida_at`

7.3 Catálogos (10) — fuentes oficiales

#	Catálogo	Fuente	Uso
1	CIE-10	OMS · MSPAS	Diagnósticos en notas y egresos
2	CIE-9-CM	OMS	Procedimientos quirúrgicos
3	ATC	WHO Collaborating Centre	Clasificación de medicamentos · LBM-MSPAS
4	LOINC	Regenstrief	Exámenes de laboratorio · interoperabilidad
5	SNOMED CT	SNOMED Int.	Conceptos clínicos finos · alergias · síntomas
6	CUI-RENAP	RENAP	Identidad nacional · 13 dígitos verificables
7	Renglones de gasto MINFIN	MINFIN	Presupuesto · compras
8	Estructura programática (UE 248 · Programa · Subprograma · Actividad · Renglón)	MINFIN-MSPAS	Ejecución presupuestaria SICOIN
9	Etnias / Idiomas (mayas, garífuna, xinka, ladino)	MSPAS · INE	Identidad cultural · interculturalidad
10	Departamentos / Municipios / Aldeas	INE	Geografía · vigilancia epidemiológica

7.4 Particionado y retención

signos_vitales (Timescale): hipertabla particionada por mes · compresión a 7 días · downsampling a 1 año.
nota_clinica (Mongo): por año · backup mensual frío.
auditoría: por mes · retención 10 años (requisito legal).
factura: 7 años (SAT).
RN datos identitarios: indefinido (paciente vivo).

7.5 Convenciones SQL

-- Toda tabla transaccional
id          uuid DEFAULT uuid_v7() PRIMARY KEY,
created_at  timestamptz DEFAULT now(),
updated_at  timestamptz DEFAULT now(),
deleted_at  timestamptz NULL,        -- soft delete
created_by  text NOT NULL,
updated_by  text NOT NULL,
version     int DEFAULT 1            -- optimistic locking

7. Modelo de datos Diccionario

7.1 Reglas de oro

7.2 Entidades transaccionales (18)

7.3 Catálogos (10) — fuentes oficiales

7.4 Particionado y retención

7.5 Convenciones SQL