system-docs/v4-archive/deck/README.md

DECK

Servidor Personal del Ecosistema TZZR

Descripción

DECK es el servidor personal que gestiona la vida digital de un usuario. Incluye:

• Vision Builder: Crear visiones → milestones (MST) → acciones y hábitos → evidencias (BCK)
• Mind Link: Interfaz unificada de acceso a servicios
• ALFRED: Orquestador lite que decide cómo procesar cada petición
• Windmill: Automatización de workflows (alternativa a n8n)
• HST Tags: Etiquetado semántico personal

Arquitectura

┌──────────────────────────────────────────────────────────────────┐
│                           DECK                                    │
│                    (Servidor Personal)                           │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│   ┌─────────────┐  ┌─────────────┐  ┌─────────────┐            │
│   │   VISION    │  │    MIND     │  │   WINDMILL  │            │
│   │   BUILDER   │  │    LINK     │  │  (Workflows)│            │
│   └──────┬──────┘  └──────┬──────┘  └──────┬──────┘            │
│          │                │                │                    │
│          └────────────────┼────────────────┘                    │
│                           │                                      │
│                    ┌──────┴──────┐                              │
│                    │   ALFRED    │  ← Orquestador Lite          │
│                    │   (decide)  │                              │
│                    └──────┬──────┘                              │
│                           │                                      │
│   ┌───────────────────────┼───────────────────────┐            │
│   │           PostgreSQL + Directus                  │            │
│   │  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │            │
│   │  │Visiones│ │  MST   │ │Acciones│ │Hábitos │ │            │
│   │  └────────┘ └────────┘ └────────┘ └────────┘ │            │
│   └───────────────────────────────────────────────┘            │
│                           │                                      │
└───────────────────────────┼──────────────────────────────────────┘
                            │
            ┌───────────────┼───────────────┐
            ▼               ▼               ▼
      ┌──────────┐   ┌──────────┐   ┌──────────┐
      │  GRACE   │   │  PENNY   │   │ FACTORY  │
      │(process) │   │ (text)   │   │(iterate) │
      └──────────┘   └──────────┘   └──────────┘

Servidor

• IP: 72.62.1.113
• Dominio: tzzrdeck.me
• VPS: Hostinger (Ubuntu 22.04, 8GB RAM, 100GB SSD)
• SSH: ssh root@72.62.1.113 (password en credentials repo)

Servicios Docker (Actualizado 2025-12-22)

Servicio	Puerto	Estado	Función
PostgreSQL	5432	UP (healthy)	Base de datos principal
Directus	8055	UP	CMS/Admin (reemplaza al antiguo NocoDB)
Mailcow	8180 + mail ports	UP	Servidor de correo
FileBrowser	8082	UP (healthy)	Gestión de archivos
Shlink	8083	UP	Acortador de URLs
Vaultwarden	8085	UP (healthy)	Gestor de contraseñas
ntfy	8080	UP	Notificaciones push
Odoo	8069	UP	ERP
Redis	6379	UP	Cache (Mailcow)

Directus (Admin)

URL: http://72.62.1.113:8055
Email: admin@tzzr.me
Password: DirectusDeck2024!

Mailcow

URL: http://mail.tzzr.net
Puertos: 25 (SMTP), 465 (SMTPS), 587 (Submission), 143 (IMAP), 993 (IMAPS)
Admin: admin / moohoo (cambiar al primer login)
Ubicación: /opt/mailcow

Bases de Datos PostgreSQL

Base de datos	Uso
tzzr	BD principal (deck_*, tablas legacy)
directus	Directus CMS
shlink	URL shortener

Migraciones Completadas

NocoDB → Directus (2025-12-22)

• NocoDB eliminado completamente
• Directus instalado y operativo
• Datos preservados en PostgreSQL

DNS (tzzrdeck.me)

; tzzrdeck.me → 72.62.1.113
@               A       72.62.1.113
mail            A       72.62.1.113
directus        A       72.62.1.113
db              A       72.62.1.113
shlink          A       72.62.1.113
link            A       72.62.1.113
odoo            A       72.62.1.113
erp             A       72.62.1.113
vault           A       72.62.1.113
files           A       72.62.1.113
ntfy            A       72.62.1.113

; Mail
@               MX  10  mail.tzzrdeck.me.
@               TXT     "v=spf1 mx a ip4:72.62.1.113 -all"
_dmarc          TXT     "v=DMARC1; p=reject; rua=mailto:postmaster@tzzrdeck.me"
dkim._domainkey TXT     "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoF3v+ytuXDr7AVJ5aPkQC7EV95Nr8zjRRYxwgrYPGsNrDOcjG5/8iwJRvdporYxoMKOoeKWTVkOlnLBUMjhP5wdGtJY63jQDjs5bybtXyZpLC+3xbwTGRk4fGOodzkhRabkaz0HxZrp/5tGqjZEv77pfX7Jpm0qAmFC2wBoYRlXngp7Eno9k7jSrGDb1f/gCgWV5wWGr7J+ny0/gScSkitp2hwTB+tV5504T4hMajxkff1iQhFTAPHiUQHzNpiq3zF+yaOE1KfbtdLTIDYBvgTQsINa4qLNbQXVQfk30+CHO/rzAb1wOdByrRO+O7IXJ+OA2Reqz/jlPIOIj7o7B7QIDAQAB"
autodiscover    CNAME   mail.tzzrdeck.me.
autoconfig      CNAME   mail.tzzrdeck.me.

NOTA: Registros en "DNS only" (nube gris) para SSL automático.

Vision Builder

Sistema de construcción de visiones que se convierten en acciones:

VISIÓN → MST (Milestones) → ACCIONES + HÁBITOS → BCK (Evidencias)

Tipos de Visión

Tipo	Descripción	Ejemplo
fitness	Transformación física	Perder 10kg en 12 semanas
career	Desarrollo profesional	Conseguir ascenso
project	Proyecto específico	Lanzar MVP
habit	Crear hábito	Meditar diario
learning	Aprendizaje	Dominar Python
finance	Finanzas	Ahorrar €10k

Acciones vs Hábitos

Concepto	Descripción	Ejemplo
Acción	Tarea única	Comprar báscula
Hábito	Comportamiento recurrente	Entrenar 5x/semana

ALFRED (Orquestador)

ALFRED decide automáticamente qué servicio usar:

// Mapeo de intenciones
"resumir" → GRACE.SUMMARIZER
"transcribir" → GRACE.ASR_ENGINE
"generar plan" → PENNY
"crear imagen" → FACTORY

Tablas Principales

deck_visiones           -- Visiones del usuario
deck_milestones         -- MST: objetivos con fecha
deck_acciones           -- Tareas únicas
deck_habitos            -- Comportamientos recurrentes
deck_habito_registros   -- Tracking diario de hábitos
deck_bck                -- Bloques de evidencia
deck_emails             -- Correos sincronizados
deck_ia_solicitudes     -- Peticiones a GRACE/PENNY/FACTORY

Windmill Workflows

Automatizaciones predefinidas:

Workflow	Trigger	Acción
Training Completed	Webhook	Guarda entreno → Pide análisis a PENNY
Weekly Progress	Cron (Lunes 9:00)	Genera reporte semanal
Email Received	IMAP	Clasifica → Extrae tareas → Notifica
Habit Reminder	Cron	Envía recordatorio de hábitos pendientes

Instalación

1. Clonar y configurar

git clone https://github.com/tzzrgit/deck.git
cd deck
cp .env.example .env
# Editar .env con credenciales

2. Levantar servicios

docker-compose up -d

3. Aplicar schema

# Schema base
psql -U tzzr -d tzzr -f database/init-tzzr-v2.sql

# Vision Builder
psql -U tzzr -d tzzr -f database/vision-builder.sql

4. Configurar Windmill

# Windmill UI en http://localhost:8000
# Importar workflows desde /windmill/

Template Clonable

DECK puede clonarse para un nuevo usuario:

# Usar template
psql -U tzzr -d nuevo_usuario -f templates/deck-template.sql

# Reemplazar variables
sed -i 's/{{USER_NAME}}/Carlos/g' ...
sed -i 's/{{START_WEIGHT}}/85/g' ...

Conexión a Servicios IA

ALFRED construye S-CONTRACT v2.1 para cada petición:

{
  "contract_version": "2.1",
  "source": { "system": "DECK", "orchestrator": "ALFRED" },
  "target": { "service": "GRACE", "module": "SUMMARIZER" },
  "input": { "type": "text", "data": "..." },
  "limits": { "budget_usd": 0.1 }
}

Repositorios Relacionados

Repo	Descripción
contratos-comunes	S-CONTRACT, ALFRED, CLARA, schemas
grace	18 módulos de procesamiento IA
penny	Generación de texto
the-factory	Generación iterativa
vision-builder	UI de Vision Builder
mind-link	UI de conexión
locker	Almacenamiento

Roadmap

• Schema PostgreSQL v2
• Vision Builder schema
• ALFRED orquestador
• Windmill config
• Integración Mail-in-a-Box → deck_emails
• API REST para Mind Link
• Push notifications
• Sync con LOCKER