trading-platform/orchestration/tareas/_archive/ARCHIVE-OPERATIONS-GUIDE.md

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)

#!/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

#!/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:

   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:

   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)

# 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