154 lines
4.4 KiB
Markdown
154 lines
4.4 KiB
Markdown
|
# VISION BUILDER
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
**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
|