system-docs/v4-archive/system-plan/IMPLEMENTATION_PLAN.md

# TZZR - Plan de Implementacion

**Fecha:** 2025-12-24
**Ultima actualizacion:** 2025-12-24
**Objetivo:** Llevar el ecosistema de 10% a 80% de funcionalidad

---

## RESUMEN DE FASES

| Fase | Objetivo | Estado | Repos Afectados |
|------|----------|--------|-----------------|
| 0 | Limpieza y consolidacion | COMPLETADA | architect, system, mind-link |
| 1 | Pipeline minimo viable | COMPLETADA | clara, deck |
| 2 | Procesamiento IA | BLOQUEADA | grace, penny, the-factory |
| 3 | Flujo empresarial | COMPLETADA | margaret, corp |
| 4 | Pipeline completo | PENDIENTE | mason, feldman, alfred, jared |
| 5 | Apps de usuario | PENDIENTE | packet, vision-builder |
| 6 | Observabilidad | PENDIENTE | sentinel |

---

## FASE 0: LIMPIEZA Y CONSOLIDACION - COMPLETADA

**Ejecutada:** 2025-12-24

### Acciones Completadas

| # | Accion | Estado |
|---|--------|--------|
| 0.1 | Eliminar carpetas obsoletas de architect | OK |
| 0.2 | Actualizar referencias a NocoDB -> Directus | OK |
| 0.3 | Anadir badges de estado a todos los repos | OK |
| 0.4 | Archivar mind-link | OK |

### Verificacion

- [x] No existen carpetas app-v2, orchestrator-* en architect
- [x] No hay referencias a NocoDB en documentacion activa
- [x] Todos los READMEs tienen badge de estado
- [x] mind-link archivado con README explicativo

---

## FASE 1: PIPELINE MINIMO VIABLE - COMPLETADA

**Ejecutada:** 2025-12-24

### Acciones Completadas

| # | Accion | Estado | Detalle |
|---|--------|--------|---------|
| 1.1 | Crear tabla clara_log en DECK | OK | PostgreSQL Docker |
| 1.2 | Generar h_instancia | OK | f25e44ac... |
| 1.3 | Desplegar CLARA Docker | OK | Puerto 5051 |
| 1.4 | Configurar red Docker | OK | tzzr-network |
| 1.5 | Probar ingesta | OK | Auth + duplicados |

### Configuracion Final

```
Servidor: DECK (72.62.1.113)
Puerto: 5051
DB: tzzr (PostgreSQL Docker)
Tabla: clara_log
R2 Bucket: deck
h_instancia: f25e44ac3c075f57b9a198c880cb1fc05cf3af56f6466828b405d8c062374179
```

### Verificacion

- [x] `curl http://72.62.1.113:5051/health` responde OK
- [x] Sin auth responde 401
- [x] Con auth valida responde 200
- [x] Duplicados responden 409
- [x] Registro aparece en clara_log

---

## FASE 2: PROCESAMIENTO IA - BLOQUEADA

**Bloqueador:** Requiere cuenta RunPod configurada

### Acciones Pendientes

| # | Accion | Estado |
|---|--------|--------|
| 2.1 | Crear template en RunPod | PENDIENTE |
| 2.2 | Configurar endpoint serverless | PENDIENTE |
| 2.3 | Probar modulo ASR_ENGINE | PENDIENTE |
| 2.4 | Probar modulo OCR_CORE | PENDIENTE |
| 2.5 | Documentar endpoint ID | PENDIENTE |

### Codigo Disponible

El repo `grace` contiene:
- handler.py con 6 modulos
- Dockerfile para RunPod
- requirements.txt

### Para Desbloquear

1. Crear cuenta RunPod
2. Subir template desde grace/runpod/
3. Crear endpoint serverless
4. Documentar ENDPOINT_ID en credentials

---

## FASE 3: FLUJO EMPRESARIAL - COMPLETADA

**Ejecutada:** 2025-12-24

### Acciones Completadas

| # | Accion | Estado | Detalle |
|---|--------|--------|---------|
| 3.1 | Verificar PostgreSQL en CORP | OK | Host PostgreSQL |
| 3.2 | Crear tabla margaret_log | OK | DB: corp |
| 3.3 | Generar h_instancia | OK | ea9e99d5... |
| 3.4 | Desplegar MARGARET Docker | OK | Puerto 5051 |
| 3.5 | Probar ingesta | OK | Auth + duplicados |

### Configuracion Final

```
Servidor: CORP (92.112.181.188)
Puerto: 5051
DB: corp (PostgreSQL Host)
Tabla: margaret_log
R2 Bucket: corp
h_instancia: ea9e99d5f95bcc23749d5f25b71a5b520ae7917438912fc6e29564534484a514
```

### Verificacion

- [x] `curl http://92.112.181.188:5051/health` responde OK
- [x] Sin auth responde 401
- [x] Con auth valida responde 200
- [x] Duplicados responden 409
- [x] Registro aparece en margaret_log

---

## FASE 4: PIPELINE COMPLETO - PENDIENTE

**Dependencia:** GRACE (FASE 2) para procesamiento IA

### ALFRED (Flujos Predefinidos DECK)

| # | Accion | Estado |
|---|--------|--------|
| 4.1 | Crear schema SQL flujos | PENDIENTE |
| 4.2 | Implementar API Flask | PENDIENTE |
| 4.3 | Integrar con CLARA | PENDIENTE |

**Nota:** ALFRED puede implementarse sin GRACE para flujos que no requieran IA.

### JARED (Flujos Predefinidos CORP)

| # | Accion | Estado |
|---|--------|--------|
| 4.4 | Fork de ALFRED | PENDIENTE |
| 4.5 | Adaptar para CORP | PENDIENTE |
| 4.6 | Integrar con MARGARET | PENDIENTE |

### MASON (Enriquecimiento)

| # | Accion | Estado |
|---|--------|--------|
| 4.7 | Crear schema SQL | BLOQUEADO (GRACE) |
| 4.8 | Implementar API Flask | BLOQUEADO (GRACE) |
| 4.9 | Integrar con GRACE | BLOQUEADO (GRACE) |

### FELDMAN (Consolidacion)

| # | Accion | Estado |
|---|--------|--------|
| 4.10 | Crear schema SQL | BLOQUEADO (MASON) |
| 4.11 | Implementar API Flask | BLOQUEADO (MASON) |
| 4.12 | Generar bloques 24h | BLOQUEADO (MASON) |

---

## FASE 5: APPS DE USUARIO - PENDIENTE

### PACKET

| # | Accion | Estado |
|---|--------|--------|
| 5.1 | Configurar firma Android | PENDIENTE |
| 5.2 | Build APK release | PENDIENTE |
| 5.3 | Publicar en Gitea releases | PENDIENTE |

### VISION BUILDER

| # | Accion | Estado |
|---|--------|--------|
| 5.4 | Implementar schema SQL | BLOQUEADO (FACTORY) |
| 5.5 | Crear API Flask | BLOQUEADO (FACTORY) |
| 5.6 | Integrar con THE FACTORY | BLOQUEADO (FACTORY) |

---

## FASE 6: OBSERVABILIDAD - PENDIENTE

### SENTINEL

| # | Accion | Estado |
|---|--------|--------|
| 6.1 | Crear schema SQL | PENDIENTE |
| 6.2 | Implementar hooks | PENDIENTE |
| 6.3 | Dashboard Grafana | PENDIENTE |
| 6.4 | Alertas ntfy | PENDIENTE |

---

## PROXIMO PASO RECOMENDADO

### Opcion A: Desbloquear GRACE (alto impacto)
1. Configurar cuenta RunPod
2. Desplegar GRACE
3. Habilita MASON, FELDMAN, THE FACTORY

### Opcion B: Implementar ALFRED/JARED (sin bloqueo)
1. Flujos predefinidos sin IA
2. Integrar con CLARA/MARGARET
3. Puede hacerse en paralelo

### Opcion C: Publicar PACKET (usuario final)
1. Build APK
2. Publicar en Gitea
3. Permite pruebas end-to-end

---

## SCRIPTS DE IMPLEMENTACION

Ver carpeta `/PHASES/` para scripts detallados.

---

*Plan actualizado automaticamente - 2025-12-24*