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>
216 lines
5.4 KiB
Markdown
216 lines
5.4 KiB
Markdown
# Estructura de Archivado - Trading Platform
|
|
|
|
**Ubicación:** `projects/trading-platform/orchestration/tareas/_archive/`
|
|
**Propósito:** Almacenar y organizar tareas completadas por período
|
|
**Estado:** ESTRUCTURA OPERATIVA (desde 2026-01-27)
|
|
|
|
---
|
|
|
|
## DESCRIPCIÓN
|
|
|
|
Este directorio contiene el sistema de archivado de tareas completadas en trading-platform, organizadas por período mensual. La estructura facilita:
|
|
|
|
- Acceso histórico rápido a tareas completadas
|
|
- Auditoría y trazabilidad de entregas
|
|
- Limpieza del directorio principal de tareas
|
|
- Organización escalable para múltiples meses
|
|
|
|
---
|
|
|
|
## ESTRUCTURA
|
|
|
|
```
|
|
_archive/
|
|
├── README.md ← Este archivo
|
|
├── ARCHIVE-OPERATIONS-GUIDE.md ← Instrucciones de operación
|
|
├── ARCHIVED-TASKS-INDEX.md ← Índice de todas las tareas
|
|
│
|
|
└── 2026-01/ ← Carpeta por período (YYYY-MM)
|
|
├── ARCHIVE-METADATA.yml ← Metadatos del período
|
|
├── TASK-2026-01-25-*/ ← Tareas completadas 25 de enero
|
|
├── TASK-2026-01-26-*/ ← Tareas completadas 26 de enero
|
|
└── TASK-2026-01-27-*/ ← Tareas completadas 27 de enero
|
|
│
|
|
└── 2026-02/ ← Próximo período
|
|
├── ARCHIVE-METADATA.yml
|
|
└── TASK-2026-02-*/
|
|
```
|
|
|
|
---
|
|
|
|
## ARCHIVOS PRINCIPALES
|
|
|
|
### 1. README.md (Este archivo)
|
|
- Descripción general de la estructura
|
|
- Guía de uso rápido
|
|
- Referencias a documentos clave
|
|
|
|
### 2. ARCHIVE-OPERATIONS-GUIDE.md
|
|
- Instrucciones detalladas de movimiento
|
|
- Scripts de validación y operación
|
|
- Procedimiento post-archivado
|
|
- Instrucciones de restauración
|
|
|
|
### 3. ARCHIVED-TASKS-INDEX.md
|
|
- Listado completo de las 20 tareas archivadas en 2026-01
|
|
- Detalles de cada tarea (tipo, módulo, entregables)
|
|
- Estadísticas agregadas
|
|
- Próximos pasos documentados
|
|
|
|
### 4. 2026-01/ARCHIVE-METADATA.yml
|
|
- Metadatos del período 2026-01
|
|
- Distribución por tipo de tarea
|
|
- Módulos afectados
|
|
- Estadísticas técnicas (LOC, tests, etc.)
|
|
|
|
---
|
|
|
|
## ESTADO ACTUAL (2026-01-27)
|
|
|
|
```
|
|
Estructura: ✓ CREADA
|
|
Índices: ✓ DOCUMENTADOS
|
|
Metadatos: ✓ GENERADOS
|
|
Directorios: ✓ PREPARADOS
|
|
Movimientos: ⏳ PENDIENTE
|
|
Commits: ⏳ PENDIENTE
|
|
```
|
|
|
|
### Archivos Creados Hoy
|
|
- `_archive/README.md` (Este archivo)
|
|
- `_archive/ARCHIVE-OPERATIONS-GUIDE.md`
|
|
- `_archive/ARCHIVED-TASKS-INDEX.md`
|
|
- `_archive/2026-01/ARCHIVE-METADATA.yml`
|
|
- `_archive/2026-01/` (directorio vacío listo para tareas)
|
|
|
|
### Próximos Pasos
|
|
1. Validar integridad de tareas (Fase 1 de ARCHIVE-OPERATIONS-GUIDE)
|
|
2. Ejecutar movimiento de archivos (Fase 2)
|
|
3. Actualizar _INDEX.yml (Fase 3)
|
|
4. Hacer commit y push (Fase 4)
|
|
|
|
---
|
|
|
|
## TAREAS ARCHIVADAS EN 2026-01
|
|
|
|
**Total:** 20 tareas completadas
|
|
|
|
- **2026-01-25:** 15 tareas
|
|
- **2026-01-26:** 2 tareas
|
|
- **2026-01-27:** 3 tareas
|
|
|
|
### Distribución por Tipo
|
|
- **FEATURE:** 10 tareas (50%)
|
|
- **ANALYSIS:** 3 tareas (15%)
|
|
- **TESTING:** 1 tarea (5%)
|
|
- **REFACTOR:** 1 tarea (5%)
|
|
- **VALIDATION:** 1 tarea (5%)
|
|
|
|
### Módulos Cubiertos
|
|
- OQI-001: fundamentos-auth
|
|
- OQI-002: educativo
|
|
- OQI-003: trading-charts
|
|
- OQI-004: cuentas-inversion
|
|
- OQI-005: pagos-stripe
|
|
- OQI-006: senales-ml
|
|
- OQI-007: llm-strategy-agent
|
|
- OQI-008: portfolio-manager
|
|
|
|
---
|
|
|
|
## CÓMO USAR ESTE ARCHIVO
|
|
|
|
### Acceder a índice completo
|
|
```bash
|
|
cat ARCHIVED-TASKS-INDEX.md
|
|
```
|
|
|
|
### Buscar tarea específica
|
|
```bash
|
|
grep -r "TASK-2026-01-25-FRONTEND-ANALYSIS" .
|
|
```
|
|
|
|
### Ver estadísticas del período
|
|
```bash
|
|
cat 2026-01/ARCHIVE-METADATA.yml
|
|
```
|
|
|
|
### Restaurar una tarea
|
|
```bash
|
|
# Ver ARCHIVE-OPERATIONS-GUIDE.md sección "Restauración"
|
|
```
|
|
|
|
### Crear nuevo período
|
|
```bash
|
|
mkdir -p 2026-02
|
|
cp 2026-01/ARCHIVE-METADATA.yml 2026-02/
|
|
# Editar ARCHIVE-METADATA.yml para nuevo período
|
|
```
|
|
|
|
---
|
|
|
|
## CONVENCIONES
|
|
|
|
### Nombres de Directorio
|
|
```
|
|
_archive/
|
|
└── YYYY-MM/ (Período mensual)
|
|
└── TASK-YYYY-MM-DD-NAME/ (Tarea individual)
|
|
```
|
|
|
|
### Archivos de Índice
|
|
- Nivel archivo: `ARCHIVED-TASKS-INDEX.md` (todas las tareas)
|
|
- Nivel período: `YYYY-MM/ARCHIVE-METADATA.yml` (estadísticas período)
|
|
|
|
### Control de Versiones
|
|
```bash
|
|
git add _archive/
|
|
git commit -m "chore: Archive completed tasks YYYY-MM (N tasks)"
|
|
```
|
|
|
|
---
|
|
|
|
## INFORMACIÓN DE REFERENCIA
|
|
|
|
**Proyecto:** trading-platform
|
|
**Sistema:** SIMCO v4.0.0
|
|
**Tipo:** STANDALONE
|
|
**Crear por:** Automatización SIMCO (Regla 7: Gobernanza de Documentación)
|
|
|
|
---
|
|
|
|
## REFERENCIAS RELACIONADAS
|
|
|
|
- `../TASK-*/METADATA.yml` - Metadatos individuales de tareas
|
|
- `../_INDEX.yml` - Índice principal (actualizar post-archivado)
|
|
- `../../_definitions/` - Definiciones de procesos SIMCO
|
|
- `../../directivas/triggers/TRIGGER-CIERRE-TAREA-OBLIGATORIO.md` - Requisitos de cierre
|
|
|
|
---
|
|
|
|
## CONTACTO Y AYUDA
|
|
|
|
**Dudas sobre:**
|
|
- **Estructura:** Ver sección "ESTRUCTURA" arriba
|
|
- **Operación:** Ver `ARCHIVE-OPERATIONS-GUIDE.md`
|
|
- **Detalles de tareas:** Ver `ARCHIVED-TASKS-INDEX.md`
|
|
- **Restauración:** Ver `ARCHIVE-OPERATIONS-GUIDE.md` → "Restauración"
|
|
|
|
---
|
|
|
|
## HISTORIAL DE CAMBIOS
|
|
|
|
| Fecha | Cambio | Autor |
|
|
|-------|--------|-------|
|
|
| 2026-01-27 | Estructura inicial creada | SIMCO Automation |
|
|
| 2026-01-27 | Índices generados | SIMCO Automation |
|
|
| 2026-01-27 | Metadatos compilados | SIMCO Automation |
|
|
| PENDIENTE | Movimiento de archivos | Manual/Script |
|
|
| PENDIENTE | Commit y push | Manual |
|
|
|
|
---
|
|
|
|
*Archivado creado por sistema SIMCO v4.0.0*
|
|
*Última actualización: 2026-01-27*
|
|
*Estado: Listo para operación*
|