docs: FODA + ROADMAP analysis

FODA.md

@@ -0,0 +1,39 @@
+# FODA - CocosBot
+
+*Análisis: 22 de febrero 2026*
+
+## 💪 Fortalezas
+
+- **Arquitectura modular**: Separación clara entre core, services, utils y config
+- **Tests completos**: 169 tests con 59% coverage global
+- **Documentación**: README excelente con ejemplos, troubleshooting y guías
+- **PyPI publicado**: Instalable via `pip install CocosBot`
+- **Artículo en Medium**: Marketing content que trae usuarios
+- **2FA automatizado**: Solución elegante con Gmail API
+- **Script discovery**: Herramienta para encontrar nuevos endpoints cuando Cocos cambia
+- **CI configurado**: GitHub Actions con tests en Python 3.11
+
+## ⚠️ Debilidades
+
+- **Coverage 59%**: Por debajo del target de 80% mencionado en roadmap
+- **Dependencia Gmail obligatoria**: No hay alternativa para 2FA manual
+- **Sin CLI**: Todo requiere escribir código Python
+- **Sin exportación de datos**: No hay forma fácil de sacar históricos a CSV/Excel
+- **Selectores CSS hardcodeados**: Vulnerables a cambios de UI
+
+## 🚀 Oportunidades
+
+- **CLI para operaciones rápidas**: `cocos portfolio`, `cocos buy AL30 100`
+- **Integración con trading bots**: Señales automáticas, stop-loss
+- **Histórico de operaciones**: Exportar a CSV para análisis fiscal
+- **Dashboard web simple**: Ver portfolio sin abrir Python
+- **Multi-broker**: Adaptar arquitectura para IOL, Balanz, etc.
+- **Rate limiting inteligente**: Evitar bloqueos proactivamente
+
+## 🔥 Amenazas
+
+- **Cocos cambia endpoints**: Ya pasó una vez (por eso existe discover_endpoints.py)
+- **Términos de servicio**: Cocos podría bloquear automatización
+- **Playwright updates**: Breaking changes en browser automation
+- **Seguridad de credenciales**: Usuarios guardan mal las keys
+- **Gmail depreca app passwords**: Requeriría nueva solución 2FA

ROADMAP.md

@@ -0,0 +1,74 @@
+# ROADMAP - CocosBot
+
+*Actualizado: 22 de febrero 2026*
+
+## ✅ Completado
+
+- [x] Arquitectura modular con servicios especializados
+- [x] Autenticación con 2FA automático via Gmail
+- [x] Operaciones de mercado (compra, venta, órdenes)
+- [x] Consulta de portfolio y balance
+- [x] Tests unitarios básicos
+- [x] Publicación en PyPI
+- [x] Script de discovery de endpoints
+- [x] CI/CD básico con GitHub Actions
+- [x] Artículo en Medium
+
+## 🎯 Próximos pasos (v1.1)
+
+### Alta prioridad
+
+- [ ] **Aumentar coverage a 80%**
+  - Tests de integración para auth flow
+  - Mocks más completos para market service
+  - Edge cases en validators
+
+- [ ] **CLI básico**
+  ```bash
+  cocos login
+  cocos portfolio
+  cocos balance
+  cocos buy GGAL 10
+  cocos sell AL30 5 --limit 50000
+  ```
+
+### Media prioridad
+
+- [ ] **Exportar histórico de operaciones**
+  - CSV con todas las operaciones
+  - Formato compatible con Excel
+  - Filtros por fecha/ticker
+
+- [ ] **2FA alternativo**
+  - Input manual de código cuando Gmail no disponible
+  - Opción de guardar sesión (con warning de seguridad)
+
+### Baja prioridad
+
+- [ ] **Rate limiting inteligente**
+  - Detectar patrones de throttling
+  - Backoff exponencial automático
+  - Logs de requests para debug
+
+## 🔮 Futuro (v2.0)
+
+- [ ] Soporte multi-broker (IOL, Balanz, Bull Market)
+- [ ] Alertas de precio via Telegram/webhook
+- [ ] Backtesting de estrategias
+- [ ] Dashboard web standalone
+- [ ] API REST wrapper local
+
+## 📊 Métricas objetivo
+
+| Métrica | Actual | Target |
+|---------|--------|--------|
+| Test coverage | 59% | 80% |
+| Tests | 169 | 200+ |
+| Documentación | ✅ | ✅ |
+| PyPI downloads/mes | ? | Monitorear |
+
+## 🏷️ Versiones
+
+- **v1.0**: Release actual (PyPI)
+- **v1.1**: CLI + coverage 80%
+- **v2.0**: Multi-broker + alertas