Skip to content

J4t1x/superset-analytics

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📊 Apache Superset Analytics

🎯 Descripción del Proyecto

Proyecto de análisis de datos y visualización utilizando Apache Superset 5.0.0, una plataforma moderna de código abierto para exploración de datos, creación de dashboards interactivos y análisis sin código.

🌟 ¿Qué es Apache Superset?

Apache Superset es una plataforma de Business Intelligence y visualización de datos que permite:

  • 📈 Crear dashboards interactivos sin código
  • 💻 Ejecutar consultas SQL avanzadas con un editor web potente
  • 🎨 Más de 40 tipos de visualizaciones (gráficos, mapas, tablas, etc.)
  • 🔌 Conectar a múltiples fuentes de datos (PostgreSQL, MySQL, BigQuery, Snowflake, etc.)
  • 🚀 Arquitectura cloud-native escalable
  • 🔐 Control de acceso granular y seguridad avanzada

📁 Estructura del Proyecto

superset-analytics/
├── README.md                    # Este archivo
├── docs/                        # Documentación completa
│   ├── README.md               # Índice de documentación
│   ├── ARCHITECTURE.md         # Arquitectura de Superset
│   ├── INSTALLATION.md         # Guía de instalación
│   ├── COMMANDS.md             # Comandos útiles
│   ├── CONFIGURATION.md        # Configuración avanzada
│   ├── DATABASES.md            # Conexión a bases de datos
│   ├── BACKLOG.md              # Backlog de tareas
│   ├── PM/                     # Gestión del proyecto
│   │   ├── BOARD.md           # Tablero Kanban
│   │   └── SPRINTS/           # Documentación de sprints
│   └── REPORTS/                # Reportes de estado
└── superset/                    # Repositorio de Superset (clonado)
    ├── docker-compose-image-tag.yml
    ├── docker-compose.yml
    └── ...

🚀 Inicio Rápido

✅ Estado: Superset Funcionando

Superset está instalado y corriendo. ¡Puedes usarlo ahora mismo!

Acceso Inmediato:

Comandos Rápidos

# Navegar al proyecto
cd /Users/ja/Documents/GitHub/superset-analytics

# Iniciar Superset
./start-superset.sh

# Detener Superset
./stop-superset.sh

# Ver logs en tiempo real
cd superset
docker compose -f docker-compose-image-tag.yml logs -f

# Ver estado de contenedores
docker ps

Contenedores Activos

  • superset_app - Aplicación principal (puerto 8088)
  • superset_worker - Worker de Celery
  • superset_worker_beat - Scheduler
  • superset_db - PostgreSQL (puerto 5432)
  • superset_cache - Redis (puerto 6379)

📖 Documentación

La documentación completa está disponible en la carpeta docs/:

Guías Principales

Gestión del Proyecto

🔧 Comandos Principales

Iniciar/Detener Superset

# Iniciar (modo detached)
docker compose -f docker-compose-image-tag.yml up -d

# Detener
docker compose -f docker-compose-image-tag.yml down

# Ver logs en tiempo real
docker compose -f docker-compose-image-tag.yml logs -f

# Reiniciar
docker compose -f docker-compose-image-tag.yml restart

Gestión de Usuarios

# Cambiar contraseña de admin
docker exec -it superset_app superset fab reset-password --username admin

# Crear nuevo usuario
docker exec -it superset_app superset fab create-admin

Mantenimiento

# Backup de base de datos
docker exec superset_db pg_dump -U superset superset > backup_$(date +%Y%m%d).sql

# Actualizar base de datos
docker exec superset_app superset db upgrade

# Ver versión
docker exec superset_app superset version

🗄️ Bases de Datos Soportadas

Superset puede conectarse a múltiples fuentes de datos:

Categoría Bases de Datos
Relacionales PostgreSQL, MySQL, SQLite, SQL Server, Oracle
Cloud DWH BigQuery, Snowflake, Redshift, Azure Synapse
Analíticas ClickHouse, Druid, Elasticsearch, TimescaleDB
Query Engines Presto, Trino, Apache Drill, Hive

Ver DATABASES.md para guías de conexión detalladas.

📊 Características Principales

Visualizaciones

  • 📊 Gráficos de barras, líneas, áreas
  • 🥧 Gráficos circulares y de dona
  • 📈 Gráficos de dispersión y burbujas
  • 🗺️ Mapas geoespaciales
  • 📋 Tablas dinámicas y pivot tables
  • 🔥 Mapas de calor
  • 🎯 KPIs y métricas destacadas
  • Y más de 40 tipos de visualizaciones

Dashboards

  • 🎨 Diseño drag-and-drop
  • 🔄 Actualización automática
  • 🎛️ Filtros globales y cross-filtering
  • 📱 Responsive design
  • 🔗 Compartir y exportar
  • 🔐 Control de permisos

SQL Lab

  • 💻 Editor SQL con autocompletado
  • 📊 Visualización de resultados
  • 💾 Guardar y compartir consultas
  • 📜 Historial de consultas
  • 🔄 Múltiples pestañas
  • 📥 Exportar resultados

🔐 Seguridad

  • 👤 Autenticación integrada
  • 🔑 OAuth, LDAP, OpenID Connect
  • 🛡️ Control de acceso basado en roles (RBAC)
  • 🔒 Row Level Security (RLS)
  • 🔐 Encriptación de credenciales

🎯 Casos de Uso

  1. Business Intelligence: Dashboards ejecutivos y KPIs
  2. Análisis de Datos: Exploración y descubrimiento de insights
  3. Monitoreo: Métricas en tiempo real
  4. Data Science: Visualización de resultados de modelos
  5. Reportes Operacionales: Automatización de reportes

📈 Roadmap del Proyecto

Fase 1: Instalación y Configuración 🟢 (83.3% Completado)

  • Crear documentación completa ✅
  • Clonar repositorio de Superset 5.0.0 ✅
  • Configurar Docker Compose ✅
  • Crear scripts de inicio/parada ✅
  • Levantar contenedores ✅
  • Verificar acceso a interfaz web ✅
  • Explorar ejemplos precargados 🟡 <-- Siguiente paso

Fase 2: Configuración de Datos 🔴 (Próxima)

  • Conectar primera base de datos
  • Crear datasets de prueba
  • Definir métricas y dimensiones
  • Explorar SQL Lab

Fase 3: Visualizaciones 🔴 (Semana 3)

  • Crear múltiples tipos de gráficos
  • Configurar interactividad
  • Crear KPIs
  • Probar diferentes visualizaciones

Fase 4: Dashboard 🔴 (Semana 4)

  • Diseñar layout
  • Construir dashboard completo
  • Configurar filtros globales
  • Personalizar estilos

🤝 Contribución

Este es un proyecto de aprendizaje y exploración de Apache Superset. Para contribuir:

  1. Revisar la documentación en docs/
  2. Seguir las guías de instalación y configuración
  3. Actualizar documentación según cambios
  4. Mantener el tablero Kanban actualizado

📚 Recursos Adicionales

Documentación Oficial

Comunidad

Tutoriales y Videos

📝 Notas Importantes

Acceso a Superset

✅ Estado: FUNCIONANDO
URL: http://localhost:8088
Usuario: admin
Contraseña: admin

🎉 Superset está listo para usar! Abre tu navegador y comienza a explorar.

⚠️ IMPORTANTE: Cambiar la contraseña de admin en producción.

Puertos Utilizados

  • 8088: Interfaz web de Superset
  • 5432: PostgreSQL (base de datos de metadatos)
  • 6379: Redis (caché)

Recursos del Sistema

  • RAM: Mínimo 4GB (8GB recomendado)
  • CPU: 2 cores mínimo (4 cores recomendado)
  • Disco: 5GB mínimo

🐛 Solución de Problemas

Contenedores no inician

# Ver logs detallados
docker compose -f docker-compose-image-tag.yml logs

# Limpiar y reiniciar
docker compose -f docker-compose-image-tag.yml down -v
docker compose -f docker-compose-image-tag.yml up -d

Puerto 8088 en uso

# Encontrar proceso
lsof -i :8088

# Matar proceso
kill -9 <PID>

Problemas de memoria

  • Aumentar memoria en Docker Desktop: Settings → Resources → Memory → 6GB+

Ver INSTALLATION.md para más detalles.

📊 Estado del Proyecto

Versión de Superset: 5.0.0 (última versión estable)
Método de Instalación: Docker Compose
Estado: ✅ SUPERSET FUNCIONANDO
Progreso General: 34.1% completado (14/41 tareas)
Sprint 1: 83.3% completado (5/6 tareas)
Última actualización: Enero 2025

Progreso por Fases

  • Fase 0 - Documentación: 9/9 (100%)
  • 🟢 Fase 1 - Instalación: 5/6 (83.3%)
  • 🔴 Fase 2 - Configuración: 0/4 (0%)
  • 🔴 Fase 3 - Visualizaciones: 0/4 (0%)
  • 🔴 Fase 4 - Dashboard: 0/4 (0%)
  • 🔴 Fases Futuras: 0/20 (0%)

📄 Licencia

Apache Superset es software de código abierto bajo la Apache License 2.0.


Desarrollado con: Apache Superset 5.0.0 | Docker | PostgreSQL | Redis
Estado: ✅ Funcionando en http://localhost:8088
Documentación: Ver carpeta docs/ para guías completas
Progreso: 34.1% completado (14/41 tareas)
Soporte: Revisar documentación oficial o Slack community

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages