090fe5d278
Create comprehensive TypeScript type definitions for Trading Agents (Atlas, Orion, Nova) in the frontend. - Align with backend trading-agents.client.ts interfaces - Export AgentType, AgentStatus, BotStatus types - Define TradingBot, AgentMetrics, AgentPosition, AgentTrade interfaces - Include utility functions for status mapping and display names - Full JSDoc documentation for all types - Export from main types/index.ts Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
259 lines
6.9 KiB
Markdown
259 lines
6.9 KiB
Markdown
# 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*
|