# Guía de Operaciones de Archivado - Trading Platform

**Versión:** 1.0.0
**Creado:** 2026-01-27
**Estado:** DRAFT - Estructura creada, movimientos pendientes

---

## ESTADO ACTUAL

### Estructura Creada
```
✓ _archive/
  ✓ 2026-01/
    ✓ ARCHIVED-TASKS-INDEX.md      (20 tareas documentadas)
    ✓ ARCHIVE-METADATA.yml          (metadatos y estadísticas)
    ✓ (directorios vacíos listos para tareas)
```

### Pendiente
```
✗ Movimiento físico de directorios TASK-* a _archive/2026-01/
✗ Actualización de _INDEX.yml principal
✗ Validación post-movimiento
✗ Commits y push
```

---

## TAREAS LISTAS PARA ARCHIVAR (20 Total)

### 2026-01-25 (15 tareas)
```
1. TASK-2026-01-25-FRONTEND-ANALYSIS
2. TASK-2026-01-25-PHASE1-MVP
3. TASK-2026-01-25-NOTIFICACIONES-COMPLETAS
4. TASK-2026-01-25-ML-DATA-MIGRATION
5. TASK-2026-01-25-OQI-008-PORTFOLIO-MANAGER
6. TASK-2026-01-25-OQI-004-ACCOUNT-DETAIL
7. TASK-2026-01-25-OQI-003-TRADING-PANELS
8. TASK-2026-01-25-002-FRONTEND-COMPREHENSIVE-AUDIT
9. TASK-2026-01-25-FRONTEND-COMPONENTS-OQI-004-006-007
10. TASK-2026-01-25-OQI-003-TRADING-ADVANCED
11. TASK-2026-01-25-ML-TRAINING-ENHANCEMENT
12. TASK-2026-01-25-OQI-002-EDUCATION-ADVANCED
13. TASK-2026-01-25-OQI-004-INVESTMENT-ADVANCED
14. TASK-2026-01-25-FRONTEND-MODULE-DOCS
15. TASK-2026-01-25-OQI-005-PAYMENTS-ADVANCED
```

### 2026-01-26 (2 tareas)
```
16. TASK-2026-01-26-OQI-007-LLM-ASSISTANT-PANELS
17. TASK-2026-01-26-OQI-006-ML-UTILITY-PANELS
```

### 2026-01-27 (3 tareas)
```
18. TASK-2026-01-27-PLATFORM-VALIDATION
19. TASK-2026-01-27-BLOCKER-001-TOKEN-REFRESH
20. TASK-2026-01-27-E2E-VIDEO-UPLOAD
```

---

## TAREAS NO ARCHIVABLES

### En Progreso
- **TASK-2026-01-26-ANALYSIS-INTEGRATION-PLAN** (EN_PROGRESO)
  - Mantener en raíz hasta completar

### Sin estado claro
- **TASK-2026-01-27-MASTER-ANALYSIS-PLAN** (No en índice de completadas)
  - Revisar antes de archivado

---

## SCRIPT DE MOVIMIENTO (PENDIENTE EJECUCIÓN)

### Opción 1: Manual (recomendado para auditoria)
```bash
#!/bin/bash

ARCHIVE_DIR="/c/Empresas/ISEM/workspace-v2/projects/trading-platform/orchestration/tareas/_archive/2026-01"
TAREAS_DIR="/c/Empresas/ISEM/workspace-v2/projects/trading-platform/orchestration/tareas"

# Moverse al directorio de tareas
cd "$TAREAS_DIR"

# Lista de tareas a mover (enero 2026)
TAREAS_2025=(
  "TASK-2026-01-25-FRONTEND-ANALYSIS"
  "TASK-2026-01-25-PHASE1-MVP"
  "TASK-2026-01-25-NOTIFICACIONES-COMPLETAS"
  "TASK-2026-01-25-ML-DATA-MIGRATION"
  "TASK-2026-01-25-OQI-008-PORTFOLIO-MANAGER"
  "TASK-2026-01-25-OQI-004-ACCOUNT-DETAIL"
  "TASK-2026-01-25-OQI-003-TRADING-PANELS"
  "TASK-2026-01-25-002-FRONTEND-COMPREHENSIVE-AUDIT"
  "TASK-2026-01-25-FRONTEND-COMPONENTS-OQI-004-006-007"
  "TASK-2026-01-25-OQI-003-TRADING-ADVANCED"
  "TASK-2026-01-25-ML-TRAINING-ENHANCEMENT"
  "TASK-2026-01-25-OQI-002-EDUCATION-ADVANCED"
  "TASK-2026-01-25-OQI-004-INVESTMENT-ADVANCED"
  "TASK-2026-01-25-FRONTEND-MODULE-DOCS"
  "TASK-2026-01-25-OQI-005-PAYMENTS-ADVANCED"
)

TAREAS_2026=(
  "TASK-2026-01-26-OQI-007-LLM-ASSISTANT-PANELS"
  "TASK-2026-01-26-OQI-006-ML-UTILITY-PANELS"
  "TASK-2026-01-27-PLATFORM-VALIDATION"
  "TASK-2026-01-27-BLOCKER-001-TOKEN-REFRESH"
  "TASK-2026-01-27-E2E-VIDEO-UPLOAD"
)

# Mover tareas
for TAREA in "${TAREAS_2025[@]}" "${TAREAS_2026[@]}"; do
  if [ -d "$TAREA" ]; then
    echo "Moviendo: $TAREA"
    mv "$TAREA" "$ARCHIVE_DIR/"
  else
    echo "ADVERTENCIA: $TAREA no encontrada"
  fi
done

echo "✓ Movimiento completado"
```

### Opción 2: Validacion pre-movimiento
```bash
#!/bin/bash

# Validar que cada tarea existe y tiene archivos CAPVED

TAREAS=(
  "TASK-2026-01-25-FRONTEND-ANALYSIS"
  "TASK-2026-01-25-PHASE1-MVP"
  # ... resto
)

for TAREA in "${TAREAS[@]}"; do
  if [ -d "$TAREA" ]; then
    # Verificar METADATA.yml
    if [ -f "$TAREA/METADATA.yml" ]; then
      echo "✓ $TAREA: METADATA.yml presente"
    else
      echo "✗ $TAREA: FALTA METADATA.yml"
    fi
  else
    echo "✗ $TAREA: DIRECTORIO NO ENCONTRADO"
  fi
done
```

---

## ACTUALIZACIÓN DE _INDEX.yml

Después del movimiento, el _INDEX.yml debe:

1. **Mantener sección `por_fecha` histórica** (para referencia)
2. **Agregar sección `tareas_archivadas`**:
   ```yaml
   tareas_archivadas:
     2026-01:
       ubicacion: "_archive/2026-01/"
       total: 20
       primera_tarea: "TASK-2026-01-25-FRONTEND-ANALYSIS"
       ultima_tarea: "TASK-2026-01-27-E2E-VIDEO-UPLOAD"
       indice: "_archive/2026-01/ARCHIVED-TASKS-INDEX.md"
       metadata: "_archive/2026-01/ARCHIVE-METADATA.yml"
   ```

3. **Actualizar sección `resumen`**:
   ```yaml
   resumen:
     total_tareas: 21
     activas: 1        # Solo TASK-2026-01-26-ANALYSIS-INTEGRATION-PLAN
     completadas: 20
     archivadas: 20    # NUEVO
     en_progreso: 1
   ```

---

## PROCESO COMPLETO DE ARCHIVADO

### Fase 1: Validación (PRE-MOVIMIENTO)
- [ ] Verificar que todas las 20 tareas existen
- [ ] Validar que cada tarea tiene METADATA.yml
- [ ] Comprobar que archivos CAPVED están presentes
- [ ] Generar reporte de validación

### Fase 2: Movimiento (EJECUTAR)
- [ ] Ejecutar script de movimiento
- [ ] Verificar que directorios se movieron correctamente
- [ ] Comprobar que no hay huérfanos en raíz

### Fase 3: Actualización (POST-MOVIMIENTO)
- [ ] Actualizar _INDEX.yml con nueva estructura
- [ ] Actualizar referencias internas si las hay
- [ ] Verificar que rutas relativas no se rompieron
- [ ] Generar reporte post-movimiento

### Fase 4: Control de Versiones
- [ ] git add _archive/
- [ ] git add _INDEX.yml
- [ ] git commit -m "chore: Archive completed tasks 2026-01 (20 tasks)"
- [ ] git push origin main

---

## BENEFICIOS DEL ARCHIVADO

✓ **Mejor organización:** Directorio raíz más limpio
✓ **Rendimiento:** Menos directorios para buscar activos
✓ **Mantenibilidad:** Histórico claro separado
✓ **Auditoría:** Trazabilidad de tareas completadas
✓ **Escalabilidad:** Patrón reutilizable para otros meses

---

## RESTAURACIÓN (Si es necesario)

```bash
# Si necesitas restaurar una tarea archivada:
ARCHIVE_DIR="/c/Empresas/ISEM/workspace-v2/projects/trading-platform/orchestration/tareas/_archive/2026-01"
TAREAS_DIR="/c/Empresas/ISEM/workspace-v2/projects/trading-platform/orchestration/tareas"

mv "$ARCHIVE_DIR/TASK-NOMBRE" "$TAREAS_DIR/"
# Actualizar _INDEX.yml nuevamente
git add . && git commit -m "chore: Restore task TASK-NOMBRE"
```

---

## NOTAS IMPORTANTES

1. **Backup:** Los archivos originales se conservan en git
2. **Integridad:** No se pierden datos, solo reorganización
3. **Frecuencia:** Repetir mensualmente para cada nuevo mes
4. **Limpieza:** Mantener _archive estructurado por fecha
5. **Documentación:** Este guía es plantilla para futuras campañas

---

## CONTACTO Y ESCALACIONES

- **Dudas sobre estructura:** Ver `ARCHIVED-TASKS-INDEX.md`
- **Problemas técnicos:** Ver `ARCHIVE-METADATA.yml` (estadísticas)
- **Restauración:** Usar script en "Restauración" arriba
- **Auditoría:** Revisar commits históricos en git

---

*Creado por sistema SIMCO v4.0.0 - 2026-01-27*
*Listo para ejecutar cuando sea aprobado*
