# VISION BUILDER

![Estado](https://img.shields.io/badge/Estado-PLANIFICADO-yellow)


**Interfaz de Diseño de Vida - Ecosistema TZZR**

## Descripción

Vision Builder es la **interfaz principal** para crear y gestionar visiones personales que se transforman en acciones concretas. Conecta con THE FACTORY para refinar iterativamente cada visión hasta que sea coherente y accionable.

## Concepto

```
USUARIO DESCRIBE VISIÓN
        │
        ▼
THE FACTORY REFINA (3-5 iteraciones)
        │
        ▼
SE GENERAN MST (Milestones)
        │
        ▼
CADA MST TIENE ACCIONES + HÁBITOS
        │
        ▼
USUARIO VALIDA CON BCK (Evidencias)
```

## Tipos de Visión

| Tipo | Icono | Descripción | Ejemplo |
|------|-------|-------------|---------|
| fitness | 💪 | Transformación física | Perder peso, ganar músculo |
| career | 📈 | Desarrollo profesional | Ascenso, cambio de carrera |
| project | 🎯 | Proyecto específico | Lanzar MVP, escribir libro |
| habit | 🔄 | Crear/eliminar hábito | Meditar, dejar de fumar |
| learning | 📚 | Aprendizaje | Dominar Python, aprender idioma |
| finance | 💰 | Finanzas personales | Ahorrar, invertir |

## Acciones vs Hábitos

| Concepto | Frecuencia | Tracking | Ejemplo |
|----------|------------|----------|---------|
| **Acción** | Una vez | Completado/Pendiente | Comprar báscula |
| **Hábito** | Recurrente | Racha, % cumplimiento | Entrenar 5x/semana |

## Flujo Completo

```
1. VISIÓN: "Quiero transformar mi físico"
        │
        ▼
2. FACTORY REFINA:
   • Objetivo clarificado
   • Motivación articulada
   • Estado actual vs deseado
   • Obstáculos identificados
   • 3-5 Milestones con fechas
        │
        ▼
3. MST (Milestones):
   • Semana 1: Establecer hábitos base
   • Semana 4: Completar primer ciclo PPL
   • Semana 8: Revisar progreso
   • Semana 12: Evaluación final
        │
        ▼
4. ACCIONES + HÁBITOS:
   ACCIONES (únicas):        HÁBITOS (recurrentes):
   • Comprar báscula         • Entrenar 5x/semana
   • Apuntarse al gym        • Beber 2.5L agua/día
   • Configurar app          • Dormir 7+ horas
        │
        ▼
5. BCK (Evidencias):
   • Foto de progreso
   • Registro de entrenamiento
   • Screenshot de báscula
```

## Dimensiones de Evaluación

| Dimensión | Pregunta | Peso (fitness) |
|-----------|----------|----------------|
| clarity | ¿Se entiende? | 10% |
| coherence | ¿Las partes encajan? | 15% |
| completeness | ¿Está completa? | 10% |
| feasibility | ¿Es realizable? | 10% |
| actionability | ¿Se puede actuar? | 25% |
| motivation | ¿Inspira? | 25% |

## Schema SQL

```sql
deck_visiones (id, titulo, tipo, contenido_refinado, estado, progreso)
deck_milestones (id, vision_id, titulo, dia_relativo, criterio_exito)
deck_acciones (id, milestone_id, titulo, tipo, prioridad, estado)
deck_habitos (id, vision_id, titulo, frecuencia_tipo, racha_actual)
deck_habito_registros (id, habito_id, fecha, completado, valor)
deck_bck (id, vision_id, tipo, titulo, imagen_ref, datos)
```

## Estructura

```
vision-builder/
├── src/
│   ├── components/
│   │   ├── VisionBuilder.jsx      # Principal
│   │   ├── VisionCreator.jsx      # Formulario
│   │   ├── VisionDetail.jsx       # Vista detalle
│   │   ├── MilestoneCard.jsx      # Tarjeta MST
│   │   └── HabitTracker.jsx       # Tracker hábitos
│   ├── hooks/
│   │   ├── useVisions.js
│   │   └── useFactory.js
│   └── api/
│       └── visionApi.js
├── styles/
└── docs/
```

## Integración

```javascript
// ALFRED detecta "crear visión" → envía a FACTORY
const alfred = new Alfred();
const vision = await alfred.process("crear visión fitness", {
  title: "Transformación 2025",
  seed: "Quiero perder 10kg...",
  timeframe: 90
});
```

## Repositorios Relacionados

| Repo | Rol |
|------|-----|
| [deck](https://github.com/tzzrgit/deck) | Servidor que ejecuta Vision Builder |
| [the-factory](https://github.com/tzzrgit/the-factory) | Refina visiones |
| [contratos-comunes](https://github.com/tzzrgit/contratos-comunes) | Schema y componentes |
| [alfred](https://github.com/tzzrgit/alfred) | Orquestador |

## Roadmap

- [x] Concepto Vision → MST → Actions/Habits → BCK
- [x] UI component principal
- [x] Schema SQL
- [x] Integración FACTORY
- [ ] App móvil
- [ ] Notificaciones
- [ ] Templates de visión