feat: Implementación del panel de administración (Dashboard)

Se ha implementado un completo panel de administración con las siguientes características:

Archivos añadidos:
- Templates HTML:
  * dashboard_base.html: Estructura base del panel con navegación lateral
  * msg_stats.html: Estadísticas detalladas de mensajes
  * report_stats.html: Visualización y gestión de reportes de usuarios
  * ride_management.html: CRUD de viajes con filtrado avanzado
  * trip_stats.html: Análisis de viajes con gráficos
  * user_management.html: Gestión de usuarios (ver, eliminar)
  * user_stats.html: Métricas de usuarios registrados

- Archivos CSS:
  * dashboard.css: Estilos específicos para el panel principal
  * dashboard_shared.css: Sistema de componentes y variables compartidas

- Archivos JavaScript:
  * dashboard.js: Funcionalidad general del panel
  * msg_stats.js: Generación de gráficos para estadísticas de mensajes

- Python:
  * urls.py: Configuración de rutas para el panel y APIs
  * views.py: Controladores para generar los datos del panel

- Scripts:
  * generate_demo_data.sh: Generación de datos de prueba para demostración

El panel permite:
- Visualizar métricas de la plataforma con gráficos interactivos
- Gestionar viajes (filtrar, buscar, eliminar)
- Analizar mensajes entre usuarios
- Gestionar reportes de usuarios
- Administrar usuarios
- Visualizar datos por diferentes periodos (hoy, semana, mes, año, todo)

También añadido/modificado:

- Funciones de interfaz pública añadidas a las aplicaciones existentes:
  * chat.public: delete_chat(), get_messages_for_chat(), get_messages_count(), get_messages_in_period(), get_all_chats_with_stats(), filter_chats_by_criteria(), get_chat_stats()
  * accounts.public: get_active_users(), delete_user(), get_user_count(), get_users_in_period(), filter_users_by_criteria(), get_recently_registered_users()
  * rides.public: get_rides_published_in_period(), delete_ride(), get_active_rides_today(), get_seats_available(), get_ride_stats(), filter_rides_by_criteria(), get_Termporal_ride_data(), get_popular_locations(), get_basic_ride_data() get ride_stats_for_dashboard(), get_completed_rides), get_recently_publissed_rides, get_Active_Rides_today()
  * reports.public: get_report_by_id(), update_report_status()
  * payments.public: get_recent_payments(), get_payments_Stats(), get_payments_in_period(), get_recent_payments()

- Utilidades del panel de control:
  * Utils.py: Funciones de ayuda para el tratamiento de datos, la generación de gráficos y la preparación del contexto
  * constants.py: Constantes para rutas de plantillas, claves de contexto y nombres de URL.

Author: alejandroGM0

README.md

@@ -117,6 +117,43 @@ Para ejecutar un método de test específico:
 python manage.py test nombre_app.tests.test_module.NombreClaseTest.test_metodo
 ```
 
+# Generador de Datos de Prueba para CharlaCar
+
+Este comando de gestión de Django genera datos de prueba aleatorios.
+## Uso
+
+Para generar datos de prueba, ejecute:
+
+```bash
+python manage.py generate_test_data
+```
+
+### Opciones disponibles
+
+- `--users NUMBER`: Número de usuarios a crear (por defecto: 20)
+- `--rides NUMBER`: Número de viajes a crear (por defecto: 50)
+- `--chats NUMBER`: Número de chats a crear (por defecto: 30)
+- `--messages NUMBER`: Número de mensajes a crear (por defecto: 200)
+- `--reports NUMBER`: Número de reportes a crear (por defecto: 25)
+- `--payments NUMBER`: Número de pagos a crear (por defecto: 40)
+- `--clean`: Elimina todos los datos existentes antes de generar nuevos datos
+
+### Ejemplos
+
+Generar datos con los valores predeterminados:
+```bash
+python manage.py generate_test_data
+```
+
+Generar un conjunto más grande de datos:
+```bash
+python manage.py generate_test_data --users 100 --rides 200 --messages 1000
+```
+
+Limpiar la base de datos y generar un pequeño conjunto de datos:
+```bash
+python manage.py generate_test_data --clean --users 10 --rides 20
+```
 
 ## Estructura del proyecto
 

codigo/accounts/__init__.py

@@ -0,0 +1,3 @@
+# ==========================================
+# Autor: Alejandro Gasca Mediel
+# ==========================================

codigo/accounts/_utils.py

@@ -1,3 +1,6 @@
+# ==========================================
+# Autor: Alejandro Gasca Mediel
+# ==========================================
 """
 Funciones de utilidad interna para la aplicación de cuentas (accounts).
 """

codigo/accounts/admin.py

@@ -1,3 +1,6 @@
+# ==========================================
+# Autor: Alejandro Gasca Mediel
+# ==========================================
 from django.contrib import admin
 from .models import UserProfile
 from django.contrib.auth.models import User

codigo/accounts/apps.py

@@ -1,3 +1,6 @@
+# ==========================================
+# Autor: Alejandro Gasca Mediel
+# ==========================================
 from django.apps import AppConfig
 
 

codigo/accounts/constants.py

@@ -1,3 +1,6 @@
+# ==========================================
+# Autor: Alejandro Gasca Mediel
+# ==========================================
 # Descripción: Constantes utilizadas en la aplicación de cuentas de usuario.
 # Tipos de configuraciones
 ACCOUNT_SETTINGS = 'account'

codigo/accounts/forms.py

@@ -1,3 +1,6 @@
+# ==========================================
+# Autor: Alejandro Gasca Mediel
+# ==========================================
 from django import forms
 from django.contrib.auth.forms import UserCreationForm
 from django.contrib.auth.models import User

codigo/accounts/models.py

@@ -1,3 +1,6 @@
+# ==========================================
+# Autor: Alejandro Gasca Mediel
+# ==========================================
 from django.db import models
 from django.contrib.auth.models import User
 from django.utils import timezone

codigo/accounts/public.py

@@ -1,9 +1,12 @@
+# ==========================================
+# Autor: Alejandro Gasca Mediel
+# ==========================================
 """
 API pública de la aplicación de cuentas (accounts).
 """
 from django.contrib.auth.models import User
 from django.utils import timezone
-from datetime import date
+from datetime import date, timedelta
 
 from .models import UserProfile
 from .constants import (
@@ -23,6 +26,49 @@ def get_user_profile(user):
     return profile
 
 
+def get_user_count():
+    """
+    Obtiene el número total de usuarios en el sistema.
+    """
+    return User.objects.count()
+
+
+def get_users_in_period(start_date=None, end_date=None):
+    """
+    Obtiene los usuarios registrados en un período específico.
+    """
+    users = User.objects.all()
+    
+    if start_date:
+        users = users.filter(date_joined__date__gte=start_date)
+    
+    if end_date:
+        users = users.filter(date_joined__date__lte=end_date)
+        
+    return users
+
+
+def get_active_users(minutes=30):
+    """
+    Obtiene los usuarios que han estado activos en los últimos minutos especificados.
+    """
+    threshold_time = timezone.now() - timedelta(minutes=minutes)
+    active_profiles = UserProfile.objects.filter(last_active__gte=threshold_time)
+    user_ids = active_profiles.values_list('user_id', flat=True)
+    
+    return User.objects.filter(id__in=user_ids)
+
+
+def get_recently_registered_users(days=7, limit=5):
+    """
+    Obtiene los usuarios registrados recientemente.
+    """
+    recent_date = timezone.now() - timedelta(days=days)
+    return User.objects.filter(
+        date_joined__gte=recent_date
+    ).order_by('-date_joined')[:limit]
+
+
 def get_user_by_username(username):
     """
     Busca un usuario por su nombre de usuario.
@@ -153,7 +199,7 @@ def profile_is_visible(user):
     profile = get_user_profile(user)
     return profile.profile_visible
 
-#TODO HAY Q EVITAR DUPLICIDAD ENTRE PUBLIC Y PRIVATE    
+
 def update_last_activity(user):
     """
     Actualiza la marca de tiempo de última actividad del usuario.
@@ -162,6 +208,7 @@ def update_last_activity(user):
     profile.last_active = timezone.now()
     profile.save(update_fields=[LAST_ACTIVE_FIELD])
 
+
 def update_notification_preference(user, notification_type, value):
     """
     Actualiza una preferencia de notificación específica.
@@ -178,4 +225,63 @@ def update_notification_preference(user, notification_type, value):
         return False
 
     profile.save(update_fields=[f'{notification_type}_notifications'])
-    return True
+    return True
+
+
+def delete_user(user_id):
+    """
+    Elimina un usuario por su ID.
+    """
+    try:
+        user = User.objects.get(id=user_id)
+        user.delete()
+        return True
+    except User.DoesNotExist:
+        return False
+        
+        
+def filter_users_by_criteria(search='', status='all', from_date='', to_date=''):
+    """
+    Filtra usuarios según múltiples criterios para el panel de administración.
+    """
+    from django.db.models import Q
+    import datetime
+    
+    users = User.objects.all().order_by('-date_joined')
+    
+    if search:
+        users = users.filter(
+            Q(username__icontains=search) |
+            Q(email__icontains=search) |
+            Q(first_name__icontains=search) |
+            Q(last_name__icontains=search)
+        )
+    
+    if status == 'active':
+        active_threshold = timezone.now() - timedelta(minutes=30)
+        user_ids = UserProfile.objects.filter(last_active__gte=active_threshold).values_list('user_id', flat=True)
+        users = users.filter(id__in=user_ids)
+    elif status == 'inactive':
+        active_threshold = timezone.now() - timedelta(minutes=30)
+        user_ids = UserProfile.objects.filter(
+            Q(last_active__lt=active_threshold) | Q(last_active__isnull=True)
+        ).values_list('user_id', flat=True)
+        users = users.filter(id__in=user_ids)
+    elif status == 'staff':
+        users = users.filter(is_staff=True)
+    
+    if from_date:
+        try:
+            from_date_obj = datetime.datetime.strptime(from_date, '%Y-%m-%d').date()
+            users = users.filter(date_joined__date__gte=from_date_obj)
+        except ValueError:
+            pass
+    
+    if to_date:
+        try:
+            to_date_obj = datetime.datetime.strptime(to_date, '%Y-%m-%d').date()
+            users = users.filter(date_joined__date__lte=to_date_obj)
+        except ValueError:
+            pass
+    
+    return users

codigo/accounts/tests/__init__.py

@@ -0,0 +1,3 @@
+# ==========================================
+# Autor: Alejandro Gasca Mediel
+# ==========================================