Archive: System v4 - Estado al 2024-12-24

2025-12-24 17:28:34 +00:00
parent a92d41c846
commit 1b392803fd
81 changed files with 24560 additions and 0 deletions
--- a/v4-archive/vision-builder/README.md
+++ b/v4-archive/vision-builder/README.md
@@ -0,0 +1,153 @@
+# 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