📘 Manual del Founder — GLT v8.2 (Referencia Detallada)

1️⃣ Inicio (Home)

Qué ven: Su dashboard personal — TRS/TES, racha, "siguiente paso recomendado" (motor que sugiere la acción más relevante según su estado actual).

2️⃣ TRS / TES — Motor de Puntaje ⭐

Cómo funciona (TRS Engine v2.0):

Tracks (nivel real, según TRS)

• Track A / Entrepreneur — TRS < 60
• Track B / Builder — TRS ≥ 60 + TES ≥ 20
• Track C / Multiplier — umbral más alto

Nota interna: en pantalla se muestran como "Gold/Silver/Bronze/Starter" (sistema Tier) — es una capa visual sobre los mismos Tracks, pedida para que sea más intuitivo para la familia.

Cómo ajustas tú el TRS manualmente: Founder Control Center (el mecanismo correcto y verificado) o TRS Insights → Traits Editor (evalúa 29 traits de conducta, recalcula el TRS a partir de ellos — úsalo cuando quieras reflejar una evaluación real de carácter, no para pruebas).

3️⃣ Progreso / Metas / Misiones

Cómo funciona: Metas viven en dos tablas técnicas distintas (milestones y personal_goals) — esto es deuda técnica interna, no afecta lo que ven tus hijos, pero significa que aprobar una meta desde tu lado a veces requiere revisar ambos orígenes.

Auto-Metas por talento: se generan automáticamente (5 por talento, vía RPC), aparecen para que el beneficiario las trabaje.

4️⃣ Dream Fund

Cómo funciona: Solicitud → tú apruebas/rechazas desde Pending → Dream. No tiene reglas de puntaje automáticas — el impacto en TRS/TES depende de si la vinculas a una meta.

5️⃣ Acquisition Pipeline — Comprar Casa Propia 🏘️

Requisitos: TRS 60+, sin Compliance Flags críticos (severidad 4-5), sin deudas críticas, ingresos documentados.

Qué cubre el Trust: Down payment, closing costs (siempre), subsidio AFR, Gift Letter, Proof of Funds.

Los 6 pasos: Inicio → Documentos del Trust → Carta de Oferta → Pre-aprobación bancaria (2-4 sem) → Closing → Completado.

TRS/TES del proceso: Pre-aprobación +5 TES · Closing +20 TES · Pago a tiempo +2 TRS/mes · Pago tardío → Compliance Flag severidad 3.

Dos caminos

• Camino 1 (Trust Compra): título queda en el Trust, beneficiario paga hipoteca. TRS 60-99, ingresos <$60K.
• Camino 2 (Beneficiario Compra): dueño directo desde cierre. TRS 80+, ingresos >$60K.

Motor de Expansión: Casa 1 (Trust financia) → al mudarse, la renta entra al sub-trust → capital financia Casa 2 → ciclo se repite.

Factores que evalúa el sistema antes de aprobar: THS del Trust, Exposure, Liquidez (Buffer 150K-300K), 10% automático a Impact Fund, Compliance Flags del beneficiario.

6️⃣ Beneficios Adicionales 🎁

• Comidas/actividades familiares: TRS = monto×10% si el beneficiario paga; +5 TRS flat si organiza sin pagar; 0 TRS si paga el Trust directamente.
• Tareas del hogar: se registran en la app, tú apruebas, otorgan TRS.
• Dream Fund — límites anuales por Track: BASIC $1,200 · BRONZE $2,400 · SILVER $3,600 · GOLD $4,800. TRS: evidencia aprobada +8, completado +2 adicionales.
• Sub-Trust (nivel GOLD/150+ TRS, TES 100+): el beneficiario puede crear su propia rama del GLT con sus propias reglas.
• Motor 2: activación prevista 1 de septiembre de 2026 (cuando Tony inicia su retiro) — mayor voz/beneficios para TRS más altos.

7️⃣ OES — Ownership Equity System 🏡

Nota importante: OES es UNA de las dos alternativas de vivienda — la otra es home_acquisitions (comprar una casa propia con apoyo de down payment/mortgage, sin cap de ownership del 40%, porque la casa es del beneficiario, no del Trust). No las confundas al explicarle a un hijo cuál le conviene — depende de si quiere construir equity dentro de una propiedad del Trust o ser dueño directo de su propia casa.

El módulo más complejo y con más historial de esta sesión. Reglas clave:

• Equity = principal pagado × 0.60 (solo principal cuenta, no impuestos/seguro/interés)
• Cap: 40% de ownership por beneficiario por propiedad
• Excedente sobre el cap → CREDIT en familybank_transactions
• Propiedades tipo lote (AMARES, LAKSHMI) no tienen desglose de amortización — el monto propuesto ES el principal completo
• Propiedades tipo residencial (Casa Acworth) sí tienen desglose Principal/Interés/Impuestos/Seguro, proporcional al monto acordado

Dónde ves el historial completo: Ops → Score Log → pestaña "Pagos OES" (todos los pagos, todos los beneficiarios, con totales).

Registrar Pago Manual: puedes registrar pagos en nombre de un beneficiario (útil para retroactivos), incluyendo modo lote para varios meses de una vez, con selector de mes/año libre.

Crear Agreement Manual: puedes iniciar un agreement de residencia directamente para cualquier beneficiario sin que él lo solicite primero.

Vender Propiedad: módulo para calcular y ejecutar la distribución de equity si alguna vez vendes una propiedad del Trust — calcula automáticamente cuánto le toca a cada beneficiario según su % acumulado, y cuánto queda retenido en el Trust.

8️⃣ Comunidad / Buzón de Sugerencias 💡

Cómo funciona: Beneficiario envía idea (con categoría) → te llega en Pending → apruebas/rechazas con nota opcional → si apruebas, +2 TRS automático y notificación push al beneficiario.

Nota: solo las sugerencias de categoría "Mejora del App" se agregan automáticamente a tu checklist de QA — las demás (Familia, Educación, etc.) no, porque no son temas técnicos.

9️⃣ Módulo QA (solo para ti, Founder) 🧪

Qué es: Panel de pruebas técnicas — tests automatizados (corren con un botón) y tests manuales (checklist, incluyendo los que tú agregues). Útil para verificar que todo funcione después de cambios grandes en la app.

🔟 Ask Trust — NotebookLM 🤖

Qué es: El ícono "Ask Trust" (campana/robot, visible en casi todas las pantallas) conecta con NotebookLM de Google — una herramienta de IA que responde preguntas basándose en documentos fuente que tú le subes (reglas del Trust, estructura legal, TRS Engine, OES, etc.). Es una herramienta muy poderosa porque le da a tus hijos respuestas consistentes y basadas en la documentación real, sin que tengas que estar disponible para responder cada pregunta.

📱 Sobre el próximo build de Android e iOS

Antes de generar un build nuevo para distribuir a tus hijos, conviene:

1. Confirmar que todo el código pendiente esté commiteado (sin regresiones activas).
2. Correr el build de producción para ambas plataformas:

   cd ~/glt-mobile && eas build --platform all --profile production

3. Probar el build instalado (no solo vía Expo) antes de distribuirlo — el comportamiento puede diferir entre el entorno de desarrollo y el build compilado.

🔍 Qué es REAL vs. qué es SIMULACIÓN en el GLT hoy

El patrón general: la app es el libro contable oficial del Trust en casi todos los módulos financieros — los números son reales y quedan en el registro histórico — pero la ejecución física del dinero (transferencia bancaria, firma de documentos legales) siempre pasa por Tony, fuera de la app.

✅ REAL

🧪 SIMULACIÓN