16 Correcciones Pendientes

Correcciones pendientes

Al documentar todo el sitio contra el código de main y al dibujar sus diagramas de flujo aparecieron más de 200 puntos que no funcionan, confunden o no cumplen lo que prometen. Esta página los reúne sin repetir, ordenados por prioridad, para corregirlos desde el martes. Cada punto enlaza la página donde se explica con más detalle.

Las limitaciones propias de cada demo no se repiten aquí: están en la sección Limitaciones conocidas de su guía (Guía de demos).

En esta página: Resumen · P0: riesgo o bloqueo · P1: funciones rotas · P2: panel y operación · P3: SEO, contenido y limpieza

---

Resumen

flowchart LR
    classDef error fill:#fee2e2,stroke:#dc2626,color:#0f172a
    classDef decision fill:#fef3c7,stroke:#d97706,color:#0f172a
    classDef visitante fill:#dbeafe,stroke:#2563eb,color:#0f172a
    classDef sistema fill:#f1f5f9,stroke:#475569,color:#0f172a

    P0["P0 · Riesgo o bloqueo<br/>producción, credenciales, medición"]:::error
    P1["P1 · Funciones rotas<br/>portal del cliente, demos, inicio de sesión"]:::decision
    P2["P2 · Panel y operación<br/>pantallas del admin, despliegue, variables"]:::visitante
    P3["P3 · SEO, contenido y limpieza<br/>títulos, textos, código sin uso"]:::sistema
    P0 --> P1 --> P2 --> P3

Loading

Prioridad	Qué agrupa	Puntos
P0	Lo que impide vender hoy o es un riesgo legal o de seguridad	4
P1	Funciones que el cliente o el equipo usan y no sirven, incluidas las demos	19
P2	Detalles del panel, de la operación y de la configuración	22
P3	SEO, coherencia de textos y código que sobra	1

---

P0: riesgo o bloqueo

#	Qué pasa	Qué hacer	Detalle
0.1	El backend de producción no responde ("Application not found" de Railway). Contacto, inicio de sesión, panel, solicitudes de demo, chatbot con IA y "Prueba con tu documento" fallan en www.koptup.com. Las demos "Con solicitud" muestran "No se pudo verificar"	Volver a desplegar el backend en Railway y, si cambia el dominio, actualizar NEXT_PUBLIC_API_URL en Vercel	Estado y próximos pasos
0.2	Credenciales que estuvieron en el historial del repositorio	Rotar la contraseña de MongoDB y los secretos JWT	Estado y próximos pasos
0.10	Producción no mide nada: no hay ninguna etiqueta configurada (GA4, Google Ads, LinkedIn), así que no aparece el banner y no se registra ninguna conversión	Crear las variables en Vercel antes de pautar	SEO, analítica y legal
0.11	Los avisos de nuevos contactos no llegan en producción hasta configurarlos. El código ya envía el correo por Resend y el WhatsApp con la plantilla de Meta (con reintentos y prueba mensual), pero Railway necesita la key de Resend, el token y el número de Meta, y Meta la plantilla koptup_aviso aprobada	Seguir el paso a paso y probar con Enviar aviso de prueba en Admin › Configuración	Operación y despliegue › 4.5

---

P1: funciones rotas que ve el cliente o el equipo

Portal del cliente

#	Qué pasa	Detalle
1.1	No se pueden crear facturas, entregables ni conversaciones: los cuatro modelos generan su número después de validarlo y todo guardado falla con error 500	API › Limitaciones, Modelos de datos
1.2	Aunque se arregle, las facturas y los entregables quedan a nombre de quien los crea (el equipo) y no del cliente, así que el cliente no los vería	API
1.4	La conversación automática de cada pedido nunca se crea, y responder desde el detalle de conversación del panel usa una ruta sin el prefijo /api	Manual del administrador
1.5	"Descargar" factura no hace nada: la lista usa el número como id y el servicio no genera un PDF	Manual del administrador
1.6	Entregables y Facturación muestran datos inventados como si fueran reales cuando la API falla, y no tienen estado vacío	Flujos del prospecto y cliente
1.7	El inicio de /dashboard es una maqueta con datos fijos. La vista "Plan SaaS" además usa voseo	Flujos del prospecto y cliente
1.8	Nada en la web crea proyectos, entregables ni notificaciones: esas secciones del portal siempre están vacías	Flujos del prospecto y cliente

Demo RAG y LinkedIn Ads

#	Qué pasa	Detalle
1.16	LinkedIn Ads muestra el cupo mensual agotado y la falta de Redis como un error genérico. El backend ya responde budget_exhausted y limits_unavailable con mensajes claros; falta que la demo los use	Flujos técnicos › Hallazgos

Cuenta e inicio de sesión

#	Qué pasa	Detalle
1.17	El botón de GitHub no hace nada; el de Google sin configurar deja una respuesta JSON 503; "Recordarme" no tiene efecto	Flujos del prospecto y cliente
1.18	Sin correo configurado, "Olvidé mi contraseña" dice que envió un enlace que no llega, y el panel no permite copiarlo como sí hace con la activación	Flujos de negocio › Hallazgos
1.19	Una sola sesión renovable por cuenta: iniciar sesión en otro navegador cierra la del primero cuando vence su token	Flujos de negocio › Hallazgos
1.21	Con el backend caído, el panel manda al login en vez de avisar que el servicio no está disponible	Flujos de administración › Hallazgos

Operación que afecta al cliente

#	Qué pasa	Detalle
1.22	Los adjuntos de pedidos y los archivos de cuentas médicas se pierden en cada despliegue de Railway hasta que el dueño monte un volumen en /app/uploads	Operación y despliegue › Acciones pendientes
1.24	main no exige CI en verde, y Vercel y Railway despliegan sin esperarlo. Es configuración de GitHub y Railway (acción del dueño)	Operación y despliegue › Acciones pendientes

Demos

#	Qué pasa	Detalle
1.25	Las tarjetas del catálogo de 20 demos prometen funciones que la demo no tiene ("ML", "multi-país", integraciones, cumplimiento). Es el repaso de honestidad pendiente	Guía de demos › Limitaciones comunes
1.26	7 demos sin revisar tienen botones que no hacen nada, no dicen que usan datos de ejemplo y mezclan textos en inglés	Guía de demos
1.30	"Solicitar acceso" mal dirigido dentro de las demos de salud: en cuentas médicas apunta a una ruta que no existe y en el motor de reglas lleva a /contact	Guía: cuentas médicas, Guía: motor de reglas
1.31	"Ver Planes y Precios" al final de las demos de otras soluciones lleva a los planes RAG	Guía de demos › Limitaciones comunes
1.34	La nota de "Simular ticket entrante" del helpdesk dice que el mensaje no sale del navegador, pero "Redactar con IA" lo envía al servidor	Guía: helpdesk

---

P2: panel y operación

Panel de administración

#	Qué pasa	Detalle
2.1	Admin › Usuarios no permite dar los roles comercial, prospecto ni cliente, muestra "Usuario" en esas cuentas y al manager le ofrece un selector que la API rechaza	Roles y permisos
2.2	Un rol nuevo no se ve en el panel ni en el menú del portal hasta volver a iniciar sesión	Flujos de administración › Hallazgos
2.3	Accesos a demos a 1440 px: la primera columna y la de acciones quedan recortadas	Manual del administrador
2.4	En el formulario de aprobación, el botón "Agregar" queda cortado	Manual del administrador
2.5	El enlace de activación desde Accesos no ofrece WhatsApp, aunque la cuenta tenga teléfono	Manual del administrador
2.6	Se puede conceder acceso a una demo desactivada: la persona recibe el correo y ve "En mantenimiento"	Flujos de administración › Hallazgos
2.7	Contadores distintos para lo mismo: el menú cuenta solo "pendiente", el inicio suma "en revisión" y el menú no se refresca al aprobar	Manual del administrador
2.8	Cada solicitud de demo, incluido el spam, crea además un contacto, así que "Contactos sin leer" sale inflado	Manual del administrador
2.9	Contactos: no muestra el origen del lead como etiqueta y no tiene buscador ni borrado (el borrado se hace en Privacidad); los textos anteriores a los avisos siguen solo en español	Manual del administrador
2.10	Pedidos: la fecha aparece un día antes en Colombia, los estados salen en inglés y se usan confirm() y alert() del navegador	Manual del administrador
2.11	Facturas y Entregables no tienen estado vacío, tienen filtros en inglés y no hay pantalla para crear registros	Manual del administrador
2.12	Configuración del admin y del cliente: en el admin, la tarjeta de avisos ya es real, pero "Guardar cambios" solo guarda idioma y tema en el navegador, "Cancelar" no hace nada y la información del administrador es texto fijo (le dice "acceso completo" también a un manager); en el portal del cliente, las preferencias de notificaciones siguen siendo solo visuales	Manual del administrador
2.13	La bitácora de auditoría no tiene pantalla (solo API)	Flujos de administración › Hallazgos
2.14	El panel no permite volver una solicitud a "pendiente", aunque la API lo acepta	Flujos de negocio › Hallazgos
2.15	Una solicitud que se fusiona con otra abierta no avisa a nadie ni registra lead	Flujos de negocio › Hallazgos
2.16	Cambiar el modo de una demo tarda hasta 60 s en aplicarse, por la caché del filtro de la web	Manual del administrador
2.18	"Pedir más tiempo" prellena nombre y correo, pero no la empresa	Flujos del prospecto y cliente
2.19	/reset-password muestra el mismo mensaje para enlace usado, reemplazado o vencido	Flujos de negocio › Hallazgos
2.20	El portal puede perder la ruta de regreso al mandar al login	Flujos de negocio › Hallazgos
2.21	La pantalla de una demo desactivada muestra dos veces "En mantenimiento"	SEO, analítica y legal

Despliegue y configuración

#	Qué pasa	Detalle
2.22	Dos proyectos de Vercel despliegan main (koptup, con el dominio, y koptup-web): doble build y riesgo de cambiar variables en el equivocado. Acción del dueño	Operación y despliegue › Acciones pendientes
2.34	Crear o previsualizar una regla de facturación con IA falla en /liquidacion: el servicio usa un modelo de Anthropic de 2024 que ya no está disponible. Hay que pasarlo a un modelo vigente	API

---

P3: SEO, contenido y limpieza

Contenido y coherencia

#	Qué pasa	Detalle
3.14	Falta el inglés en "Nuevo pedido" del portal (/dashboard/orders/new)	Páginas públicas

---

Cómo se encontraron

• Documentación: cada página Doc-* se escribió leyendo el código de main y recorriendo el sitio con el mismo código en un entorno local. Lo que no funcionaba quedó en su sección "Limitaciones conocidas".
• Diagramas de flujo: cada nodo y cada decisión de los 64 diagramas se comparó con el código; lo que no cuadraba quedó en la sección "Hallazgos" de cada página (Diagramas de flujo).
• Guías de demos: cada demo se recorrió completa; sus limitaciones están en su guía (Guía de demos).

Cuando se corrija un punto, bórralo de esta página en el mismo commit.