PROYECTO: CAUDALL PROMPT MAESTRO DE CONTINUIDAD VERSIÓN DE REFERENCIA: CAUDALL v2.0
Estoy desarrollando Caudall, una plataforma de salud financiera B2B2C con cuestionario adaptativo, un índice de salud financiera (CFHI), motores de inferencia y decisión, economía conductual, aprendizaje y un panel administrativo altamente parametrizable.
IMPORTANTE: Todo lo descrito a continuación YA FUE DISCUTIDO, DISEÑADO Y APROBADO durante la sesión de trabajo.
NO quiero que vuelvas a empezar la metodología. NO quiero que vuelvas a diseñar el banco de preguntas desde cero. NO quiero un mockup conceptual desconectado del producto real. NO simplifiques la arquitectura. NO elimines funcionalidades existentes. NO sustituyas silenciosamente decisiones ya aprobadas. NO declares algo terminado si solo existe en UI y todavía no modifica realmente el motor.
Tu tarea es tomar el proyecto actual de Caudall, inspeccionarlo cuidadosamente y CONTINUAR desde el estado real del proyecto, incorporando esta arquitectura completa especialmente en el Panel Administrativo y conectándola con el cuestionario/motor real.
==================================================
Caudall NO debe funcionar como:
cuestionario → suma de respuestas → score → recomendación genérica
Debe funcionar como:
EVIDENCIA → VARIABLES → CONSTRUCTOS → FINANCIAL STATE → CONFIDENCE / CONSISTENCY → CFHI → SAFETY → ROOT CAUSE → PRIORITY → ELIGIBILITY → FINANCIAL READINESS → BEHAVIORAL READINESS → NEXT BEST ACTION → BEHAVIORAL DESIGN → COMMITMENT → OUTCOME → LEARNING → NUEVO ESTADO
La unidad fundamental del sistema NO es la pregunta. La unidad fundamental es la VARIABLE. Las preguntas son instrumentos para obtener evidencia sobre variables.
==================================================
A. DIAGNÓSTICO
B. DECISIÓN
C. INTERVENCIÓN
D. APRENDIZAJE
==================================================
CONTROL Pregunta central: ¿Manejo sosteniblemente mis finanzas cotidianas?
RESILIENCIA Pregunta central: ¿Puedo absorber un shock financiero?
DEUDA Pregunta central: ¿Mis obligaciones son sostenibles?
AHORRO Pregunta central: ¿Acumulo recursos de forma sostenible?
Contexto, Behavioral y Readiness NO constituyen una sexta dimensión del CFHI.
Pesos globales iniciales: Control 20% Resiliencia 20% Deuda 20% Ahorro 20% Planificación 20%
IMPORTANTE: estos pesos son PROVISIONALES y PARAMETRIZABLES. No deben presentarse como científicamente validados todavía.
==================================================
CONTROL FINANCIERO Capacidad de la persona para mantener sus gastos y compromisos dentro de los recursos disponibles, comprender su flujo financiero y conservar margen suficiente para tomar decisiones sin depender recurrentemente de deuda o reservas.
Constructos: margen financiero, cumplimiento, estabilidad del flujo, visibilidad, capacidad de ajuste, uso del margen, causa del desequilibrio.
RESILIENCIA FINANCIERA Capacidad de absorber imprevistos o interrupciones temporales de ingresos sin comprometer necesidades esenciales, deteriorar significativamente objetivos financieros o recurrir a deuda problemática.
Constructos: cobertura de reserva, capacidad ante imprevistos, liquidez/accesibilidad, estabilidad de reserva, vulnerabilidad del ingreso, protecciones complementarias, dependencia externa.
DEUDA Capacidad de mantener las obligaciones financieras en un nivel sostenible, cumplirlas oportunamente y utilizarlas sin comprometer necesidades presentes, capacidad de ahorro, resiliencia u objetivos.
Constructos: aplicabilidad, capacidad de pago, presión, atrasos, rollover, dependencia de nueva deuda, costo, estructura, trayectoria y driver.
AHORRO Capacidad y comportamiento de acumular recursos de manera recurrente y sostenible para fortalecer la posición financiera y financiar necesidades u objetivos futuros.
Constructos: frecuencia, capacidad, consistencia, intensidad, sistematicidad, intencionalidad, persistencia y barreras.
PLANIFICACIÓN Capacidad de transformar aspiraciones financieras en objetivos suficientemente definidos, acciones viables y mecanismos de seguimiento que permitan avanzar y ajustar el rumbo.
Constructos: existencia de objetivos, prioridad, especificidad, cuantificación, horizonte, plan de acción, ejecución, seguimiento, progreso y ajuste.
==================================================
El scoring NO suma preguntas directamente. Debe seguir: Respuesta → Evidence → Variable → Constructo → Dimensión → CFHI
Mecanismo de conversión (Variable → Constructo → Dimensión → CFHI): Cada opción de respuesta de una pregunta de tipo SCORE trae su propio puntaje (0-100), asignado por quien diseña el contenido según qué tan saludable es esa elección — no una fórmula derivada del enum. Ese puntaje viaja con la Evidence hasta el VariableState. Una variable de contexto o de gating (ej. DEBT_APPLICABILITY) no trae puntaje: solo abre o cierra ramas, nunca puntúa. Constructo, Dimensión y CFHI se calculan los tres con la misma función: promedio ponderado de sus entradas, excluyendo cualquiera sin dato o en N/A. Cuando una entrada queda excluida, su peso no se pierde ni se reparte con una fórmula aparte: el promedio se recalcula solo sobre el peso de lo que sí quedó, así que la redistribución es automáticamente proporcional (mismo mecanismo que excluye a Deuda N/A del CFHI, sección 12). Nunca hay una entrada tratada como 0 ni como 100 por estar ausente o no aplicar. La Confidence de un Constructo/Dimensión es el promedio simple de la confidence de sus entradas directas — no se pondera por el mismo peso que el score, es una señal aparte de “cuánta evidencia hay”, no de “qué tan bien le va”.
Constructos iniciales:
CONTROL CTRL_MARGIN 45% CTRL_COMPLIANCE 35% CTRL_STABILITY 20%
RESILIENCIA RES_COVERAGE_CONSTRUCT 45% RES_SHOCK_CONSTRUCT 35% RES_EFFECTIVENESS 20%
DEUDA DEBT_PAYMENT_CONSTRUCT 45% DEBT_PRESSURE_CONSTRUCT 35% DEBT_STRESS_CONSTRUCT 20%
AHORRO SAV_FREQUENCY_CONSTRUCT 40% SAV_CONSISTENCY_CONSTRUCT 35% SAV_SUSTAINABILITY 25%
PLANIFICACIÓN PLAN_DIRECTION 20% PLAN_DEFINITION 20% PLAN_ACTION_CONSTRUCT 25% PLAN_EXECUTION_CONSTRUCT 25% PLAN_MONITORING 10%
Todos los pesos internos deben quedar parametrizables.
==================================================
Toda evidencia que afecte scoring debe tener un PRIMARY OWNER. Una misma evidencia puede informar otras dimensiones, pero NO puede penalizar varias veces el CFHI.
Ejemplo: DEBT_ARREARS → PRIMARY OWNER = DEBT_STRESS Puede informar CTRL_PAYMENT_STRESS y FINANCIAL_STRESS, pero esos efectos secundarios NO vuelven a penalizar independientemente el CFHI.
==================================================
Cada respuesta o dato debe crear un Evidence Object con, como mínimo: EVIDENCE_ID SOURCE QUESTION_ID si aplica ANSWER_ID si aplica VALUE TIMESTAMP PERIOD RELIABILITY / PROVENANCE
Ejemplo: SOURCE = QUESTION QUESTION_ID = CTRL-01 VALUE = EXPENSES_GT_INCOME RELIABILITY = DIRECT
Luego: Evidence → CTRL_CASHFLOW = NEGATIVE
Necesitamos trazabilidad completa. El Admin debe poder explicar POR QUÉ Caudall cree algo.
==================================================
Formalizar: DIRECT STRONG_INFERENCE WEAK_INFERENCE
Cada valor almacena VALUE + SOURCE + CONFIDENCE.
Regla inicial: una STRONG_INFERENCE puede sustituir una pregunta cuando confidence >= threshold. Threshold inicial global: 80%, parametrizable.
Una WEAK_INFERENCE puede afectar routing o valor informativo, pero NO sustituye una pregunta.
==================================================
Debe existir FORBIDDEN_INFERENCE.
Ejemplos: RES_COVERAGE = STRONG NO permite inferir SAV_FREQUENCY = REGULAR. RES_DEPENDENCY = CREDIT NO permite inferir DEBT_APPLICABILITY = YES.
El Admin debe permitir visualizar estas relaciones prohibidas.
==================================================
CTRL_CASHFLOW CTRL_PAYMENT CTRL_STABILITY CTRL_VISIBILITY CTRL_ADJUSTMENT CTRL_MARGIN_USE CTRL_DRIVER CTRL_DEPENDENCY CTRL_STATE CTRL_CONFIDENCE
Estados relevantes: CTRL_CASHFLOW = HIGH / POSITIVE / EVEN / NEGATIVE / CRITICAL CTRL_PAYMENT = ALWAYS / OFTEN / SOMETIMES / RARELY / NEVER CTRL_STABILITY = STABLE / MOSTLY_STABLE / VARIABLE / HIGHLY_VARIABLE CTRL_VISIBILITY = CLEAR / PARTIAL / LOW / UNKNOWN CTRL_ADJUSTMENT = HIGH / MODERATE / LOW / NONE CTRL_MARGIN_USE = PLANNED / MIXED / SPENT / UNCLEAR CTRL_DRIVER = INCOME_GAP / SPENDING / DEBT_LOAD / VARIABLE_INCOME / ONE_OFF_EVENT / DEPENDENT_SUPPORT / UNKNOWN CTRL_DEPENDENCY = CREDIT / SAVINGS_DRAWDOWN / FAMILY_SUPPORT / PAYMENT_DEFERRAL / NONE CTRL_STATE = MET / PARTIAL / UNMET / CRITICAL
Score de Control ≠ Confidence de Control.
==================================================
RES_COVERAGE RES_SHOCK_CAPACITY RES_LIQUIDITY RES_STABILITY RES_INCOME_VULNERABILITY RES_PROTECTION RES_DEPENDENCY RES_DRIVER RES_STATE RES_CONFIDENCE
Estados: RES_COVERAGE = VERY_LOW / LOW / PARTIAL / GOOD / STRONG RES_SHOCK_CAPACITY = FULL / MOSTLY / PARTIAL / DEBT_REQUIRED / UNABLE RES_LIQUIDITY = FULLY_LIQUID / MOSTLY_LIQUID / PARTIALLY_LIQUID / RESTRICTED / UNKNOWN RES_STABILITY = STABLE / OCCASIONAL_USE / RECURRENT_USE / DEPLETING RES_INCOME_VULNERABILITY = LOW / MODERATE / HIGH / VERY_HIGH RES_DEPENDENCY = NONE / CREDIT / NEW_DEBT / FAMILY_SUPPORT / DEFER_PAYMENTS / SELL_ASSETS / UNKNOWN RES_DRIVER = LOW_SAVING_CAPACITY / RECENT_SHOCK / CASHFLOW_DEFICIT / RESERVE_DRAWDOWN / DEBT_BURDEN / INCOME_VOLATILITY / LOW_SAVING_HABIT / EARLY_BUILDING_STAGE / UNKNOWN RES_STATE = MET / PARTIAL / UNMET / CRITICAL
Regla central: RESILIENCIA ≠ AHORRO. Stock/cobertura acumulada pertenece a Resiliencia. Flujo/hábito de ahorro pertenece a Ahorro.
==================================================
DEBT_APPLICABILITY DEBT_PAYMENT_CAPACITY DEBT_PRESSURE DEBT_ARREARS DEBT_ROLLOVER DEBT_ESSENTIAL_DEPENDENCY DEBT_COST_AWARENESS DEBT_STRUCTURE DEBT_TRAJECTORY DEBT_DRIVER DEBT_STATE DEBT_CONFIDENCE
DEBT_APPLICABILITY = NONE / APPLICABLE / UNKNOWN
Si DEBT_APPLICABILITY = NONE: DEBT_STATE = N/A DEBT_CONFIDENCE ≈ 100% STOP de toda la rama.
NO preguntar capacidad de pago, presión, atrasos, rollover, tasas, estructura, trayectoria, dificultad o preocupación de deuda. NO ofrecer salir de deudas, refinanciar, consolidar o priorizar deuda.
Debt N/A NO equivale a Debt score = 100. Debe excluirse del denominador del CFHI y redistribuir proporcionalmente pesos entre dimensiones aplicables.
DEBT_PAYMENT_CAPACITY = COMFORTABLE / MANAGEABLE / TIGHT / DIFFICULT / UNMANAGEABLE DEBT_PRESSURE = NONE / LOW / MODERATE / HIGH / SEVERE DEBT_ARREARS = NONE / ONE_TIME / RECURRENT / CURRENT DEBT_ROLLOVER = NONE / ONE_TIME / OCCASIONAL / RECURRENT DEBT_ESSENTIAL_DEPENDENCY = NONE / OCCASIONAL / RECURRENT DEBT_TRAJECTORY = DECREASING / STABLE / INCREASING_PLANNED / INCREASING_UNPLANNED / UNKNOWN DEBT_DRIVER = PAYMENT_BURDEN / HIGH_COST / INCOME_GAP / INCOME_SHOCK / OVERSPENDING / EMERGENCY / ROLLOVER_CYCLE / MULTIPLE_OBLIGATIONS / ONE_OFF_EVENT / UNKNOWN DEBT_STATE = N/A / MET / PARTIAL / UNMET / CRITICAL
DEBT_STRESS consolida DEBT_ARREARS + DEBT_ROLLOVER + DEBT_TRAJECTORY. No sumarlos mecánicamente como castigos independientes.
==================================================
SAV_FREQUENCY SAV_CONSISTENCY SAV_CAPACITY SAV_INTENSITY SAV_SYSTEM SAV_PURPOSE SAV_PERSISTENCE SAV_BARRIER SAV_STAGE SAV_STATE SAV_CONFIDENCE
SAV_FREQUENCY = NEVER / RARELY / SOMETIMES / MOST_MONTHS / EVERY_MONTH SAV_CAPACITY = NONE / CONSTRAINED / LIMITED / AVAILABLE / STRONG / UNKNOWN SAV_CONSISTENCY = STABLE / MOSTLY_STABLE / INTERRUPTED / IRREGULAR / NONE SAV_SYSTEM = AUTOMATED / PLANNED_MANUAL / AD_HOC / NONE SAV_PURPOSE = EMERGENCY / SPECIFIC_GOAL / GENERAL_FUTURE / MULTIPLE / NO_DEFINED_PURPOSE SAV_PERSISTENCE = MAINTAINED / REDUCED / PAUSED / REVERSED SAV_BARRIER = INCOME_INSUFFICIENT / INCOME_VARIABLE / UNEXPECTED_EXPENSES / SPENDING / NO_SYSTEM / NO_PRIORITY / NO_GOAL / DEBT_PRESSURE / BEHAVIORAL_FRICTION / OTHER / UNKNOWN SAV_STAGE = CONSTRAINED / NOT_STARTED / INTENDING / STARTED / REPEATING / SYSTEMATIC / MAINTAINING SAV_STATE = MET / PARTIAL / UNMET / CONSTRAINED
AUTOMATED ≠ automáticamente mejor score. NO PUEDE AHORRAR ≠ PUEDE AHORRAR PERO NO LO HACE. Constraint vs Behavior debe ser una distinción formal.
==================================================
PLAN_GOAL_EXISTENCE PLAN_GOAL_PRIORITY PLAN_SPECIFICITY PLAN_AMOUNT PLAN_HORIZON PLAN_ACTION PLAN_EXECUTION PLAN_PROGRESS PLAN_TRACKING PLAN_ADJUSTMENT PLAN_STAGE PLAN_STATE PLAN_CONFIDENCE
PLAN_STAGE = NO_DIRECTION / ASPIRATION / GOAL_DEFINED / PLAN_DEFINED / READY_TO_ACT / STARTED / REPEATING / TRACKING / MAINTAINING
REGLA OBLIGATORIA: Si PLAN_EXECUTION indica que la persona YA comenzó, NO mostrar preguntas como “¿Qué te impide comenzar?”. Si no existe objetivo, NO preguntar monto, fecha, aportes, seguimiento o progreso hasta que corresponda.
Mantener separados: USER_GOAL SYSTEM_PRIORITY ACTION_ELIGIBILITY
Ejemplo: USER_GOAL = HOME SYSTEM_PRIORITY = DEBT HOME_ELIGIBILITY_NOW = LOW
No borrar el objetivo; conservar aspiración y ajustar secuencia.
==================================================
Cada usuario debe terminar representado por un estado vivo:
CONTROL: score / state / confidence / driver RESILIENCE: score / state / confidence / driver DEBT: applicability / score si aplica / state / confidence / driver SAVING: score / state / confidence / stage / barrier PLANNING: score / state / confidence / stage USER_GOAL SYSTEM_PRIORITY ROOT_CAUSE SAFETY_FLAGS ELIGIBILITY FIN_READINESS BEH_READINESS
Objetivo, prioridad y causa raíz son cosas diferentes.
==================================================
Contexto NO entra directamente al CFHI.
CTX_INCOME_PATTERN CTX_PAY_FREQUENCY CTX_DEPENDENTS CTX_EMPLOYMENT_STABILITY CTX_UPCOMING_EVENT CTX_DATA_SOURCE CTX_LIFE_STAGE
Ingresos variables + ahorro irregular NO significa automáticamente mala conducta de ahorro. Puede significar SAV_BARRIER = INCOME_VARIABLE.
==================================================
BEH_FINANCIAL_STRESS BEH_SELF_EFFICACY BEH_INTENTION BEH_FRICTION CAPACITY_PERCEIVED BEH_TRIGGER BEH_COMMITMENT BEH_FEEDBACK
BEH_FRICTION puede contener: COMPLEXITY TOO_MANY_CHOICES FORGETTING PROCRASTINATION UNCERTAINTY LOW_PRIORITY EMOTIONAL_AVOIDANCE LACK_OF_SYSTEM NO_CLEAR_TRIGGER NONE UNKNOWN
==================================================
NO mezclarlas.
FINANCIAL READINESS considera FIN_CAPACITY, SAFETY_CLEARANCE, ACTION_ELIGIBILITY y RESOURCE_AVAILABILITY. Estados: NOT_ELIGIBLE / CONSTRAINED / ELIGIBLE / STRONG
BEHAVIORAL READINESS considera SELF_EFFICACY, INTENTION, FRICTION, BEHAVIOR_STAGE y PERCEIVED_CAPACITY. Estados: LOW / MODERATE / HIGH
FIN_READINESS + BEH_READINESS → ACTION DESIGN
ELIGIBILITY = ¿Conviene hacer esta acción? READINESS = ¿Está preparado para hacerla ahora?
==================================================
Safety es independiente del score.
DEBT_ARREARS = CURRENT → DEBT_PAYMENT_STRESS DEBT_ROLLOVER = RECURRENT → DEBT_CYCLE_RISK DEBT_ESSENTIAL_DEPENDENCY = RECURRENT → CASHFLOW_CREDIT_DEPENDENCY DEBT_STATE = CRITICAL → CRITICAL_DEBT
Safety puede bloquear temporalmente INVEST, ACCELERATE_SECONDARY_GOAL, AGGRESSIVE_SAVING, NEW_FINANCIAL_COMMITMENT. Puede hacer override temporal sobre Priority. Safety NO modifica necesariamente el score.
==================================================
A. USER CONTRADICTION “No tengo deuda” + “Tengo pagos de deuda vencidos” → CLARIFY
B. APPARENT ANOMALY Reserva 6+ meses + no puede cubrir imprevisto → investigar liquidez/accesibilidad.
C. ENGINE QA ERROR DEBT_APPLICABILITY = NONE + el sistema pregunta tasa de deuda → NO preguntar al usuario; registrar QA FAILURE.
==================================================
Score ≠ Confidence. Cada variable, constructo y dimensión puede tener confidence. Initial skip threshold = 80%, parametrizable.
==================================================
El banco adaptativo de preguntas YA EXISTE y YA FUE TRABAJADO/AUDITADO. NO LO REHAGAS DESDE CERO.
Principio central: Caudall pregunta únicamente aquello que puede mejorar materialmente la siguiente decisión.
Cada pregunta debe tener: QUESTION_ID DIMENSION VARIABLE_TARGET CONSTRUCT_TARGET ASK_IF SKIP_IF / DO_NOT_ASK_IF BASE_PRIORITY INFORMATION_VALUE SAFETY_VALUE SCORING_VALUE ROUTING_VALUE UNCERTAINTY_REDUCTION BURDEN INFERENCE_SUBSTITUTION_ALLOWED MIN_CONFIDENCE_TO_SKIP VERSION STATUS
Conceptualmente: NBQ = Information Value + Decision Impact + Uncertainty Reduction - Redundancy - User Burden
==================================================
Debe ser amplio y personalizado. No construir árboles rígidos; construir un grafo. Referencia de Ahorro:
¿Ahorra regularmente? → NO: ¿hay capacidad? → no hay margen / sí hay margen → control / hábito → A VECES: ¿qué rompe la constancia? → ingreso variable / gastos / imprevistos → SÍ: ¿cómo está estructurado? → objetivo definido / sistemático / madurez
Una pregunta puede informar más de una dimensión.
==================================================
STOP cuando:
Target 8–12 preguntas Soft max 15 Hard max 18 Parametrizable globalmente y por cliente.
==================================================
No seleccionar simplemente la dimensión con score más bajo. Ejemplo: Income gap → Cashflow deficit → No saving → Low reserve. Aunque Ahorro tenga score menor, Root Cause puede ser Control.
Formalizar SOURCE_VARIABLE / TARGET_VARIABLE / RELATION / STRENGTH / CONDITIONS / CONFIDENCE. Cada estado puede declarar DRIVER_OF y CAUSED_BY.
==================================================
Orden conceptual:
Root Cause ≠ Priority necesariamente. Safety puede hacer override temporal. No congelar todavía coeficientes matemáticos definitivos.
==================================================
Separar USER_GOAL / SYSTEM_PRIORITY / ACTION_ELIGIBILITY. Nunca borrar una aspiración solo porque no sea accionable ahora.
==================================================
Principio: FRICTION → TECHNIQUE, nunca al revés.
PROCRASTINATION → Implementation intention FORGETTING → Stable trigger / reminder TOO_MANY_CHOICES → Choice reduction COMPLEXITY → Microaction LOW_SELF_EFFICACY → Small wins REPEATING_BEHAVIOR → Habit formation DISTANT_GOAL → Goal gradient NO_CLEAR_MOMENT → Trigger HIGH_INTENTION_NO_EXECUTION → Commitment WEAK_TRACKING → Feedback FRESH_START_OPPORTUNITY → Fresh start NO_SYSTEM → Default / automation
Técnicas exploradas: implementation intentions, commitment devices, defaults, choice architecture, choice reduction, salience, reminders, stable triggers, habit formation, feedback, goal gradient, fresh start effect, mental accounting, present bias, loss aversion, friction costs, small wins, microactions, simplification, precommitment, automation.
==================================================
MICRO / STANDARD / ACCELERATED Si una acción es demasiado difícil, NO cambiar arbitrariamente la prioridad.
==================================================
ACTION AMOUNT FREQUENCY TRIGGER DATE si aplica DURATION TARGET_VARIABLE TARGET_DIMENSION BEHAVIORAL_TECHNIQUE STATUS
Un solo trigger principal por compromiso.
==================================================
COMPLETED / PARTIALLY_COMPLETED / NOT_COMPLETED / SKIPPED / UNKNOWN Capturar WHY. Ejemplo: NOT_COMPLETED + TOO_DIFFICULT puede reducir preferred_action_size y actualizar self_efficacy/friction probability.
Ciclo: Diagnóstico → Acción → Compromiso → Conducta observada → Aprendizaje → Nuevo estado → Next Best Action.
==================================================
==================================================
FINANCIAL HEALTH / FINANCIAL WELL-BEING
FINANCIAL CAPABILITY
BEHAVIORAL ECONOMICS / BEHAVIORAL SCIENCE
STAGES / READINESS / BEHAVIOR CHANGE
ADAPTIVE ASSESSMENT
PSYCHOMETRICS / SCORING En fase posterior validar confiabilidad, consistencia interna, discriminación de ítems, estabilidad de constructos, pesos, bandas, correlación con outcomes, validez convergente/discriminante y desempeño adaptativo. Por eso: pesos actuales = PROVISIONAL; thresholds = parametrizables; Admin compara Draft vs Published; Analytics mide information value; no afirmar todavía que CFHI está psicométricamente validado.
ROOT CAUSE / SYSTEMS THINKING No tratar síntomas de forma aislada.
HUMAN-CENTERED / LOW-FRICTION UX
Estas referencias son sustento/benchmark, NO sustituyen la arquitectura Caudall v2.0.
==================================================
PLATFORM DEFAULT → CLIENT CONFIGURATION → SEGMENT CONFIGURATION → USER STATE
🔒 CORE: Primary Owner, anti-double-counting, provenance, safety crítica, consistency crítica, reglas N/A, protección del motor. ⚙️ PARAMETRIZABLE: pesos permitidos, thresholds, número objetivo de preguntas, catálogo de objetivos, intervenciones habilitadas, copy, segmentación. 🎨 BRAND: logo, colores, tipografía, claim, imágenes, tono.
==================================================
El logo visible al usuario debe ser el logo cargado en Admin para ese cliente. El background debe poder adaptarse al fondo/colores del logo, con override manual. Admin: logo principal, logo alternativo/negativo, claim, colores, fondos, tipografía, imágenes, textos, co-branding.
==================================================
Versiones separadas: Methodology, Question Bank, Scoring, Behavioral Rules, Client Config. Cada evaluación guarda METHODOLOGY_VERSION_USED. Nada se modifica directamente en producción. Flujo: PUBLISHED → CREATE DRAFT → EDIT → SIMULATE → VALIDATE → COMPARE → PUBLISH. Debe existir rollback.
==================================================
==================================================
| Caudall Core v2.0 | Cliente [Global ▼] | Segmento [Todos ▼] | Estado [Draft / Published] | [Simular] | [Publicar] |
==================================================
Portada ejecutiva con clientes activos, usuarios evaluados, CFHI promedio, acciones completadas, preguntas activas, intervenciones activas, reglas activas y estado del motor/QA.
==================================================
Mostrar 5 dimensiones, ~15 constructos, 50+ variables, versión publicada, scoring válido, variables huérfanas, conflictos CORE, dependencias válidas. Tabs: Dimensiones / Constructos / Variables / Scoring / Dependencias / Versiones.
==================================================
Tarjetas para CONTROL / RESILIENCIA / DEUDA / AHORRO / PLANIFICACIÓN. Cada tarjeta: nombre, pregunta central, peso CFHI, constructos, variables, estado, Administrar.
==================================================
Cada constructo: definición, peso, variables/evidencias, Primary Owner, método de agregación, confidence, scoring rule.
==================================================
Filtros por dimensión, tipo, función y estado. Funciones: Score / Diagnostic / Routing / Safety / Root Cause / Behavioral / Derived. Cada variable: VARIABLE_ID, NAME, DIMENSION, CONSTRUCT, VARIABLE_TYPE, ALLOWED_VALUES, PRIMARY_OWNER, SCORING_ROLE, SOURCE_TYPES, INFERENCE_IN, INFERENCE_OUT, CONFIDENCE_RULE, ROUTING_RULE, SAFETY_ROLE, ROOT_CAUSE_ROLE, ELIGIBILITY_ROLE, BEHAVIORAL_ROLE, CONSISTENCY_RULES, VERSION, STATUS.
==================================================
Añadir donde sea razonable. Si hay datos, mostrar efecto de cambios en preguntas promedio, inferencias, confidence, clientes y segmentos. Si no hay datos, decir que no está disponible; no inventar.
==================================================
Mostrar pesos 20/20/20/20/20, total 100%, tratamiento N/A redistribuido, etiqueta “Pesos provisionales — pendientes de validación empírica”, simulador Draft vs Published.
==================================================
Filtros: Causales / Inferencias / Prohibidas. Relación: SOURCE / TARGET / RELATION / STRENGTH / INFERENCE TYPE / CONFIDENCE / CONDITIONS / CAN SUBSTITUTE QUESTION? / VERSION / STATUS.
==================================================
NO rediseñar el banco desde cero. Permitir ver banco por dimensión, navegar árbol/grafo, editar pregunta/opciones/scoring owner/ASK_IF/SKIP_IF/inferencias/candidatas/stop condition/estado/versionar/simular.
==================================================
Ejemplo DEBT-01 → “No tengo deudas”: DEBT_APPLICABILITY = NONE DEBT_STATE = N/A DEBT_CONFIDENCE = 100% EXCLUDE preguntas de deuda EXCLUDE intervenciones de deuda CFHI aplica regla N/A
==================================================
Ver en tiempo real: Pregunta → Respuesta → Evidence → Variable → Confidence → Inferencias → Constructo → Score → Financial State → Consistency → Safety → Root Cause → Priority → Eligibility → Financial Readiness → Behavioral Readiness → Intervention → Behavioral Technique → Commitment. También preguntas omitidas y por qué.
==================================================
PERSONA 1 — SIN DEUDA: Debt = N/A, no preguntas posteriores de deuda, no objetivo salir de deuda. PERSONA 2 — DÉFICIT CRÍTICO: no inversión, no ahorro agresivo, prioridad upstream correcta. PERSONA 3 — ALTA SALUD FINANCIERA: no preguntas innecesarias. PERSONA 4 — RESPUESTAS CONTRADICTORIAS: Consistency / Clarification. PERSONA 5 — INGRESOS VARIABLES: no tratar variabilidad automáticamente como mala conducta. PERSONA 6 — YA INICIÓ PLAN: no preguntar qué le impide comenzar. PERSONA 7 — RESERVA SUFICIENTE: no ofrecer crear reserva. PERSONA 8 — AHORRO EXISTE PERO RESERVA BAJA: distinguir hábito de ahorro de resiliencia.
Si prueba crítica falla: BLOQUEAR PUBLICACIÓN.
==================================================
Verificar pesos = 100%, variables SCORE con constructo, evidencia scoring con Primary Owner, no double counting, no inferencias circulares, N/A consistente, Safety con consecuencias, no preguntas huérfanas, no ramas imposibles, Stop Rules alcanzables, no intervenciones inaccesibles, no violaciones CORE, dependencias válidas, versiones consistentes.
==================================================
Ejemplo: Methodology 2.0 Question Bank 2.0.4 Scoring 2.0.1 Behavioral Rules 2.1 Client Config BANCO_X_14
Flujo: PRODUCTION → CREATE DRAFT → EDIT → SIMULATE → VALIDATE → QA → APPROVE → PUBLISH. Debe existir rollback.
==================================================
PLATFORM OWNER: todo. METHODOLOGIST: metodología, variables, constructos, scoring, preguntas, inferencias. PRODUCT ADMIN: UX, contenido, clientes, intervenciones. ANALYST: Analytics, simulador, QA. CLIENT ADMIN: solo tenant autorizado. VIEWER: solo lectura.
==================================================
Diagnósticos iniciados/completados, completion rate, tiempo promedio, número promedio de preguntas, CFHI, scores por dimensión, drop-off por pregunta, tiempo de respuesta, information value, intervenciones, compromisos, acciones completadas, outcomes. Por pregunta: veces mostrada, abandono después, tiempo medio, cambio de decisión, valor informativo, confidence gain.
==================================================
Preparar arquitectura futura para CRM, Payroll, core bancario, AFP, Open Banking, HRIS y APIs. Si Caudall ya posee un dato confiable proveniente de integración, NO volver a preguntárselo al usuario. Toda fuente guarda provenance/confidence.
==================================================
Toda la experiencia en español. Metodología técnica NO se muestra al usuario. Economía conductual opera detrás. Pantalla de acción: qué hacer, cuánto si aplica, por qué, siguiente clic. Mantener “¿Por qué este paso?” con explicación simple y personalizada. No mostrar códigos técnicos, nombres internos de etapas, triggers internos, técnicas conductuales ni logs metodológicos.
==================================================
El CFHI puede mantenerse internamente. Admin permite mostrar score global: Sí / No / Por cliente. Puede ser más útil mostrar estados por dimensión en vez de depender solo de un número.
==================================================
El proyecto ya ha tenido problemas importantes de navegación en iPhone 17. NO romper correcciones existentes. Probar Desktop, Surface/tablet, iPhone/Safari. Especial atención a Comenzar, Panel administrativo, opciones, Continuar, sliders, selectors, scroll, sticky CTA, overlays, z-index, pointer-events, touch targets, safe-area, viewport, barra de progreso, cards, textos largos, inputs y admin tabs. No crear contenedores estrechos artificialmente. Las preguntas deben usar el ancho útil del dispositivo. La barra de progreso debe avanzar realmente con el journey adaptativo. No asumir que abrir un HTML desde Archivos iOS equivale a probar una web real. La versión web debe funcionar por HTTPS en Safari.
==================================================
==================================================
Una funcionalidad está terminada SOLO cuando:
==================================================
Ya se trabajó previamente:
NO regreses a rehacer esas etapas salvo contradicción concreta con el código real.
==================================================
ESPECIFICACIÓN MAESTRA CAUDALL v2.0 ↓ METODOLOGÍA ↓ VARIABLES + CONSTRUCTOS ↓ BANCO ADAPTATIVO EXISTENTE ↓ MOTORES ↓ PANEL ADMINISTRATIVO ↓ EXPERIENCIA DE USUARIO
Si encuentras contradicción entre implementación y especificación:
==================================================
PRIMERO: Inspecciona cuidadosamente el proyecto actual antes de modificar nada.
Identifica:
NO empieces de cero.
DESPUÉS: Crea un PLAN DE IMPLEMENTACIÓN POR FASES basado en el código real.
FASE 1 Modelos de datos + compatibilidad + Evidence / Variables / Constructs / Primary Owner.
FASE 2 Admin → Metodología completo.
FASE 3 Motor adaptativo conectado al banco existente.
FASE 4 Decision Engine: Safety + Root Cause + Priority + Eligibility.
FASE 5 Financial Readiness + Behavioral Readiness + Interventions + Behavioral Engine.
FASE 6 Simulator + Explainability + QA.
FASE 7 Multi-tenant + governance + publishing/versioning.
FASE 8 Analytics + Learning.
Después del plan: COMIENZA LA IMPLEMENTACIÓN REAL.
Antes de cada cambio estructural importante:
Después de cada fase:
NO declares algo terminado si solo existe la interfaz y todavía no afecta realmente al motor. NO vuelvas a diseñar la metodología. NO vuelvas a construir el banco desde cero. CONTINÚA DESDE EL ESTADO ACTUAL DEL PROYECTO.