Ingedop Services¶
Bienvenido a la documentación técnica de Ingedop Services, una plataforma de microservicios para análisis de datos empresariales, detección de anomalías y predicción de demanda.
🎯 ¿Qué es Ingedop Services?¶
Ingedop Services es un conjunto de herramientas diseñadas para:
- Detectar anomalías en datos de producción y ventas usando Machine Learning
- Predecir demanda futura con algoritmos de forecasting avanzados
- Visualizar datos a través de dashboards interactivos
- Automatizar la sincronización de datos empresariales
🏗️ Arquitectura¶
┌─────────────────────────────────────────────────────────────────────────┐
│ Docker Network: anomalies_network │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────┐ ┌─────────────────────┐ ┌───────────────┐ │
│ │ anomalies_service │ │ streamlit_app │ │ update_cron │ │
│ │ (FastAPI) │◄───┤ (Streamlit) │ │ (Alpine) │ │
│ │ Puerto: 8000 │ │ Puerto: 8501 │ │ │ │
│ └──────────┬──────────┘ └─────────────────────┘ └───────┬───────┘ │
│ │ │ │
│ └──────────────────────────────────────────────────┘ │
│ │ │
│ ┌──────────────────────────┴─────────────────────┐ │
│ ▼ ▼ │
│ ┌─────────────────────┐ ┌─────────────────────┐ │
│ │ data_volume │ │ logs_volume │ │
│ │ /data/production/ │ │ /app/logs/ │ │
│ └─────────────────────┘ └─────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
📦 Servicios¶
-
Anomalies Service
API REST principal para detección de anomalías y forecasting.
-
Streamlit Apps
Dashboards interactivos para visualización y análisis.
-
CRON Service
Actualización automática de datos programada.
🛠️ Stack Tecnológico¶
| Componente | Tecnología |
|---|---|
| Backend API | FastAPI + Uvicorn |
| Frontend | Streamlit |
| ML/Data Science | Scikit-learn, Prophet, SHAP |
| Data Processing | Pandas, NumPy |
| Contenedores | Docker + Docker Compose |
| Programación | Python 3.11+ |
🚀 Inicio Rápido¶
# Clonar repositorio
git clone git@github.com:sciling/ingedop.git
cd ingedop/services
# Configurar variables de entorno
cp .env.example .env
# Levantar servicios
docker-compose up -d
# Acceder a los servicios
open http://217.72.207.42:8000/docs # API Documentation
open http://217.72.207.42:8501 # Dashboard Anomalías
📚 Navegación¶
- Guía de Inicio - Instalación y configuración
- Anomalies Service - API de detección y forecasting
- Streamlit Apps - Dashboards interactivos
- CRON Service - Actualización automática
- Desarrollo - Guía para contribuidores
🔗 Enlaces Útiles¶
- Repositorio GitHub
- Swagger UI (requiere servicio activo)