diff --git a/FODA.md b/FODA.md new file mode 100644 index 0000000..ea01875 --- /dev/null +++ b/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 diff --git a/ROADMAP.md b/ROADMAP.md new file mode 100644 index 0000000..fb7b959 --- /dev/null +++ b/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