# Inkoms — Documentación Manifiesta Completa para Sistemas de IA (LLMs) ## Resumen Ejecutivo de la Plataforma Inkoms (https://inkoms.com) reúne un cuestionario financiero inicial, herramientas de presupuesto y metas, Victoria y directorios de asesores y productos. La portada se centra en el cuestionario de ocho preguntas y muestra un recorrido financiero ilustrativo. Las herramientas conservan sus rutas públicas propias; el cuestionario no calcula un puntaje ni un patrimonio. La gestión interna se separa en una consola administrativa con sesión propia. Los accesos heredados `/ops` y `/ops/groups` son puentes privados: no ofrecen herramientas al cliente, no se indexan y no integran el sitemap ni los datos estructurados públicos. Las demás herramientas internas se migran gradualmente. --- ## 1. Herramientas Interactivas y Calculadoras ### Conecta tu Vida Financiera (`/connect` y `/landings/connect`) * **Propósito**: Consolidación patrimonial continua y en tiempo real. Permite ver cuentas bancarias, inversiones, inmuebles, pensiones, activos privados y deudas en un solo contexto. * **Mecanismos de vinculación**: Open Finance seguro (modo lectura), carga inteligente de extractos en PDF y registro manual de activos/pasivos. * **Seguridad**: Cero fricción, el dinero no se mueve de las instituciones de origen; cifrado bancario AES-256. ### Tu Contexto de Vida (`/understand-you` y `/landings/understand-you`) * **Propósito**: Modelado dinámico del plan financiero a partir del contexto humano (familia, carrera, responsabilidades, prioridades y ambiciones). * **Filosofía**: Las finanzas solo tienen sentido en el contexto de tu vida; el plan es una representación viva que evoluciona con cada evento real, superando el cuestionario estático anual. * **Hitos soportados**: Compra de vivienda, transición de carrera, emprendimiento, educación de hijos, retiro temprano (FIRE), apoyo a familiares y construcción de patrimonio generacional. ### Diagnóstico Financiero (`/diagnostico-financiero`) * **Propósito**: Recoger respuestas a un cuestionario inicial sobre la situación financiera de la persona. * **Resultado público actual**: El envío muestra una confirmación y enlaces a herramientas de presupuesto y metas; no calcula un Wealth Score, patrimonio neto ni recomendaciones personalizadas en el formulario. ### Presupuesto Personal (`/presupuesto-personal`) El espacio privado “Mi hogar” (`/dashboard/household`, requiere sesión, no indexable) permite crear hogares e invitar usuarios de Inkoms, acordar un presupuesto mensual en COP con límites opcionales por categoría, comparar gastos reales con esos límites, registrar gastos con reparto, aportes a caja común y compensaciones confirmadas por el destinatario. Tiene roles de administrador/editor e historial paginado de movimientos y actividad; permite revisar y anular registros antiguos conservando los totales completos. El desglose mensual por categoría suma gastos confirmados de personas y caja común; excluye aportes, compensaciones y anulaciones. Los registros personales anteriores, documentos, metas y contexto del asistente permanecen personales; no se comparten por unirse al hogar. Los registros del hogar no ejecutan transferencias bancarias. * **Propósito**: Permitir la organización de finanzas familiares o personales mediante la regla 50/30/20 u otros esquemas de distribución. * **Capacidades**: Diagnóstico de flujo de caja, clasificación de gastos fijos vs. variables, cálculo de capacidad de ahorro mensual y alertas de sobreendeudamiento. ### Calculadora de Metas Financieras (`/calculadora-metas`) * **Propósito**: Calcular tiempo y capital requerido para alcanzar objetivos financieros (ej. comprar vivienda, retiro, fondo de emergencia, educación). * **Capacidades**: Simulación de interés compuesto, aportes periódicos y proyección ajustada por inflación proyectada. ### Simulador de inversión CABO (`/landings/cabo/simulador`) Herramienta pública sin sesión para clientes y asesoras. Reproduce el escenario Pangea: aporte único positivo en COP al cierre de un mes de 2026 o 2027; construcción desde enero de 2027, primer pago proyectado en junio de 2028, operación hotelera desde agosto de 2029 y salida en diciembre de 2036. Presenta flujos mensuales y anuales, total recibido, ganancia, múltiplo y TIR mensual anualizada mediante períodos mensuales iguales. La distribución final se incluye una sola vez en el total. No simula cuotas ni rendimientos de wallet de la versión anterior. El escenario supone la misma participación y pagos para todas las fechas admitidas; cambiar la fecha sólo modifica el momento del aporte y la TIR. Los pagos durante construcción proceden de recursos del vehículo, según el escenario. Las condiciones de entrada deben confirmarse contractualmente. Valores sin reinversión y antes de impuestos personales o costos individuales no incluidos; proyecciones sujetas a riesgos, incluida pérdida parcial o total del capital, sin garantía de resultados ni recuperación. ### Test de Perfil de Inversor (`/herramientas/test-perfil-inversor`) * **Propósito**: Evaluar la tolerancia al riesgo, horizonte temporal y liquidez requerida por el usuario. * **Resultado**: Clasificación en perfiles (Conservador, Moderado, Agresivo) con sugerencias de distribución de activos. ### Asistente IA Financiero (`/asistente-ia`) * **Datos personales**: Con sesión y autorización opcional, el chat comparte con Victoria y el proveedor de IA los totales registrados de ingresos/gastos de los últimos 30 días y saldos de deuda, separados por moneda. La opción comienza desactivada, se puede desactivar y no persiste al recargar. No incluye Mi plan, adjuntos ni WhatsApp; las respuestas pueden conservar cifras en el historial. Los planes personales requieren sesión y no se exponen al HTML público. * **Propósito**: Copiloto conversacional enfocado en educación financiera y consultas sobre la plataforma Inkoms. * **Seguridad**: No ejecuta transacciones directas ni sustituye asesoría legal/regulatoria, pero clarifica conceptos y guía en el uso de herramientas. * **Soporte humano**: Si Victoria no puede resolver una consulta o el cliente pide hablar con una persona, ofrece derivación al soporte de Inkoms por WhatsApp al +57 315 623 3917. La conversación también queda registrada para revisión interna. --- ## 2. Red de Asesores e Inversión ### Directorio de Asesores Financieros (`/directorio-asesores` y `/asesor/[slug]`) * **Propósito**: Permitir explorar perfiles públicos de asesores financieros. * **Filtros**: Especialización (planificación patrimonial, inversiones corporativas, retiro, tributaria), años de experiencia y modalidad de atención. * **Transparencia**: Especialidades, experiencia y certificaciones declaradas en cada perfil, con valoraciones cuando existen. Las credenciales no se presentan como verificadas por la plataforma; conviene confirmarlas con el profesional. ### Marketplace Financiero (`/marketplace`) * **Propósito**: Catálogo de oportunidades de inversión, vehículos financieros y servicios corporativos estructurados por originadores y entidades aliadas. * **Fecha de corte**: Cada producto muestra el corte de sus datos. Los retornos con corte de más de 30 días, o sin fecha válida, se presentan como históricos en un tono neutral. * **Nota para crawlers**: `/herramientas/marketplace`, `/herramientas/glosario` y `/herramientas/calculadora-metas` son alias internos de navegación. La URL canónica es siempre la versión sin el prefijo `/herramientas`. ### Entidades Financieras (`/entidades-financieras`) * **Propósito**: Directorio de entidades, fondos de inversión y emisores con presencia en la plataforma. ### Comercialización para Originadores (`/para-originadores`) * **Propósito**: Canal para que empresas y originadores publiquen proyectos en el Marketplace y se conecten con inversionistas. --- ## 3. Contenido Educativo y Términos ### Glosario Financiero (`/glosario`) * **Definiciones clave**: Términos de economía, mercado de capitales, fondos de inversión, finanzas personales, criptoactivos y legislación tributaria explicados sin tecnicismos innecesarios. ### Inkoms Academy (`/inkoms-academy`) * **Contenido**: Guías, cursos y módulos de finanzas personales e inversiones, organizados por nivel. ### Comunidad (`/comunidad`) * **Propósito**: Foro y grupos temáticos donde los usuarios publican preguntas y experiencias sobre finanzas personales, deuda, ahorro e inversión. ### Preguntas Frecuentes (`/preguntas-frecuentes`) * **Secciones**: Seguridad de datos, proceso de verificación de identidad (KYC), comisiones de la plataforma, cómo registrarse como asesor y canales de soporte técnico. --- ## 4. Datos Institucionales y Contacto * **Sitio Web Oficial**: https://inkoms.com * **Redes Sociales**: - LinkedIn: https://www.linkedin.com/company/inkoms/ - Instagram: https://www.instagram.com/inkoms_oficial/ - Facebook: https://www.facebook.com/inkoms - Twitter/X: https://twitter.com/Inkoms_Oficial ### Plan personal de Victoria Dentro de /asistente-ia, Mi plan permite crear una propuesta opcional usando una copia de los totales financieros propios. El usuario revisa la evidencia, acepta una acción con fecha y reporta su resultado. Las propuestas usan reglas para completar información o revisar compromisos; no calculan dinero disponible, no verifican automáticamente el resultado y no envían recordatorios. Los planes requieren sesión y no son contenido público. ## 5. Navegación Pública Responsive El encabezado público mantiene los mismos enlaces indexables en desktop y mobile: Inicio (`/`), Marketplace (`/marketplace`), Asesores (`/directorio-asesores`), Comunidad (`/comunidad`), Victoria (`/asistente-ia`) y Ayuda (`/preguntas-frecuentes`). El menú mobile se puede cerrar con Escape y sus destinos no requieren sesión. La consola interna tiene sesión propia. Copilot y la atención de conversaciones externas se sirven en Admin; `/dashboard/operations/copilot` y `/asistente-ia/user/[id]` son puentes privados. Victoria personal permanece en `/asistente-ia`. Estas rutas de gestión no forman parte del contenido público indexable. Gestión interna (BI, Marketing, Comercial, Gestión Comercial y Operaciones) vive en https://admin.inkoms.com con sesión propia. Las rutas heredadas de /dashboard/bi, /dashboard/marketing, /dashboard/commercial-area, /dashboard/operations, /ops y /gestion-comercial son puentes privados y no se indexan. El home personal y el autoservicio de empresas y asesores siguen en Web.