LPDI · Tarea 32 · Plan para aprobación

Memoria del Sistema LPDI

Un módulo del sidebar, solo para superadmin, que reúne en un solo lugar la documentación del sistema. Cada documento con su versión, su fecha real, su estado, su historial y su PDF. Es la fuente de verdad que yo consulto antes de ejecutar una tarea y la que usted consulta para saber qué está vigente. Antes de proponer, revisé uno por uno los 12 documentos que usted mapeó, los 8 adjuntos, el código y la base de datos.

Versión 1.1 · 24-sep-2026Responde los puntos a a nEstado: aprobado con ajustes

1.1Decisiones de Frank (24-sep-2026, 19:37)

  • Aprobadas las 9 secciones y el destino de cada documento, y la revisión cada 3 meses de los documentos redactados.
  • Documentos suyos que entran: B1 Requerimiento técnico V.4, C1 Manual SGC V.5, B2 Manual de usuario V.4 (05-jun-2026) y E1 Manual SGR V.7 (10-abr-2026).
  • Hostinger: dominio y hosting de lapuntadeliceberg.co. Entra a Plataformas.
  • Credencial de GitHub: proceso explicado; espera saber quién tiene acceso a la cuenta devlapuntadeliceberg para crear el token nuevo.
  • Orden: fase 0 en paralelo; 29 y 31 primero; luego 30 y 32 en paralelo; el resto de la 32 en los huecos.
  • o. Reportes y planes NUEVO: sección con cada playground que genero, con su tarea, fecha, versión, estado (vigente o reemplazado) y enlace. Se registra solo al publicar.
  • Design System: la página es del 09-ago, pero DESIGN.md del repositorio es del 23-sep. En la Memoria se genera desde DESIGN.md, sin copia a mano.
  • Estética: inspiración en lapuntadeliceberg.co/terminos-y-condiciones, sobre todo la barra lateral, con el branding LPDI; se muestra en la fase 1.
  • Política de actualización por naturaleza: inmediata en cada despliegue (Correos, Íconos, URLs, Roles, Design System, Score, Diccionario de datos); diaria (Plataformas, Automatizaciones, Seguridad); semanal (Novedades); cada 3 meses (redactados). Cada documento muestra su política y su última actualización.
  • Enlaces entre documentos: cada sigla y mención a otro documento se vuelve enlace automático; una regla detecta enlaces a documentos inexistentes.

00Lo que encontré

Revisión documento por documento, con la fecha real de cada archivo y la versión que declara.

4 de 12
documentos sin número de versión (SC Codificación, MU, EP, Score)
2 versiones
en el mismo IC: «Versión 24 · 16-sep» arriba y «Versión 23 · 13-sep» abajo; y 90 correos en un lugar, 87 en otro
3 formatos
del mismo contenido: HTML, Word (.docx) y PDF, que se desincronizan
≈ 15
archivos viejos, duplicados o de redirección que todavía están publicados
≈ 26
tareas automáticas del sistema (Vercel, Supabase y el servidor), hoy sin documentar

Síntomas concretos

  • Se actualiza el contenido y no la versión: pasa en IC (dos versiones y tres conteos de correos conviven), en IS (la barra dice 22-ago y el cuerpo 05-jul) y en BM. Es el síntoma que usted describió, y la causa es que la versión se escribe a mano.
  • Sigla repetida y siglas sin registrar: «SC» se usa para Codificación y para Score de completitud. AE, ET y MU no están en el documento de Siglas (IS).
  • El mismo tema en dos lugares: los íconos están en el Design System (sección 6, sin cambios desde el 09-ago) y en el Catálogo de íconos (vivo, 24-sep), sin enlace entre ellos. La codificación está partida entre «Codificación» y «Códigos de eventos», que no está en su lista.
  • Enlaces a versiones viejas: la Base de Conocimiento enlaza a una revisión del Inventario de correos del 30-may.
  • Criterio visual distinto: 11 de 12 usan el azul LPDI y fondo blanco; el de Score usa fondo azul oscuro y otras fuentes. Los encabezados muestran campos distintos en cada documento y solo 7 tienen índice.
  • Adjuntos: hay dos «A.5». La V.2 del 03-jun-2026 describe el sistema construido y es la vigente. La V.1 del 05-mar-2026 es un diseño previo con 6 afirmaciones que ya no son ciertas: dice Prisma, shadcn, Zod, Svelte 5, roles «Curador/Registrador» y app móvil con Capacitor, y nada de eso existe. Además encontré dos documentos de su serie que no vinieron en esta carga: B1 Requerimiento técnico V.4 (12-abr-2026) y C1 Manual SGC V.5 (08-jun-2026).
  • Lo que sí está bien: las cifras del sistema (eventos, organizadores, migraciones) coinciden entre el Análisis estratégico, la Especificación técnica y el reporte de Eventos. El Design System tiene el mejor encabezado e índice: es la base para el estándar.

aSecciones del módulo «Memoria»

Nueve secciones por tema. Cada documento vive en una sola, aunque puede enlazar a otras.

01

Fundamentos y estrategia

Marco lógico (A.2), Esquema tecnológico (A.1), Análisis estratégico (A.6 y AE), Oferta de valor (A.7), Pitch deck. Son los documentos que usted sube y que definen la filosofía del sistema.
02

Arquitectura y especificación

Especificación técnica (ET y A.5 V.2), Arquitectura técnica (A.4), Requerimiento técnico (B1), Módulo de Eventos (SGE), Mapa de URLs (MU), Diccionario de datos NUEVO.
03

Diseño y experiencia

Design System (DS), Catálogo de íconos (II), Especificación de paneles (EP), Manual de marca NUEVO.
04

Datos, catálogos y reglas

Codificación unificada (Codificación y Códigos de eventos), Siglas y convenciones (IS), Score de completitud, Roles y permisos NUEVO.
05

Operación

Inventario de correos (IC), Plataformas NUEVO, Automatizaciones y tareas programadas NUEVO, Guía de despliegue y reversa NUEVO, Manual SGC (C1).
06

Gobierno y cumplimiento

Documentos legales (se traslada), Registro de parches (se traslada), Política de desarrollo estructural, Política de tratamiento de datos y sus 6 anexos.
07

Seguridad e integridad

Panel de salud y seguridad NUEVO, Registro de incidentes NUEVO.
08

Propiedad intelectual

Registros de marca, derechos de autor, dominios NUEVO.
09

Conocimiento y decisiones

Base de conocimiento (BM): bitácora de instrucciones y decisiones.

··Inventario y destino de cada documento

Filtre por estado. «Versión» es la que declara hoy el documento; «Archivo» es la fecha real de su última modificación.

SiglaDocumentoVersión declaradaArchivoEstadoSecciónAcción
ICInventario de correosV.24 · 16-sep y V.23 · 13-sep24-sep2 versionesOperaciónUnificar; versión automática
SCCodificación (taxonomías)sin versión · 03-ago06-agosin versiónDatosUnir con Códigos de eventos
ISSiglas y convencionesV.2 · 22-ago (cuerpo: 05-jul)03-sepdesfaseDatosAgregar AE, ET, MU y la sigla del Score
IICatálogo de íconosV.7 · 24-sep24-sepcoherenteDiseñoEnlazar desde DS §6
MUMapa de URLssin versión · 03-ago03-agosin versiónArquitecturaGenerar desde las rutas del código
DSDesign SystemV.2 · 09-ago09-agocoherenteDiseñoBase del estándar visual
AEAnálisis estratégicoV.2 · 10-ago10-agocoherenteFundamentosReemplaza a A.6 V.1
ETEspecificación técnicaV.3 · 09-ago09-agocoherenteArquitecturaReemplaza a A.5 V.2
EPEspecificación de panelessin versión · 24-sep24-sepsin versiónDiseñoPoner versión
BMBase de conocimientoV.1 · 28-jul (cuerpo: 08-jul)28-juldesfaseConocimientoCorregir enlace a IC viejo
SGEMódulo de EventosV.1 · 09-ago09-agocoherenteArquitecturaActualizar con la 21 de hoy
SC (repetida)Score de completitudsin versión · 14-sep14-sepsin versión, estilo distintoDatosSigla nueva y estilo estándar
A.5 V.1Especificaciones completas SGR (05-mar)V.1 (el documento dice V.2.0 · 26-feb)adjuntoobsoletoArquitecturaArchivar como histórico
·Revisiones viejas del Inventario de correos (5 archivos), Códigos de evento V.1 y V.2, códigos de 6 dígitos, 2 páginas de redirección de Score y 1 de Paneles, borrador de puntajes FSD, reportes PMO de marzo y abrilvariasmay a sepobsoletos·Archivar con redirección al vigente
Los documentos que usted sube (A.1, A.2, A.4, A.6, A.7, B1, C1 y el pitch deck) entran como archivo original con su propia ficha: versión, fecha y a qué documento vivo reemplazan o complementan. Quedan como referencia fija; no se editan dentro del sistema.

bEstándar de presentación

No todos iguales por dentro, pero todos con el mismo marco. El marco lo pone el sistema, no cada documento.

ET · Especificación técnicaArquitectura y especificaciónVersión 3.2Actualizado 24-sep-2026VigenteFuente: repositorio + base de datosPróxima revisión: 24-dic-2026Descargar PDF
Índice automático
1. Arquitectura
2. Modelo de datos
3. Módulos
4. Seguridad

Historial de versiones
Contenido del documento con la tipografía y los colores del Design System. Buscador dentro del documento, enlaces «volver al índice» y pie con «qué cambió en esta versión».
  • Encabezado único con siempre los mismos campos: sigla, título, sección, versión, fecha de actualización, estado (Vigente, En revisión, Obsoleto), responsable, fuente de verdad, próxima revisión y botón PDF.
  • Índice lateral automático armado desde los títulos del documento, fijo al hacer scroll, con buscador interno. Resuelve los documentos largos (IC mide 296 KB, DS 148 KB).
  • Misma tipografía, colores y componentes del Design System (DESIGN.md), incluidas tablas, notas y bloques de código.
  • Pie común: resumen de cambios de la versión, enlace al historial y documentos relacionados.

cMaestro de documentos y control de versiones

Una tabla viva con todos los documentos, y un historial por documento donde se puede abrir o descargar cualquier versión anterior.

  • Maestro: sigla, título, sección, versión vigente, fecha, estado, responsable, fuente, próxima revisión y un semáforo (al día, revisión vencida, con cambios pendientes de publicar). Con filtros por sección y estado, y buscador.
  • Historial por documento: cada versión queda guardada completa, con su fecha, quién la publicó, qué cambió y su PDF. Se puede comparar una versión con la anterior.
  • En la base de datos: una tabla de documentos y otra de versiones. Cada versión guarda su contenido y una huella digital del contenido, para detectar cambios sin versión.

dReglas para que la versión y la fecha nunca se queden atrás

La causa del problema es que hoy la versión y la fecha se escriben a mano. La solución es que nadie las escriba.

  1. La versión y la fecha las pone el sistema al publicar. Si el contenido cambió (su huella digital es distinta), se crea una versión nueva con la fecha del día y un resumen de cambios obligatorio. Un contenido nuevo con la versión vieja deja de ser posible.
  2. Cambio menor o mayor: correcciones suben 3.1 a 3.2; cambios de fondo suben a 4.0. Lo elige quien publica, con una ayuda para decidir.
  3. Documentos generados desde el sistema (Inventario de correos, Íconos, Codificación, Mapa de URLs, Score, Plataformas, Automatizaciones): se regeneran desde el código y la base. Una regla automática falla si el sistema cambió y el documento no, como ya hace hoy el inventario de correos.
  4. Documentos redactados (Especificación, Análisis, Design System): tienen fecha de próxima revisión. El maestro los marca en ámbar cuando se vence y el chequeo diario de las 6:05 le avisa.
  5. Regla de trabajo para mí: todo cambio en el sistema que afecte un documento de la Memoria actualiza ese documento en el mismo cambio. Queda escrita en las reglas del repositorio y se verifica al cerrar cada tarea.
  6. Un solo lugar: al migrar, la versión de la Memoria pasa a ser la única. Las páginas viejas redirigen a ella y los Word desaparecen, para no mantener tres copias.

eDescarga en PDF

Cada versión publicada genera su PDF en ese momento y lo guarda junto a la versión. Así el PDF de la versión 3.2 siempre es la 3.2, con el mismo encabezado estándar, el índice y el número de página. Los documentos que usted sube ya en PDF se descargan tal cual.

fDocumentos que faltan o están perdidos

DocumentoSituación verificadaQué propongo
B1 Requerimiento técnico V.4 (12-abr-2026) y C1 Manual SGC V.5 (08-jun-2026)Existen en la base de conocimiento, no en su lista ni en los adjuntosIncluirlos (necesito su confirmación y la versión vigente)
Roles y permisosLos roles viven sueltos en el código (superadmin, admin de eventos, de beneficios, de convocatorias, de contratos, de referidos…); ningún documento los reúneCrear: quién puede ver y hacer qué, generado desde el código
Diccionario de datosLa Especificación técnica tiene solo las tablas principales; no hay un mapa completo de la baseCrear, generado desde la base (tablas, columnas, relaciones, quién escribe)
Automatizaciones y tareas programadasHay 7 en Vercel, 7 dentro de Supabase y unas 12 en el servidor (anonimización, recordatorios de correo, transferencias, respaldo diario, guardia de datos, chequeo de seguridad…), sin documentarCrear: qué corre, cuándo, dónde y a quién avisa si falla
Guía de despliegue y reversaSolo existe una guía puntual de un caso; el DEPLOY.md del repositorio está casi vacíoCrear
Registro de incidentesHay notas sueltas de incidentes (por ejemplo, el NIT de Sura), no un registroCrear: qué pasó, impacto, causa, corrección y prevención
Política de tratamiento de datosSí existe: V.2 y 6 anexos en Documentos legalesSolo trasladarla a la Memoria

gPantalla de Plataformas

Lo que encontré conectado, revisando el código, la configuración y las tareas del servidor. Hostinger no aparece en ninguna parte: necesito que me diga para qué lo usan.

PlataformaPara qué se usa
SupabaseBase de datos, inicio de sesión, archivos (10 depósitos: logos, pitch decks, data room, documentos legales, adjuntos…) y 7 tareas programadas internas
VercelPublica la plataforma eco.lpdi.co, 7 tareas programadas y las vistas previas
GitHubCódigo fuente, revisiones automáticas y pruebas de cada cambio
ResendEnvío de los correos del sistema
Google CloudMapas, búsqueda de ciudades y zonas horarias
Google Analytics 4Medición de visitas de eco.lpdi.co
Google DriveRespaldo diario de la base de datos (5:00 a. m.)
CloudflareDominio y certificado de eco.lpdi.co
Servidor de operación (Hetzner)Tareas programadas diarias, chequeos de salud y seguridad, páginas de documentación y el vigilante de Slack
SlackCanal de trabajo y alertas automáticas (guardia de datos)
Anthropic (Claude)Revisión automática de cada cambio de código y los agentes de desarrollo
Hostingersin rastro en el sistema por confirmar con usted

Qué muestra cada ficha

  • Para qué se usa y qué partes del sistema dejan de funcionar si falla.
  • Cuenta dueña, plan y costo, fecha de renovación y límites de uso (por ejemplo, qué tan cerca está Supabase del tope de su plan).
  • Dónde se cambian las claves y cuándo se cambiaron por última vez. Nunca se muestran las claves.
  • Estado verificado automáticamente (responde o no responde) y enlace a su consola.

h · iDocumentos legales y Registro de parches

h. Traslado: los dos módulos pasan de «Administración, Sistema» a la sección «Gobierno y cumplimiento» de la Memoria. Las direcciones actuales redirigen a las nuevas. Documentos legales conserva todo lo que hace hoy: versiones, publicación, el aviso de aceptación a los usuarios y el registro de consentimientos.

i. Qué pasa con el Registro de parches: lo revisé.

  • No está desactualizado: tiene 3 entradas, 2 resueltas (06-sep y 09-sep) y 1 activa. En el código hay exactamente 1 marca de parche, la de esa activa. Desde el 9 de septiembre no se aprobó ningún parche nuevo, por eso no cambia.
  • Por qué da la sensación de estar quieto: nada lo muestra. Solo se actualiza cuando se aprueba un parche, y la verificación que cruza el código con el registro no corre en las pruebas automáticas de cada cambio, solo si alguien la ejecuta a mano.
  • Propuesta: la verificación corre en cada cambio y en el chequeo diario; la pantalla muestra «Última verificación: hoy 6:05 · código y registro coinciden · 1 parche activo», la fecha de revisión de cada parche activo y el enlace a su aprobación en Slack. Así usted sabe que el «sin cambios» es real.

jSeguridad, ciberseguridad e integridad

Sí va aquí: un panel que reúne lo que ya se revisa solo, suma lo que falta y deja rastro de cada revisión.

Ya funciona (se muestra en el panel)

  • Guardia de salud de datos, diaria 6:05
  • Tablas sin protección de acceso, diario 6:00
  • Funciones de la base abiertas sin sesión
  • Fuente única de organizadores y nombre de beneficios
  • Respaldo diario de la base a Google Drive
  • Monitor del plan de Supabase

Falta y propongo

  • Prueba de restauración mensual del respaldo: hoy se respalda, pero nunca se probó restaurar
  • Librerías con vulnerabilidades conocidas, semanal
  • Claves o credenciales expuestas en el código y la configuración
  • Alertas de seguridad que ofrece Supabase
  • Encabezados de seguridad del sitio y límites de intentos
  • Monitor de disponibilidad de eco.lpdi.co
  • Revisión externa periódica (tipo OWASP), como la que hicimos para otro proyecto
Hallazgo de esta revisión: en el servidor de operación, la copia del código guarda una credencial de GitHub dentro de la dirección del repositorio. No está publicada, pero es una mala práctica. Propongo rotar esa credencial y guardarla aparte. Lo hago con su OK.

kRegla para documentos nuevos

Todo documento base nuevo se crea dentro de la Memoria, con su ficha completa: sigla registrada en Siglas, sección, responsable, fuente de verdad y fecha de revisión. Una regla automática revisa que no haya documentos del sistema publicados fuera de la Memoria ni siglas repetidas, igual que hoy se hace con los correos y los íconos.

lPropiedad intelectual

Un espacio privado, solo superadmin, con una ficha por registro: tipo (marca, derecho de autor, software, dominio), número, entidad (SIC, Dirección Nacional de Derecho de Autor…), titular, fecha de concesión, fecha de vencimiento con aviso de renovación y el archivo del certificado. Los archivos van en un depósito privado, nunca público.

mManual de marca interactivo

Una página pública y compartible, al estilo de adn.sura.com: logos para descargar, colores, tipografías, usos correctos e incorrectos, tono de voz y aplicaciones. Toma los datos del Design System, así el manual y la plataforma nunca se contradicen. De acuerdo con consultar a Claude Design para el concepto visual: le preparo el material y usted aprueba la dirección antes de construir.

nLo que agrego

  • Memoria legible por los agentes: una versión de texto de toda la Memoria que yo consulto al iniciar cada tarea. Así la Memoria es de verdad mi fuente, no solo la suya.
  • Buscador global dentro de la Memoria: busca en todos los documentos a la vez.
  • Novedades del sistema: una página con lo que cambió cada semana, a partir de los cambios publicados.
  • Limpieza: los ≈15 archivos viejos quedan archivados con redirección, para que ningún enlace lleve a una versión vieja.

··Plan por fases

0
Inventario y limpieza
Maestro inicial con los 12 documentos, los adjuntos, B1 y C1; archivar los obsoletos con redirección; completar Siglas; resolver la sigla repetida.
TERMINADO CUANDO · cada documento tiene ficha completa · 0 enlaces a versiones viejas · 0 siglas repetidas.
1
Módulo base
Sección «Memoria» en el sidebar, maestro con filtros, visor estándar (encabezado, índice, historial), versiones automáticas, PDF por versión y traslado de Documentos legales y del Registro de parches.
TERMINADO CUANDO · publicar un cambio crea la versión y su PDF sin tocar el número a mano · las direcciones viejas redirigen · Documentos legales sigue funcionando igual (prueba de publicación y de aceptación).
2
Migración de los 12 documentos al estándar
Con las unificaciones: Codificación con Códigos de eventos, e íconos entre el Design System y el Catálogo. Los documentos generados se regeneran desde el sistema.
TERMINADO CUANDO · los 12 se ven con el mismo marco · las reglas automáticas detectan un cambio sin documentar (probado a propósito).
3
Documentos nuevos
Plataformas, Automatizaciones, Roles y permisos, Diccionario de datos, Guía de despliegue y Registro de incidentes.
4
Panel de salud y seguridad
Lo existente más lo nuevo, con historial y alertas.
TERMINADO CUANDO · primera prueba de restauración del respaldo hecha y registrada · cada chequeo muestra su última ejecución.
5
Propiedad intelectual
6
Manual de marca, con el concepto de Claude Design aprobado por usted.

··Lo que necesito de usted

  1. ¿Aprueba las 9 secciones y el destino de cada documento?
  2. ¿Incluyo B1 (Requerimiento técnico V.4) y C1 (Manual SGC V.5)? ¿Son las versiones vigentes?
  3. Cadencia de revisión de los documentos redactados: propongo cada 3 meses. ¿Le parece?
  4. ¿Para qué usan Hostinger? No encontré ninguna conexión con el sistema.
  5. ¿Autoriza rotar la credencial de GitHub que encontré guardada en el servidor?
  6. ¿En qué lugar de la fila va la 32? Hoy: 29 → 31.1 a 31.3 → 30. Recomiendo hacer la fase 0 de la 32 en paralelo, porque es limpieza y no toca la plataforma, y el resto después de la 29.