Files
system-docs/v4-archive/vision-builder/README.md
2025-12-24 17:28:34 +00:00

154 lines
4.4 KiB
Markdown

# 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