LPDI ยท Diagnostico de arquitectura

Integridad de datos: donde puede desalinearse el sistema, y como cerrarlo de fondo

Revisión del sistema completo buscando el patrón que causo el problema de organizadores: una copia de texto de un nombre conviviendo con la ficha/entidad canonica, sin una que mande sobre la otra. Esto es diagnostico + propuesta, NO codigo. Nada se toca hasta tu OK.

Lo primero, derecho y sin maquillaje

El peor caso —dos pantallas que se contradicen porque cada una se llena por su lado— es practicamente unico de organizadores/eventos. NO esta esparcido por convocatorias, noticias, networking ni matchmaking. No te voy a inflar el problema para verme minucioso.

PERO tienes razon en el fondo: hay una decision de diseño sistemica —enlazar a una entidad por un id "suelto" sin llave (FK) y guardar una copia del nombre al lado— que deja puertas de drift abiertas en varios modulos (mas leves). Y hay un segundo problema sistemico aparte: los catalogos con doble fuente (base de datos vs una copia en el codigo), que HOY ya causa un bug real. Los tres se cierran con el plan de abajo.

1. Los dos ejes del problema

No es un solo problema: son dos, de naturaleza distinta. Conviene no fundirlos.

Eje A — Ficha vs copia de texto

Una fila guarda el nombre en texto de algo que ademas existe como ficha canonica, atados por un id sin llave (FK). Si hay dos pantallas que lo muestran y se llenan por separado, se contradicen. Este es el caso de organizadores (y el que mas duele).

Eje B — Catalogos doble fuente

Un valor de catalogo (industria, pais, rol) esta duplicado entre la tabla en la base de datos y una copia escrita a mano en el codigo. Ya esta auditado por el equipo (AUDITORIA-CAMPOS-HARDCODEADOS.md) y hoy causa un bug verificable: el rango de ingresos mezcla codigos y etiquetas segun por que formulario se guardo.

2. Inventario de puntos donde SI puede desalinearse

Solo puntos reales de drift. Los snapshots (la copia congelada de lo que una empresa envio al aplicar, o la estructura de un contrato al enviarlo) son intencionales y correctos: NO se tocan.

PuntoCopia de textoFuente canonicaRiesgoPor que
Organizadores de eventosnombre libre en el eventoficha del directorioALTODos pantallas visibles; sync best-effort de un solo sentido; no maneja renombres ni separaciones
Nombre de la ficha del directorionombre de la fichacompany_name / organization_name de la entidadMEDIO-ALTOSi renombras la startup/ICG, la ficha NO se renombra sola (solo se limpia al borrar)
Aliado de convocatoriapartner_namestartup / ICG (partner_entity_id)MEDIOSin llave y sin sync; una sola pantalla, admin, baja cantidad
Atribucion de referido (perks)match por nombrestartup / ICGMEDIOSolo canjes viejos; los nuevos ya guardan la eleccion como fuente
Industrias en el perfiletiqueta de industria (label)catalogo de industriasBAJOGuarda tambien el codigo (re-resoluble); solo la etiqueta mostrada se enrancia
Lo que esta sano (para tu tranquilidad): las relaciones que NO son polimorficas ya usan llaves reales (evento→organizador, campo→catalogo, aplicacion→startup). Los nombres normalizados de busqueda son columnas GENERATED derivadas: no pueden desalinearse. Noticias aun no existe como modulo. Networking y matchmaking no guardan copias de nombres (el matcheo por nombre ahi es solo para avisar duplicados al registrar, no se almacena).

3. El arreglo estructural (tres niveles)

No una reconciliacion por modulo. Una fuente unica de verdad + un guardian que vigile TODO el sistema.

1

Fuente unica para organizadores (cierra la clase, no la instancia)

Que el evento referencie la ficha del organizador y que el nombre SIEMPRE se muestre desde la ficha, no desde una copia de texto. Sin dos copias que cuadrar, el drift es imposible. La reconciliacion deja de ser necesaria porque hay una sola verdad.

Migracion + cambio de UI (elegir del directorio en vez de escribir texto). Reversible, por fases.
2

Guardian de salud de datos SISTEMICO (la garantia que pides)

Un chequeo de integridad que barre todos los puntos de arriba en todos los modulos y te muestra, en un tablero, cualquier drift/huerfano apenas aparezca — no cuando yo lo tropiezo indagando. Cierra las "puertas abiertas" de los links sin llave: aunque no todos se migren de una, quedan VIGILADOS.

Vista de admin + chequeo periodico. Es lo que hace que el sistema quede "sano", no solo un modulo.
3

Catalogos con fuente unica (arregla el bug de hoy)

La base de datos manda; la copia escrita en el codigo se genera desde ahi o se elimina. Arregla el bug verificado del rango de ingresos (codigos vs etiquetas) y evita que el vocabulario del sistema se bifurque.

Consolidacion catalogo→codigo + correccion del dato ya inconsistente.
Que es cada cosa (sin maquillar): lo de arriba es el ARREGLO ESTRUCTURAL (elimina la clase del problema y la vigila en todo el sistema). La reconciliacion de los 65 organizadores que te pase aparte es una LIMPIEZA puntual para dejar los datos de hoy en cero: la hago para desbloquear, pero no es "el arreglo" — el arreglo es este plan.

Diagnostico y propuesta · 21-sep-2026 · No se toca codigo hasta tu OK · La Punta del Iceberg