# Análisis de Gaps de Documentación: Workspace vs Proyecto

**Subtarea:** 1.3
**Fecha:** 2026-01-30
**Agente:** Claude Code (Opus 4.5)

---

## 1. RESUMEN EJECUTIVO

| Aspecto | Workspace docs/ | Proyecto docs/ | Gap |
|---------|-----------------|----------------|-----|
| Archivos totales | ~49 | ~284 | Proyecto mucho más completo |
| Menciones trading | 4 líneas | N/A (es su propia doc) | Sin documentación específica en workspace |
| Documento específico | NO existe | N/A | **FALTA PROYECTO-TRADING-PLATFORM.md** |

---

## 2. ESTADO EN WORKSPACE docs/

### 2.1 Documentación Actual (docs/60-proyectos/_INDEX.md)

Trading-platform aparece con **solo 4 líneas**:

```markdown
### trading-platform
- **Tipo:** Aplicación específica
- **Descripción:** Plataforma de trading
- **Ubicación:** `/projects/trading-platform`
```

### 2.2 Comparación con Otros Proyectos

| Proyecto | Documentación Específica | Nivel de Detalle |
|----------|-------------------------|------------------|
| local-llm-agent | PROYECTO-LOCAL-LLM-AGENT.md | Alto (puertos, backend, API) |
| erp-suite | PROYECTOS-ERP-SUITE.md | Alto (6 proyectos detallados) |
| template-saas | PROYECTOS-PRIORITARIOS.md | Medio |
| **trading-platform** | **NO EXISTE** | **Mínimo (4 líneas)** |

---

## 3. ESTADO EN PROYECTO docs/

### 3.1 Estructura Existente

```
trading-platform/docs/
├── 00-notas/                 # Notas y discrepancias
├── 00-vision-general/        # 4+ archivos (visión, arquitectura, stack)
├── 01-arquitectura/          # 10+ archivos (integraciones, diagramas)
├── 02-definicion-modulos/    # 9 OQIs con subcarpetas
│   ├── OQI-001-fundamentos-auth/
│   │   ├── README.md
│   │   ├── especificaciones/  (5 archivos ET-*)
│   │   ├── historias-usuario/ (12 archivos US-*)
│   │   └── requerimientos/    (5 archivos RF-*)
│   ├── OQI-002-education/     (similar estructura)
│   ├── OQI-003-trading-charts/(similar estructura)
│   └── ... (9 OQIs total)
├── 04-fase-backlog/          # Backlog futuro
├── 90-transversal/           # Temas cross-cutting
├── 95-guias-desarrollo/      # Guías prácticas
├── 97-adr/                   # Architecture Decision Records
└── 99-analisis/              # Análisis técnicos
```

### 3.2 Métricas de Documentación Local

| Tipo | Cantidad | Descripción |
|------|----------|-------------|
| READMEs de módulos | 9 | Uno por OQI |
| Especificaciones (ET-*) | ~40+ | Técnicas por módulo |
| Historias Usuario (US-*) | ~80+ | Por módulo |
| Requerimientos (RF-*) | ~50+ | Por módulo |
| ADRs | ~5+ | Decisiones arquitectónicas |
| Total estimado | ~284 | archivos markdown |

---

## 4. GAPS IDENTIFICADOS

### 4.1 Gaps a Nivel Workspace (P0-P1)

| ID | Documento Faltante | Ubicación Sugerida | Prioridad |
|----|-------------------|-------------------|-----------|
| DOC-001 | **PROYECTO-TRADING-PLATFORM.md** | docs/60-proyectos/ | **P0** |
| DOC-002 | Sección en PROYECTOS-PRIORITARIOS.md | docs/60-proyectos/ | P1 |
| DOC-003 | WEBSOCKET-PROTOCOL.md (general) | docs/10-arquitectura/ | P1 |
| DOC-004 | ML-INTEGRATION-PATTERN.md | docs/10-arquitectura/ | P2 |

### 4.2 Contenido Sugerido para PROYECTO-TRADING-PLATFORM.md

```markdown
# Trading Platform

## Descripción
Plataforma integral de trading con:
- Money Manager IA
- Educación trading
- Charts TradingView-style
- Cuentas de inversión PAMM

## Stack Tecnológico
- Backend: Express.js 5.0.1 (TypeScript)
- Frontend: React 18.2.0 + Vite
- ML: FastAPI + PyTorch + XGBoost
- Database: PostgreSQL 16+ (10 schemas)

## Módulos (9 OQIs)
| OQI | Nombre | Progreso |
|-----|--------|----------|
| 001 | Auth | 85% |
| 002 | Education | 55% |
| ... | ... | ... |

## Puertos
| Servicio | Puerto |
|----------|--------|
| Frontend | 3080 |
| Backend | 3081 |
| ML Engine | 3083 |
| ... | ... |

## Credenciales
- DB: trading_platform / trading_user / trading_dev_2026
- Redis DB: 1

## Referencias
- Documentación local: `/projects/trading-platform/docs/`
- Inventarios: `/projects/trading-platform/orchestration/inventarios/`
```

### 4.3 Gaps a Nivel Proyecto (P2-P3)

| ID | Documento Faltante | Ubicación Sugerida | Prioridad |
|----|-------------------|-------------------|-----------|
| DOC-005 | DATABASE-SCHEMA.md (diagrama ER) | docs/01-arquitectura/ | P2 |
| DOC-006 | FRONTEND-ARCHITECTURE.md | docs/01-arquitectura/ | P2 |
| DOC-007 | DEPLOYMENT.md | docs/95-guias-desarrollo/ | P2 |
| DOC-008 | TESTING-STRATEGY.md | docs/95-guias-desarrollo/ | P2 |
| DOC-009 | API-REFERENCE.md | docs/01-arquitectura/ | P3 |

---

## 5. DOCUMENTACIÓN PARA PURGA/CONSOLIDACIÓN

### 5.1 Documentación Potencialmente Obsoleta

| Archivo | Fecha | Razón | Acción |
|---------|-------|-------|--------|
| NOTA-DISCREPANCIA-PUERTOS-2025-12-08.md | 2025-12-08 | Puertos ya estandarizados | ARCHIVAR |
| Análisis antiguos en 99-analisis/ | Varios | Supersedidos | REVISAR |

### 5.2 Documentación Duplicada

| Archivo 1 | Archivo 2 | Acción |
|-----------|-----------|--------|
| ARQUITECTURA-GENERAL.md | ARQUITECTURA-UNIFICADA.md | CONSOLIDAR |
| Múltiples ET-TRD-* | Potencial overlap | REVISAR |

---

## 6. RECOMENDACIONES

### 6.1 Acciones Inmediatas (P0)

1. **Crear PROYECTO-TRADING-PLATFORM.md** en `docs/60-proyectos/`
   - Incluir: descripción, stack, módulos, puertos, credenciales
   - Referenciar documentación local del proyecto

### 6.2 Acciones de Corto Plazo (P1)

2. **Actualizar PROYECTOS-PRIORITARIOS.md**
   - Agregar trading-platform como P2 o ajustar prioridad

3. **Crear WEBSOCKET-PROTOCOL.md**
   - Documentar patrón de WebSocket usado en trading
   - Útil como referencia para otros proyectos

### 6.3 Acciones de Mediano Plazo (P2)

4. **Crear DATABASE-SCHEMA.md** en proyecto
   - Diagrama ER de los 10 schemas
   - 89 tablas documentadas

5. **Consolidar arquitectura**
   - Merge ARQUITECTURA-GENERAL + ARQUITECTURA-UNIFICADA

### 6.4 Acciones de Purga

6. **Archivar documentación obsoleta**
   - NOTA-DISCREPANCIA-PUERTOS-2025-12-08.md → _archive/

---

## 7. MATRIZ DE DOCUMENTACIÓN

### 7.1 Workspace vs Proyecto

| Carpeta Workspace | Equivalente Proyecto | Estado |
|-------------------|---------------------|--------|
| docs/00-vision-general/ | docs/00-vision-general/ | Proyecto más completo |
| docs/10-arquitectura/ | docs/01-arquitectura/ | Proyecto más completo |
| docs/30-directivas/ | orchestration/directivas/ | Ambos tienen |
| docs/40-estandares/ | N/A | Solo workspace |
| docs/50-requerimientos/ | docs/02-definicion-modulos/ | Proyecto más completo |
| docs/60-proyectos/ | N/A | **FALTA en workspace** |
| docs/90-adr/ | docs/97-adr/ | Ambos tienen |

### 7.2 Recomendación de SSOT

| Tipo de Doc | SSOT Recomendado | Razón |
|-------------|------------------|-------|
| Especificaciones técnicas | Proyecto | Más detallado |
| Historias de usuario | Proyecto | Específico del dominio |
| Arquitectura general | Workspace | Visión global |
| Estándares de código | Workspace | Aplica a todos |
| ADRs | Proyecto | Decisiones específicas |

---

## 8. CONCLUSIÓN

| Métrica | Valor |
|---------|-------|
| Documentación workspace sobre trading | **4 líneas** (insuficiente) |
| Documentación proyecto local | **~284 archivos** (completa) |
| Gap principal | **PROYECTO-TRADING-PLATFORM.md** faltante |
| Documentación para purga | ~2-5 archivos obsoletos |

**Próxima acción:** Crear PROYECTO-TRADING-PLATFORM.md en docs/60-proyectos/

---

**Subtarea completada:** 1.3 Auditar documentación workspace vs proyecto
**Estado:** COMPLETADA
**Siguiente:** 1.4 Análisis de purga - documentación y tareas obsoletas
