Technical documentation
Stack tecnológico
5.1 Versiones fijas (IMPORTANTE — no actualizar sin consenso)
Los tres frontends deben usar estas versiones exactas.
react-diff-viewer-continued(usado en el EOE Flow Designer) solo soporta React ≤18. Cualquier upgrade debe validarse end-to-end en los tres frontends.
| Tecnología | Versión fija | Motivo del pin |
|---|---|---|
react / react-dom | ^18.3.x — NO 19.x | Compatibilidad con react-diff-viewer-continued |
vite | ^5.x — NO 6, 7, 8 | No validado por el equipo |
typescript | ~5.8.x — NO 6.x | No validado por el equipo |
tailwindcss | ^3.4.x — NO 4.x | v4 cambió toda la API de configuración |
@vitejs/plugin-react | ^4.x | Alineado con Vite 5 |
5.2 Stack por capa
| Capa | Tecnología | Versión | Propósito |
|---|---|---|---|
| Frontend NOC | React + TypeScript + Vite + Tailwind 3 + ECharts 5 + ReactFlow 11 | 18.3 / 5.8 / 5 | Panel de operaciones NOC |
| Frontend Admin | React + TypeScript + Vite + Tailwind 3 + Recharts | 18.2 / 5.2 / 5 | Panel SaaS de billing |
| Frontend EOE | React + TypeScript + Vite + Tailwind 3 + Monaco Editor | 18.3 / 5.8 / 5 | Flow Designer visual |
| Backend API | FastAPI 0.136 + SQLAlchemy async 2.0 + Alembic 1.18 | Python 3.12 | REST API + WebSocket |
| Workers | Celery 5.6 + Redis (broker) | — | 12 tareas periódicas |
| Pipeline | aiokafka 0.14 + Confluent Kafka 7.5 | — | 4 consumers en secuencia |
| Orquestación | Temporal.io + FastAPI | — | Workflows de automatización |
| DB Relacional | PostgreSQL 15 | — | Fuente de verdad OLTP |
| Cache / Broker | Redis 7 | — | Cache + Celery broker |
| Graph DB | Neo4j 5 | — | Topología de infraestructura |
| Search | OpenSearch 2.12 | — | Logs + eventos full-text |
| Object Store | MinIO | — | Artefactos, secretos EOE |
| ML | scikit-learn 1.8 + XGBoost 3.2 + Polars 1.40 | Python 3.12 | Anomalías, RCA, patrones |
| LLM | OpenAI SDK 2.36 + Ollama 0.6 | — | Multi-proveedor: Ollama/OpenAI/Anthropic/Azure |
| Observabilidad | Prometheus-client 0.25 + OpenTelemetry | — | Métricas y trazas internas |
| Contenedores | Docker Compose (24 servicios) | — | Orquestación local y producción |
| CI/CD | GitLab CI | — | Validación y deploy automático |
5.3 Dependencias Python principales (backend)
fastapi==0.136.1 # Web framework
uvicorn==0.46.0 # ASGI server
sqlalchemy==2.0.49 # ORM async
asyncpg==0.31.0 # PostgreSQL driver async
alembic==1.18.4 # Migraciones de esquema
pyjwt==2.12.1 # JWT
passlib[bcrypt]==1.7.4 # Hashing de contraseñas
redis==6.4.0 # Cache + Celery broker
celery==5.6.3 # Task queue
scikit-learn==1.8.0 # Anomaly detection, RCA
xgboost==3.2.0 # RCA prediction
polars==1.40.1 # Pattern detection (fast DataFrames)
opensearch-py==3.2.0 # Search engine client
aiokafka==0.14.0 # Kafka async consumer/producer
cryptography==48.0.0 # Fernet para credenciales datasources
networkx==3.6.1 # Análisis de grafos de topología
openai==2.36.0 # LLM client