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:
### 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
# 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)
- 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)
-
Actualizar PROYECTOS-PRIORITARIOS.md
- Agregar trading-platform como P2 o ajustar prioridad
-
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)
-
Crear DATABASE-SCHEMA.md en proyecto
- Diagrama ER de los 10 schemas
- 89 tablas documentadas
-
Consolidar arquitectura
- Merge ARQUITECTURA-GENERAL + ARQUITECTURA-UNIFICADA
6.4 Acciones de Purga
- 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
3c2d98707c